z/OS Communications Server: SNA Programming
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Specifying authorized path macroinstructions

z/OS Communications Server: SNA Programming
SC27-3674-00

The VTAM® authorized path macroinstructions can be executed asynchronously (OPTCD=ASY) or synchronously (OPTCD=SYN) under control of a service request block (SRB), or a task control block (TCB). Table 1 shows the coding requirements for VTAM authorized path, including the VTAM authorized path macroinstructions and the supervisor macroinstructions needed to execute the authorized path through VTAM. Consult the z/OS MVS Programming: Authorized Assembler Services Guide for information on coding the supervisor macroinstructions described in Table 1.

To use authorized path while running under a TCB, the authorized program, having put itself into supervisor state, specifies BRANCH=YES on any RPL-based macroinstruction that is to be executed using authorized path.

Subsequently, to issue any macroinstruction that is not to use authorized path and that uses the same RPL, the RPLBRANC flag in the RPL must be turned off by one of the following:
  • Coding BRANCH=NO on a MODCB macroinstruction
  • Referring to the field by using the IBM-supplied DSECT and turning it off with an assembler language instruction
  • Coding BRANCH=NO on the subsequent macroinstruction that is not to use authorized path.

Authorized path is always used when an RPL-based macroinstruction is issued under the control of an SRB. A task identification and address space identification should be specified in the SRB as discussed in Task association; otherwise (RTNCD,FDB2)=(X'14',X'55') could result. One way to gain control under an SRB is for the authorized program, while running under a TCB, to specify an RPL exit routine when issuing (in supervisor state) an RPL-based macroinstruction that specifies BRANCH=YES. On entry to the RPL exit routine, the program is running under an SRB. Any RPL-based macroinstruction issued under an SRB is automatically executed using authorized path; BRANCH=YES need not be specified. An alternative way to create the SRB environment is to use the MVS™ SCHEDULE macroinstruction.

Table 1. Coding requirements for authorized path
Method of program execution (OPTCD=ASY or SYN operand specified on VTAM RPL and RPL-based macroinstructions)
Method of dispatching Synchronous Asynchronous
TCB
  1. MODESET MODE=SUP
  2. BRANCH=YES operand on authorized path VTAM macroinstruction
  1. MODESET MODE=SUP
  2. BRANCH=YES operand on authorized path VTAM macroinstruction
  3. EXIT or ECB operand on VTAM RPL or other VTAM RPL-based macro instruction
SRB
  1. MODESET EXTKEY=ZERO
  2. SCHEDULE with operands
  3. SETFRR with operands
  1. MODESET EXTKEY=ZERO
  2. SCHEDULE with operands
  3. SETFRR with operands
  4. EXIT or ECB operand on VTAM RPL or other VTAM RPL-based macroinstruction

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014