jobstdl

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.