Forcible and quiesced mass termination of ARSRASCR created address spaces (z/OS)

On z/OS®, you can control the termination of the submitted job address space.

The ARSRASC9 program is used to control the termination of the submitted job address space. When the ARSRASC9 program is invoked to process a FORCETERM or QUIESCE request, the following messages are produced:

  ARS04502I ODF STARTED ADDRESS SPACE TERMINATION REQUESTED,
            MODE=termination_mode

  ARS04503A REPLY 'Y' TO CONFIRM mode ADDRESS SPACE
            TERMINATION.

where

termination_mode: FORCETERM or QUIESCE, corresponding to the type of termination processing that is requested.
mode: FORCETERM or QUIESCE, corresponding to the type of termination processing that is requested.

If the response to message ARS04503A is anything other than the single character Y, the mass termination request is not performed and the following message is produced:

ARS04504I mode ADDRESS SPACE TERMINATION ABANDONED

Otherwise, this message is produced:

ARS04504I mode ADDRESS SPACE TERMINATION PROCEEDING

Now, all target address spaces (that is, address spaces that were created by ARSRASCR) are signaled to voluntarily (and promptly) terminate.

For a QUIESCE operation, all target address spaces are allowed to continue processing their current unit of work. After this work is completed, the address space should terminate. Any request for a new unit of work that originates from any target address space is rejected.

For a FORCETERM operation, all target address spaces have one minute to end. If all of the target address spaces have ended before one minute has elapsed, then no other action is taken.

Otherwise, the remaining target address spaces are forcibly ended using ABEND (each address space will be ABENDed with a U0013 ABEND, Reason Code x'0B0F'). The following message is also produced:

ARS04505I AT LEAST ONE ADDRESS SPACE HAS BEEN ABENDED

The following are a few sample scenarios of forcible and quiesced mass termination of ARSRASCR created address spaces:

Initiating a forcible mass termination request and then rejecting it

  ARS04502I ODF STARTED ADDRESS SPACE TERMINATION REQUESTED,
            MODE=FORCETERM
  *113 ARS04503A REPLY 'Y' TO CONFIRM FORCIBLE ADDRESS SPACE
                 TERMINATION.
  R 113,X
  ARS04504I FORCIBLE ADDRESS SPACE TERMINATION ABANDONED
  ARS04507I ARSRASC9 PROCESSING ENDED, RC=00000000,
            FCN=FORCETERM

Initiating a forcible mass termination request and allowing it to proceed. All address spaces terminate within one minute

  ARS04502I ODF STARTED ADDRESS SPACE TERMINATION REQUESTED,
            MODE=FORCETERM
  *109 ARS04503A REPLY 'Y' TO CONFIRM FORCIBLE ADDRESS SPACE
                 TERMINATION.
  R 109,Y
  ARS04504I FORCIBLE ADDRESS SPACE TERMINATION PROCEEDING
  ARS04507I ARSRASC9 PROCESSING ENDED, RC=00000000,
            FCN=FORCETERM

Initiating a forcible mass termination request and allowing it to proceed. Not all address spaces terminate within one minute

  ARS04502I ODF STARTED ADDRESS SPACE TERMINATION REQUESTED,
            MODE=FORCETERM
  *112 ARS04503A REPLY 'Y' TO CONFIRM FORCIBLE ADDRESS SPACE
                 TERMINATION.
  R 112,Y
  ARS04504I FORCIBLE ADDRESS SPACE TERMINATION PROCEEDING
  ARS04505I AT LEAST ONE ADDRESS SPACE HAS BEEN ABENDED
  ARS04507I ARSRASC9 PROCESSING ENDED, RC=00000000,
            FCN=FORCETERM

You also see messages similar to the following for each address space that is ABENDed:

  IEA995I SYMPTOM DUMP OUTPUT
     USER COMPLETION CODE=0013 REASON CODE=00000B0F

Initiating a Mass Quiesce request and allowing it to proceed

  ARS04502I ODF STARTED ADDRESS SPACE TERMINATION REQUESTED,
            MODE=QUIESCE
  *110 ARS04503A REPLY 'Y' TO CONFIRM QUIESCED ADDRESS SPACE
                 TERMINATION.
  R 110,Y
  ARS04504I QUIESCED ADDRESS SPACE TERMINATION PROCEEDING
  ARS04507I ARSRASC9 PROCESSING ENDED, RC=00000000,
            FCN=QUIESCE

When ARSRASC9 is invoked with the PURGE or RESET PARM text, it does not ask for confirmation. It simply goes ahead with the request. The only message that you should expect to see is ARS04507I as in the following example:

ARS04507I ARSRASC9 PROCESSING ENDED, RC=00000000, FCN=RESET