The IOF Job Summary analyzes a job and displays detailed job information in a simple format. It shows the return codes for each step of the job and lists all the sysout data sets associated with the job. Data sets can be selected for browse, canceled, modified or released from the IOF Job Summary.
The IOF Job Summary is displayed by selecting a job from either the Job List Menu or the Output Group Display. It also will be displayed directly if you request a specific job name and only one job by that name exists in the system. A specific job name can be requested on the JOBNAMES field of the IOF Option Menu, or by specifying I.jobname from the ISPF Primary Option Menu.
|
The IOF Job Summary has three sections, each of which displays several fields of data. Both sections and fields have names that are used in some of the panel commands described below. Field names are generally identical to the field heading or title. In some cases this is not possible. For example, in the data set section, the CLASS field has a field heading of C in order to keep the column on the screen as small as possible.
The job information section at the top of the panel displays basic job information.
|
Additional job information can be displayed by scrolling right. The user name from the job statement, notify userid, account number, and various time stamps are available to the right.
The Step Section has one line for each job step that summarizes exactly what happened during the step.
|
The step section has fields for the return code (RC), program name, step name, procedure step name, procedure, and comments. IOF analyzes the job in detail in order to produce this unique summary of the job. The job in the sample panel above has four steps. The first two steps ran with a zero return code as indicated by the 0 in the RC field. The third step abended with return code B37. The fourth step was NOT EXECUTED, probably because the third step abended.
The data set section has one line for each sysout data set associated with the job.
|
The following fields are initially displayed in the data set section. Additional data set information can be displayed by scrolling right.
The following line commands can be entered for a data set on the IOF Job Summary subject to restrictions that may be imposed by your local installation:
The following line commands can be entered for a data set but will affect all the sysout data sets in the same output group with the data set. The GRP display column indicates which data sets belong to the same group.
Most of the commands above have a specific interface menu that describes the options for that particular command. To invoke the interface menu for a particular command follow the command name with a question mark (?). For example, P? will produce a panel specifically designed to help you print a copy of a data set.
Data set commands can be entered in the data set command area to the left of each data set. The example below shows the SYSPRINT data set being selected for browse with an S in the data set command area.
|
Data set characteristics can be modified by overtyping the desired new value directly on the IOF Job Summary.
To see all the attributes that can be modified for a data set, enter M in the
data set command area and press ENTER.
Line Commands in the Command Area
Line commands can also optionally be entered in the command area at the top of the screen. This is the only way to enter line commands from line mode terminals, from batch TSO, and from IOF clists. It may also be more convenient and faster from a full-screen terminal in certain cases.
The data set menu number, or list of menu numbers if the command is to apply to multiple data sets, is entered first to identify the data set(s). This is followed by the command and any optional parameters. For example, entering 1-3 C causes data sets 1 through 3 to be canceled.
Select is the default command. Therefore, a data set can be browsed by entering it's menu number in the command area. This is often much faster than tabbing down to the bottom of the screen to enter a SELECT command.
Data set characteristics can also be modified from the command area. To modify a data set, follow the command with the name of the field to be modified as a keyword and the new value as the keyword parameter. For example, the command:
1-3 7 9 R CLASS(A) FORMS(WHITE) DEST(LOCAL)
causes data sets 1,2,3,7 and 9 to be released to class A with WHITE forms, and routed to the LOCAL printer. See Chapter 15 for a full list of data set characteristics that can be used in conjunction with data set commands.
The ALLOC line command allocates the sysout data set to a file name (DDNAME) of your choice. The data set remains allocated after the IOF session terminates until an explicit FREE FILE command is executed. The sysout data can be read by any MVS access method. ALLOC requires at least one parm, so it must be issued from the command area. See Chapter 18 for an example of using the ALLOC statement in a clist. ALLOC has keyword parms for DDNAME, LRECL, RECFM and BLKSIZE. The DDNAME parm is required.
Examples
5 ALLOC DDNAME(SYSUT1)
7 ALLOC DDNAME(INPUT) LRECL(132)
The IOF Job Summary primary commands are used to manage the data displayed on the panel. Primary commands must be entered in the command area at the top of the screen.
Browse all the data sets of the job as one contiguous data set.
Syntax
Browse
Exclude steps or data sets from the menu based on a display field meeting a specified condition. EXCLUDE with no parameters reverses all previous exclude commands on the panel.
Syntax
EXCLude [fieldname operator string]
fieldname. The display field name. Field names are normally the same as the field heading. See the Appendix for detailed information on using HELP to determine field names.
operator. Comparison operator. Valid operators are EQ, NE, LT, GT, CT (containing), NC (not containing), BG (beginning), and NB (not beginning).
string. The string to be compared against. The string can be enclosed in single quotes.
Examples
EXCLUDE RC EQ 0 (Remove steps with zero return code)
EXCL STEP NE PLI (Keep steps and sysouts with PLI step name)
EXCL CLASS
Return excluded steps or data sets to the menu based on a display field meeting a specified condition.
Syntax
UNEXcl [fieldname operator string]
fieldname. The display field name. Field names are normally the same as the field heading. See the Appendix for detailed information on using HELP to determine field names.
operator. Comparison operator. Valid operators are EQ, NE, LT, GT, CT (containing), NC (not containing), BG (beginning), and NB (not beginning).
string. The string to be compared against. The string can be enclosed in single quotes.
Update the IOF Job Summary display. If the job being reviewed is currently running or is currently being printed, the fields displayed are updated to indicate the latest status.
Syntax
REFresh
Display system input data sets on the panel. Input data sets are not normally displayed unless the job is on input.
Syntax
INPUT [ ON / OFF ]
ON. Enable input data set display. On is default.
OFF. Disable input data set display.
Define a sysout target data set for SNAP. See Chapter 16 for a complete description of operands on the SS command. If SS is entered with no operands, an interface option panel is displayed to assist in defining the target sysout data set.
Syntax
SS
Define an MVS target snap data set. Any non-vsam data set can be defined as the target data set. See Chapter 16 for a complete description of operands that can be entered on the SD command. If SD is entered with no operands, an interface panel is displayed to assist in defining the target MVS data set.
Syntax
SD
Snap all the sysout data sets of the job to the target output data set.
Syntax
SNAP
Explicitly close a target snap data set. Note that the snap data set will automatically be closed when the Job Summary for the job is terminated.
Syntax
SNAPCLOS
Edit the job. Rebuild the original job in a temporary data set and enter the ISPF editor (ISPF only). SYSIN data sets are merged into their original positions. The temporary data set can be submitted. The editor REPLACE or CREATE commands must be used to save a permanent copy of the rebuilt job.
Syntax
EDit
Note that if the installation has EDIT in the ISPF command table, the syntax will be: ED
Check to determine why all output groups of the job will not print. Note that this command produces output for each output group of the job, and can produce multiple screens of information for large jobs. The PC command is not available under CICS.
Syntax
PChk
Display the internal text data set on the IOF Job Summary.
Syntax
INTTEXT
If a SAVEINDX command has previously been entered under browse for this job, the VIEW command can be used to restart the browse session using the index saved by the SAVEINDX command.
Syntax
VIEW [ * DSNAME(dsname) ]
DSNAME(dsname). The data set name specified in the SAVEINDX command when the index was saved. The VIEW command does not need a DSNAME operand if the index was saved with any of the following names:
userid.jobname.jobid.IOFINDEX
userid.jobname..IOFINDEX
sysiof.jobname.jobid.IOFINDEX
sysiof.jobname.IOFINDEX
owner.jobname.jobid.IOFINDEX
owner.jobname.IOFINDEX
where:
- userid is the prefix of the user entering the VIEW command.
- jobname is the name of the job being viewed.
- jobid is the job number of the job being viewed.
- sysiof is an installation defined prefix, normally SYSIOF.
- owner is the owner of the job.
Examples >
VIEW
V * DSN('SMITHJ.MONTHLY.IOFINDEX')
Return to the Job List Menu and optionally cancel the job or release it for print.
Syntax
RETurn [ Cancel / PRint ]
Cancel. Cancel the job before returning.
PRint. Release the held data sets of the job to the default sysout class and route the job to the default sysout destination. Note that the PR and C commands can be entered in the command area, and the RETURN PF Key can be pressed to print or cancel the current job.
IOF does not display null spun sysout data sets on the Job Summary by default. This command causes null data sets that have already printed or been cancelled to be displayed.
Syntax
SHOWNULL
Explodes text to block letters and writes it to the previously defined target snap data set.
See Chapter 16 for a complete description of the SNAPHDR command.
Adds carriage control and text to the target snap data set.
See Chapter 16 for a complete description of the SNAPTEXT command.
See Chapter 6 for a description of the CUT, PASTE, and ARRANGE commands to customize the panel display format.