TSO COMMAND RECEIVE TSO COMMAND RECEIVE Author: TSO/E formatted on 1995/04/01 06:54 for assistance contact: SysTech Group NICKNAME, RECEIVE, TRANSMIT are TSO commands -------------------------------------------------------------------------------- CLIST NAME. RECEIVE users. Transmission of datasets and messages type. TSO command resides in SYS1.LINKLIB -------------------------------------------------------------------------------- RECEIVE RECEIVE (XMIT) datasets and/or messages -------------------------------------------------------------------------------- related TRANSMIT (XMIT) -------------------------------------------------------------------------------- -------------------------------------------------------------------------------- The TSO/E Interactive Data Transmission Facility RECEIVE command allows you to obtain files transmitted to your userid. The RECEIVE command queries the Job Entry Subsystem (JES) on your behalf to determine if there are any files for your TSO userid. If there is at least one file, the RECEIVE command will obtain the file from JES and then display descriptive information about the file. You will then be prompted for information to control the RECEIVE operation. You may choose to accept the default dataset name (the origin dataset name with your prefix replacing the sender's userid) and space information by simply pressing the key marked ENTER. You may also specify overriding parameters as described later on. After you have successfully received a file, the RECEIVE command will continue processing with any remaining files. If requested by the sender, a no- tification of receipt, by you, and the success of your RECEIVE command process- ing will be transmitted back to the sender. If the RECEIVE command detects that the file obtained from JES was enciphered by the Interactive Data Transmission Facility TRANSMIT command, it will automat- ically attempt to decipher the data. In order to do this, you will be prompted for decipher options which will be passed to the Access Method Services REPRO command. The RECEIVE command will request that JES retain the file until you successfully receive or delete it. If the RECEIVE command detects any errors while processing a file, the RECEIVE command will automatically retain the file. In cases where the error is related to JES, the RECEIVE command will prompt you to retain the file. The format of the RECEIVE command is RECEIVE USERID(userid) PARM(string) INDATASET(dsname)/INDSNAME(dsname)/ INDDNAME(ddname)/INFILE(ddname) The RECEIVE command will prompt you for additional parameters after obtaining a file from JES. If you do not specify any parameters, they will be defaulted or obtained from the control records transmitted with the data. The optional parameters which you may specify are BLKSIZE(size) DATASET(dsn) / DSNAME(dsn) DIRECTORY(blocks) NEW/OLD/MOD/SHR PARM(parameter strings) RELEASE RESTORE / RESTORE(LOG) / COPY / DELETE / END SPACE(primary secondary) SYSOUT(sysoutclass or *) TRACKS / CYLINDERS / BLOCKS(size) UNIT(unitname) VOLUME(volser) Defaults TRACKS NOPREVIEW RESTORE USERID The USERID operand of the RECEIVE command is the TSO USERID for which files are to be received. You may specify this operand, however, the RECEIVE command will verify that you have TSO OPERATOR command au- thority before requesting files from the Job Entry Subsystem. If you do not have TSO OPERATOR command authority and wish to receive files for another TSO USERID, your installation can provide this function through one of the RECEIVE command installation exits. PARM You may specify a character string to be passed to your installa- tion's exit routines. If the parameter contains blanks or other spe- cial characters, you must enclose the string in quotes. Normally, you will only supply a parameter string value if indicated by your installation support personnel. This parameter value only has mean- ing to your installation's exit routines. INDATASET You may request that the RECEIVE command obtain its input from a da- taset rather than the Job Entry Subsystem (JES). This keyword is in- tended to be used in conjunction with the TRANSMIT command OUTDATASET/OUTDSNAME/OUTFILE/OUTDDNAME keyword. It will generally be used by your installation support personnel. -- INDDNAME is not of any practical use; it is restricted to local system use only. INDSNAME You may request that the RECEIVE command obtain its input from a dataset rather than the Job Entry Subsystem (JES). This keyword is intended to be used in conjunction with the TRANSMIT command OUTDATA- SET/OUTDSNAME/OUTFILE/OUTDDNAME keyword. It will generally be used by your installation support personnel. -- INDDNAME is not of any practical use; it is restricted to local system use only. INDDNAME You may request that the RECEIVE command obtain its input from a file allocated during your TSO session rather than from the Job Entry Subsystem (JES). This keyword is intended to be used in conjunction with the Interactive Data Transmission Facility TRANSMIT command OUT- DATASET/OUTDSNAME/ OUTDDNAME/OUTFILE keyword. It will generally be used by your installation support personnel. -- INDDNAME is not of any practical use; it is restricted to local system use only. INFILE You may request that the RECEIVE command obtain its input from a file allocated during your TSO session rather than from the Job Entry Sub- system (JES). This keyword is intended to be used in conjunction with the Interactive Data Transmission Facility TRANSMIT command OUTDATA- SET/OUTDSNAME/ OUTDDNAME/OUTFILE keyword. It will generally be used by your installation support personnel. -- INDDNAME is not of any practical use; it is restricted to local system use only. DATASET You may specify the name of the data set to used to contain the file being received. This dataset will be created if it does not exist. The dataset name will default to the name of the transmitted data set (the sender's userid will be replaced with your userid). If this de- fault data set already exists and is a sequential data set and you have not specified a disposition (SHR/MOD/OLD/NEW), then RECEIVE will prompt you for your permission to overwrite the data set. If the de- fault data set is a partitioned data set, then identically named mem- bers be automatically replaced. DSNAME You may specify the name of the data set to used to contain the file being received. This dataset will be created if it does not exist. The dataset name will default to the name of the transmitted data set (the sender's userid will be replaced with your userid). If this de- fault data set already exists and is a sequential data set and you have not specified a disposition (SHR/MOD/OLD/NEW), then RECEIVE will prompt you for your permission to overwrite the data set. If the de- fault data set is a partitioned data set, then identically named mem- bers be automatically replaced. UNIT You may specify a unit type for the output data set to reside on. If you do not specify this keyword, your installation default unit spec- ification will be used. VOLUME You may specify the volume serial number of the device that you wish the output data set to reside on. The default for this value to let your system select a volume as defined by your installation's unit name value. SPACE You may specify primary and optionally secondary space for the data set in which you are about to receive the file from the Job Entry Subsystem. The default value for SPACE is a primary size equal to the size of the data set you are about to receive and a secondary size value 10 percent of the primary space allocation. TRACKS If you enter this keyword, you are requesting that the space allo- cation be in tracks. The capacity of the track is dependent on the device type that you select. CYLINDERS If you enter this keyword, you are requesting that the space al- location be in cylinders. The capacity of the cylinder is dependent on the device that you select. BLKSIZE If you enter this keyword, you are requesting that the space allo- cation in unit of the blksize value. RELEASE You may request RECEIVE to release any unused space associated with the data set just received by specifying this parameter. DIRECTORY You may override the number of directory blocks for a partitioned data set by specifying this parameter. The default value for the DI- RECTORY keyword is the number of directory blocks required to receive the transmitted members. NOTE If you are receiving a sequential data set as a NEW partitioned data set, DATASET(x(member01)), and you do NOT specify the DIRECTORY keyword, the RECEIVE command assumes a default directory block value of 27. BLKSIZE You may specify the blocksize to be used when receiving the input file from the Job Entry Subsystem. Your value will be used as long as it does not conflict with the existing data set characteristics or device type characteristics. NEW/OLD/MOD/SHR You may specify the disposition to be used for the data set you are receiving into. If you DO NOT specify one of these values AND you also DID NOT specify the SPACE keyword, RECEIVE will first assume that the data set exists. If the RECEIVE command determines that the data set does not exist, the data set is allocated NEW with the space values of the original data set. PARM You may specify a character string to be passed to your installa- tion's exit routines. If the parameter contains blanks or other spe- cial characters, you must enclose the string in quotes. Normally, you will only supply a parameter string value if indicated by your installation support personnel. This parameter value only has mean- ing to your installation's exit routines. SYSOUT You may specify a SYSOUT class which will be used for messages from utility programs invoked by the RECEIVE command (e.g. IEBCOPY). If you specify an "*" for this value, all utility messages will be sent to you at the terminal. The default is "*", however your installa- tion may modify this value in the INMXPARM installation parameter CSECT. PREVIEW You may request the RECEIVE command to display the data at your ter- minal as it is being restored to the data set. Please note that when PREVIEW is specified when receiving a partitioned data set what you will see is the unloaded dataset before RECEIVE has invoked IEBCOPY to restore it to its original format. NOPREVIEW You may request the RECEIVE command not to display the data on your terminal as it is being received by specifying the NOPREVIEW keyword. NOPREVIEW is the DEFAULT. COPY You may request the RECEIVE command to copy the file in its trans- mission format into the named dataset by specifying this keyword. You may then use the RECEIVE INDATASET keyword to restore the data in its original format at a later time. NOTE This option is intended mainly as a debugging aid for use by your installation support personnel. RESTORE You may request the RECEIVE command to restore the file in its ori- ginal format into the named dataset dataset by specifying this keyword. RESTORE is the DEFAULT. RESTORE(LOG) You may request that the file be restored to its original format and written to the appropriate log. You will also PREVIEW the data at your terminal as it is being written to the appropriate log. You may not specify the DATASET or DSNAME parameter when you specify RESTORE(LOG). DELETE You may request RECEIVE to delete the current file without any fur- ther processing by specifying this keyword. You may or may not con- tinue processing at this time depending on whether or not the RECEIVE command has determined the availability of any more Interactive Data Transmission Facility files. END You may request RECEIVE to end its processing immediately, leaving the any Interactive Data Transmission Facility files available to the Job Entry Subsystem for later processing by you. -------------------------------------------------------------------------------- This material was gathered together by use of the following clists: @STRAPQ HELP RECEIVE @CAPSCR PLICHK @SCRPTDU