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

Arguments

calendars | calendar | cal

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

If argument 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 eventrulename follows, lists or prints the eventrulename event rule. Wildcard characters are permitted.

parms | parm | vb

If no argument follows, lists or prints all global variable definitions found in the default variable table.

If argument 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 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 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 workstationame#resourcename follows, lists or prints the resourcename resource of the workstationame workstation on which the resource is defined. If workstationame is omitted, the default is the workstation on which composer is running. Wildcard characters are permitted for both workstationame and resourcename.

runcyclegroup | rcg

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

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

cpu

Lists or prints workstations, workstation classes, or domains.

workstation

The name of the workstation. Wildcard characters are permitted.

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 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 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 workstationclassname follows, lists or prints the workstationclassname workstation class. Wildcard characters are permitted.

jobs | jobdefinition | jd

If no argument follows, lists or prints all job definitions.

If argument workstationame#jobname follows, lists or prints the jobname job 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 both workstationame and jobname.

sched | jobstream | js

If no argument follows, lists or prints all job stream definitions.

If argument workstationame#jstreamname follows, lists or prints the jstreamname job stream 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 both workstationame 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 workstationame#username follows, lists or prints the username user of the workstationame workstation on which the user is defined. If workstationame is omitted, the default is the workstation on which composer is running. Wildcard characters are permitted for both workstationame and username.

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.

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.

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

See also

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

the Dynamic Workload Console User's Guide.

• To list or print workstations, see

  Editing workstation definitions.

• To list or print event rules, see

  Editing event rules.

• To list or print access control lists, security domains, and security roles, see

  Managing Workload Security.

• To list or print all other objects, see

  Listing object definitions in the database.