The following utility routines are provided for permanent datasets:
• PDSDUMP dumps all specified permanent datasets to a
user-specified dataset. Input and output datasets may be included in the dump.
• PDSLOAD loads permanent datasets that have been dumped by PDSDUMP and updates or regenerates the Dataset Catalog. Input and output datasets are also loaded via PDSLOAD.
• AUDIT produces a report containing status information for each permanent dataset. AUDIT does not include input or output datasets.
PDSDUMP - DUMP PERMANENT DATASET
PDSDUMP dumps specified permanent datasets to a dataset, which may then be saved or staged to a station as desired. Conditions that cause a dataset to be omitted from dumping include:
• The dataset is execute-only,
• There are dataset allocation conflicts,
• The dataset has catastrophic errors,
• Inconsistent allocation has occurred,
• The dataset resides on a down device, or
• The dataset has an inactive entry in the system's Queued Dataset Table (QDT).
Format:
PDSDUMP,DN=dn,DV=Zdv,PDS=pds,cw=cW,
SR-OOII
ID=uid,Us=usn,ED=ed,x,C,D,I,O,S.
Part 2 7-1
7
J
I
I
I
All parameters are in keyword form. Optional parameters establish criteria for datasets being dumped.
DN=dn
Installation-defined control word regulating use of PDSDUMP. If the user number is specified on the JOB
Dump all datasets with user identification as specified.§
If ID is specified without a value, all datasets which meet the rest of the criteria and have a null id are dumped.
Dump all datasets with specified user number.§
Edition number of permanent dataset dumped; meaningful only if PDS parameter is specified.§
Dump expired datasets.
Dump selected datasets never dumped or datasets modified since the last dump of the dataset.
Delete datasets that are dumped.
Dump system input datasets.
I
Dump system output datasets. See note Dump user permanent datasets.
§ By default, all permanent datasets specified by the parameters are dumped.
SR-OOll
Part 2
7-2 J-Ol
NOTE
If none of these 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 may be made if the dump dataset is to include several permanent datasets requiring specification of different
parameters.
Example:
PDSDUMP,DN=DUMPA,PDS=LIBI.
PDSDUMP,DN=DUMPA,PDS=LIB2.
This example results in a dataset DUMPA that contains all editions of LIBI and all editions of LIB2.
PDSDUMP produces a listing (figure 7-1) 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 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, using the dump dataset leads to unsuccessful results.
SR-OOll
Part 2
7-3 J-Ol
I
PDSDUMP - PERMANENT DATASET DUMP UTILITY DUMP ON 01/07/82 AT 14:50:44 AUDPL ED=OOOl ID=QITTYQAT USR=SYSTEM
AUDPL ED=0002 ID=QITTYQAT USR=SYSTEM DSCED ED=OOOl ID=QITTYQAT USR=SYSTEM DSCED ED=0002 ID=QITTYQAT USR=SYSTEM TXBUILD ED=OOOl ID=QITTYQAT USR=SYSTEM TXBUILD ED=0002 ID=QITTYQAT USR=SYSTEM TXBUILD ED=0003 ID=QITTYQAT USR=SYSTEM LONGDATASETNAME ED=OOOl ID=QITTYQAT USR=SYSTEM LONGDATASETNAME ED=0002 ID=QITTYQAT USR=SYSTEM LONGDATASETNAME ED=0003 ID=QITTYQATUSR=SYSTEM LONGDATASETNAME ED=0004 ID=QITTYQAT USR=SYSTEM DSBUILD ED=OOOl ID=QITTYQAT USR=SYSTEM DSBUILD ED=0002 ID=QITTYQAT USR=SYSTEM DSBUILD ED=0003 ID=QITTYQAT USR=SYSTEM DSBUILD ED=0004 ID=QITTYQAT USR=SYSTEM AUDPL ED=0003 ID=QITTYQAT USR=SYSTEM DSCED ED=0003 ID=QITTYQAT USR=SYSTEM TXBUILD ED=0004 ID=QITTYQAT USR=SYSTEM AUDPL ED=0004 ID=QITTYQAT USR=SYSTEM DSCED ED=0004 ID=QITTYQAT USR=SYSTEM 20 DATASETS SELECTED FOR DUMPING
Figure 7-1. PDSDUMP listing
PDSLOAD - LOAD PERMANENT DATASET
DUMPED
All parameters are in keyword form. Optional parameters establish criteria for datasets being loaded.
DN=dn parameters are loaded.
SR-OOll
Part 2
7-4 J-Ol
I
Installation-defined control word to regulate the use of PDSLOAD. The CW parameter is usually not required. If the parameter is specified on the PDSLOAD control statement, the user can load any datasets with the correct control
Load output datasets.
Load saved datasets.
I
each dataset selected and successfully loaded. Each message is followed by the notation LOADED or NOT LOADED. The notation NOT LOADED indicates the dataset was selected but not loaded. A user logfile message further explains the problem encountered.PDSLOAD ED=OOOI ID=TAQI USR=SYSTEM LOADED
ED=OOOI ID=TAQI USR=SYSTEM LOADED ED=OOOI ID=TAQI USR=SYSTEM
ED=OOOI ID=TAQI USR=SYSTEM ED=OOOI ID=TAQI USR=SYSTEM 5 DATASETS SELECTED FOR LOADING
AUDIT - AUDIT PERMANENT DATASETS
LOADED
AUDIT supplies the following information on the listing:
Permanent dataset name Edition number Last access date/time
Last modification date/time Logical device name
Number of datasets selected
Part 2
7-6 J-Ol
•
Format:
AUDIT,L=Zdn,B=bdn,PDN=pdn, ID=uid,PREFIX=pfx, Dv=dvn,
sz=dsz,X=.mm/dd/yy:'hh:mm:ss',TCR=.mm/dd/yy:'hh:mm:ss',
TLA=.mm/dd/yy:'hh:mm:ss',TLM=mm/dd/yy:'hh:mm:ss'.
Parameters are in keyword form.
L=Zdn List dataset name. The default is $OUT.
B=bdn Specifies dataset to receive the binary output. If B is specified alone, the dataset is $BINAUD. If the B parameter is omitted, no binary output is written. For a description of the binary output format, refer to the COS Product Set
Internal Reference Manual, eRI publication SM-004l.
PDN=pdn Name of permanent dataset or datasets to be listed. Up to 15 alphanumeric characters may be specified. A shorthand notation may be used where a dash represents any number of characters or no characters and an asterisk represents any one character.
SR-OOII
Examples:
PDN=ABC- List all permanent dataset names beginning with ABC.
PDN=A*** List all 4-character permanent dataset names beginning with A.
PDN=-A*- List all permanent dataset names containing the letter A followed by one or more other characters.
PDN=- List all names.
PDN=***- List all names having three or more characters.
Part 2
7-7 J-Ol
I
ID=uid List all permanent datasets with the specified user
identification. The default is to list all IDs. If ID is present without an equated value, datasets having a null id are selected.
PREFIX=pf~
Dv=dvn
sZ=dsz
List all permanent datasets whose names begin with the specified prefix. pf~ is 1-8 characters. The default is no prefix specified.
List all permanent datasets on the specified logical device. The default is to list permanent datasts on all devices.
List all permanent datasets greater than or equal to the specified size. Size is specified in words. The default is to list all sizes.
X=mm/dd/yy:'hh:mm:ss'
List all permanent datasets that are expired as of the specified mm/dd/yy:'hh:mm:ss'. mmfdd/yy
may be specified alone. The default expiration date and time are "now" if only X is specified.
TCR=mm/dd/yy: 'hh:mm:ss'
List all permanent datasets that have been created since the specified mm/dd/yy:'hh:mm:ss'. The keyword
cannot be specified alone; however, TCR=mmVddlyy is sufficient.
TLA=mm/ddlyy:'hh:mm:ss'
List all permanent datasets that have not been accessed since the specified mm/dd/yy:'hh:mm:ss'. The
keyword cannot be specified alone; however, TLA=mm/dd/yy is sufficient.
TLM=mm/dd/yy:'hh:mm:ss'
SR-OOll
List all permanent datasets that have been modified since the specified mrnVdd/yy:'hh:mm:ss'. The keyword
cannot be specified alone; however, TLM=mmVddlyy is sufficient.
Part 2
7-8 J-Ol