list

Lists, or prints summary information about objects defined in the HCL Workload Automation database. List provides you with the list of objects names with their attributes. Print sends the list of objects names with their attributes to the device or file specified in the MAESTROLP local variable. The print command can be used to send the output to a local printer, if the MAESTROLP variable is set accordingly.

Authorization

If the enListSecChk global option is set to yes on the master domain manager, then to list or print an object you must have either list access, or list and display access.

To list security objects, you must have permission for the display action on the object type file with attribute name=security.

Syntax

{list | l}
{[calendars | calendar | cal=[folder/]calname] |
[eventrule | erule | er=[folder/]eventrulename] |
folder|fol=foldername |
[parms | parm | vb=[[folder/]tablename.]variablename] |
[vartable | vt=[folder/]tablename] |
[prompts | prom=[folder/]promptname] |
[resources | resource | res=[[folder/]workstationame#]resourcename] |
[runcyclegroup | rcg=[folder/]runcyclegroupname] |
[cpu={[folder/]workstationame | [folder/]workstationclassname | domainame}]
[wat=workloadapplicationtemplatename]
[workstation | ws=[folder/]workstationame] |
[workstationclass | wscl=[folder/]workstationclassname] |
[domain | dom=domainame] |
[jobs | jobdefinition | jd=[[folder/]workstationame#][folder/]jobname] |
[sched |jobstream | js= [[folder/]workstationame#][folder/]jstreamname
   [valid from date|
    valid to date |valid in date date]
|
[users | user=[[folder/]workstationame#]username] |
[accesscontrollist | acl for securitydomainname] |
[securitydomain | sdom=securitydomainname] |
[securityrole | srol=securityrolename]
}
[;offline]
[;showid]

Arguments

calendars | calendar | cal
If no argument follows, lists or prints all calendar definitions.

If argument [folder/]calname follows, lists or prints the calname calendar. Wildcard characters are permitted.

eventrule | erule | er
If no argument follows, lists or prints all event rule definitions.

If argument [folder/]eventrulename follows, lists or prints the eventrulename event rule. Wildcard characters are permitted.

folder | fol
If no argument follows, lists or prints the current folder.

If argument foldername follows, lists or prints the foldername folders. Wildcard characters are permitted.

You can also use the dedicated listfolder composer command to list folders.

parms | parm | vb
If no argument follows, lists or prints all global variable definitions found in the default variable table.
If argument [folder/]tablename.variablename follows, lists or prints the variablename variable of the tablename table. If tablename is omitted, composer looks for the variable definition in the default variable table. Wildcard characters can be used on both tablename and variablename. For example:
list parms=@.@
Lists all variables on all tables.
list parms=@
Lists all variables on the default table.
list parms=@.acct@
Lists all the variables whose name starts with acct on all the existing tables.
vartable | vt
If no argument follows, lists or prints all variable table definitions.

If argument [folder/]tablename variable table follows, lists or prints the tablename variable table. Wildcard characters are permitted.

prompts | prom
If no argument follows, lists or prints all prompt definitions.

If argument [folder/]promptname follows, lists or prints the promptname prompt. Wildcard characters are permitted.

resources | resource | res
If no argument follows, lists or prints all resource definitions.

If argument [folder/]workstationame#[folder/]resourcename follows, lists or prints the resourcename resource of the workstationame workstation in the specified folder on which the resource is defined. If workstationame is omitted, the default is the workstation on which composer is running. Wildcard characters are permitted.

runcyclegroup | rcg
If no argument follows, lists or prints all run cycle groups.

If argument [folder/]runcyclegroupname follows, lists or prints the runcyclegroupname run cycle group. Wildcard characters are permitted.

[folder/]workstation
The name of the workstation. Wildcard characters are permitted.
[folder/]workstationclass
The name of the workstation class. Wildcard characters are permitted.
domain
The name of the domain. Wildcard characters are permitted.
wat
If no argument follows, lists or prints all workload application template definitions.

If argument [folder/]workloadapplicationtemplate follows, lists or prints the specified workload application template. Wildcard characters are permitted.

workstation | ws
If no argument follows, lists or prints all workstation definitions.

If argument [folder/]workstationname follows, lists or prints the workstationname workstation. Wildcard characters are permitted.

domain | dom
If no argument follows, lists or prints all domain definitions.

If argument domainname follows, lists or prints the domainname domain. Wildcard characters are permitted.

workstationclass | wscl
If no argument follows, lists or prints all workstation class definitions.

If argument [folder/]workstationclassname follows, lists or prints the workstationclassname workstation class. Wildcard characters are permitted.

[folder/]
The folder where the job or job stream definition is stored. You can specify folder names using absolute or relative paths. If you want to submit the command from a precise folder, then you can use the chfolder command to navigate folders and sub-folders. The chfolder command changes the working directory, which is set to root ("/") by default, so that you can use relative folder paths when submitting commands. See chfolder for more information about changing folder paths.
jobs | jobdefinition | jd
If no argument follows, lists or prints all job definitions.

If argument workstationame#[folder/]jobname follows, lists or prints the jobname job stored in the folder named [folder/] of the workstationame workstation on which the job runs. If workstationame is omitted, the default is the workstation on which composer is running. Wildcard characters are permitted for workstationame, [folder/], and jobname.

sched | jobstream | js
If no argument follows, lists or prints all job stream definitions.
If argument workstationame#[folder/]jstreamname follows, lists or prints the jstreamname job stream stored in the folder named [folder/] of the workstationame workstation on which the job stream is defined. If workstationame is omitted, the default is the workstation on which composer is running. Wildcard characters are permitted for workstationame, [folder/], and jstreamname.
valid from
date Restricts the selection to job streams that have a valid from date equal to the indicated value. The format is mm/dd/yyyy.
valid to
date Restricts the selection to job streams that have a valid to date equal to the indicated value. The format is mm/dd/yyyy.
valid in
date date The time frame during which the job stream can run. The format is mm/dd/yyyy - mm/dd/yyyy. One of the two dates can be represented by @.
users | user
If no argument follows, lists or prints all user definitions.

If argument [folder/]workstationame#username follows, lists or prints the username user of the workstationame workstation in the specified folder on which the user is defined. If workstationame is omitted, the default is the workstation on which composer is running. Wildcard characters are permitted.

Note: If you are listing windows users in the UPN format username@internet_domain , insert the escape character '\' before the '@' character in the username@internet_domain value. For example if you are listing the administrator@bvt.com user, run the following command:
list users=administrator\@bvt.com
accesscontrollist | acl
If no securitydomainname argument follows, lists or prints the access control list definitions for all the security domains.

If argument securitydomainname follows, lists or prints the access control list definitions for the securitydomainname security domain. Wildcard characters are permitted for securitydomainname .

securitydomain | sdom
If no securitydomainname argument follows, lists or prints all the security domain definitions.

If argument securitydomainname follows, lists or prints the securitydomainname security domain definition. Wildcard characters are permitted for securitydomainname .

securityrole | srol
If no securityrolename argument follows, lists or prints all the security role definitions.

If argument securityrolename follows, lists or prints the securityrolename security role definition. Wildcard characters are permitted for securityrolename .

;offline
Sends the output of the command to the composer output device. For information about this device, see UNIX variables. The list ..... ;offline command is equivalent to the print command.
showid
Displays a unique identifier that identifies a workstation, resource or prompt. These objects are no longer identified in the plan solely by their names, but also by the folder in which they are defined. The name and folder association is mapped to a unique identifier. For example, for workstations, the this_cpu option is the unique identifier of the workstation in the localopts file. You can verify the unique identifier for workstations, resources, and prompts by submitting the composer list command, together with the ;showid filter, or by submitting the conman command, showcpus, showresources, or showprompts, in combination with the ;showid filter. See the related example in the Examples section.

Identifying workstations by their unique identifier avoids the problem that occurred in previous versions when objects were renamed in the plan. For example, if an object was renamed and then carried forward to a new production plan, references to the old object name were lost. With the implementation of the unique identifier, this will no longer occur and dependencies will be correctly resolved.

When deleting a workstation, if the workstation is still in the plan, then another workstation cannot be renamed with the name of the deleted workstation for the number of days specified by the global option folderDays. However, a brand new workstation can be created with the name of the deleted workstation. This behavior applies only to dynamic agents, pools, and dynamic pools. The default value is 10 days.

When deleting a folder, a prompt, or resource, if there are still objects in the plan that reference these objects, then another folder, prompt, or resource cannot be renamed with the name of the deleted folder, prompt or resource for the number of days specified by folderDays. However, a brand new folder, prompt, or resource can be created with the name of the deleted object. For more information about the folderDays option see Global options - detailed description.

Results

List provides you with the list of objects names with their attributes. Print sends the list of objects names with their attributes to the device or file set in the MAESTROLP local variable. The print command can be used to send the output to a local printer, if you set the MAESTROLP variable accordingly. Make sure the MAESTROLP is set in your environment before running the print command.

Depending on the value set in the MAESTROCOLUMNS local variable the different sets of information about the selected object can be shown.

Output formats for displaying scheduling objects shows an example of the output produced according to the value set for the MAESTROCOLUMNS variable.
Table 1. Output formats for displaying scheduling objects
Object Type Output format if MAESTROCOLUMNS<120 Output format if MAESTROCOLUMNS ≥120
Calendar "CalendarName : UpdatedOn : LockedBy" "CalendarName : UpdatedBy : UpdatedOn : LockedBy : LockedOn"
Domain "DomainName : ParentDomain : Master : UpdatedOn : LockedBy" "DomainName : ParentDomain : Master : UpdatedBy : UpdatedOn : LockedBy : LockedOn"
Event rule "EventRuleName : Type : Draft : Status : UpdatedOn : LockedBy" "EventRuleName : Type : Draft : Status : UpdatedOn : LockedBy : LockedOn"
Folder "Name : UpdateOn : LockedBy" "Name : UpdateOn : LockedBy"
Job "Workstation : JobDefinitionName : UpdatedOn : LockedBy" "Workstation : JobDefinitionName : TaskType : UpdatedBy : LockedBy : LockedOn"
Job Stream "Workstation : JobstreamName : Validfrom : UpdatedOn : LockedBy" "Workstation : JobstreamName : Draft : ValidFrom : ValidTo : UpdatedBy : UpdatedOn : LockedBy : LockedOn"
Parameter "VariableTableName : VariableName : UpdatedOn : LockedBy" "VariableTableName : VariableName : UpdatedBy : UpdatedOn : LockedBy : LockedOn"
Prompt "PromptName : UpdatedOn : LockedBy " "PromptName : UpdatedBy : UpdatedOn : LockedBy : LockedOn"
Resource "Workstation : ResourceName : Quantity : UpdatedOn : LockedBy " "Workstation : ResourceName : Quantity : UpdatedBy : UpdatedOn : LockedBy : LockedOn"
Run cycle group "RunCycleGroupName : UpdatedOn : LockedBy " "RunCycleGroupName : UpdatedBy : UpdatedOn : LockedBy : LockedOn"
Variable Table "VariableTableName : Default : UpdatedOn : LockedBy " "VariableTableName : Default : UpdatedBy : UpdatedOn : LockedBy : LockedOn"
User "Workstation : UserName : UpdatedOn : LockedBy" "UserName : Workstation : UpdatedBy : UpdatedOn : LockedBy : LockedOn"
Workstation "WorkstationName : Type : Domain : Ignored : UpdatedOn : LockedBy" "WorkstationName : Type : Domain : OsType : Ignored : UpdatedBy : UpdatedOn : LockedBy : LockedOn"
Workstation Class "WorkstationClassName : Ignored : UpdatedOn : LockedBy" "WorkstationClassName : Ignored : UpdatedBy : UpdatedOn : LockedBy : LockedOn"

See Offline output for more information on how to set MAESTROLP.

Examples

  • To list all calendars, run the following command:
    list calendars=@
    this is a sample output:
    Calendar Name     Updated On  Locked By
    ----------------  ----------  ---------------------
    HOLIDAYS          03/02/2021
    PAYDAYS           03/02/2021
    HOLIDAYS          03/02/2021
      01/01/2021 02/15/2021 05/31/2021
    
    
    Calendar Name     Updated On  Locked By
    ----------------  ----------  ---------------------
    MONTHEND          01/01/2021  -
    
    MONTHEND
      "Month end dates 1st half 2010"
      01/31/2021 02/28/2021 03/31/2021 04/30/2021 05/31/2021 06/30/2021
    
    Calendar Name     Updated On  Locked By
    ----------------  ----------  ---------------------
    PAYDAYS           01/02/2021  -
    
    PAYDAYS
      01/15/2021 02/15/2021 03/15/2021 04/15/2021 05/14/2021 06/15/2021
  • To list all your defined event rules, run the following command:
    list er=@
    If MAESTROCOLUMNS=80, the output looks something like this:
    Event Rule Name   Type       Draft  Status     Updated On  Locked By
    ----------------  ---------  -----  ---------  ----------  -------------
    EVENT-MULTIPLE1   filter            active     06/06/2021  -
    EVENT-MULTIPLE2   filter            active     06/06/2021  -
    EVENT-MULTIPLE3   filter            active     06/06/2021  -
    M_SUCC_12_S       sequence   Y      inactive   06/07/2021  -
    M_SUCC_12_S_A     filter            active     06/07/2021  -
    M_SUCC_12_S_B     filter     Y      inactive   06/07/2021  -
    NEWEVENTRULE      filter            active     06/01/2021  administrator
    If MAESTROCOLUMNS≥120, the output looks something like this:
    Event Rule Name         Type      Draft Status   Updated On  Locked By
    ---------------------   --------- ----- -------- ---------- ---------
    EVENT-MULTIPLE1         filter          active   06/06/2021 -
    EVENT-MULTIPLE2         filter          active   06/06/2021 -
    EVENT-MULTIPLE3         filter          active   06/06/2021 -
    M_SUCC_12_S             sequence   Y    inactive 06/07/2021 -
    M_SUCC_12_S_A           filter          active   06/07/2021 -
    M_SUCC_12_S_B           filter     Y    inactive 06/07/2021 -
    NEWEVENTRULE            filter          active   06/01/2021 administrator
  • To view the properties of the NC1150691 agent workstation, run the following command:
    list ws=NC1150691
    An output similar to the following is displayed:
    Workstation Name  Type     Domain            Ignored  Updated On  Locked By
    ----------------  -------  ----------------  -------  ----------  ----------
    NC1150691         agent    -                          03/31/2021  -
    
    CPUNAME NC1150691
      DESCRIPTION "This workstation was automatically created at agent
                   installation time."
      OS WNT
      NODE nc115069.LondonLab.uk.vbtredfk.com SECUREADDR 22114
      TIMEZONE GMT+1
      FOR MAESTRO HOST NC115069_DWB
        TYPE AGENT
        PROTOCOL HTTPS
    END
  • To view the properties of the POOL_A pool workstation, including all its members, run the following command:
    list ws=POOL_A
    An output similar to the following is displayed:
    Workstation Name  Type     Domain            Ignored  Updated On  Locked By
    ----------------  -------  ----------------  -------  ----------  ----------------
    POOL_A            pool     -                          03/31/2021  -
    
    CPUNAME POOL_A
      DESCRIPTION "This is a manually created pool"
      VARTABLE TABLE1
      OS OTHER
      TIMEZONE America/Argentina/Buenos_Aires
      FOR MAESTRO HOST NC115069_DWB
        TYPE POOL
      MEMBERS
        NC1150691
        NC1150692
    END
  • To list job streams defined in the folder named FOLDJS_API on all workstations using an absolute path, submit the following command:
    composer li js @#/FOLDJS_API/@
    The following is the output of this command:
    -li js @#/FOLDJS_API_132/
    
    Workstation       Job Stream Name   Valid From  Updated On  Locked By
    ----------------  ----------------  ----------  ----------  ----------------
    >>                /FOLDJS_API_132/
    EU-HWS-LNX127     JS_FOLD_API_132   08/22/2021  07/31/2022  -
    
    Optionally, you can obtain this same result, by submitting the command using a relative path. To submit the command using a relative path, use the -cf option to change the current folder from root (/) to /FOLDJS_API/ as follows:
    composer -cf /FOLDJS_API_132/ "li js @#@"
    An additional way to obtain the same result is to change the current folder in composer first, then submit the command:
    -cf /FOLDJS_API/
    -li js @#@
  • To list workstation Austin, stored in folder Texas, run the command:
    list ws Texas/Austin
  • To list all workstations defined in all folders, including the unique identifier assigned to each workstation:
    -li ws=/@/@;showid
    The following is the output for this command:
    Workstation Name  Type     Domain      Ignored  Updated On  Locked By
    ----------------  -------  ----------  -------  ----------  ----------------
    AGENT95_DYN       agent    -                    09/30/2021  -
    EU-HWS-LNX36      manager  MASTERDM             10/03/2021  -
    EU-HWS-LNX36_1    agent    -           Y        09/30/2021  -
    EU-HWS-LNX36_1_1  agent    -                    09/30/2021  -                 {07775EB26F77524X}
    EU-HWS-LNX36_1_2  agent    -                    10/03/2021  -                 {0AAEYDX55XC22E6C}
    EU-HWS-LNX36_DWB  broker   MASTERDM             09/30/2021  -
    MASTERAGENTS      pool     -                    09/30/2021  -
    
    /WSFTA95/
    FTA95OMAR         fta      MASTERDM             09/30/2021  -                 {0AAA5D7ZC7BY24A6}

See also

From the Dynamic Workload Console you can perform the same tasks as described in:

the Dynamic Workload Console User's Guide.