The RECEIVE command picks the first file that has been transmitted to you, displays descriptive information about the file, and prompts you for information to control the restore operation. You can choose to accept the default data set name (the original data set name with the high-level qualifier changed to the receiving user's TSO/E prefix) and space information or you can override any of these defaults. RECEIVE creates the data set if it does not exist. You can specify a disposition (OLD, SHR, MOD, or NEW) to force a particular mode of operation. If the data set is successfully restored, RECEIVE continues with the next file. If requested by the sender, RECEIVE generates a notification of receipt and transmits it back to the sender. This return message contains routing and origin information, the name of the data set transmitted, the original transmission sequence number, and an indication of whether the receive was successful. If an error occurred, the message number of the error is included.
You can also use RECEIVE to retrieve Office Vision notes. However, an acknowledgment is not transmitted to the sender of the Office Vision note. Receipt notification is the default for any addressee entered individually on the TRANSMIT command, but not for addressees derived from distribution lists. If you want to be notified for addressees on distribution lists, you must specify :NOTIFY on the distribution list in the control data set or specify NOTIFY(ALL) on the TRANSMIT command.
You can use the RECEIVE command to receive network data (data that was not sent by the TRANSMIT command). The default LRECL for network data is 251 bytes. If you need to receive network data with an LRECL greater than 251 bytes, you must use a data set with an LRECL greater than 251 bytes.