5.2.8 Judgment job definition

This paragraph explains how to specify a judgment job definition.

The following gives the format of, and the parameters for a judgment job definition.

Format

[ej={gt|ge|lt|le|eq|ne|ri|ro|ef|nf|vgt|vge|vlt|vle|veq|vne|vri|vro|sce|spe|sne|spn|snn|snl};]
[ejc=judgment-return-code;]
[ejl=lower-limit-of-judgment-return-codes;]
[ejh=upper-limit-of-judgment-return-codes;]
[ejf="end-judgment-file-name";]
[ejv=variable-name;]
[ejt="judgment-value-for-variable (string)";]
[eji=judgment-value-for-variable (numeric);]
[ejs=lower-limit-judgment-value-for-variable_(numeric);]
[ejg=upper-limit-judgment-value-for-variable_(numeric);]
[ejm={gt|ge};]
[eju={lt|le};]
[ha={y|n};]

Parameters

ej={gt|ge|lt|le|eq|ne|ri|ro|ef|nf|vgt|vge|vlt|vle|veq|vne|vri|vro|sce|spe|sne|spn|snn|snl};

Define judgment conditions for comparing the return code of the preceding job with the reference value. You can specify only one judgment condition. The default is gt.

gt: The return code of the preceding job is greater than the reference value. You cannot specify this option together with ejf="end-judgment-file-name";.
ge: The return code of the preceding job is equal to or greater than the reference value. You cannot specify this option together with ejf="end-judgment-file-name";.
lt: The return code of the preceding job is smaller than the reference value. You cannot specify this option together with ejf="end-judgment-file-name";.
le: The return code of the preceding job is equal to or smaller than the reference value. You cannot specify this option together with ejf="end-judgment-file-name";.
eq: The return code of the preceding job is equal to the reference value. You cannot specify this option together with ejf="end-judgment-file-name";.
ne: The return code of the preceding job is not equal to the reference value. You cannot specify this option together with ejf="end-judgment-file-name";.
ri: The return code of the preceding job is within the judgment value range. You cannot specify this option together with ejf="end-judgment-file-name";. You must also specify the ejl and ejh options. If necessary, specify ejm and eju.
ro: The return code of the preceding job is outside the judgment value range. You cannot specify this option together with ejf="end-judgment-file-name";. You must also specify the ejl and ejh options. If necessary, specify ejm and eju.
ef: A file is created. You cannot specify this option together with ejc=judgment-return-code;.
nf: No file is created. You cannot specify this option together with ejc=judgment-return-code;.
vgt: The value of the specified variable is greater than the judgment value. eji is treated as a numerical value.
vge: The value of the specified variable is equal to or greater than the judgment value. eji is treated as a numerical value.
vlt: The value of the specified variable is smaller than the judgment value. eji is treated as a numerical value.
vle: The value of the specified variable is equal to or smaller than the judgment value. eji is treated as a numerical value.
veq: The value of the specified variable is equal to the judgment value. eji is treated as a numerical value.
vne: The value of the specified variable is not equal to the judgment value. eji is treated as a numerical value.
vri: The specified variable value is within the judgment value range. ejs and ejg are treated as numeric values. You must also specify ejs and ejg. If necessary, specify ejm and eju.
vro: The specified variable value is outside the judgment value range. ejs and ejg are treated as numeric values. You must also specify ejs and ejg. If necessary, specify ejm and eju.
sce: The value of the specified variable is equal to the judgment value. ejt is treated as a character string.
spe: The value of the specified variable contains the judgment value. ejt is treated as a character string.
sne: The value of the specified variable is not equal to the judgment value. ejt is treated as a character string.
spn: The value of the specified variable does not contain the judgment value. ejt is treated as a character string. You must also specify ejv and ejt.
snn: There is a value for the specified variable. ejt is not processed.
snl: There is no value for the specified variable. ejt is not processed.

ejc=judgment-return-code;

Define the judgment return code for judgment. The default value is 0.

You can set 0 to 4,294,967,295.

This parameter takes effect if you specify gt, ge, lt, le, eq, or ne for the ej parameter. If you specify another value, this parameter does not take effect.

ejl=lower-limit-judgment-return-code;

Define the lower limit judgment return code used in making a judgment.

You can specify a value from 0 to 4,294,967,295. If there is no integer value in the range used to judge the return code from the lower limit judgment return code (ejl parameter) and the boundary condition (ejm parameter) to the upper limit judgment return code (ejh parameter) and the boundary condition (eju parameter), an error occurs.

If you specify ri or ro for the ej parameter, this parameter takes effect. If you specify another value, this parameter does not take effect.

If the return code is a negative value, judgment can be performed by specifying a value that converts to an unsigned integer. For example, -1 is treated as 4,294,967,295 in Windows, and as 255 in UNIX. Note, however, that if a negative number in an return code is converted to an unsigned integer, it falls within the range from 2,147,483,648 to 4,294,967,295. Accordingly, if the lower limit of the return code is a negative value and the upper limit is a positive value, the range cannot be specified.

ejh=upper-limit-judgment-return-code;

Define the upper limit judgment return code used in making a judgment.

If you specify ri or ro for the ej parameter, this parameter takes effect. If you specify another value, this parameter does not take effect.

ejf="end-judgment-file-name";

Define the file name of a file subject to end judgment.

You can set a character string of 1 to 260 bytes. This parameter takes effect when ef or nf is specified for the ej parameter. If you specify another value, this parameter does not take effect.

If you want to use a double quotation mark (") or a hash mark (#) as a character, prefix the character by #. That is, use #" instead of " and use ## instead of #.

ejv=variable-name;

Using the ?AJS2xxxxx? format, specify the macro variable name specified in the preceding job. If you specify vgt, vge, vlt, vle, veq, vne, vri, vro, sce, spe, sne, spn, snn, or snl for the ej parameter, this parameter takes effect. If you specify another value, this parameter does not take effect.

The xxxxx string in the variable name can contain only upper-case alphabetic characters, numeric characters, and periods (.).

You can specify a string of 1 to 64 bytes as the macro variable name.

ejt="judgment-value-for-variable (string)";

Specify the judgment value to be used as the judgment criterion by using a string of up to 511 bytes.

If you specify sce, spe, sne, or spn for the ej parameter, this parameter takes effect. If you specify another value, this parameter does not take effect.

eji=judgment-value-for-variable (numeric);

Specify the judgment value to be used as the judgment criterion by using a numerical value ranging from 0 to 2,147,483,647. The default value is 0.

If you specify vgt, vge, vlt, vle, veq, or vne for the ej parameter, this parameter takes effect. If you specify another value, this parameter does not take effect.

ejs=lower-limit-judgment-value-for-variable_(numeric);

Specify a numeric value from 0 to 2,147,483,647 as the lower limit judgment value used in making a variable (numeric) judgment. If there is no integer value in the range used to judge the variable (numeric) judgment value from the lower limit judgment value (ejs parameter) and the boundary condition (ejm parameter) to the upper limit judgment value (ejg parameter) and the boundary condition (eju parameter), an error occurs.

If you specify vri or vro for the ej parameter, this parameter takes effect. If you specify another value, this parameter does not take effect.

ejg=upper-limit-judgment-value-for-variable_(numeric);

Specify a numeric value from 0 to 2,147,483,647 as the upper limit judgment value used in making a variable (numeric) judgment. If there is no integer value in the range used to judge the variable (numeric) judgment value from the lower limit judgment value (ejs parameter) and the boundary condition (ejm parameter) to the upper limit judgment value (ejg parameter) and the boundary condition (eju parameter), an error occurs.

If you specify vri or vro for the ej parameter, this parameter takes effect. If you specify another value, this parameter does not take effect.

ejm={gt|ge};

Define the boundary conditions used to define the lower limit judgment return code (the ejl parameter) or the lower limit judgment value (the ejs parameter) for variables (numeric). If you omit this option, the system assumes ge.

If you specify ri, ro, vri, or vro for the ej parameter, this parameter takes effect. If you specify another value, this parameter does not take effect.

gt

Indicates that the return code of the preceding job or the variable judgment numeric value is greater than the judgment value.
ge

Indicates that the return code of the preceding job or the variable judgment numeric value is equal to or greater than the judgment value.

eju={lt|le};

Define the boundary conditions used to define the upper limit judgment return code (the ejh parameter) or the upper limit judgment value (the ejg parameter) for variables (numeric). If you omit this option, the system assumes le.

If you specify ri, ro, vri, or vro for the ej parameter, this parameter takes effect. If you specify another value, this parameter does not take effect.

lt

Indicates that the return code of the preceding job or the variable judgment numeric value is smaller than the judgment value.
le

Indicates that the return code of the preceding job or the variable judgment numeric value is equal to or smaller than the judgment value.

ha={y|n};

Define whether to suspend job execution. The default is n.

y: Suspends jobnet execution.
n: Does not suspend jobnet execution.

To Page Top