z/OS JES2 Initialization and Tuning Guide
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Dialog options: CANCEL and TERM

z/OS JES2 Initialization and Tuning Guide
SA32-0991-00

Several WTOR messages throughout the dialog give an option of ‘CANCEL’ or ‘TERM’. The two options, CANCEL and TERM are quite different in their meaning, and the two are never presented as options at the same time.
  • TERM, an option within I/O error checkpoint dialogs

    If selected, TERM indicates to JES2 to terminate (that is, force abnormal termination) of all members that experienced an I/O error on the CKPTn being processed by this checkpoint reconfiguration as indicated by $HASP233. The remaining members continue processing, but terminated members require a restart.

    $HASP233 provides which checkpoint (CKPT1 or CKPT2) experienced the I/O error; it also provides the number of members affected. See Determining the reason for a checkpoint reconfiguration for a discussion of the precedence of reconfiguration types if multiple checkpoint problems occur. $HASP275 provides an individual message for each affected member; it also provides a $Knn reason code specific to the member that issued the message. If you reply TERM in response to $HASP272, this reason code becomes the $Knn error code reflected in the $HASP095 message when the member abnormally terminates. To verify which members received the $HASP275 message and determine the members that will be affected (terminated) by a reply of TERM, issue D R,L,CN=(ALL),MSG=$HASP275 (This MVS™ command assumes that CONDEF CONCHAR=$ on all MAS members.)

    If you need to terminate a single JES2 member while within a reconfiguration, you need to complete the following 2-step process:
    1. Enter the $P JES2,ABEND command
      JES2 responds with:
      $HASP697 COMMAND PURGED--RECONFIGURATION DIALOG IN PROGRESS
    2. Enter the $P JES2,ABEND,FORCE command.

    TERM is more serious and always causes all member(s) experiencing the I/O on CKPTn to abend. IBM® does not recommend its use because the remaining member(s) might subsequently reenter a checkpoint reconfiguration because of the same error situation. If the error situation is temporary, you should forward the checkpoint (options ‘1’ or ‘2’) or suspend using the checkpoint (options ‘5’ or ‘6’) and immediately reenter a new reconfiguration dialog to resume (options ‘7’ or ‘8’) using the suspended checkpoint.

  • TERM, an option within JES2-initiated dialogs for initialization

    A response of TERM to the $HASP289 and $HASP272 message pair while within a JES-initiated dialog for initialization affects (terminates) the initializing member only. (A JES2-initiated initialization dialog has a scope of the single member, it never affects other MAS members.)

  • CANCEL, an option for other reconfiguration dialog types.

    CANCEL provides the operator a means to easily end the dialog and allow processing to continue as before. If you replied CKPTDEF to change CKPTn or NEWCKPTn and then CANCEL a reconfiguration, those changes are lost.

Attention: Although TERM and CANCEL are never presented simultaneously as options on the same message, if you inadvertently specify either TERM or CANCEL when that option is not presented, JES2 will treat that response as a synonym for the presented option. For example, if $HASP273 offers an option of TERM and you reply CANCEL in response to $HASP272, JES2 terminates all JES2 members that experienced an I/O error; JES2 does not end the dialog directly.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014