DSNAME keyword

When the data set name contains a reference to a partitioned data set (PDS) member name and it is used for dynamic allocation, DISP=SHR or OLD is required. When unloaded segment records files (USR files) are specified for two or more PDS data set names, each member name and each data set name must be unique. DSNAME may contain a reference to a generation data group (GDG), with or without a relative generation number such as "(+1)".

If DISP=OLD or DISP=SHR is specified, the data set name must refer to an existing cataloged data set. If DISP=NEW is specified, the data set name must not refer to an existing cataloged 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 a relative generation "(+1)". DISP=(NEW,CATLG) must be specified when a new generation data set is being created.

The subcommand must contain either the DSNAME or the DDNAME keyword. Do not specify both; they are mutually exclusive.

DSNAME is an optional keyword for the FILECTL subcommand.

DSNAME is a required keyword for the IRENAME subcommand.

For the FILECTL subcommand:

• DATACLAS keyword
• DDNAME keyword
• DISP keyword
• EXPDT keyword
• LIKE keyword
• MGMTCLAS keyword
• RETPD keyword
• SPACE keyword
• STORCLAS keyword
• UNIT keyword
• VOLCNT keyword
• VOLSER keyword

dsname

Specify a data set name or data set mask with 1- to 64-characters. Enclose the dsname in single or double quotation marks. Use the following variables, as necessary.

&DBD

DBD name

&AREA

Area name

&AREA#

3-digit relative area number. (If you specify an area number that is greater than 999, FPA does not convert the mask variable to the relative area number and issues error message HFPU0099E.)

&AREAn#

n-digit relative area number. n is 1 - 5.

When the mask variable &AREA# is used for an area whose relative area number is greater than n-digit, for example, when &AREA2# is used for an area whose relative area number is greater than or equal to 100, FPA does not convert the mask variable to the relative area number and issues error message HFPU0099E.

&INDEX

Secondary index DBD name. &INDEX and &IDXGRP are mutually exclusive.

&IDXGRP

The first DBD name in the second index partition group. &INDEX and &IDXGRP are mutually exclusive.

&DATE

Current date ("Dyyddd")

&TIME

Current time ("Thhmmss")

&JOBN

Job name

&STEPN

Step name

&PROCSN

Procedure step name

&IMSID

IMS system ID (system ID from DFSVC000)

For example, if you specify DSNAME='HFP.TEST.DB.&AREA' and the area name is AREA123, the resulting data set will be 'HFP.TEST.DB.AREA123'. If you specify DSNAME='HFP.TEST.DB.HFP&AREA4#' and the relative area number is 1500, the resulting data set will be 'HFP.TEST.DB.HFP1500'.