jobstdl

Returns the names 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.

Syntax

jobstdl -V | -U

jobstdl
     [-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
Returns the names of 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
Returns the name of the first qualifying standard list file.
-last
Returns the name of the last qualifying standard list file.
-num n
Returns the name of the standard list file for the specified run of a job.
-all
Returns the name of all qualifying standard list files.
-twslog
Returns the path of the current day stdlist file.
-name ["[folder/]jobstreamname[(hhmm date), (jobstream_id)].]jobname" | jobnum
Specifies the instance of the job stream and name of the job for which standard list file names are returned.
jobnum
Specifies the job number of the job for which standard list file names are returned.
-schedid jobstream_id.jobname
Specifies the job stream ID and name of the job for which standard list file names are returned.

Comments

File names are returned in a format suitable for input to other commands. Multiple names are returned separated by a space.

When you use the full syntax of the -name argument, the square brackets in the expression [(hhmm date), (jobstream_id)] are part of the command, not syntax indicators. Also, 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.

You can also run abbreviated versions of the -name argument using a simpler syntax. If you want less specific outputs from the command, you can specify just the schedtime (the date is not required if it is for the same day) or the jobstream_id together with the jobname. As long as there are no blanks in the arguments, you can omit the double quotation marks. You can also omit the square brackets if you do not specify both the schedtime and the jobstream_id.

The following examples show the syntax you must use with the -name argument for the different types of information you expect in return, ranging from the more specific to the more general. 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. The job number of job1 is 310. You can run jobstdl for job1 as follows:

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

Returns the standard list file name of job1 for the specific instance of job_stream1 with the specified schedtime and jobstream_id.

jobstdl -name job_stream1(0AAAAAAAAAAAAAB5).job1

Returns the standard list file name for job1 for the instance of job_stream1 with ID 0AAAAAAAAAAAAAB5.

jobstdl -name "job_stream1(0600 04/05/10).job1"

Returns the standard list file names for job1 for all possible instances of job_stream1 scheduled to run at 0600 of 04/05/10.

jobstdl -name job_stream1(0600).job1

Returns the standard list file names for job1 for all possible instances of job_stream1 scheduled to run at 0600 of the current day.

jobstdl -name 310

Returns the standard list file names for job1 for all the instances it had job number 310.

Examples

To return the path names of all standard list files for the current day, run the following command:
jobstdl 
To return the path name of the standard list for the first run of job MY_CPU#ELI[(1824 03/09/06),(0AAAAAAAAAAAAAEE)].DIR on the current day, run the following command:
jobstdl -first -name "MY_CPU#ELI[(1824 03/09/06),(0AAAAAAAAAAAAAEE)].DIR"
To return the path name of the standard list for the first run of job 0AAAAAAAAAAAAAEE.DIR on the current day, run the following command:
jobstdl -first -schedid 0AAAAAAAAAAAAAEE.DIR
To return the path name of the standard list for the second run of job MY_CPU#ELI[(1824 03/09/06),(0AAAAAAAAAAAAAEE)].DIR on the current day, run the following command:
jobstdl -num 2 -name "MY_CPU#ELI[(1824 03/09/06),(0AAAAAAAAAAAAAEE)].DIR"
To return the path names of 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:
jobstdl -day 3 -name "MY_CPU#ELI[(1824 03/09/06),(0AAAAAAAAAAAAAEE)].DIR"
To return the path name of the standard list for the last run of job MY_CPU#ELI[(1824 03/09/06),(0AAAAAAAAAAAAAEE)].DIR from four days ago, run the following command:
jobstdl -day 4 -last -name "MY_CPU#ELI[(1824 03/09/06),(0AAAAAAAAAAAAAEE)].DIR"
To return the path name of the standard list for job number 455, run the following command:
jobstdl 455
To print the contents of the standard list file for job number 455, run the following command:
cd ˋmaestroˋ/bin
lp -p 6 ˋjobstdl 455ˋ