LISTJOB – List job attributes from the database
Use LISTJOB
to display the job
attributes from the database. These can include the applications where
the job is coded, the operation level details, including Special Resources
and User Fields, and dependencies, including internal and external
predecessors and successors.
LISTJOB <jobname> [ADID(<adname>)] [DETAIL(APPL|OPER|SUCC)]
[DISPLAY(YES|NO)]
[FLOW(n)] [GROUPDEF(<application-group>)]
[GROUP(<authority-group>)] [MULTI(ALL|FAIL|FIRST|LAST)]
[IGNORE(=ALL,=NONE,=FIRST,=LAST,=<wstype>,<wsname>,<opno>)]
[OBJECT(<object>)] [OPNO(nnn)] [OUTPUT(*|<ddname>)]
[OWNER(<owner>)][PRIORITY(n)] [SAVELIST(<savelist>)]
[STATUS(A|P|*)] [STYLE(TEXT|LOADER)]
[VALFROM(yymmdd)] [VALID(yymmdd)] [VALTO(yymmdd)]
[WSNAME(<wsid>)]
where:- The first positional parameter
- The job name to find.
ADID
- A filter field to restrict the search to the application specified. Wildcards are allowed.
DETAIL
- How much detail to return.
APPL
lists only the applications in which the job is found.OPER
also lists the operation attributes, extended information, automation information, special resources, dependencies, conditional dependencies, and user fields.SUCC
lists external successors. DISPLAY
- Whether to generate the output to SYSTSPRT.
FLOW
- The column width at which one line of output flows to another. If not specified, the data will flow appropriate to the length of the output stream.
GROUPDEF
- A filter field to restrict the search to the members of the application group specified. Wildcards are allowed.
GROUP
- A filter field to restrict the search to the authority group specified. Wildcards are allowed.
IGNORE
- A list of elements that define the internal dependencies to be
ignored when listing the dependencies of the job. The default is
=FIRST =LAST
to ignore the internal dependencies to the first and last operations. The default is set byOPTIONS IGNORE
.You can combine the following arguments:=ALL
- Ignore all internal dependencies.
=NONE
- Do not ignore any internal dependencies.
=FIRST
- Ignore the first operation (as defined by
OPTIONS FIRST
). =LAST
- Ignore the last operation (as defined by
OPTIONS LAST
). <wstype>
- Ignore the operations that use a specific workstation type. Valid types are: AUTO, CPU, DUMMY, PRINT, REMOTE-D, REMOTE-Z, SETUP, STC, VIRTUAL, WAIT, WTO, or ZCENTRIC.
<wsname>
- Ignore the operations that use a specific workstation.
<opno>
- Ignore the operations on a specific operation number.
MULTI
- Specifies what to do if the job is found more than once:
ALL
- Reports all places found.
FAIL
- Ends with RC=8, if more than one match is found.
FIRST
- Reports only the first place found.
LAST
- Reports only the last place found.
SAVELIST
andOBJECT
always return all matches. OBJECT
- Sets an object variable in which to store all the attributes.
OPNO
- A filter field to restrict the search to the operation number specified in this keyword.
OUTPUT
- Sets an output destination for display style output, either * to output to the stack, or a DD statement.
OWNER
- A filter field to restrict the search to applications with the specified owner ID. Wildcards are allowed.
SAVELIST
- Saves the record selection criteria for each application containing the job to a specified list.
STATUS
- A filter field to restrict the search to applications with a specific
status:
A
- Active applications.
P
- Pending applications.
*
- All applications (default).
STYLE
- The output style:
TEXT
- Uses descriptive text to identify each record.
LOADER
- Uses batch loader keywords to identify each record.
VALFROM
- A filter field to restrict the search to applications matching the valid from date specified. Wildcards are allowed.
VALID
- A filter field to restrict the search to applications that are valid on the date specified. Wildcards are allowed.
VALTO
- A filter field to restrict the search to applications matching the valid to date specified. Wildcards are allowed.
WSNAME
- A filter field to restrict the search to applications containing the specified workstation. Wildcards are allowed.
For example, LISTJOB JOB040
lists all the
applications in which JOB040 is contained.
Application: ADID(CMDDEMO3) ADVALFROM(141024) DESCR('Demonstrate CMD1 WS')
OWNER(TWS)
Application: ADID(DEEPFROG1) ADVALFROM(141030) DESCR('Demonstrate CMD1 WS')
OWNER(TWS)
Application: ADID(DROPTEST) ADVALFROM(140922) DESCR('Test DROP command')
OWNER(TWS)
Application: ADID(DROPTEST2) ADVALFROM(140924) DESCR('Test DROP command')
OWNER(TWS)
LISTJOB JOB005 ADID(DEEPFROG6) DETAIL(SUCC)
lists all details
of JOB005 as defined in application
DEEPFROG6:Application: ADID(DEEPFROG6) ADVALFROM(141102) DESCR('Demo RUNIF') OWNER(TWS)
Operation: WSID(CPU1) OPNO(005) JOBN(JOB005) DURATION(1) HIGHRC(00000006)
STARTTIME(2100) R1NUM(00000002) R2NUM(00000004) FORM(ABD00123)
TIME(Y) CRITICAL(P)
Predecessor-INT: WSLCCMD1 PREADID(DEEPFROG6) PREWSID(CMD1) PREOPNO(001)
Predecessor-EXT: ZLAST PREADID(DEEPFROG4) PREWSID(NONR) PREOPNO(255)
PRECSEL(R) PREMAND(C)
Resource: RESOURCE(JOHN) USAGE(X)
User field: UFNAME(EQQ-SYSIN-01) UFVALUE('VARSUB SCAN(!)')
User field: UFNAME(EQQ-SYSIN-02) UFVALUE('SHO OPTIONS')
Ext criteria: ADID(DEEPFROG4) WSID(NONR) OPNO(255) TYPE(R) TOWHEN(B)
TOHHH(000) TOMM(01)
Successor-INT: JOB010 SUCADID(DEEPFROG6) SUCWSID(CPU1) SUCOPNO(010)
Successor-INT: JOB020 SUCADID(DEEPFROG6) SUCWSID(CPU1) SUCOPNO(020)
Successor-EXT: WSLCCMD1 SUCADID(DEEPFROG5) SUCWSID(CMD1) SUCOPNO(001)
The output from LISTJOB
is similar to Batch
Loader, though not directly executable as Batch Loader. The fields
shown are the fields that are not set to their default values, and
the values themselves are stripped of trailing spaces.
For the DISPLAY
output, each segment type
is shown as descriptive labels.
OBJECT
output, the Batch Loader command name prefixes each
record, with the exception of dependencies. The OBJECT
structure includes
a record counter contained in the high level object variable and a record for each segment of
output. The following command:VARSUB SCAN(!)
LISTJOB JOB005 DETAIL(SUCC) OBJECT(FREDDO) DISPLAY(N) MULTI(FAIL)
ADID(DEEPFROG6)
DO X = 1 TO !@FREDDO
DISPLAY @V(@FREDDO-!X.)
END
returns the following OBJECT
output:ADSTART ADID(DEEPFROG6) ADVALFROM(141102) DESCR('Demo RUNIF') OWNER(TWS)
ADOP WSID(CPU1) OPNO(005) JOBN(JOB005) DURATION(1) HIGHRC(00000006) STARTTIME(2100)
R1NUM(0000002) R2NUM(0000004) FORM(ABD0123) TIME(Y) CRITICAL(P) TIME(Y) CRITICAL(P)
ADPRE-INT WSLCCMD1 PREADID(DEEPFROG6) PREWSID(CMD1) PREOPNO(001)
ADPRE-EXT ZLAST PREADID(DEEPFR4) PREWSID(NONR) PREOPNO(255) PRECSEL(R) PREMAND(C)
ADSR RESOURCE(JOHN) USAGE(X)
ADUSF UFNAME(EQQ-SYSIN-01) UFVALUE('VARSUB SCAN(!)')
ADUSF UFNAME(EQQ-SYSIN-02) UFVALUE('SHO OPTIONS')
ADXIV ADID(DEEPFROG4) WSID(NONR) OPNO(255) TYPE(R) TOWHEN(B) TOHHH(000) TOMM(01)
ADSUC-INT JOB010 SUCADID(DEEPFROG6) SUCWSID(CPU1) SUCOPNO(010)
ADSUC-INT JOB020 SUCADID(DEEPFROG6) SUCWSID(CPU1) SUCOPNO(020)
ADSUC-EXT WSLCCMD1 SUCADID(DEEPFROG5) SUCWSID(CMD1) SUCOPNO(001)
The exception to Batch Loader format is how dependencies are presented.
The database works only with predecessors, but LISTJOB
shows
also successor relationships for each job. Instead of ADDEP
,
the dependencies are represented by ADPRE
and ADSUC
with -INT
or -EXT
appended
to show whether the dependency is internal or external. The application
name is shown, even for internal dependencies, so that the ADDJOB
function
can use this to resolve relationships. Also in an exception to the
Batch Loader convention the job name is listed as the first word on
any ADPRE
or ADSUC
record.