ADSN

Use the ADSN keyword to specify an area data set name.

Use

ADSN is a required keyword for the REGISTER subcommand.

Note

If you do not use the ADSN keyword the following error message is generated:

BMC115556E DPCDI,DPCDIB0: Required DBRC Registration information not found for output area. Predefine area information to DBRC or use the REGISTER subcommand

Related keyword

DSNAME

Syntax

ADSN=<parameter>

Parameters

Specify a 1-character to 64-character data set name. Enclose the name in single or double quotation marks. Use the following variables, as necessary, to create a mask for the name:

Variable	Description
&ADDN	Area ddname
&AREA	Area name
&AREA#	Secify 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
&LCLDATE	Current date ('Dyyddd') in local form
&LCLTIME	Current time ('Thhmmss') in local form
&PROCSN	Procedure step name
&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