z/OS MVS Using the Subsystem Interface
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Environment

z/OS MVS Using the Subsystem Interface
SA38-0679-00

Review Function Routines/Function Codes, which describes both the general environment on entry to your function routine and other programming considerations that your function routine should take into account.

If you decide to set up your subsystem to handle Early Notification of End-of-Task calls, make sure that your function routine is in place before you enable the subsystem for SSI function code 50. IBM® recommends that you use the IEFSSVT macro to notify MVS™ that your subsystem should be given control whenever Early Notification of End-of-Task calls are made. IEFSSVT macro services are available only to dynamic subsystems. Subsystems that are not dynamic can still use the IEFJSVEC service; see Building the SSVT and Enabling Your Subsystem for New Functions for more information.

The subsystem function routine runs in the address space of the ending task. Because each subsystem function routine is called for every ending task, the subsystem function routine should not be a long running program. That is, the function routine should quickly determine if the subsystem was ever associated with the ending task and, if not, return to the system. Also, do not code a function routine that enters an explicit WAIT or uses a system service that enters a WAIT. Entering a WAIT can cause degraded system performance.

Data areas commonly referenced are mapped by the following mapping macros. IBM recommends you include them in your function routine:
  • IEFSSOBH
  • IEFJSSIB
  • IEFSSET

The function routine receives control in the following environment:

Environment variable Value
Minimum authorization Supervisor state with PSW key 0
Dispatchable unit mode Task
AMODE 24-bit or 31-bit
Cross memory mode PASN=HASN=SASN
ASC mode Primary
Interrupt status Enabled for I/O and external interrupts
Locks No locks held
Control parameters

The SSIB, SSOB, and SSET control blocks reside in storage below 16 megabytes.

Recovery The function routine should provide an ESTAE-type recovery environment. See z/OS MVS Programming: Authorized Assembler Services Guide for more information on an ESTAE-type recovery environment.

Figure 1 shows the environment on entry to the function routine for SSI function code 50.

Figure 1. Environment on Entry to the Function Routine for SSI Function Code 50Environment on Entry to the Function Routine for SSI Function Code 50

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014