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:
- Enter the $P JES2,ABEND command
JES2 responds with:
$HASP697 COMMAND PURGED--RECONFIGURATION DIALOG IN PROGRESS
- 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.