Permanent user job variables

Like files, job variables are identified by means of a character string comprising three parts separated by delimiters:

1. Catalog identifier (catid) identifies the pubset (PVS) in whose file catalog (TSOSCAT) the job variable has been stored.

2. User identification (userid) identifies the user entry in the user catalog (SYSSRPM) of the pubset.

3. Job variable name (jvname) uniquely identifies the job variable within the user ID.

This three-part character string is called the “path name”.
It has the following format:

: c a t i d : $ u s e r i d . j v n a m e

|<----------- pathname ---------------->|

• The following characters must be used as delimiters:
  A specified catalog identifier “catid” must be enclosed in colons.
  A specified user ID “userid” must be enclosed between a dollar sign and a period.

• A path name is incomplete if at least one of the two parts “:catid:” or “$userid.” is not specified; otherwise it is complete.

• If a path name is specified incompletely, it is completed by DMS using the following default values. The default catalog identifier of the user ID is used if “catid” is missing. The user ID of the calling job is used if “userid” is missing.

• The default catalog identifier is defined in the user entry; it can be interrogated using the SHOW-USER-ATTRIBUTES command.

• Maximum lengths including delimiters:

  :catid: $userid. jvname

  6 characters 10 characters 41 characters

  The total length of the pathname must not exceed 54 characters. This means that the maximum length of jvname is shortened if :catid:$userid. is longer than 13 characters. With a four-character catalog ID (6 characters including delimiters) and an
  eightcharacter user ID (10 characters including delimiters), it follows that jvname cannot be more than 38 characters long. For this reason jvname should not be more than 38 characters long so as to allow for a possible change to the catalog ID or user ID.

• If only “$.” (delimiter without user ID) is specified, the system searches for the job variable under the user ID named with the system parameter DEFLUID.
  Up to and including BS2000 V21.0A, the default setting is: DEFLUID=TSOS. As of BS2000 V21.0B, this value is permanently set to TSOS.

• A path name is partially qualified if “jvname” has not been specified or ends with a period; otherwise it is fully qualified.

• In jvname the same characters as for file names are permitted:

  All letters
  Digits 0 ... 9
  Special characters - , @ , # , $ , .

  The job variable name must contain at least one letter.

  The TEMPFILE character cannot be the first character for a permanent JV.
  The characters “-” and “$” are not permitted as the first character.

Example

This example is designed to illustrate the meaning of the terms “partially/fully qualified” and “incomplete/complete path name” by using various path name entries..

JV name	Partially qualified	Fully qualified	Incomplete	Complete
:V:$PM211052.JOBVAR		x		x
$PM211194.JV.JOB.STEUER		x	x
:A:HILFSVARIABLE		x	x
JOBV.VARIABLE.A		x	x
:V:	x		x
$PM211052.	x		x
JOBV.A.	x		x
JOB.MON.	x		x

Table 2: Examples of path name specifications