DSNAME
If DISP=OLD or DISP=SHR is specified, the data set name must refer to an existing catalogued data set. If DISP=NEW is specified, the data set name must not refer to an existing catalogued data set.
If the data set name matches an existing GDG base name, the product will automatically append the appropriate generation information to the base name equivalent to relative generation '(+1)', if not specified explicitly. DISP=(NEW,CATLG) is required when a new generation data set is being created.
Use
DSNAME is an optional keyword for the following subcommands:
- ACTIVITY_FILECTL
- CORRECTIONS_FILECTL
- DISCARD_FILECTL
- IC
- IX
- MODIFY
- OFILECTL
- PLAN_FILECTL
DSNAME is a required keyword for the ADD subcommand.
Related keywords
- DATACLAS
- DDNAME
- DISP
- DSKEYLBL
- DSNTYPE
- EXPDT
- LIKE
- MGMTCLAS
- RETPD
- SPACE
- STORCLAS
- UNIT
- VOLCNT
- VOLSER
Syntax
Parameters
Specify a 1-character to 64-character data set name mask. Enclose the mask in single or double quotation marks. Use the following variables, as necessary, to create the mask:
Variable | Description |
|---|---|
&AREA | Area name |
&AREA# | Specify the area number as 3 digits when the area number is less than or equal to 999; specify the area number as 5 digits when the area number is greater than 999 |
&AREA4# | 4-digit area number |
&AREA5# | Specify the area number as 5 digits |
&DATE | Current date ('Dyyddd') in its default form (local or UTC) |
&DBD | dbdname |
&IMSID | IMS subsystem ID (actual IMS subsystem ID if online; subsystem ID from DFSCV000 if offline) |
&INDEX | Index name |
&JOBN | Job name |
&PROCSN | Procedure step name |
&LCLDATE | Current date ('Dyyddd ') in local form |
&LCLTIME | Current time ('Thhmmss ') in local form |
&STEPN | Step name |
&TIME | Current time ('Thhmmss') in its default form (local or UTC) |
&UTCDATE | Current date ('Dyyddd ') in UTC form |
&UTCTIME | Current time ('Thhmmss ') in UTC form |
The following table provides examples of the resulting data set name that is dynamically allocated based on the specified area variable, and the area name or number of digits in the area number:
Area name/number | Specified area name variable | Dynamically allocated data set name |
|---|---|---|
A123 | DSNAME=’PFPTEST.DB.&AREA’ | PFP.TEST.DB.A123 |
26 | DSNAME=’PFPTEST.DB.PF&AREA#’ | PFP.TEST.DB.PF026 |
26 | DSNAME=’PFPTEST.DB.PF&AREA4#’ | PFP.TEST.DB.PF0026 |
26 | DSNAME=’PFPTEST.DB.PF&AREA5#’ | PFP.TEST.DB.PF00026 |
1024 | DSNAME=’PFPTEST.DB.PF&AREA#’ | PFP.TEST.DB.PF01024 |
1024 | DSNAME=’PFPTEST.DB.PF&AREA4#’ | PFP.TEST.DB.PF1024 |
1024 | DSNAME=’PFPTEST.DB.PF&AREA5#’ | PFP.TEST.DB.PF01024 |
Using the &AREA#4 or &AREA5# variable instead of the &AREA# variable lets you standardize the length of dynamically allocated data set names when using 1000 or more areas, while still supporting area numbers 1 through 999.
Default
None
Alias
None