INPUT_DSN_MASK

Use the INPUT_DSN_MASK keyword to specify a data set name or mask for use when dynamically allocating pre-existing input data sets.

To allocate the VSAM area data set or image copy data set to be used as input, use INPUT_DSN_MASK with one of the following commands:

ANALYZE
BUILD
CHANGE
DMAC_PRINT
EXTRACT
INITIALIZE
PFPSORT
PROCESS_AREA
REORGANIZE
UNLOAD
VERIFY

To allocate the input (UNLOAD) data set, use INPUT_DSN_MASK with the RELOAD or PFPSORT command. You can refer to a relative generation of a GDG by including it in the mask, such as in ‘gdg-name(-2)’. The relative generation number that you specify must be 0 or less. If you refer to a GDG name without specifying a relative generation number, the product automatically appends a relative generation of 0.

Use

INPUT_DSN_MASK is an optional keyword for the following commands and subcommand:

ANALYZE
BUILD
CHANGE
DMAC_PRINT
EXTEND
EXTRACT
INITIALIZE
PFPSORT
PROCESS_AREA
RELOAD
REORGANIZE
UNLOAD
VERIFY
XSCAN

Note

This keyword applies to processing in offline mode only. It is ignored during online and BMP processing.

Syntax

INPUT_DSN_MASK='parameter'
INPUT_DSN_MASK='LATEST_BATCH_IMAGECOPY'

Parameters

Specify a data set name. If the data set name contains special characters, enclose the name in single quotes.

To use the most recent image copy data set that is available in DBRC, specify LATEST_BATCH_IMAGECOPY. The following requirements must be met to use this parameter:

DBRC must be active.
The image copy data set must be batch and standard (use the sequential access method). (Concurrent image copies are ignored.)
The image copy must be marked as valid in DBRC.

Masks for data set names

Use the following variables, as necessary, to create the mask.

Variable	Description
&ADDN	The area DD name registered to DBRC or the AREA name if not registered.
&AREA	Use the 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#	Use the 4-digit area number.
&AREA5#	Specify the area number as 5 digits.
&DATE	Current date ('Dyyddd') in its default form (local or UTC).
&DBD	Use the DBD name.
&IMSID	IMS subsystem ID (actual IMS subsystem ID if online; subsystem ID from DFSCV000 if offline).
&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	INPUT_DSN_MASK=’PFPTEST.DB.&AREA’	PFP.TEST.DB.A123
26	INPUT_DSN_MASK=’PFPTEST.DB.PF&AREA#’	PFP.TEST.DB.PF026
26	INPUT_DSN_MASK=’PFPTEST.DB.PF&AREA4#’	PFP.TEST.DB.PF0026
26	INPUT_DSN_MASK=’PFPTEST.DB.PF&AREA5#’	PFP.TEST.DB.PF00026
1024	INPUT_DSN_MASK=’PFPTEST.DB.PF&AREA#’	PFP.TEST.DB.PF01024
1024	INPUT_DSN_MASK=’PFPTEST.DB.PF&AREA4#’	PFP.TEST.DB.PF1024
1024	INPUT_DSN_MASK=’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

IDM