PERMANENT DATASET UTILITIES 11
11.2 PDSDUMP - DUMP PERMANENT DATASETS
PDSDUMP dumps specified permanent datasets to another dataset that can then be saved or staged to a station. Datasets that have the following characteristics or conditions cannot be dumped:
• Execute-only dataset
• Dataset allocation conflict
• Catastrophic dataset error
• Inconsistent dataset allocation
• Device on which the dataset resides is down
• Inactive dataset entry in the COS Queued Dataset Table (QDT)
• Retired or migrated dataset
When dumping to a tape dataset, the recording format for the tape dataset must be transparent (for example, DF=TR on ACCESS statement). If the dataset is recorded in interchange format, loading of the dumped datasets cannot be performed.
SR-0011 0 11-9
PDSDUMP produces a listing (refer to figure 11-7) on $OUT identifying the datasets dumped or bypassed and summarizing the dump run. The date and time in the heading line refer to the time when the dump run started.
The permanent dataset name, edition number, ID, and user number are extracted from the DSC entry for each dataset selected. Each message is followed by the notation DUMPED, DUMPED AND DELETED, or NOT DUMPED. The notation NOT DUMPED indicates the dataset was selected but could not be accessed for dumping. A user logfile message further explains the problem encountered.
Format:
PDSDUMP,DN=dn,DV=ldv'PDS=pdn,ED=ed,CW=cw,ID=uid,US=usn,o
PDN WN=ov, INC=mmlddlyy:'hh:mm:ss',ARC=mmlddlyy: 'hh:mm:ss',TS=opt,X,C,D,B,SO,I,O,S.
DN=dn
Dv=ldv
PDN PDS=pdn
ED=ed
CW=CW
ID=uid
11-10
Name of dataset to which dump is written. The default is
$PDS. Multiple dumps to a dataset are possible; if the dataset specified already exists, the dump is appended to it.
Dumps all datasets residing on logical device
Idv.
Currently only one
Idv
can be specified. (By default, all permanent datasets that could be specified by the parameters are dumped.) Datasets can be limited by the B parameter.Dumps all editions of the specified permanent dataset.
Editions can be limited by ED parameter.t
Edition number of permanent dataset dumped; meaningful only if PDS parameter is specified.t
Site-defined control word regulating use of PDSDUMP. If the CW parameter is omitted, only the datasets belonging to the job owner can be dumped. If the CW parameter is
present and the correct control word is used, any dataset can be dumped. If an invalid control word is given, the job step is aborted.
Dumps all datasets with additional user identification as specified.t If ID is specified without a value, all
datasets that meet the rest of the criteria and have a null ID are dumped.
SR-0011 0
US=usn Dumps all datasets with specified user numbert OWN=ov Dumps all datasets with specified ownership valuet
INC=mmlddlyy: 'hh:mm:ss'
Incremental dump. Dumps only datasets modified since the specified date and time.
ARC=mmlddlyy:'hh:mm:ss'
TS=opt
x
C
D B
so
I
o
S
Archive datasets. Dumps and deletes datasets, regardless of the D option, that have not been accessed since the specified date and time.
Time-stamp conversion option.
opt
may be one of the following:CURR NS RT
S~E
Writes time-stamp in whatever format is the current system default for writing time-stamps Writes time-stamp in nanosecond (new) format Writes time-stamp in real-time clock (old) format Does not convert time-stamp
If TS is not specified, TS=CURR is assumed.
Dumps expired datasets
Dumps selected datasets never dumped or datasets modified or adjusted since the last dump of the dataset
Deletes datasets that are dumped
Dumps only datasets that begin on the logical device specified by the DV parameter
Performs selection only (suppress actual dumping or deletion)
Dumps system input datasets Dumps system output datasets Dumps user permanent datasets
t By default, all permanent datasets that match the criteria specified by the parameters are dumped.
SR-0011 0 11-11
NOTE
If none of the I, 0, or S parameters is specified, the input, output, and user permanent datasets are all dumped. If any of these parameters is specified, only those datasets of the type specified are dumped.
Multiple calls to PDSDUMP can be made if the dump dataset is to include several permanent datasets requiring specification of different
parameters.
Example:
PDSDUMP,DN=DUMPA,PDS=LIB1.
PDSDUMP,DN=DUMPA,PDS=LIB2.
This example results in a dataset DUMPA that contains all editions of LIB1 and all editions of LIB2.
PDSDUMP produces a listing (refer to figure 11-7) on $OUT identifying the datasets dumped or bypassed and summarizing the dump run. The date and time in the heading line refer to the time when the dump run started.
The permanent dataset name, edition number, ID, and user number are extracted from the DSC entry for each dataset selected. Each message is followed by the notation DUMPED, DUMPED AND DELETED, or NOT DUMPED. The notation NOT DUMPED indicates the dataset was selected but could not be accessed for dumping. A user logfile message further explains the problem encountered.
When dumping to a tape dataset, the recording format for the tape dataset must be transparent (for example, DF=TR on ACCESS statement). If the dataset is recorded in interchange format, loading of the dumped datasets cannot be performed.
11-12 SR-0011 0
PDSDUMP - PERMANENT DATASET DUMP UTILITY DUMP ON 08/15/85 AT 14:50:44 AUDPL ED=OOOl ID=QITTYQAT USR=SYSTEM DUMPED
AUDPL ED=0002 ID=QITTYQAT USR=SYSTEM DUMPED DSCED ED=OOOl ID=QITTYQAT USR=SYSTEM DUMPED DSCED ED=0002 ID=QITTYQAT USR=SYSTEM DUMPED TXBUILD ED=OOOl ID=QITTYQAT USR=SYSTEM DUMPED TXBUILD ED=0002 ID=QITTYQAT USR=SYSTEM DUMPED TXBUILD ED=0003 ID=QITTYQAT USR=SYSTEM DUMPED LONGDATASETNAME ED=OOOl ID=QITTYQAT USR=SYSTEM DUMPED LONGDATASETNAME ED=0002 ID=QITTYQAT USR=SYSTEM DUMPED LONGDATASETNAME ED=0003 ID=QITTYQAT USR=SYSTEM DUMPED LONGDATASETNAME ED=0004 ID=QITTYQAT USR=SYSTEM DUMPED DSBUILD ED=OOOl ID=QITTYQAT USR=SYSTEM DUMPED DSBUILD ED=0002 ID=QITTYQAT USR=SYSTEM DUMPED DSBUILD ED=0003 ID=QITTYQAT USR=SYSTEM DUMPED DSBUILD ED=0004 ID=QITTYQAT USR=SYSTEM NOT DUMPED AUDPL ED=0003 ID=QITTYQAT USR=SYSTEM DUMPED DSCED ED=0003 ID=QITTYQAT USR=SYSTEM DUMPED TXBUILD ED=0004 ID=QITTYQAT USR=SYSTEM DUMPED AUDPL ED=0004 ID=QITTYQAT USR=SYSTEM DUMPED DSCED ED=0004 ID=QITTYQAT USR=SYSTEM DUMPED