RECEIVE command operands
- USERID(user_id)
- allows you to receive data for a user ID other than your own. The USERID operand is limited to users with OPERATOR authority and to those who are authorized through the RECEIVE initialization exit (INMRZ01). The user ID might exist in SYS1.UADS at the target node or might be a non-existent user ID.
- INDDNAME(ddname) | INFILE(ddname)
- specifies the use of a preallocated file as the input data set
to receive the transmitted data. Define the data set with RECFM=F,
FB, V, VB, or U. For F and FB, LRECL=80. The remaining DCB attributes
are installation dependent.
Specify the data set as either sequential or partitioned, but it must be the same as that specified for OUTDDNAME or OUTFILE of the TRANSMIT command. INDDNAME and INFILE are primarily intended for system programmer use.
- INDSNAME(dsname) | INDATASET(dsname)
- specifies the use of a sequential data set as the input data set
to receive the transmitted data. Define the data set with RECFM=F,
FB, V, VB, or U. For F and FB, LRECL=80. The remaining DCB attributes
are installation dependent.
If you specify INDATASET or INDSNAME with RECEIVE, the transmitted data is not logged and no acknowledgment is sent to the originator. If you do not specify INDATASET, the transmitted data is logged into the log entry and an acknowledgment is sent to the originator.
Use INDSNAME and INDATASET in combination with OUTDSNAME and OUTDATASET operands of the TRANSMIT command. INDSNAME and INDATASET are primarily intended for system programmer use.
- PARM(parameter_string)
- You can be instructed by your installation to use this operand to specify installation dependent data.
- LOGDATASET(dsname) | LOGDSNAME(dsname)
- specifies an alternate name of a sequential data set used to log
the transmitted data. RECEIVE checks if the data set, specified by
the LOGDATASET/LOGDSNAME operand, is a sequential data set. However,
RECEIVE does not check whether the data set attributes are RECFM=VB,
LRECL=255, and BLKSIZE=3120. If the data set does not exist, the system
creates it.
If you specify NONAMES with LOGDATASET or LOGDSNAME, the system does not search the NAMES data set.
- DISPLAY | NODISPLAY
- DISPLAY
- specifies that the transmitted data or message is to be displayed
at the terminal. The system normally displays the data or messages
that are transmitted according toone of the following operands of
the TRANSMIT command:
- MSGDATASET or MSGDSNAME
- MSGDDNAME or MSGFILE
- MESSAGE or MSG
- TERMINAL
The system places the message or name of the transmitted data set in the log data set. DISPLAY is the default.
- NODISPLAY
- specifies that the transmitted data or message is not to be displayed
at the terminal. The system normally displays the data or messages
that are transmitted according to one of the following operands of
the TRANSMIT command:
- MSGDATASET or MSGDSNAME
- MSGDDNAME or MSGFILE
- MESSAGE or MSG
- TERMINAL
The system places the data or message in the log data set.
- NAMES | NONAMES
- NAMES
- specifies that RECEIVE search and resolve the NAMES data set for
a matching node and user ID of the user who transmitted the data or
message. If the nickname and name of the user are found, RECEIVE
places the nickname, name, user ID, and node into the log data set.
If the nickname and name are not found, RECEIVE places only the user ID and node into the log data set. All other NAMES data set processing remains the same. For more information about the NAMES data set, see NAMES data set function under the TRANSMIT command. NAMES is the default.
- NONAMES
- specifies that the nickname and name of the user who transmitted
the data or message are not to be resolved. RECEIVE places only the
node and user ID in the log data set. All other NAMES data set processing
remain the same. For more information about the NAMES data set, see NAMES data set function under the TRANSMIT command.
If you specify NONAMES with LOGDATASET or LOGDSNAME, the system does not process the NAMES data set.