morestdl

Displays the contents of standard list files. This command must be run by the user for which HCL Workload Automation was installed. If you use this command without any parameters, ensure that you are logged on as an HCL Workload Automation user. This command is supported for fault-tolerant agents and standard agents.

Syntax

morestdl -V | -U

morestdl
     [-day num]
     [-first | -last | -num n | -all]
     [-twslog]
     [{-name ["[folder/]jobstreamname [(hhmm date),(jobstream_id)].]jobname"
       | jobnum | -schedid jobstream_id.jobname}]

Arguments

-V
Displays the command version and exits.
-U
Displays command usage information and exits.
-day num
Displays standard list files that are the specified number of days old (1 for yesterday, 2 for the day before yesterday, and so on). The default is zero (today).
-first
Displays the first qualifying standard list file.
-last
Displays the last qualifying standard list file.
-num n
Displays the standard list file for the specified run of a job.
-all
Displays all qualifying standard list files.
-twslog
Displays the content of the current day stdlist file.
-name ["[folder/]jobstreamname [(hhmm date),(jobstream_id)].]jobname"|jobnum
Specifies the instance of the job stream, optionally preceded by the folder within which the job stream is defined, and the name of the job for which the standard list file is displayed.
jobnum
Specifies the job number of the job for which the standard list file is displayed.
-schedid jobstream_id.jobname
Specifies the job stream ID and name of the job for which standard list file names are returned.

Comments

The square brackets in the expression [(hhmm date), (jobstream_id)] are part of the command, not syntax indicators. This means that you can supply either of the following for the -name argument:
morestdl -name ["[folder/]jobstreamname[(hhmm date),(jobstream_id)].jobname"
morestdl -name jobnum

The whole job identification string must be enclosed in double quotation marks if the part identifying the job stream instance contains blanks. For example, because the schedtime, represented by hhmm date, has a space in it you must enclose the whole job identification in double quotation marks.

If you just want to identify a job name, you do not need the double quotation marks.

The following is an example of the syntax to use when identifying a job both with and without its job stream. In the example, job_stream1 is the name of the job stream, 0600 04/05/06 is the scheduled time, 0AAAAAAAAAAAAAB5 is the job stream ID, and job1 is the job name. You can run the morestdl command against job1 using either of these two formats:

morestdl -name "job_stream1[(0600 04/05/06),(0AAAAAAAAAAAAAB5)].job1"
morestdl -name job1

Examples

To display the standard list file for the first run of job MY_CPU#ELI[(1824 03/09/06),(0AAAAAAAAAAAAAEE)].DIR on the current day, run the following command:
morestdl -first -name "MY_CPU#ELI[(1824 03/09/06),(0AAAAAAAAAAAAAEE)].DIR"
To display the standard list file for the first run of job 0AAAAAAAAAAAAAEE.DIR on the current day, run the following command:
morestdl -first -schedid 0AAAAAAAAAAAAAEE.DIR
To display the standard list file for the second run of job MY_CPU#ELI[(1824 03/09/06),(0AAAAAAAAAAAAAEE)].DIR on the current day, run the following command:
morestdl -num 2 -name "MY_CPU#ELI[(1824 03/09/06),(0AAAAAAAAAAAAAEE)].DIR"
To display the standard list files for all runs of job MY_CPU#ELI[(1824 03/09/06),(0AAAAAAAAAAAAAEE)].DIR from three days ago, run the following command:
morestdl -day 3 -name "MY_CPU#ELI[(1824 03/09/06),(0AAAAAAAAAAAAAEE)].DIR"
To display the standard list file for the last run of job MY_CPU#ELI[(1824 03/09/06),(0AAAAAAAAAAAAAEE)].DIR from four days ago, run the following command:
morestdl -day 4 -last -name "MY_CPU#ELI[(1824 03/09/06),(0AAAAAAAAAAAAAEE)].DIR" 
To print the standard list file for job number 455, run the following command:
morestdl 455 | lp -p 6