Use the DUMPDS NAME command to establish a name-pattern for automatically
allocated dump data sets.
DD NAME |
DD NAME=name-pattern
|
The parameter is:
- NAME=name-pattern
- The system names automatically allocated dump data sets according
to the naming convention specified by the name-pattern. The name-pattern
can include both text and system symbols. The system substitutes
text for the system symbols when it creates data set names.
The
system default name-pattern is:
SYS1.DUMP.D&YYMMDD..T&HHMMSS..&SYSNAME..S&SEQ.
Note: If you want to use a name pattern other than
the system default, place the DUMPDS NAME command before the DUMPDS
ADD commands, so that the system uses the correct name pattern for
the added resources. Using a different name pattern could cause the
system to use different RACF® profiles for the allocation.
Before you specify system symbols in the DUMPDS NAME command, read
the rules and recommendations for using system symbols in commands
in
Sharing system commands.
Note: - All name-patterns must specify the &SEQ. sequence number system
symbol to ensure uniqueness. The system rejects the name-pattern
if you do not specify &SEQ..
- When you change the installation naming convention for dump data
sets, also change the procedures for protecting them (password or RACF protection).
- If the installation has a SYSNAME that begins with a numeral, the default will be changed to either SYS1.DUMP.D&YYMMDD..T&HHMMSS..S&SYSNAME..S&SEQ.
or | SYS1.DUMP.D&YYMMDD..T&HHMMSS..S&SYSNAME(2&colon.8)..S&SEQ
to ensure that the resulting S&SYSNAME position will have only
eight characters.
- Names generated by a name-pattern must adhere to MVS™ data
set naming conventions and limitations. Ensure that system symbols
do not return a numeric character as the first character of any qualifier
in the data set name. For example, in the default name-pattern:
SYS1.DUMP.D&YYMMDD..T&HHMMSS..&.SYSNAME..S&SEQ.
&HHMMSS, &SEQ, and &YYMMDD
return numeric substitution texts. Each symbol is preceded by an
alphabetic character to avoid placing a numeric character in the first
character of each qualifier. If resolved substitution texts create
a data set name that is not valid, the system rejects the name-pattern
and issues message IEE855I. The previous name-pattern remains in
effect.
- The DUMPDS NAME function will not work when the command
is issued from an MCS, HMCS or SMCS console and
the character '&' is specified as a command delimiter. Command
delimiters are defined using the CMDDELIM parameter on the INIT statement
of the CONSOLxx parmlib member. See z/OS MVS Initialization and Tuning Reference for more information on defining command delimiters.
Example:
To establish automatically allocated dump data sets with names
such as
SYS1.USERIDX.T025930.S00001
where the
system name is
SYS1 and
USERIDX is the name of the job
requesting the dump, enter:
DD NAME=&SYSNAME..&JOBNAME..T&HHMMSS..S&SEQ.