Filter
Top Products
560 Chapter 7
Command Definitions S-SO
SETJCW
The result of a mathematical operation must be in the range of 0 to 65,535, inclusive; if the
number is out of range, an error message is generated, and the value of the JCW remains
unchanged. When the result of an operation is greater than the value of the next "step",
the JCW value displayed by the SHOWJCW command will be the mnemonic of the higher
step plus any offset. For example, the value OK16385 is displayed as WARN1.
User-Defined JCWs
User-defined JCWs are created and initialized to a value by the SETJCW command or
PUTJCW intrinsic. The JCW name contains alphanumeric characters and must begin with
an alphabetic character. The name can be up to 255 characters long. The value assigned to
the JCW must be in the range of 0 to 65,535, inclusive.
The SETJCW command scans the MPE/iX variable table for the name of the specified JCW
(jcwname). If the specified name is found, the JCW is set to value. If the jcwname is not
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.