The JOBVAR statement has two different formats, one for saving job variables and one for restoring job variables. The JOBVAR statement for saving job variables is described here; the JOBVAR statement for restoring job variables is described in the section "JOBVAR Select job variables in restoration runs".
In the JOBVAR statement, you must specify the job variables to be saved in an ARCHIVE run, together with the associated volumes.
More than one JOBVAR statement can be entered. Each JOBVAR statement may contain a number of NAME and EXCEPT operands, but only one EXCEPT operand may be specified per NAME operand.
The handling of the JOBVAR statement and the NAME operand is analogous to that described for the FILES statement in the section "Parallel and serial processing".
J[OBVAR] |
[ { [NA[ME] = [ { jv-name / (jv-name[,THRU = jv-name],...) / (jv-name[,RENAME = jv-name],...)] ] [,FR[OM] = { svid[,(vsn,...),...] / SV,(vsn,...),...] } |
NAME =
The job variables to be saved are specified in the NAME operand. The possible specifications are dependent on the value of the CATID parameter.
The following applies to runs with
PARAM CATID=NO:No catalog ID may be entered, otherwise the statement will be rejected. Only the catalog of the default pubset of the relevant user ID is searched.
If the NAME operand is omitted:
All job variables which are cataloged in the default pubset of the user ID are saved.
If the user has the TSOS privilege, the job variables of all user IDs are saved from their respective default pubsets.
The following applies to runs with
PARAM CATID=YES:A catalog ID can be specified in the job variable name. If no catalog ID is specified, the catalog ID of the default pubset of the relevant user ID is added to the job variable name.
It is also possible to specify only the catalog ID (e.g.NAME=:c:), in which case all job variables belonging to the user ID and under the specified catalog ID are saved.If the NAME operand is omitted:
All job variables under the relevant user ID on all available pubsets on which this ID is entered are saved.
All cataloged job variables of all locally imported pubsets are saved if the user has the TSOS privilege.
When copying save data, all job variables of the user are copied.
All saved job variables are copied if the user has the TSOS privilege.
NAME = jv-name
This may be a partially or fully qualified job variable name.
NAME = (jv-name,...)
If more than one job variable is specified, the names must be enclosed in parentheses.
NAME = (jv-name,THRU=jv-name)
The specification “THRU” enables a range of job variables to be defined. All those lying alphabetically between the job variable names (both inclusive) are then addressed.
The job variables must be on the same pubset for a run with PARAM CATID=YES, i.e. the catalog IDs of the two job variables in jv-name,THRU=jv-name must be the same.
NAME = (jv-name,RENAME=jv-name)
You can rename job variables with the RENAME operand. This operand is supported only for EXPORT runs without a directory file.
For a renamed job variable, the entry ERASE=YES (ALL, ALLP, ...) is ignored with a warning message. The job variable is exported but not erased.
The name in the RENAME operand replaces the original name (NAME=...).
If the name is partially qualified, the part which is specified is modified.
If ARCHIVE is not running under the TSOS privilege, only job variables under the user's own ID are renamed.
It is sound practice to start EXPORT runs using RENAME with PARAM CATID=NO; in this case, specification of a catalog ID is not permitted.
If job variables of several pubsets are to be exported using PARAM CATID=YES, the following applies:
If, in a new job variable name, a catalog ID
:c:is specified
(jv-name,RENAME=:c:jv-name), all addressed job variables with the standard catalog ID of the user ID in question are written to the EXPORT volume using the catalog ID:c:.If a catalog ID
:c:is specified in the old job variable name
(:c:jv-name,RENAME=jv-name), all job variables concerned are written to the EXPORT volume using the same catalog ID:c:.
It is possible to specify user IDs instead of the job variable names
($userid1.,RENAME=$userid2.).
The following applies to runs with PARAM CATID=YES: All job variables under the current standard catalog ID of $userid1 are written to the EXPORT volume with $userid2.ARCHIVE does not check the new catalog and user IDs.
EXCEPT = jv-name / (jv-name,THRU=jv-name)
This specifies job variables or job variable ranges that are to be excluded from the list of job variables in the NAME operand. Only one EXCEPT operand may be specified per NAME operand.
If the EXCEPT operand is not preceded by a NAME operand, it refers to all the job variables under the user ID or, in the case of the system administrator ID, to all the job variables in the system.
The same applies to the EXCEPT operand in the JOBVAR statement as was described for the EXCEPT operand in the FILES statement.
The rules governing the specification of job variable names in the NAME operand also apply to the EXCEPT operand.
FROM =
This operand must and can only be specified when job variables are to be copied from an existing save version to a new save version. Only the job variables which are specified in the NAME operand and fulfill the conditions of the FROM operand are copied.
FROM = svid
This specifies the save version in which the job variables in the NAME operand were saved. Specification of a directory file is mandatory.
FROM = svid,(vsn,...)
Only the job variables in the NAME operand which belong to a save version on the volume with the specified VSN are copied. If a specified VSN does not belong to the specified save version, the ARCHIVE run is aborted.
A directory file must not be specified.
FROM = SV,(vsn,...)
This specification is used to duplicate save data fully or partially when the svid is not known. All the job variables given in the NAME operand and resident on the specified volumes (vsn,...) are copied. This operand is not permitted when saving to disk.
FROM = ...,DEVICE = TAPE-C4 / device type
If the svid is not known, the device type of the save volume is specified (not possible when saving to disk).