JES2 collects job output together in units called output groups. An output group is the smallest unit of work that can be selected by a printer. All sysout data in an output group has common sysout characteristics like forms, class, and destination. A job may have many groups if it has data sets with many different types of sysout characteristics.
Groups made up of held data sets are considered to be held groups. But individual data sets that are members of a held group can be controlled and modified independently until the group is released.
The G option on the IOF Option Menu is used to produce theOutput Group Display. By default, all groups in the system are displayed to authorized users when the G option is selected. The JOBNAMES, SCOPE, and DEST fields on the option menu can be used to limit the groups displayed to specific job names, owners, or destinations.
You can go directly to the Output Group Display from any IOF screen by entering /G. And, you can request several group selection options directly after the G option. The Output Group Display options listed below can be entered from any IOF panel because they are all preceded by the slash (/).
Option Effect /Gab Only groups of class A or B /G white Only groups with output forms of WHITE /G@ Only groups to be sent to another node
Additional selection criteria for groups can be specified by entering G? to cause the Output Group Selection Menu to be displayed.
|
In addition to the JOBNAMES, SCOPE, and DEST fields, this selection menu has several additional selection criteria for output groups. FORMS, CLASS, and WTRID are particularly useful selection criteria for output groups.
The selection panel is self-explanatory. The options at the top work together with the fields at the bottom just as on other IOF option menus.
The U option selects groups that have an extended destination specification that includes a userid. The A option selects groups that are output from APPC transactions. Once you have selected the desired options, you will be presented with the IOF Output Group Display.
|
Subject to restrictions that may be imposed by your installation, the following line commands can be executed on the Output Group Display:
Overtyping Group Characteristics
Output group characteristics can be modified by overtyping the appropriate field on the screen.
Output group commands can optionally be entered in the command area at the top of the screen. This method may be faster and save key strokes on full-screen terminals. It is the only way to enter group commands from line mode terminals, from batch TSO, and from IOF clists.
Group commands in the command area begin with a group menu number or list of menu numbers. This identifies the group(s) for which the command will be executed. The menu number(s) are followed by the command and then any optional parameters. For example, to cancel the third and fifth through twelfth groups, enter:
3 5-12 C
Output group characteristics can also be modified from the command area. To modify a group, simply follow the command with the name of the field to be modified and the new value as a parameter. For example, to change the FORMS of the third group on the menu to INVOICE, enter in the command area:
3 M FORMS(INVOICE)
See Chapter 15 for a complete description of the attributes that can be modified for output groups.
The Output Group Display provides comprehensive commands to manipulate the list of groups and individual groups in the list. Primary commands, which apply to the whole list, must be entered in the command area at the top of the screen.
Exclude groups from the menu based on some display field meeting a specified condition. Exclude with no parameters removes all previous exclude commands.
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.
Examples
EXCLUDE JOBNAME BG SYS EXCL WTRID EQ (Excludes groups with no writer id) EXCL CLASS LT G EXCL (resets all Excludes)
Return excluded groups 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 groups based on a displayed field. Sort with no parameters and the cursor in the COMMAND input area causes a sort assist panel to be displayed. Sort with no parms and the cursor pointing to a panel field does an ascending sort on that field. The sort values are saved in the user’s profile unless an initial sort was 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 DEST SORT CLASS A FORMS A RECORDS D SORT (cursor point to jobname) SORT (cursor in COMMAND area 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 specific group in the group display.
Syntax
FIND [ section ] [ fieldname ] string
section. A section name can optionally be specified as the first operand to limit the search to groups in that section. Section names are documented in HELP for the panel.
fieldname. A field name can optionally be specified 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 group with job name of PAYROLL) FIND JOBID J08862 FIND DEST BOSTON
Locate the first group with a field equal to or greater than a specified value. The group list should be sorted based 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 groups 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 M13 (Locate group with job name EQ or GT 'M13') LOC CLASS C
Scroll the Output Group Display up or down.
Syntax
Down / Up [ nnn / Max / Section ]
nnn. Number of rows to scroll up or down.
MaxScroll 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 columns to scroll right or left.
Max. Scroll to the right or left margin.
Display additional information about each group in the list to the far right of the display. The added information is not resident in the system's main memory 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 groups is locked and not updated as long as lock is active. This command can be used before the EXTEND command to reduce overhead, and is quite useful in clists to allow working with a fixed list of groups.
Syntax
LOCK
The current list of groups is unlocked and refreshed.
Syntax
UNLOCK
Cause the list of groups to be refreshed even if the display is currently locked. This command is normally useful only in IOF clists.
Syntax
REFresh
Define a sysout target data set for SNAP.
Syntax
SS
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.
Note that when the SS command is entered on the Output Group Display, 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.
Syntax
SD
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.
Note that when the SD command is entered on the Output Group Display, 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 Output Group Display. Note that the snap data set will be closed automatically when the IOF session is terminated.
Syntax
SNAPCLOS
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.