- JRF |Define Job Report File

JRF [ file | *LIB(lib,element[(vers)],typ ] [,E] [ , SYSOUT | SYSLST | JRFILE]

The JRF command will cause the selected file to be displayed in the Job Report mask after termination of each of the following jobs. The parameters for this command can also be entered using the same format in the E command.

The operands in the JRF command, the JRF parameters in the E command, or the parameters in a /REMARK command of the procedure to be started all have the same effect:

file The specified file should be displayed after all Enter jobs started hereafter with the E command have terminated. This could be useful, for example, if all the Enter jobs log their output to the same file, opened in EXTEND mode.

The construction of the file name can utilise the following variables:

&TSN TSN of the CFS task which started the Enter job.

&DATE Start date of the Enter job in yymmdd format.

&TIME Start time of the Enter job in hhmmss format.

&LOGNAM Job name of the CFS task which started the Enter job.

*LIB(lib,element[(vers)] ,typ

The specified library element will be displayed (from OSD V1).

E The SYSOUT / SYSLST file is opened in Extend mode.

SYSOUT | SYSLST

The first SYSOUT or SYSLST file assigned with a /SYSFILE SYSOUT, /ASSIGN SYSOUT, /SYSFILE SYSLST, or /ASSIGN SYSLST command in the procedure file will be displayed in the Job Report mask. The SYSFILE or ASSIGN command must appear in the first 20 records following the LOGON command.

For a DO procedure started in Enter mode that does not contain any SYSFILE command, CFS will generate a SYSFILE command in the Enter file with the following form:

/SYSFILE SYSOUT=CFS.SYSOUT.tsn.time     or

/SYSFILE SYSLST=CFS.SYSLST.tsn.time.

When starting a DO procedure in Enter mode, and if JRF=SYSLST was specified, then an /OPTION MSG=FH command will be inserted in addition to the /SYSFILE SYSLST command. This will ensure that the SYSOUT statements will also appear in the SYSLST file.

JRFILE The file specified in the first /REMARK JRF=file command in the procedure will be displayed in the Job Report mask.

Standard for JRF: SYSOUT.

Examples:

E CFS.DO.TEST,PAR1=XY/TIME=10,JRF=CFS.FILE.XYZ

E CFS.DO.TEST/JRF=SYSLST

Notes:

The JRF command parameters can also be specified in a REMARK command in the DO or Enter procedure file.

Example: /REMARK JRF=CFS.FILE.XYZ , JRFILE.

The REMARK command must occur within the first 20 records of the Enter or Proc file. If a REMARK JRF command appears in a DO or Enter procedure, then the JRF option will only be valid for that Enter job.

The different sources for specifying the JR file will be evaluated according to the following priorities (1 being the highest priority):

1) Explicit specification of the JR file in the parameter mask.

2) Explicit specification of the JR file in the E command.

3) JR file from a /REMARK command or SYSFILE SYSOUT/SYSLST command in the procedure file.

4) File from the Job Report command JRF or the JRP mask.

5) The standard name CFS.SYSOUT.tsn.time or CFS.SYSLST.tsn.time, as generated in the SYSFILE command by JRS.

The name of the file to be displayed in the Job Report mask will be displayed in the parameter mask (see page 11-), and can be amended from there.