Substituting job variables

This function requires the chargeable subsystem JV to be loaded.

Expressions to be replaced by job variables are specified as follows:

• directly via the job variable name in the form “&(jv-name)”

• indirectly via the job variable link name in the form “&(*jv-link)” after the link name has been assigned to the job variable by means of the command
  SET-JV-LINK LINK-NAME = jv-link, JV-NAME = jv-name.

Note
Before job variable replacement, ACS, if required, replaces the alias of a JV by its real path name (in accordance with the alias catalog entry).

The following restrictions apply to substituting job variables:

• An expression can be replaced only by a job variable in its full length.

• Read access must have been granted to the job variable value to be substituted for the expression, otherwise the input will be rejected as a syntax error.

• No substitution is possible within CJC command sequences.

• Job variables cannot be substituted for input data. SDF treats statements intended for programs with SDF interface like commands and not like input data.

• In procedures, job variables cannot replace the slash introducing commands or the two slashes introducing statements, the period introducing non-S labels, the semicolon separating commands or the continuation character.

• Job variables cannot be used as procedure parameters. This restriction can be circumvented, for instance, by using a link name (see example 3 "Submitting the name of the job variable to be substituted as procedure parameter of a non-S procedure: ").

• Expressions cannot be nested.

• With interactive mode or S procedures, job variable substitution in the manner outlined above is effected only if no identical S variable or builtin function is known. This mechanism can be replaced, however, by the builtin function JV(), in which case the appropriate entry would take the form “&(JV(JV-NAME=<c-string 1..54>))”. (See builtin function JV( ) in the “Commands“ manual [1] or in the “SDF-P” manual [5]. If the job variable name contains the catalog and/or user ID, only job variable substitution is possible.