The IOF Option Menu provides a simple way to request special IOF functions. Remember that by default IOF displays a list of the jobs you submitted, but you may have reasons to review other jobs, or to use other IOF facilities. The IOF Option Menu displays the first level of IOF options, and allows more specialized option panels to be displayed.
To invoke the IOF Option Menu from your ISPF Primary Option Menu, enter I (or I. depending upon how IOF was installed for your group).
---------------------------ISPF-Primary-Option-Menu------------------------------------
Option ===>
0 Settings Terminal and user parameters *************************
1 View Display source data or listings * Depending upon your *
2 Edit Create or change source data * *
3 Utilities Perform utility functions * site's configuration, *
4 Foreground Interactive language processing * *
5 Batch Submit job for language processing * this area may contain *
6 Command Enter TSO or Workstation commands * *
7 Dialog Test Perform dialog testing * identification *
8 LM Facility Library administrator functions * *
9 IBM Products IBM program development products * information. *
10 SCLM SW Configuration Library Manager *************************
11 Workplace ISPF Object/Action Workplace
M More Additional IBM Products
I IOF Interactive Output Facility
Enter X to Terminate using log/list defaults
|
The IOF Option Menu can be invoked from TSO READY, CICS, or from ISPF Option 6 by entering IOF (or IOF * depending upon how IOF was installed for your group). The IOF Option Menu should not normally be invoked from a line mode terminal, a clist, or REXX exec.
---------------------------------IOF-Option-Menu--------------------------------
COMMAND ===>
Select an option. To get a detailed option menu, follow the option with "?".
blank - Your jobs G - Output Groups M - System Monitor
I - Input jobs H - Held Groups INIT - Initiators
R - Running jobs L - System Log APPC - APPC tasks/output
O - Output jobs PR - Printers MAS - MAS system display
J - All jobs menu D - Device Options CMDS - Global Commands
P - IOF Profile NEW - What's New in IOF QT - Quick Trainer
JOBNAMES ===>
Enter 1 to 8 generic jobnames above
SCOPE ===> ALL, ME or another user's USERID
Enter HELP to see all valid SCOPE values
DEST ===>
Enter 1 to 8 destinations above
SORT ===> INVNULL Enter HELP to see all valid SORT values
|
The IOF Option Menu has a command area at the top followed by a description of the primary options. Parameters can be entered in the four parameter fields at the bottom of the screen.
The blank option, and the I, R, O, J, and H options are all used to request a list of jobs. P is the profile option used for setting profile variables. G, L, PR, D, M, INIT, and Q are options that are used primarily by operators and system support personnel.
The NEW option provides help on what is new in this release of IOF. The MAS option displays the IOF Multiple Access Spool menu. APPC causes running APPC transactions or APPC output to be displayed.
You may not have the authority to use some of the options shown on the IOF Option Menu, and your installation may have chosen to remove those options from your menu to reduce confusion. For this reason, the option menu you see may not be identical to the one shown above. Your menu will have a command area at the top with available options listed, and one or more of the parameter fields at the bottom.
The four parameter fields at the bottom of the panel are used in conjunction with the command area option. The four fields listed on this menu are the parameters that will be needed most often.
--------------------------------------------------------------------------------
JOBNAMES ===> CICSMAIN PROD* ++SAS*
Enter 1 to 8 generic jobnames above
|
One to eight job names can be specified in the JOBNAMES fields. Only jobs or output groups that match one of the names will be displayed. IOF uses the plus character ( + ) to represent a single-character wildcard which can be placed in any position within the job name. The asterisk ( * ), referred to as a wildcard terminator, is used as a multi-character wildcard for characters at the end of a job name. The example above will restrict the display to:
-----------------------------------------------------------------------------------
SCOPE ===> SMITH userid - Another user's jobs ME -Just your jobs
GROUP - Your IOF group ALL -All jobs
groupid - Another IOF group
|
The SCOPE field is used to control the scope of an IOF session. The default scope depends on the values entered in the command and parameter fields. If the command area is blank and no other parameter fields are specified, the default scope is ME which displays only your jobs. Specifying JOBNAMES changes the default scope to ALL and displays all jobs that match the job names entered.
Another user's USERID can be specified in SCOPE, as shown in the example above. If you are authorized, a menu of that user's jobs will be displayed. Depending upon the IOF options selected by your installation, you may be able to specify an IOF group name in the SCOPE field, or the word GROUP, to display all jobs in your group.
--------------------------------------------------------------------------------------
DEST ===> NAPLES R77
Enter 1 to 8 destinations above
|
The DEST field limits the display of jobs, groups, or devices to those associated with one of the specified destinations. Destination names, node numbers and remote numbers can be specified. The example above requests the destinations NAPLES and remote 77.
-----------------------------------------------------------------------------
SORT ===> INVNULL For jobs: NULL, DEST, SIZE, JOB#, INVNULL
groups: SIZE, FORMS, WTRID, UCS, FCB, FLASH
|
The SORT field can be used to alter the order in which the jobs or groups will be displayed on the menu. Valid sort fields for jobs are:
blank - default sort of jobid within jobnameValid sort fields for output groups are:
blank - Queue order (CLASS, then DEST, then position in queue)Additional options and parameter fields can be specified on specialized option menus that are available for each command area option. A specialized menu can be requested by following any option with a question mark ( ? ). For example, to display the System Monitor Option Menu, enter M? in the command area.
The specialized option menus are self explanatory, easy to use, and have help available.
The SAVEPROF command saves a copy of option menu selection fields in your profile data set. Any time that option menu is displayed, it's fields are initialized to the saved value. For example, if you normally need to review only jobs with job names beginning PROD or BKUP, then set PROD* BKUP* in the JOBNAMES field, and enter SAVEPROF in the command area of the IOF Option Menu.
The SAVEPROF command is available on all IOF option menus. The JOBNAMES, SCOPE and DEST fields are saved in common profile variables for all option menus (except the Device Option Menu), so that specifying values for these fields on any option menu causes the value to be set in any other option menu you may display.
All other fields are unique to each option menu and only apply if that option menu is displayed. For example, specifying a CLASSES field value on the Input Jobs Selection Menu only has meaning when you display that menu. If you display input jobs without going through that menu, the classes specification is ignored.
The IOF Jump Function ( / ) can be used in conjunction with IOF Option Menu options from any IOF panel. For example, /L from any panel skips directly to the bottom of the system log. Anything that can be entered in the IOF Option Menu command area can be entered following the jump character on any IOF panel.
All option menu parm fields are reset to their profile value by the jump function.
Many of the options that can be entered in the command area also have positional parameters. There are two types of positional parameters. The first type parameter is entered immediately adjacent to the command, while the second type parameter is entered after an intervening space.
For example, the I option allows one or more input classes immediately adjacent to the command. It also allows H for held jobs, or NH for non-held jobs as the second type parameter. Entering Iabt H as an option means input the held jobs on classes A, B, and T.
The table below describes the positional parameters accepted by specific options:
| Option | Type 1 Parameter | Type 2 Parameter |
| I | input classes | "H" for held, "NH" for non-held |
| J | none | jobname |
| R | none | "J" for jobs, "T", "S", or "ALL" |
| H | held classes | jobname |
| O | none | none |
| G | output classes | forms |
| PR | printer number | none |
| D | none | device name or device type |
| M | none | monitor parms |
| INIT | initiator range | initiator range |
| L | none | sysid, old, oper, syslog |
| Q | none | none |
| P | none | none |
The examples below illustrate the use of positional parameters with various options. These examples can be entered directly from any IOF panel because they are preceded by the jump character ( / ).
| Option Parm | Description |
| /J arbit* | All job names beginning with "ARBIT" |
| /I H | Held input jobs |
| /Iab | Input jobs of class A or B |
| /Icd NH | Non-held input jobs of class C or D |
| /G white | Output groups with forms of WHITE |
| /Gab | Output groups with class A or B |
| /H smf | Jobs with held output with job names beginning with "SMF" |
| /L ipo9 | Browse system log for sysid IPO9 |
| /PR3 | Device control panel for local printer 3 |
| /D lne | Device list of all JES2 lines |
| /D R23 | Device list for remote 23 |
| /INIT 5-7 | Initiator display for initiators 5-7 |
| /M ojob | Monitor display for jobs only |
Several additional options that are not documented on the panel can be entered on the IOF Option Menu or following a slash ( / ) on any menu:
| Parm | Description |
| CUR | Select the current TSO session. |
| JOBnnnn | Select job number nnnn. |
| TSUnnnn | Select TSO session with number nnnn. |
| STCnnnn | Select STC number nnnn. |
| DA | Alias for the "M" option. |
| ST | Alias for the "J" option. |
| REMOTEn | Display remote n devices. |
| Display a menu of queued mail. | |
The PREFIX command can be used from any IOF panel to initialize the JOBNAMES field of the IOF Option Menu. One to eight generic job names can be specified as parameters. PREFIX with no parameters resets JOBNAMES to null.
The SUFFIX command also can be used from any IOF panel to initialize the JOBNAMES field of the IOF Option Menu to cause selection of jobs based on a job name suffix. The command SUFFIX X will cause selection of all job names that end in X. The command SUFFIX 9* will cause selection of all job names that contain a 9 in any position.
The OWNER command can be used from any IOF panel to initialize the SCOPE field of the IOF Option Menu to a specific userid or IOF group name. This has the same effect as setting SCOPE on the IOF Option Menu and then entering the SAVEPROF command.
The DEST command can be used from any IOF panel to initialize the DEST field of the IOF Option Menu to one to eight destinations. This has the same effect as setting one or more destinations on the IOF Option Menu and then entering the SAVEPROF command.
Remember that PREFIX, SUFFIX, OWNER and DEST operands are saved in the profile. These profile variables will affect all future IOF sessions until you change them with another PREFIX, SUFFIX, OWNER, or DEST command.
The PSAVE command must be issued on the IOF Option Menu. It saves the values of PREFIX, OWNER and DEST in the user's profile. A one character parm is required on the PSAVE command. Letters A-Z and numerals 0-9 may be used as the parm. This provides 36 separate slots for saving PREFIX, OWNER and DEST values.
The PRESTORE command can be issued on any IOF panel to restore the values of PREFIX, OWNER and DEST from the profile. The one character value specified on PSAVE is used as a parm. PRESTORE with no parms resets PREFIX, OWNER and DEST to null values.
The PLIST command displays the all the variables saved with PSAVE.