Your Browser is not longer supported

Please use Google Chrome, Mozilla Firefox or Microsoft Edge to view the page correctly
Loading...

{{viewport.spaceProperty.prod}}

@SETJV - Catalog job variable and assign value

&pagelevel(3)&pagelevel

The @SETJV statement enters a job variable in the catalog and assigns it a value.

Operation

Operands

F mode, L mode

@SETJV

{ [string]=string1[,...] [,CODE=name]
 | string }

string

String which specifies the fully qualified name of a job variable.
Although the name must comply with the syntactic rules for job variable
names, EDT does not check these rules in full.

If the job variable is not yet present in the catalog, it is cataloged using the
standard functions of the DCLJV macro.

The link name *EDTLINK is assigned to the job variable. This can be used
to address it in subsequent statements. The assignment is performed
before the corresponding system interfaces are called. If errors then occur
when values are assigned, the assignment that has already been
performed is retained.

If string is not specified then the job variable is addressed using the link
name *EDTLINK. In this case, string1 must be specified. If no job variable
is linked to the link name *EDTLINK then the statement is rejected with the
message EDT5289. If string1 is also not specified then the statement
is rejected with the message EDT3908.

If the job variable cannot be accessed then the statement is aborted with the
message EDT4208.

string1

One or more strings that are to be assigned to the job variable.

If multiple strings are assigned then they are chained together to form an
intermediate result. If all the strings involved have the same character set
then this is also the character set of the intermediate result. If the involved
strings have different character sets then the character set of the intermediate
result is UTFE.

If the string is longer than 256 bytes then only the first 256 bytes are
assigned as a value and the message EDT1936 is output.

If string1 is not specified or if string1 is an empty string then an empty
job variable is created. If it already exists, its value is not changed.

name

Name of a character set into which the intermediate result is converted
before being assigned to the job variable. If name is not specified, EDF041
is used. The character set name must be known in XHCS; otherwise, the
statement is rejected with message EDT4980.

If the string that is to be assigned contains characters which are invalid in the specified character set then these characters are replaced by a substitute character provided that such a character has been specified (see @PAR SUBSTITUTION-CHARACTER); otherwise, no assignment is performed and the error message EDT5453 is output.

If the Job Variable Support subsystem is not installed, the statement is rejected with the error message EDT5254. For details concerning job variables, see the User Guide JV [9].