MPE/iX Commands Reference Manual (32650-90877)

480 Chapter12
Command List X
Commands SAVE thru SHUTQ
found, it is created and set to value. The term "value," as used here, means the explicitly
stated or the computed value.
You may not begin a JCW name with the mnemonic names OK, WARN,
FATAL, or SYSTEM, unless you append a number to the mnemonic such that the computed
value exceeds 65,535 (for example, WARN999999, or SYSTEM200000). If the computed value
exceeds 65,535, MPE/iX does not recognize the term as a valid mnemonic, and treats it as
the name of a JCW. This restriction is intended to eliminate the possibility of an
ambiguous JCW assignment. For example, it is unclear from the following two commands
whether the JCW X is equal to 100 or to 0:
SETJCW OK=100
SETJCW X=OK
Naming a JCW with a mnemonic or predefined JCW value results in an error message, as
in the following example:
SETJCW OK200=1982
JCWNAME CANNOT BE A VALID JCW VALUE (CIERR 1725)
Negative or out-of-range JCW values cause the following error message to be displayed:
VALUE NOT IN RANGELEGAL RANGE IS 0 TO 65535 (CIERR 1712)
System-Defined JCWs
JCW and CIERROR are MPE/iX system-defined JCWs created for each job and session. The
JCW named JCW is always initialized to zero at the beginning of the job or session and
remains zero, unless fatal errors occur, or unless the user changes the value. There are two
special values for the system-defined JCW:
%140000 (System 0) Program aborted per user request.
>%140000 Program terminated in an error state.
The CIERROR JCW tracks command interpreter (CI) errors.
CIERROR is set to zero at the beginning of the job or session. If a command interpreter error
occurs, CIERROR is updated to reflect the current CI error message number.
Users are advised not to alter the values of the CIERROR and JCW job control words.
User-defined JCWs should be used for information the user wishes to control.
The following example shows the use of the CIERROR JCW:
LISTF
^
UNKNOWN COMMAND NAME. (CIERR 975)
SHOWJCW CIERROR
CIERROR = 975
RUN
^
NO PROGRAM FILE SPECIFIED. (CIERR 600)
SHOWJCW CIERROR
CIERROR = 600
:
System-Reserved JCWs