z/OS V1R9.0 TSO/E Command Reference

RECEIVE Commandalso supported. RECEIVE does not support data sets with keys, ISAM data sets,VSAM data sets, or data sets with user labels.Receiving PDSE data setsRECEIVE supports PDSE Data Libraries and PDSE Program Libraries. Dependingon the user’s specifications and on the level of MVS/DFP or DFSMS, conversionbetween PDSEs and PDSs, and PDSs and PDSEs, are performed implicitly.Program Objects which are executable programs stored as members of a PDSEProgram Library, are subject to some restrictions when conversions to other dataset types are attempted. When executing the TRANSMIT and RECEIVE commands,these restrictions prevent invalid Program Objects from being accepted.When a PDS or PDSE is sent with the TRANSMIT command, the IEBCOPY utilityfirst copies the data set to an intermediate sequential file. Control information isadded and the data set is sent. When it is received, the control information is usedto determine the characteristics of the original data set so that a new data set canbe allocated with the proper size and of the same type. IEBCOPY is then used toreload the PDS or PDSE. Since there are restrictions when receiving ProgramObjects, the receiving terminal user gets assistance by means of a message aboutthe data set characteristics of the incoming file. The user is then asked to enter therestore parameters.The figure later in this section shows all combinations of source and target datasets and how they are handled by TRANSMIT and RECEIVE.Table 39. Combinations of source and target data setsSOURCESequentialFilePDSOutput datasetSequentialFileSequentialFileSequentialFile *Data Library SequentialFile *ProgramLibraryOutput datasetOutput datasetTARGETOutput datasetPDS Data Library ProgramLibraryPDSmemberData LibrarymemberINMR155INo output data set specifiedPDSE is fullysupportedSequentialFileOnly DataLibrary issupportedSequentialFilePDS Data Library INMR156I PDS PDS PDSPDS Data Library INMR157I Data Library Data Library PDSINMR158I INMR158I INMR158I ProgramLibrary* PDS member or Data Library member was transmitted with the SEQ option.INMR15xI is the error message number resulting from the user request.ProgramLibraryINMR159IPDSE is notsupportedSequentialFileINMR159IReceiving protected data setsRECEIVE warns you if you are receiving a data set that was RACF or PASSWORDprotected. It takes no further action to protect newly restored data. If you are usingthe automatic data set protection feature of RACF or a RACF generic profile, thedata set is protected. Otherwise, use the PROTECT command or the RACFADDSD command to protect the data.252 z/OS V1R9.0 TSO/E Command Reference