The IOF Job List Menu displays a list of jobs. It is invoked from one of its submenus, from the IOF Option Menu, or directly from the IOF command. By default only the jobs that a user submitted are displayed. However, it also can be set to display many other job lists. Options I, R, O, and J, on the IOF Option Menu are used to request lists of specific job types. Also, lists of jobs by destination, group, or other criteria can be displayed.
|
The Job List Menu is organized by sections. Each section displays a different job type so that the most appropriate information for each is shown. Additionally, each section is named and can be used in commands.
The vertical columns of data are called fields. Each field has a field heading (title) and a field name. Where possible, field names are identical to the field heading. For example, JOBNAME and JOBID are field names that match the field heading. Some field headings are abbreviated or expanded from the field name. For example, the CLASS field has a heading of C. Fields and section information is available in the panel's HELP.
Several fields on the Job List Menu are common to all sections. From the left:
The remaining fields on the panel vary according to the section shown. Thus, the most appropriate data for each job type can be displayed. Additional fields can be seen by scrolling right.
Input jobs, if any, are displayed first on the Job List Menu.
------------------------------- Input Jobs ---------------------------------- -------JOBNAME--JOBID---ACT-STA-OWNER----C-POSIT-PRTY-SECLABEL-QUALIFIER----- _ 1 DMSMERG1 J007890 JOB ISIJER A 4 9 |
The Input Job Section in the sample menu shows that:
Running jobs, if any, are displayed next.
|
The sample running jobs menu shows:
Output jobs, if any, are displayed next.
|
The sample menu of output jobs shows that:
The DEST/DEVICE column normally shows a destination. If the job is busy printing, the device name is shown instead.
The DAY and TIME fields are highlighted if the job ran today and are non-blank only if the job has at least one output group. Each output group is time stamped, and the earliest group time stamp is displayed in this field.
There are several additional sections on the Job List Menu that will be displayed when needed. You may occasionally see jobs queued for transmission to another node, or jobs queued to be purged from the system. See the Appendix for directions on accessing HELP for field and section information.
Subject to restrictions that may be imposed by your installation, the following line commands can be executed on the Job List Menu:
|
Line commands are normally entered in the line command area to the left of the job. The example above shows that the first job (MODELGN) has been canceled and the third job (TSCDRS) has been selected for review.
Job characteristics can be modified simply by overtyping on the menu.
|
Modifications can be done in conjunction with any of the commands. In the example above, the third job (MAKLOAD) is being printed to an explicit destination of LOCAL.
Scroll right to see the additional overtypeable job characteristics.
Optionally, line commands can be entered in the command area at the top of the screen. This method may be faster and save key strokes for certain commands. It is the only way to enter line commands from line mode terminals, from batch TSO, and from IOF clists.
|
Line commands in the command area begin with a job menu number or list of menu numbers. This identifies the job(s) for which the command will be executed. The line command in the above example cancels jobs 1 through 3 and job 5.
To select a job, enter its menu number in the command area. For example, entering 5 in the command area would select SALESRUN for review.
Job characteristics also can be modified from the command area. To modify a job, follow the M command with the name of the field to be modified and the new value as a parameter. For example, to change the destination of the MAKSRCE job in the menu above to LOCAL, enter:
3 M DEST(LOCAL)
in the command area.
The following modification operands can be used with the commands:
Operand Function
CLASS(c) Set job input class to c.
PRTY(p) Set job priority to p.
DEST(route) Set job destination to the route code.
XEQ(node) Set the execution node name for an input job.
SYSID(sid1,...,n) Set the system id to a list of system ids.
IND(YES/NO) Add or remove JES2 independent mode to the job.
PERFORM(g) Set the performance group of a running job to g.
(WLM Compat mode)
SRVCLASS(c) Set the service class of an input or running job
to c (WLM Goal mode).
NEWCLASS(c) Set new class for released held output.
QUIESCED(YES/NO) Set WLM goal mode quiesced state.
The Job List Menu provides comprehensive commands to manipulate the list of jobs. Primary commands which apply to the whole job list must be entered in the command area at the top of the screen.
Analyze all jobs in the job list to determine the highest return code or abend code. Save the date and time the job ran, the highest code and its stepname, and the total record count of the job in the COMMENTS field. This command is not available under CICS.
Syntax
RC [Cur] [Nozero] [SA] [SD]
Cur. If specified, then only current jobs (those that ran yesterday or today) will be analyzed.
Nozero. If specified, then all jobs that have zero return code in all steps will be excluded from the display.
SA. Sort the display in ascending date/time sequence.
SD. Sort the display in descending date/time sequence.
Examples
RC
RC C N SA
Exclude jobs from the menu based on a display field meeting a specified condition.
EXCLUDE with no parameters resets all previous exclusions. EXCL ALL excludes
all items from the list.
Syntax
EXCLude fieldname operator string
ALL
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.
ALL. Exclude all jobs.
Examples
EXCLUDE JOBNAME EQ TEST
EXCL JOBID- BG S
EXCL DAYSOLD LT 3 (Requires EXTEND)
EXCL SECTION NE INPUT
EXCL (remove all previous
Return excluded jobs to the menu based on 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.
Sort the list of jobs on one to four display fields within section. Sort with no parameters will display a sort assist panel if the cursor remains in the COMMAND input area. Sort without parms with the cursor pointing to a panel field does an ascending sort on that field. The specified sort criteria is saved in the user’s profile, unless an initial sort was also specified on the Option Menu.
Syntax
SORT field1 [A/D] [field2 A/D field3 A/D field4 A/D]
OFF
field1 Display field on which to sort. See the Appendix for detailed information on using HELP to determine field names, or enter the FIELD command with the cursor pointing to a field to determine the field name.
A. Sort in ascending sequence. This is the default for the first sort field. A or D must be specified for other sort fields.
D. Sort in descending order.
field2, field3, field4. Optional additional sort fields.
OFF. Disable sorting on this panel.
Examples
SORT DATE D TIME D
SORT CPUTIME D (Applies to running jobs only)
SORT JOBNAME A JOBID A
SORT OFF
Determine the official field name of a displayed field on the panel.
Syntax
FIELD
Point the cursor to the field whose field name is to be determined. When running under ISPF, a popup window will be displayed. From TSO or CICS, the field name will be displayed in the short error message area to the right of the top line on the screen.
Find a job in the job list.
Syntax
FIND [ section ] [ fieldname ] string
section. A section name can optionally be specified as the first operand to limit the search to jobs in that section. Section names are documented in HELP for the panel.
fieldname. A field name optionally can be specified next to designate the search field. JOBNAME is the default field name if none is specified. See the Appendix for detailed information on using HELP to determine field names.
string. The string to be found.
Examples
FIND PAYROLL (Find a job with job name of PAYROLL)
FIND JOBID J08862
FIND OUTPUT
Locate the first job with a field equal to or greater than a specified value. The job list should be sorted on the specified field.
Syntax
LOCate [ section ] [ fieldname ] string
section. A section name can optionally be specified as the first operand to limit the search to jobs in that section. Section names are documented in HELP for the panel.
fieldname. A field name can optionally be specified next to designate the locate field. JOBNAME is the default field name if none is specified. See the Appendix for detailed information on using HELP to determine field names.
string. The string to be located.
Examples
LOCATE PA (Locate first job name beginning PA or greater)
LOC CLASS C
Scroll the Job List Menu up or down.
Syntax
Down / Up [ nnn / Max / Section ]
nnn. Number of rows to scroll up or down.
Max. Scroll to the top or bottom of the menu.
Section. Scroll up to the previous section or down to the next section in the menu.
Scroll the menu to the left or right.
Syntax
RIght / LEft [ nnn / Max ]
nnn. Number of characters to scroll right or left.
Max. Scroll to the right or left margin.
Display additional information about each job in the list to the far right of the display. The added information is not resident in the system queue and must be read from disk. Because of this additional overhead, this command may be restricted at your installation.
Information such as job submission time stamp, user name, account number, job execution time stamp, and job age is displayed when extend is on.
Syntax
EXTEND [ ON / OFF ]
ON / OFF. Enable or disable extend. ON is default if neither ON nor OFF is specified.
The current list of jobs is locked and not updated as long as lock is active. This command can be used before the EXTEND command is used to reduce overhead, and is quite useful in clists and REXX execs to allow working with a fixed list of jobs.
Syntax
LOCK
The current list of jobs is unlocked and refreshed.
Syntax
UNLOCK
Cause the list of jobs to be refreshed even if the display is currently locked. This command is normally useful only in IOF clists and REXX execs.
Syntax
REFRESH
Jobs selected after this command has been entered will have no dynamically allocated sysout data sets displayed on the IOF Job Summary. Entering this command before selecting a job with a large number of dynamically allocated (spun) sysout data sets can significantly reduce the delay in producing the IOF Job Summary.
Syntax
NOSPUN
Turns off the NOSPUN option set by the NOSPUN command.
Syntax
SPUN
Jobs selected after this command has been entered will have only the system sysout data sets displayed on the IOF Job Summary.
Syntax
NODATA
Turns off the NODATA option.
Syntax
DATA
Defines 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
Note that when the SS command is entered on the Job List Menu, the target data set remains open until it is explicitly closed with a SNAPCLOS command, another SS or SD command, or until the IOF session is terminated.
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
Note that when the SD command is entered on the Job List Menu, the target data set remains open until it is explicitly closed with a SNAPCLOS command, another SS or SD command, or until the IOF session is terminated.
Explicitly close a target snap data set that was previously opened on the Job List Menu. Note that the snap data set will automatically be closed when the IOF session is terminated.
Syntax
SNAPCLOS
Explodes text to block letters and writes them 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.