Deactivating Your Subsystem

To deactivate your subsystem, you can use either:

The IEFSSI macro
The SETSSI DEACTIVATE command.

Use the deactivate request of the IEFSSI macro or the SETSSI DEACTIVATE command to deactivate your subsystem so that your subsystem can suspend operations or stop responding to SSI function requests. The SSI stops routing requests, including broadcast requests, to the subsystem when it receives the deactivation request or command. However, there may be outstanding function requests that have not completed. Since it is not possible to determine when the outstanding requests complete, subsystems must not attempt to delete function routines or other resources that might still be in use after either the deactivate request or SETSSI DEACTIVATE command has been issued.

Note: If a job requires the use of paired subsystem function requests, such as, allocate/unallocate or open/close, the job may not end as expected if the subsystem processing these requests is deactivated when the first request of the pair has been processed but the second has not. The SSI cannot determine if this situation exists. It is both the installation's and the subsystem's responsibility to control the job sequence and subsystem deactivation requests to avoid potential problems.

Outputs: The deactivate request returns a vector table token to its caller in the location identified by the optional OUTTOKEN parameter. The token represents the SSVT that has been deactivated. You can use the token in subsequent activate requests, if the same set of functions is supported when it is reactivated. The vector table token is output only. A deactivate request always applies to the active subsystem vector table.

A deactivate request or command is processed only if the target subsystem is dynamic, even if the active vector table is not managed by the SSI. In this case, the output token contains a zero and the request receives the IEFSSI_WARNING (4) return code.

Note: If the subsystem does not have vector tables managed by the SSI, the subsystem cannot be reactivated dynamically.