Operating System BS2000 OS DX V1.0 (en)

&pagelevel(3)&pagelevel

Provide information about job variables on a Snapset

Component:	BS2000
Functional area:	Job variables
Domain:	JOB-VARIABLES SNAPSET
Privileges:	STD-PROCESSING TSOS

Function

The LIST-JV-FROM-SNAPSET command enables the user to obtain information about job variables which were saved on a Snapset when a pubset was backed up. The information relates to whether job variables can be restored (using the RESTORE-JV-FROM-
SNAPSET command). The associated pubset must be imported.

Nonprivileged users can obtain information about all job variables which they can access (as with SHOW-JV-ATTRIBUTES, which supplies information from the current file catalog).

The Snapsets are temporarily not available if the SHC-OSD subsystem was not active when the pubset was imported. In this case the command is aborted with DMS0622. As soon as SHC-OSD is active, the Snapsets are subsequently activated when the SHOW-SNAPSET-CONFIGURATION command is called.

Privileged functions

Systems support (TSOS privilege) can obtain information on the job variables of all user IDs. Wildcards are not permitted in the user ID here.

Format

LIST-JV-FROM-SNAPSET

JV-NAME = <filename 1..54 without-gen-vers with-wild(80)>
,SNAPSET = LATEST / ALL / <name 1..1 with-low> / <integer -52..-1> / *INTERVAL(...)
	*INTERVAL(...)
		\|	OLDEST = -52 / <integer -52..-1>
		\|	,NEWEST = -1 / <integer -52..-1>
,INFORMATION = NAME-AND-SIZE / ALL
,OUTPUT = list-poss(2): SYSOUT / SYSLST

Operands

JV-NAME = <filename 1..54 without-gen-vers with-wild(80)>
Selects the job variables which are to be listed. The job variables must satisfy the following requirements:

They must be cataloged when the Snapset is created.
The pubset on which they are cataloged must be imported locally.

Aliases may be specified.

SNAPSET = *LATEST / *ALL / <name 1..1 with-low> / <integer -52..-1> / *INTERVAL(...)
Specifies the Snapset from which the file information is to be output.
Information about all existing Snapsets for a pubset can be obtained using the SHOW-SNAPSET-CONFIGURATION command.

SNAPSET = *LATEST
The information is to be output from the latest Snapset (i.e. from the most up-to-date pubset backup).

SNAPSET = *ALL
The information from all existing Snapsets is output.

SNAPSET = <name 1..1 with-low>
Specifies the Snapset explicitly by means of the Snapset ID. The maximum of 52 Snapsets for a pubset are distinguished by means of Snapset IDs specified which comprise letters from the 26 lowercase letters a to z and the 26 uppercase letters A to Z.

SNAPSET = <integer -52..-1>
Specifies the Snapset explicitly by means of the relative age. The value -1 specifies the latest Snapset.

SNAPSET = *INTERVAL(...)
Information on all Snapsets which lie in the specified age range is output:

OLDEST = -52 / <integer -52..-1>
Specifies the oldest Snapset; the range begins with this Snapset.

NEWEST = -1 / <integer -52..-1>
Specifies the newest Snapset; the range ends with this Snapset.

INFORMATION = *NAME-AND-SIZE / *ALL
Determines the type and scope of the information to be output.

INFORMATION = *NAME-AND-SIZE
For each cataloged job variable one line is output which contains the length of its value and its name.

INFORMATION = *ALL
Two lines are output for each cataloged job variable. The first line has the same format as with INFORMATION=*NAME-AND-SPACE. The second line contains the creation date and release date.

OUTPUT = list-poss(2): *SYSOUT / *SYSLST
Specifies whether the information is to be directed to SYSOUT (default) and/or SYSLST.

Return codes

(SC2)	SC1	Maincode	Meaning/Guaranteed messages
	0	CMD0001	Command executed without errors
1	0	CMD0001	Interrupt the output with the K2 key
2	0	DMS05B6	Incorrect conversion of UTC to LT
2	0	DMS0616	Volume set in SM pubset might not be available
	1	CMD0202	Syntax or semantic error Guaranteed messages: DMS0598, DMS06F7, DMS05DE, DMS05EE
	32	DMS05C7	Unexpected internal error in DMS
	64	DMS0501	Requested catalog not available
	64	DMS0512	Requested catalog not found
	64	DMS051B	Specified user ID not in home pubset Guaranteed message: DMS051B
	64	DMS051C	User does not have permission to access pubset
	64	DMS051D	Logon and pubset passwords different
	64	DMS0535	Catalog entry not accessible
	64	DMS0585	Error detected when processing catalog or multiprocessor system
	64	DMS05FC	User ID does not exist
	64	DMS0616	Volume set not accessible in SM pubset
	64	DMS0622	Snapset not available
	64	DMS0682	Error while accessing job variable (e.g. it does not exist); for more detailed information on the cause of the error, see the insert of the SYSOUT message Guaranteed message: DMS0682
	130	DMS0585	Error detected when processing catalog or multiprocessor system
	130	DMS0594	Not enough virtual memory available

Example

/list-jv-from-snapset :x:,inf=*all

----------------------------SNAPSET b-------------------------
         0 :X:$TSOS.JV.#AAA
  CRE-DATE=2011-09-14 09:23:40  EXPIR-DATE=2011-09-14 00:00:00 
         0 :X:$TSOS.JV.TTT
  CRE-DATE=2011-09-14 09:23:35  EXPIR-DATE=2011-09-14 00:00:00 
         0 :X:$TSOS.JV.1
  CRE-DATE=2011-09-14 09:23:24  EXPIR-DATE=2011-09-14 00:00:00 
         0 :X:$TSOS.JV.2
  CRE-DATE=2011-09-14 09:23:28  EXPIR-DATE=2011-09-14 00:00:00

Your Browser is not longer supported

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

LIST-JV-FROM-SNAPSET