Restarting the SMSPDSE1 address space

You can use operator commands to restart or activate the SMSPDSE1 address space. This type of operator intervention occurs only in extreme failure situations; for example, when PDSEs are hung because a canceled task is holding a latch.

For more information on using the VARY SMS commands for the SMSPDSE and SMSPDSE1 address spaces, see z/OS MVS System Commands. Before you decide whether to restart the SMSPDSE1 address space, review the Considerations for restarting the SMSPDSE1 address space.

Perform the following steps to restart the SMSPDSE1 address space:

  1. Issue the VARY SMS,PDSE1,ANALYSIS operator command to determine which PDSE is causing the hang and which latch is being used. This command detects common problems that cause PDSE breakage.

    VARY SMS,PDSE1,ANALYSIS

    This example analyzes the all of the PDSEs in the SMSPDSE1 address space.

  2. Cancel the related task to attempt to free the latch that is used.
  3. If the system is still hung, issue the VARY SMS,PDSE1,FREELATCH command to force the release of the latch.

    VARY SMS,PDSE1,FREELATCH(latchaddr,ASID,tcbaddr)

    This example frees the latch at the specified latch address.

  4. Ensure that PDSE_RESTARTABLE_AS(YES) and PDSESHARING(EXTENDED) are specified in the IGDSMSxx parmlib member.
  5. If the system is still hung, restart the SMSPDSE1 address space. This command is valid if the system was IPLed with the restartable SMSPDSE1 address space.

    VARY SMS,PDSE1,RESTART

    The system terminates and restarts the SMSPDSE1 address space, and reconnects previously connected PDSEs.

    VARY SMS,PDSE1,RESTART,QUIESCE(5),COMMONPOOLS(REUSE)

    In this example, the system waits five seconds to quiesce current operations before shutting down the current SMSPDSE1 address space. During this quiesce interval, new requests are held until the SMSPDSE1 address space is restarted. The restarted SMSPDSE1 address space reuses the storage cell pools in the extended common storage area (ECSA).

    The output is:
    IGW0701 SMSPDSE1 WILL RESUME ALL USER TASKS.