MVS SLIP command change for MODE=HOME

Description

When a SLIP command is issued for a PER trap with MODE=HOME specified, but without JOBNAME and ASID specified, the system issues message IEE088D to prompt the operator for a reply (continue or cancel).

The JOBNAME, ASID, and MODE parameters for a SLIP command work together to control the cross memory environment for a PER interrupt. Specifying MODE=HOME indicates that the SLIP trap matches only when the command is running in the home address space. When MODE=HOME is specified, more processing is used to monitor for the correct environment. When MODE=HOME is specified with the JOBNAME or ASID parameter, this monitoring is limited to the specified address spaces.

However, if MODE=HOME is specified without JOBNAME and ASID, the monitoring occurs for every address space on the system, which can impact performance significantly. As a warning, the system issues message IEE088D with either of the following text strings: 
IEE088D SLIP COMMAND SPECIFIES MODE=HOME WITHOUT JOBNAME AND ASID. SPECIFY 'OK' OR 'CANCEL'
IEE088D SLIP ID=xxxx SPECIFIES MODE=HOME WITHOUT JOBNAME AND ASID. SPECIFY 'OK' OR 'CANCEL'
Note: When this capability was introduced in z/OS V2R1 with APAR OA45297 and even after APAR OA45912, you enabled it by specifying the option TRAPS NAME(IeaSlipConfirm) in the DIAGxx parmlib member. However, in z/OS V2R2, this capability is enabled automatically; you no longer need to specify it explicitly. If you do so in z/OS V2R2, the explicit specification is ignored without an error.

Table 1 provides more details about the migration action. Use this information to plan your changes to the system.

Table 1. Information about this migration action
Element or feature: BCP.
When change was introduced: z/OS V2R2.
Applies to migration from: z/OS V2R1 and z/OS V1R13.
Timing: Before the first IPL of z/OS V2R2.
Is the migration action required? Yes, if you use any IEASLPxx parmlib member or program that issues a SLIP command for a PER trap with MODE=HOME specified, but without JOBNAME and ASID specified.
Target system hardware requirements: None.
Target system software requirements: None.
Other system (coexistence or fallback) requirements: None.
Restrictions: None.
System impacts: None.
Related IBM® Health Checker for z/OS® check: None.

Steps to take

For any IEASLPxx parmlib member or program that issues a SLIP command for a PER trap with MODE=HOME specified, but without JOBNAME and ASID specified, verify your use of MODE=HOME to determine whether changes are needed.

Follow these steps:
  • If a SLIP command includes MODE=HOME, ensure that it also includes JOBNAME or ASID, or both. Or, if you require the SLIP trap to be set this way, include the OK parameter to avoid message IEE088D.
  • If you already include the OK parameter on the SLIP command for another purpose, verify that the MODE=HOME parameter is required. Previously, you might have specified the OK parameter to avoid receiving the following message:
    IEE831D SLIP TRAP ID=0001 PER RANGE (00000000_00000000,00000000_01000000)
EXCEEDS 1M OR WRAPS. SPECIFY 'OK' OR 'CANCEL'
    For example, if you have a SLIP trap that is defined as follows, verify that MODE=HOME is required: 
    SLIP SET,IF,RA=(0,1000000),MODE=HOME,OK,END

Reference information

For more information, see the following references:
Parent topic: BCP actions to perform before the first IPL of z/OS V2R2