IOF Server

Introduction

Many MVS sites utilize multiple machines in the complex to distribute function and workload. The JES2 multiple access spool facility and MVS sysplex function are two examples of software that connect several machines into a common environment. Network Job Entry (NJE) is an example of software that links remote machines in a loosely connected environment. The IOF server can be used in MAS, sysplex and NJE environments to display and control jobs and other JES2 resources on alternate machines.

Many IOF functions can be executed directly from any CPU in a MAS or sysplex without using the IOF server. For example, any job on the JES2 output queue can be selected and reviewed by IOF from any CPU in the JES2 multiple access spool complex. However, some IOF functions must be executed on a specific CPU. The IOF server easily and effectively executes such functions at the appropriate location. Some examples are:

• Device displays must be executed on the CPU to which the device(s) are attached.
• Each system has it's own set of initiators; and thus, a unique set of initiator displays.
• Current performance information such as CPU and I/O time used for running tasks must be gathered on the CPU on which the task is running.
• Sysout data written by a running job but not yet written to the spool can be browsed only on the CPU on which the job is running.

When an interactive IOF client session displays a panel that was built by an IOF server, the left part of the top line of the display indicates the system name of the server system. The example panel shown below was produced by an IOF server on system T91F. Note that CPU and I/O time used is displayed for jobs running on that CPU.

-< System T91F >-------------- IOF Job List Menu -------------( 10 )------------ COMMAND ===> SCROLL ===> SCREEN ------------------------------- Running Jobs --------------------------------- -------JOBNAME--JOBID--ACT-STA-SYID------CPU-----I/O---STEP-----PROCSTEP-SWP _ 1 MODEL J05551 T91F 12:23 303.17 STEP17 IN _ 2 QAS311 J06060 T91F 53:03 443.02 QAS311 IN _ 3 TSCDRS J06157 T91F 1:02 1.75 TSCDRS RBTR OUT

Once an IOF server session is initiated, subsequent IOF commands are processed by the server. IOF displays are returned to the client session that initiated the server session. To exit from a server session, enter the END command repeatedly, or enter /X to jump to the IOF exit command. Exiting from the server session returns control to the IOF client session at the point where the remote session was initiated.

AT? can be entered to determine the names and alias names of CPUs that support the server function. The display includes the system id (SYSID) of each CPU. Typically, the numbers 1 through n (where n is the highest system number) are used as aliases for system names.

Syntax

AT cpu-name/alias function

cpu-name/alias. The name or alias of the remote server system.

function. Any IOF command or option that can be entered on the IOF Primary Option Menu.

Examples

     AT?                        Determine remote server names.
     AT 2                       Go to the IOF Option Menu on remote 2.
     AT IPO9 PR                 IOF printer display on IPO9.
     AT 4 M                     IOF Monitor display on remote 4.
     AT 2 %CHKOUT               Invoke the %CHKOUT REXX exec on remote 2.

The AT line command is also supported on the MAS display.

• MVS Parmlib APPC definitions
• VTAM parms
• APPC Transaction Program definitions
• IOF B67SERV option definition and generation

Access to servers is controlled by the ALLOW macro in the B23ALLOW options data set. Level 1 update access to a system (the new SYSTEMS attribute) is required in order to use the AT command. For example:

ALLOW 0,1,SYSTEMS,*,ID=*	permits all users to issue the AT command for all available systems.
ALLOW 0,1,SYSTEMS,(Y2K,TSTLPR),GROUP=PGMRS	permits members of the PGMRS group to issue the AT command for systems Y2K and TSTLPR.
ALLOW 4,4,SYSTEMS,*,UADS=OPERATOR	permits anyone with UADS OPERATOR authority full access to all SYSTEMS functions.

The ALLOW macro grants access to initiate communications with another system. The server IOF session controls commands and functions permitted on that system.

By default the server session will operate under the same userid and password as the client session. The VTAM APPL statement must specify SECACPT=ALREADYV in order for this to happen.

You can optionally start a server with an alternate userid by entering:

       AT LOGON

-------------------- IOF Logon to Server Panel ------------------------------- COMMAND ===> SYSTEM NAME ===> Name of the remote server system USERID ===> Userid on the server PASSWORD ===> Password for the remote logon Enter a userid and password for the remote IOF server. If you clear the userid field, the server logon will use your local userid and password.

SVPRINT

Syntax

menu       %SVPRINT     [CLASS(A)]     [DEST(LOCAL)]     FORMS(STD)]

menu is the menu number of the job, output group or sysout data set to be printed.

CLASS(A) is the target sysout data set class. The default is class A.

DEST(LOCAL) is the target sysout data set destination. The default dest is LOCAL.

FORMS(STD) is target sysout data set forms. The default forms is STD.

In the example below, a Job List Menu is being displayed from the Y2K server. Assume that job GEN (menu number 2) needs to be printed on the client production system and that there is no NJE or shared spool connection between these systems. The SVPRINT command shown on the COMMAND line in red copies the whole GEN job back to the client system to sysout class J.

-( Server Y2K )----------------- IOF Job List Menu -----------( 7 )------------ COMMAND ===> 2 %SVPRINT CLASS(J) SCROLL ===> CURSOR --------------------------------- Output Jobs --------------------------------- -------JOBNAME--JOBID--ACT-STAT-OWNER----DEST/DEVICE--------RECS-HELD-DAY--TIME _ 1 M18NEWOP J02700 ISIJFW TRISYS.IOFT7D0 18K 127 16:33 _ 2 GEN J02675 ISIJFW TRIANGLE 42 126 15:10 _ 3 M53ZAP J02393 SEL ISIJFW TRISYS.IOFT7D0 76 119 16:57 _ 4 M86ISFCV J01749 ISIJFW TRISYS.IOFT7D0 10K 096 16:22 _ 5 M21APPC J08120 ISIJFW TRISYS 137 365 15:03 _ 6 M21LIST J08107 ISIJFW TRISYS 69 365 13:12 _ 7 SLAMARCH J06164 ISIJFW TRISYS 262 132 327 22:06