Provide information about files on a Snapset
Component: | BS2000 |
Functional area: | File processing |
Domain: | FILE |
Privileges: | STD-PROCESSING |
Function
The LIST-FILE-FROM-SNAPSET command enables the user to obtain information about files which were saved on a Snapset when a pubset was backed up. The information relates to whether files can be restored (using the RESTORE-FILE-FROM-SNAPSET command). The associated pubset must be imported.
Nonprivileged users can obtain information about all files which they can access (as with SHOW-FILE-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 files of all user IDs. Wildcards are not permitted in the user ID here.
Format
LIST-FILE-FROM-SNAPSET |
Operands
FILE-NAME = <filename 1..54 with-wild(80)>
Selects the files which are to be listed. The files 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. Individual file generations can be specified. When a file generation group is specified, the file generations are also output.
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 pubsets 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-SPACE / *ALL
Determines the type and scope of the information to be output.
INFORMATION = *NAME-AND-SPACE
For each cataloged file name, one line is output which contains the file size in PAM pages and the file name. Work files (WORK-FILE=*YES) and migrated files as well as files on Net-Storage or on private disk are also flagged. Tape files are listed without file size or identification.
INFORMATION = *ALL
Two lines are output for each cataloged file name. The first line has the same format as with INFORMATION=*NAME-AND-SPACE. The second line contains the creation date, date of modification and the file status. The file status indicates whether the file was open in write mode when the backup took place (STATE=OPENED or CLOSED). In the case of files which cannot be restored (e.g. files with the backup frequency BACKUP-CLASS=E or special system files, work files, files on Net-Storage or on private disk), STATE=NOREST is displayed.
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 | Too many operands, syntax error | |
1 | CMD0202 | Syntax error in Snapset specification | |
1 | CMD0202 | Path name too long | |
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 | |
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 | Specified user ID not in home pubset | |
64 | DMS0616 | Volume set not accessible in SM pubset | |
64 | DMS0622 | Snapset not available | |
64 | DMS0684 | File does not exist | |
64 | DMS06CC | No file name corresponds to specified wildcard string | |
130 | DMS0585 | Error detected when processing catalog or multiprocessor system | |
130 | DMS0594 | Not enough virtual memory available |
Examples
/list-file-from-snapset :kh:sysa*
----------------------------SNAPSET a---------------------------------------
4 :KH:$TSOS.SYSACF.EDT.170
4 :KH:$TSOS.SYSACF.LMS.034
4 :KH:$TSOS.SYSACF.PMLOG.035
12 :KH:$TSOS.SYSACF.SORT.079
20 :KH:$TSOS.SYSAFR
/list-file-from-snapset :kh:sys.serslog*,inf=all
----------------------------SNAPSET a---------------------------------------- 56 :KH:$TSOS.SYS.SERSLOG.2011-08-25.001.01 CRE-DATE=2011-08-25 11:56:55 CHANG-DATE=2011-08-25 12:04:52 STATE=CLOSED 56 :KH:$TSOS.SYS.SERSLOG.2011-08-25.002.01 CRE-DATE=2011-08-25 12:17:51 CHANG-DATE=2011-08-25 12:33:32 STATE=CLOSED 56 :KH:$TSOS.SYS.SERSLOG.2011-08-25.003.01 CRE-DATE=2011-08-25 13:15:38 CHANG-DATE=2011-08-25 14:01:39 STATE=CLOSED 56 :KH:$TSOS.SYS.SERSLOG.2011-08-28.004.01 CRE-DATE=2011-08-28 08:14:34 CHANG-DATE=2011-08-28 08:37:57 STATE=CLOSED 64 :KH:$TSOS.SYS.SERSLOG.2011-08-28.005.01 CRE-DATE=2011-08-28 08:44:31 CHANG-DATE=2011-08-28 08:44:31 STATE=OPENED 56 :KH:$TSOS.SYS.SERSLOG.2011-08-28.006.01 CRE-DATE=2011-08-28 09:49:23 CHANG-DATE=2011-08-28 10:17:44 STATE=CLOSED
/list-file-from-snapset :kh:ca*,snap=-2,inf=*all
----------------------------SNAPSET b---------------------------------------- 8 :KH:$TSOS.CAP CRE-DATE=2011-08-25 10:58:40 CHANG-DATE=2011-08-25 10:58:40 STATE=CLOSED 4 :KH:$TSOS.CAT.SHC-OSD.060 CRE-DATE=2011-08-25 13:47:36 CHANG-DATE=2011-08-25 13:47:36 STATE=CLOSED 4 :KH:$TSOS.CAT.SYMAPI-D.062 CRE-DATE=2011-08-25 13:26:29 CHANG-DATE=2011-08-25 13:26:29 STATE=CLOSED
/list-file-from-snapset :x:s*,inf=all
---------------------------SNAPSET a----------------------------------------- 33 :X:$TSOS.SYSCAT.SNAPSET CRE-DATE=2011-09-14 08:32:23 CHANG-DATE=2011-09-14 08:32:24 STATE=OPENED 33 :X:$TSOS.SYSDAT.APUB-PUBX00 CRE-DATE=NONE CHANG-DATE=NONE STATE=NOREST 24 :X:$TSOS.SYSSRPM CRE-DATE=2011-09-14 08:31:23 CHANG-DATE=2011-09-14 08:31:23 STATE=NOREST 30 :X:$TSOS.SYSSRPM.BACKUP CRE-DATE=2011-09-14 08:32:25 CHANG-DATE=2011-09-14 08:32:25 STATE=CLOSED
/list-file-from-snapset :kh:$ulr.,snapset=*all
----------------------------SNAPSET c---------------------------------------- 0 :KH:$ULR.FGG (FGG) 8 :KH:$ULR.FGG(*0001) 8 :KH:$ULR.FGG(*0002) 12 :KH:$ULR.SAM.EDT 64 :KH:$ULR.SAM.WORK ----------------------------SNAPSET b---------------------------------------- 0 :KH:$ULR.FGG (FGG) 8 :KH:$ULR.FGG(*0001) 8 :KH:$ULR.FGG(*0002) 8 :KH:$ULR.T.1 8 :KH:$ULR.T.2
/list-file-from-snapset :kh:t.,snapset=*all
----------------------------SNAPSET c----------------------------------------
% DMS06CC NO FILE CORRESPONDING TO SPECIFIED OPERANDS
----------------------------SNAPSET b----------------------------------------
8 :KH:$ULR.T.1
8 :KH:$ULR.T.