RECEIVE command prompt parameters

Default values for other keywords are specified with the keyword below.

DATASET(dsname)|DSNAME(dsname)

specifies the name of the data set to be used to contain the received data set. If it does not exist already, the system creates it.

If DATASET and DSNAME are omitted, then RECEIVE uses the name of the transmitted data set, with the high-level qualifier changed to the user ID of the receiving user. If this data set already exists, is a sequential data set, and disposition (SHR/MOD/OLD/NEW) was not specified, RECEIVE prompts you for permission to overwrite the data set. If the data set is partitioned, you are prompted to replace duplicate members.

UNIT(unit_name)

specifies a unit name for a new output data set. The default value for UNIT is your normal TSO/E unit name.

VOLUME(volser)

specifies a specific volume serial number for a new output data set. The default value for VOLUME is no value, allowing the system to select a volume from those defined by your unit name specified on the UNIT keyword.

SPACE(primary,secondary)

specifies primary and secondary space for the received data set. The default value for SPACE is a primary size equal to the size of the incoming data and a secondary size of approximately 25 percent of the primary. If the disposition MOD is used, and the data set is not yet allocated, the system defaults are used to obtain the SPACE parameter defaults.

TRACKS

specifies space to be allocated in tracks. TRACKS is the default when SPACE is specified.

CYLINDERS

specifies space to be allocated in cylinders.

BLOCKS(size)

specifies space to be allocated in blocks of the specified size. BLOCKS is the default when SPACE is not specified.

RELEASE

specifies unused space to be released when the receive operation is complete.

DIRECTORY(blocks)

specifies an override for the number of directory blocks in a partitioned data set. The default value for DIRECTORY is the number of directory blocks required for the received members.

If a sequential data set is being received into a new PDS by specifying DA(X(MEM)) and DIRECTORY is not specified, the default value for directory blocks is 27.

BLKSIZE(size)

specifies a value for the block size of the output data set. This value is used, if it does not conflict with the received data set parameters or device characteristics. BLKSIZE is ignored if specified in response to prompting message INMR907A Enter COPY parameters.

NEW | OLD | MOD | SHR

specifies the data set disposition. If you do not specify one of the disposition keywords and the SPACE value is not present, RECEIVE first tries disposition OLD and attempts to allocate an existing data set. If this fails, disposition NEW is used, space values are added, and another attempt is made at allocation.

PARM(parameter string)

Your installation may instruct you to use this operand to specify installation dependent data.

SYSOUT(sysout_class | *)

specifies a SYSOUT class to be used for messages from utility programs the RECEIVE command invokes (such as IEBCOPY). If * is specified, these messages are directed to the terminal. The default for SYSOUT is normally *, but this might be changed by the installation.

PREVIEW | NOPREVIEW

PREVIEW: specifies the received data should be displayed at the terminal as it is stored. This is generally appropriate only for sequential data sets because what is displayed is the result of the first pass at restoring the data. For partitioned data sets, the IEBCOPY unloaded format is displayed.
NOPREVIEW: specifies no previewing is to be done. NOPREVIEW is the default.

RESTORE | RESTORE(LOG) | DELETE | END

RESTORE: specifies the transmitted data should be restored to its original format. RESTORE is the default.
RESTORE(LOG): specifies the transmitted data should be restored to its original format and written to the appropriate log. It is also previewed to the terminal, but it is not written to another data set. You cannot specify RESTORE(LOG) with the DATASET or DSNAME operand. You need to use RESTORE(LOG) primarily to RECEIVE a message and log the message text in the log entry.
DELETE: specifies the file be deleted without restoring it.
END: specifies the RECEIVE command terminate immediately, leaving the current data set on the spool to be reprocessed at a later time.

COPY

specifies not to restore the transmitted data to its original format, but copy it ‘as is’. At a later time you can specify RECEIVE INDATASET to restore the data. COPY allows you to examine the data in its transmitted form so that you can debug problems when RECEIVE cannot process the transmitted data. It is primarily intended for system programmer use.

MGMTCLAS(management_class_name)

With Storage Management Subsystem (meaning Storage Management Subsystem is installed and is active), specifies the name, 1 to 8 characters, of the management class for a new data set. When possible, do not specify MGMTCLAS. Instead, use the default your storage administrator provides through the automatic class selection (ACS) routines.

After the data set is allocated, attributes in the management class control the following:

The migration of the data set, which includes migration from primary storage to Data Facility Storage Management Subsystem Hierarchical Storage Manager (DFSMShsm) owned storage to archival storage.
The backup of the data set, which includes frequency of backup, number of versions, and retention criteria for backup versions.

Note: Without Storage Management Subsystem, the system syntax checks and then ignores the MGMTCLAS operand.

STORCLAS(storage_class_name)

with Storage Management Subsystem, specifies the name, 1 to 8 characters, of the storage class. When possible, do not specify STORCLAS. Instead, use the default your storage administrator provides through the automatic class selection (ACS) routines.

The storage class replaces the storage attributes that are specified on the UNIT and VOLUME operand for non-Storage Management Subsystem managed data sets.

A "Storage Management Subsystem-managed data set" is defined as a data set that has a storage class assigned. A storage class is assigned when you specify STORCLAS or an installation-written ACS routine selects a storage class for the new data set.

Note: Without Storage Management Subsystem, the system syntax checks and then ignores the STORCLAS operand.