Home

User Manual - ServiceNet

1. rvsMVS User Manual Appendix B Transmissions of Partitioned Datasets PDS e The PDS at the sending station must have fixed or variable record length but not undefined like load module libraries e When queuing a dataset for sending the Rename function will be used The name that is specified as DSNOLD parameter applies to the sending PDS member in the following form pdsname member Under this circumstances the transmitted PDS member is treated as sequential dataset at the receiving station In this case the PDS Transfer Function is only a local function at the sending station this means the receiving station does not get any information whether a PDS member or a sequential dataset has been transmitted For this reason the exceptional rules for PDS transfer at the receiving station are not valid here Note Whether a PDS member has been transmitted as sequential dataset or as member depends only besides the record format of the dataset on the syntactical form of the parameters DSN and DSNOLD Example for the specified control parameters SID ST2 DSN DXX ST1ST2 A200 DSNOLD SYS1 PDS2 T22 DEVR DISK B 3 Description of the procedure of PDS Transfer This chapter describes the transmission procedure from the queuing to the complete reception of a PDS These informations may be useful for solving problems especially when errors have occured B 3 1 Queuing for Sending Already when queuing a PDS member of
2. gt REMOTE STATION 2 DSN eee ae m in Mee HL M EE DATASET NAME EE EE EE ONLY IF THE DATASET SHALL BE RENAMED AFTER RECEIVING 4 ACCT gt ACCOUNT NUMBER 5 SYMBOLIC UNIT gt NAME OF SYMBOLIC UNIT GROUP 6 VOLUME SSS oues ONLY IF SPECIAL VOLUME IS WANTED 7 DEVICE TYPE gt D DISK T TAPE 8 GDG I TRANSFORM DATASET INTO GDG Y YES N NO 9 STAMPS gt N NONE T TIMESTAMP D DATESTAMP B BOTH 10 REPLACE gt REPLACE OF SEQ DATASET Y YES N NO 11 JOB m eee Te popa Coy ROT PEEL ere teme e sey PEED OER aaepe ds e repe eer ep uem EOS AUTOMATIC JOBSUBMIT AFTER RECEIVING SPECIFY COMPLETE DATASET AND MEMBERNAME CONTAINING THE JCL TO BE SUBMITTED Remarks to the Entry Fields The entry fields ACCT SYMBOLIC UNIT and DEVICE TYPE may already contain values during calling this format These values depend on the specific rvs installation The entry fields are not described in detail in this section The meaning of the parameters may be read in Chapter A 3 of this manual The names of the entry fields in the screen formats agree mostly with suitable parameters described in Chapter A 3 By insertion of a Y in the field DISPLAY FURTHER OPTIONS the screen on next page will be displayed 19 rvsMVS User Manual 2 rvs ISPF Panels kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk DEA2O0POO kx kx x x ehe e e e e e e ke e ke ke e ke ke e ke ke e ke ke ke ke kk x RVS CREATE RESIDENT RECEIVE
3. 5 c tg ao eame 47 56 Transmissions CD C EE 58 RI O 15 GDG Doatasets essere 33 Transmitted Datasets OED eco RR Seege 11 46 EE 36 How to use EXTERNAL SECURITY 41 TSTAMD s ceenceemeenpenenenenued 51 59 ISPF Panels 2 2 tee merit etc is 8 HNR isnCG neret ene EUR eA e 57 JOB rea ebessen orbes 10 52 56 UNITREMO TE 48 JSSEV ENT ee ient etus 52 60 User Abends 1 neon er e oe ER eet 66 JSSEVTNM uote eise 52 60 VOLREMO TE 48 80 rvsMVS User Manual Index VOEUME erp E RUE 46 54 81
4. All these specifications will be only considered by the rvs Monitor of the receiving station if the sending station is authorized for using this specifications see remarks related to the parameters 15 through 19 of Section 9 2 of this manual Is this authorization missing the above described standard processing will be used see Section 3 1 Additionally the rvs Monitor issues a adequate message In any case an eventually available Resident Receive Entry of the receiving station will be ignored 4 3 Creating of Resident Receive Entries Transmission Control by the Receiving Station Normally the processing of received datasets will be controlled by Resident Receive Entries These records are stored in the rvs control dataset They contain information about how to proceed by rvs after reception of a specific dataset Resident Receive Entries are permanently stored in the rvs control dataset They differ from Send Entries which will be deleted a definite time after transmission The creation of a Resident Receive Entry effects that after reception of a specific dataset with DSN dsname and SID station identification this dataset will be processed as described in the Resident Receive Entry Exceptions Cases described in Section 3 2 The Resident Receive Entry will be ignored in these cases If PDS is received the parameters DEV DISK and DISPZCATLG are always used independently of other values that might be specifie
5. SID ST2 DSN ABC DATEI02 DEV DISK JOB PDS NAME MEMBERS5 The dataset with the DSN ABC DATEI02 received from station SID ST2 will be cataloged on disk DEV DISk after reception Additionally after reception of the dataset a job will be started which is stored in member MEMBERBS of the partitioned dataset PDS NAME 4 SID ST2 DSN ABC DATEI02 DEV DISK JOB PDS NAME MEMBERS5 DSNNEW XYZ T5 As example 3 but the dataset to be received DSN ABC DATEIO2 will be cataloged under the new dsname XYZ T5 5 SID ST1 DSN ABC DATEI01 DEV DISK GDG YES Same as example 1 except that the dataset to be received will be handled as a GDG This requires the definition of a GDG with base name ABC DATEI01 see IDCAMS command DEFINE GDG 6 SID ANY DSN ABC DATEI01 DEV DISK This resident entry becomes active when the dataset ABC DATEIO1 is received independently of the sender 31 rvsMVS User Manual 4 Receiving Datasets 4 3 1 Messages issued when creating Resident Receive Entries The program DF080A00 issues messages on SYSPRINT for every creation of a Resident Receive p m of the parameters entered via SYSIN and e Messages about the executed action During successfully creation of the entry the message RECORD ADDED TO DATASET respectively RECORD REPLACED IN DATASET appears depending on a new creation of the Resident Receive Entry or a replacing of an existing Receive Entry In case of an unsuccessful
6. lt 23 59 Default is the actual time STRTDATE or actual day default STRTDATE 9 or range 0 lt strtdate lt 9 STRTDATE 999 range 001 lt strtdate lt 365 Earliest sending date if the day number 999 lower than the actual day number next year is assumed SENDWIN The parameter specifies the interval to start the transmission Possible values are 00 00 to 24 00 CODETRNS Code translation when a file is received this parameter is also valid for code translation within the ODETTE File Transfer Protocol FORMAT TEXT YES a code translation is done from EBCDIC to ASCII code translation table Installation Manual Chapter 6 11 NO no code translation is done 12 rvsMVS User Manual 2 rvs ISPF Panels Also any code translation may be done by using system defined tables These tables are maintained by your rvs system programmer See also Installation Manual Chapter 6 11 From version rvsMVS 2 5 10 is not any necessity to specify the parameters S The control whether the Security Compression feature program is used is based on rvsMVS license key and the parameters SECURITY COMPRESS in station Entry Parameter S should only be use gives necessity to use of the parameters SECURITYZzNO and or COMPRESS NO By specifying a S in the field DISPLAY FURTHER OPTIONS of screen DF100P00 the following screen will be displayed kkkkkkkkkkkkkkkkkkkkkkk kkkk kkkkkkxkxkxkk DF120P00 kkkkkkkkkkkkkkkkkkkkkkk kkkk k
7. or for all datasets starting with your userid The specification of this field is optional Remarks After entering appropriate values on the following screen either e a confirmation for deleting will be required if only one send entry with the specified values exists or e all send entries will be indicated which fulfill the selection criteria SID DSN The deletion of one or more send entries can be executed by entering a D in front of the displayed entry Important A send entry can only be deleted by the TSO user userid who has queued the dataset for sending Hints The deletion of a send entry is not possible if the transmission of the dataset has already been started In this case the transmission can only be interrupted by the rvs operator rvsMVS User Manual 2 rvs ISPF Panels 2 4 Option 4 Creating Resident Receive Entries The function of Resident Receive Entries is described in Chapter 3 3 of this manual After selecting option 4 the following screen will be displayed kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk DEAOOPOO x kx x x e c e ec e e e e e ke e ke ke e ke ke ke ke ke e ke ke ke ke ke x RVS CREATE RESIDENT RECEIVE ENTRY c e e e e e e e e e e e e e e e e e de e de e de de de de e ede de de de e de de ede e de e de de de ede dede ede dee eee eee eee eee ce e e e e e ke ke kx kx kx kx x COMMAND gt SPECIFY PARAMETERS BELOW DISPLAY FURTHER OPTIONS gt Y YES N NO 1 SID
8. 8 SYSOUT x or SYSOUT x pppp or SYSOUT x ffff This parameter may be specified if the received dataset shall be placed in a sysout class Hints SYSOUT is ignored when Parameter JOB is used at the same time DEVICE DISK is set as default D describes the sysout class length 1 byte alohanumeric pppp describes a sysout program name length 8 bytes alphanumeric With this you can reach that the data will be processed with a special output writer pppp 56 rvsMVS User Manual Appendix A Control parameters of program DF080A00 IT describes the form number length 4 bytes alphanumeric The form number will be used if the data from a special sysout class shall be printed on a special formular Hints Sysout class sysout program name and form number must be generated in your own rvs installation Default value NONE 9 COPIES n Abbreviation CO Specification about the number of copies that shall be made while printing from a sysout class n specifies the total number of samples to be printed 1 to 99 This parameter may only be specified in connection with the SYSOUT parameter Default value NONE 10 DESTzdest dest is the name of a RJE station max 6 characters This is the destination of the received data This parameter may only be used in connection with the SYSOUT parameter Default value NONE 11 FREE R The specification of this parameter effects the deletion of a Resident Rec
9. DATASET v nos EARLIEST STARTDATE gt 00 00 24 00 TIME WINDOW FOR SENDING HH MM HH MM 095990958 CODE TRANSLATION YES NO OR NAME OF TABLE RVS TRANSMISSION OF A DATASET SEND e e e e e e e e ee e de e de oe de de de e de de e de de e de e de de de de de e de ede e e de de de de de dede de dede e eee eee eee eee ecce eee e e ke ke ke ke kx kx kx x COMMAND gt SPECIFY PARAMETERS BELOW 9 WRITE EVENT N Y YES N NO SUBSYSTEM ID gt Lake WRITE EVENT TO JSS AFTER TRANSMISSION 10 DDNAME SSS a cae DD NAME OF DATASET INSTEAD OF DS NAME 11 HOLD 2 Y YES N NO 12 SYSOUT CIT TN RU M SYSOUT CLASS COPIES al ONLY IF SYSOUT CLASS IS SPECIFIED DESTINATION gt ONLY IF SYSOUT CLASS IS SPECIFIED 13 RJE SEET A sr ed Y YES PTR NOT SUPPORTED BY ALL STATIONS 14 FORMAT gt T TEXT ONLY IF ODETTE PROTOCOL IS USED 15 SERIAL gt Y YES N NO SERIALIZE SENDING OF DATASETS 16 STAMPS gt T ADD TIMESTAMP TO DSN D DATESTAMP B BOTH M PF1 PF13 HELP PRESS END KEY TO TERMINATE Remarks to the entry fields WRITE EVENT Y N Selection whether an event is written after sending the dataset or not If Y is specified a job submit is not possible rvsMVS User Manual 2 rvs ISPF Panels SUBSYSTEM ID Name of job scheduling subsystem e g OPCE the event is routed to If this parameter is omitted the corresponding rvs start parameter is used If this parameter is not specif
10. DD Statement The rules for coding the control parameters and the control parameters itself are described in the appendix of this manual chapter 9 1 and 9 2 3 1 Creating Send Entries queuing for sendin The following JCL may be used to queue datasets for sending ABC JOB SEND EXEC PGM DFO080AO00 STEPLIB DD DSN rvs LOADLIB DISP SHR SYSPRINT DD SYSOUT STATIONS DD DSN rvs TABLES STATIONS SYSIN DD Control Parameter Cards The Control Parameter Cards must contain all specifications of the datasets to be sent Mandatory parameters are the dsname of the dataset to be transmitted DSN respective DSNOLD parameter as well as the rvs station identification SID parameter where the dataset shall be sent to Examples Control Cards entered under SYSIN Examples 1 through 5 apply to sequential datasets examples 6 through 9 apply to PDS or members of PDS Examples for sending GDG datasets you will find in Chapter 4 1 SID ST1 DSN ABC DATEI01 The cataloged dataset with the DS name ABC DATEIO1 is to be sent to the rvs station ST1 Because of the fact the DISP parameter has not been specified the default value will be efficient KEEP After queuing for transmission the dataset remains cataloged After the complete transmission the dataset will not be deleted 1 The queuing of datasets is also possible with the ISPF panels see Chapter 1 This statement used for the allocation of the stations tab
11. DF180A in field F1 CALL DF180A F1 CALL OF DF180A LTR 15 15 ACTION OK BZ sens YES F1 DC H 23 LENGTH OF CONTROL PARAMETERS 23 DC CL23 SID ST3 DSN ABC DATEIO1 CONTROL PARAMETER FOR DF080A00 Remark The length field need not to indicate the exact length of the given control parameters The following definition could be used as well F1 DC H 80 DC CL80 SID ST3 DSN ABC DATEIO1 Example 2 Call of DFO80A00 within an assembler program In this case the control parameters are passed to DF180A via SYSIN instead of program area CALL DF180A F2 CALL OF DF180A LTR 15 15 ACTION OK BZ iens YES F2 DC H O INDICATION THAT CONTROL PARAMETERS ARE PASSED VIA SYSIN Example 3 Creation of a resident receive entry within an assembler program In this case the control parameters must be passed via SYSIN while the program field passed to DF180A must contain the fixed text RESIDENT 65 rvsMVS User Manual Appendix 0 CALL DF180A F3 CALL OF DF180A LTR 15 15 ACTION OK BZ gre YES F3 DC H 8 LENGTH 8 DC CL8 RESIDENT Remarks If program DF180A is called by an assembler program register 13 must contain the address of a 72 byte savearea The contents of registers 2 13 will not be modified Example 4 Queuing of a dataset for transmission within a COBOL program In this case the control parameters are passed to DF180A in the program field PARMFLD 01 PARMFID 02 LENGTH PIC S9 4 COMP VALUE 60 02 T
12. ERROR SYSPRINT DD STATEMENT MISSING The SYSPRINT allocation is missing The program will end with User Abend 1801 This message is only issued when the program is called under TSO environment ERROR KEYWORD TOO LONG keyword An invalid keyword parameter has been specified too long keyword applies to the first 8 characters of the detected invalid keyword ERROR keyword value INVALID KEYWORD An invalid keyword parameter has been specified keyword value applies to the detected invalid keyword and the specified parameter value ERROR ERROR NEAR PARAMETER keyword An invalid parameter value has been specified e g a not identified station id keyword applies to the keyword of the invalid parameter value ERROR STATION ID SID MISSING The mandatory specification of the station id is missing SID or ORT parameter Without specification of this parameter no modification inserting modifying deleting of records within the Control Dataset can be carried out ERROR NO DSNAME SPECIFIED The mandatory specification of the dsname DSN parameter is missing Without specification of this parameter no modification inserting modifying deleting of records within the Control Dataset can be made Exception When queuing a dataset for sending instead of specifying the DSN parameter the DDN parameter may be specified Then the DS name will be determined with the JFCB of the existing allocation ERROR REQUESTED DDNAME NOT
13. FOUND When queuing a dataset for sending the DDN parameter has been specified but no allocation with the specified DD name can be found The dataset will not be queued for sending ERROR DSNAME CONTAINS INVALID CHARACTERS The DS name DSN parameter does not specified according to JCL rules Impossible if using rename function 71 rvsMVS User Manual Appendix 0 Messages of program DF080A00 ERROR INVALID DEVICE TYPE When queuing a dataset for sending it is determined that the device type where the dataset resides is neither a disk nor a tape But only datasets that reside on this type of device may be queued for sending ERROR REQUESTED JOB DATASET NOT CATALOGED A Resident Receive Entry shall be created changed where the JOB parameter for automatic job start after reception has been specified But the specified dataset PDS where the starting job is located is not cataloged or does not exist Maybe the DS name has not been specified according to JCL rules ERROR TRANSMISSION OF TAPE MULTIVOLUME DATASETS NOT SUPPORTED BY RVS A multi volume tape dataset shall be queued for sending but rvs supports only transmissions of datasets that reside completely on one tape volume Hence the queuing for sending will not be processed ERROR MEMBER SPECIFICATION NOT ALLOWED FOR SEQUENTIAL DATASET A sequential dataset shall be queued for sending but with the DSN or DSNOLD parameter a member name has been specified This is not
14. Insert the at least SID and DSNAME parameter and without select chapter 2 1 S for further options panel DF100P00 __ The rest will be done by rvsMVS automatically 43 rvsMVS User Manual Appendix A Control parameters of program DF080A00 Appendix A Control parameters of program DF080A00 A 1 Rules for coding of control parameters The following rules for coding the control parameters apply for creation or deletion of e Send Entries queuing of datasets for sending e Resident Receive Entries 1 The control parameters must be entered via SYSIN in special cases control parameters may be also entered via the PARM field in the EXEC statement 2 Every statement may use columns 1 through 71 of the record There is no restriction in the number of continuation statements The continuation statements need no continuation character in colume 72 3 The control parameters belonging to a single entry may be coded on one or more statements thus forming a set of parameters A single parameter cannot yet be spanned to another statement 4 The parameter SID sid or SIDLIST dsn must always be the first parameter in a set of parameters belonging to a single entry It must be the first parameter on a statement All other parameters may be specified in any sequence on the set of statements 5 The parameters must be separated by a comma and or one or more blanks 6 One or more entries creation or dele
15. Job will be started depends on what control information at the sending station or at the receiving station has been specified 4 1 Standard Processing In case no control information is available for a received dataset a standard processing starts This standard processing is defined in the start parameters of the rvs Monitor see rvsMVS Installation Manual There are two possibilities e The received dataset remains on disk e The rvs Monitor starts a job that copies the received dataset to tape In both cases the dataset will be cataloged if possible If a dataset with the same name already exists and is cataloged receiving of this file will be rejected Only exceptions Receiving of PDS or use of the GDG function 4 2 Control of Receiving by Sender The sender of a dataset has some possibilities to control the handling and processing of the dataset at the receiving station These possibilities may be e To copy a dataset into a special sysout class at the receiving station eventually with an additional specification of a sysout program name or a form number This procedure will be executed only if no local specifications Resident Receive Entry have been made at the receiving station Is a Resident Receive Entry available only the parameters of this entry will be considered e To copy the received data into the Internal Reader Queue that means the received data will be interpreted as a complete Job which will be p
16. Panels If one or both properties are missing the send request will be changed to the default compression see COMPRESS parameter in station table I you specify COMPRESSION N the external Compression Feature will be not used for this send request By specifying a Y in the field DISPLAY FURTHER OPTIONS the screen described above will be displayed rvsMVS User Manual 2 rvs ISPF Panels 2 2 Option 2 Displaying Transmissions After selecting option 2 the following screen will be displayed kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk DE200P00 d x d dc de de e ok de ok oe de de oe ok de ke ke de e e e e e e e e k k k k RVS DISPLAY OF TRANSMISSIONS tg KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KK KKK KKK KKK KKK kk ke e KKK KKK KKK KEKE KK KKK He de He de ke ke ke ke ke k k COMMAND gt SPECIFY PARAMETERS BELOW 1 DIRECTION gt R RECEIVE S SEND 2 STATION ID gt ID OR INITIAL PART OF ID OF REMOTE STATION LIST OF STATIONS 3 DS NAME FSS o5ceo00od09c cnood oooo o0odoo nbootncoo nooodooodn BLANK OR A PATTERN FOR DATASET SELECTION LIST 4 DAYS gt TRANSMISSIONS DURING LAST UP TO 7 DAYS PF1 PF13 HELP PRESS END KEY TO TERMINATE Remarks to the Entry fields DIRECTION It must be specified whether received datasets R or sent datasets respectively datasets queued for sending S shall be displayed STATION ID Related to received datasets the name of the origin sending sta
17. allowed when processing sequential datasets ERROR DSN MEMBER NOT ALLOWED IF THERE IS NO DSNOLD MEMBER SPECIFIED A sequential dataset shall be queued for sending and the Rename function is used With the DSN parameter besides the dataset name a member name has been specified This is only allowed when a member name has been specified with the DSNOLD parameter too This has not been done ERROR ALLOCATION ERROR xxxx yyyy FOR SEQUENTIAL DATASET ERROR ALLOCATION ERROR xxxx yyyy FOR PARTITIONED DATASET ERROR ALLOCATION ERROR xxxx yyyy FOR TEMPORARY OUTPUT DATASET ERROR ALLOCATION ERROR xxxx yyyy FOR TEMPORARY INPUT DATASET Messages about an unsucessful dynamic allocation of datasets Dynamic allocations are used when PDS or members of a PDS are queued for sending xxxx applies to the errorcode yyyy to the infocode of the wrong allocation These codes e g may be looked up in the IBM manual OS VS2 SPL Job Management Note Appendix C contains a more detailed description of PDS transmission ERROR UNLOAD OF SPECIFIED MEMBER FAILED A member of a PDS shall be queued for sending It is necessary to unload the member into a sequential work dataset this procedure did not end successfully In this case further error messages will be displayed 72 rvsMVS User Manual Appendix 0 Messages of program DF080A00 ERROR SPECIFIED MEMBER NOT FOUND A member of a PDS shall be queued for sending but the member does not exist wit
18. class at the receiving station 9 SYSOUT x or SYSOUT x pppp or 47 rvsMVS User Manual Appendix A Control parameters of program DF080A00 SYSOUT x ffff This parameter may be specified if the dataset to be sent shall be placed in a SYSOUT class at the receiving station x means the SYSOUT class length 1 byte alohanumeric eppp specifies a SYSOUT program name length up to 8 bytes alphanumeric With this you can obtain that the data will be processed with the special output writer pppp Tff means the form number length 4 bytes alphanumeric The form number will be used if the data from one SYSOUT class shall be printed on a special formular Hints e The SYSOUT parameter is only relevant if rvsMVS is installed at the receiving station e SYSOUT class SYSOUT program name and FORM number must be generated at the receiving station In order to avoid mistakes the values specified under SYSOUT should fit for the receiving station Default value NONE 10 COPIES n Abbreviation CO Specification of a number of copies which shall be made during printing from a SYSOUT class n specifies the number of copies to be printed 1 to 99 This parameter can only be used in connection with the SYSOUT parameter Default value NONE 11 DESTzdest dest is the name of a RJE station length 6 characters alohanumeric After complete receiving of data by the rvs station the data will be tansmitted to the R
19. disc dataset name under which the dataset to be received will be allocated see also DBNNEW parameter The name of the dataset to be received must be specified in the same form as it is specified in the JCL that means fully qualified and not included within quotes Length and syntax see chapter A 2 point 2 a Default value NONE the specification is mandatory From rvs MVS 1 2 06 on you can use additional wildcard characters in the name of the dataset in all components using the ODETTE file transfer protocol OFTP The wildcard characters are asterisk and question mark with following meanings TT substitutes 0 44 characters substitutes 1 character exactly Parentheses and cannot be substituted they must be given explicitely 3 DEVICE DISK TAPE abbreviation DEV for DEVICE D for DISK T for TAPE Specification of the device type on which the dataset to be received shall be allocated disc or tape Hints DEVICE TAPE is ignored when Parameter JOB is used at the same time DEVICE DISK is set as default When a PDS is received DEVICE DISK is always used even when another value is specified Default value The default value for the rvs Monitor has been specified in a start parameter and depends on the specific installation see rvsMVS Installation Manual 4 VOLUME volume abbreviation VOL 55 rvsMVS User Manual Appendix A Control parameters of program DF080A00 Specification of a d
20. following parameters are possible DSN name Selecting transmissions which starts with a DSN parameter value of name name may be specified between 3 and 24 characters SID sid or Selecting transmissions from or to rvs station sid ORT ort DAY nnn or Selecting transmissions which took place on day nnn nnn specifies the TAG nnn 3 digit machine date DAY n or Selection of transmissions which have taken place within the last n days TAG n n may be a value between 0 listing for the running day and 364 ZZ nn Maximum number of lines per page After printing this number of lines a skip to next page will be done nn may be a value between 10 an 999 LVL LO L1 L2 Specifies how detailed the information of transmissions which took place shall be listed LVL LO The following informations will be listed Name of the transmitted 37 rvsMVS User Manual 6 Overview of Transmitted Datasets dataset with Rename function both names possible name of transmitted PDS member specifications about the transmission path the accounting number and DCB specifications of the transmitted dataset LVL L1 Additionally to the specifications of LVL LO the following informations will be issued The volume where the dataset resides transmission time informations the number of transmitted data records the dataset disposition and if available remarks LVL L2 Additionally to the specifications of LVL L1 the foll
21. for sending The volume where the dataset resides is determined with the catalog and displayed within the message DEFAULT VALUE DEVICE device FROM SYSTEM CATALOG A cataloged dataset is to be queued for sending The device type DISK or TAPE of the dataset will be determined with the catalog and displayed within the message DATASET HAS BEEN SUCCESSFULLY UNLOADED A partitioned dataset or a member of a PDS is to be queued for sending The necessary unloading of the PDS into a work dataset has been done successfully For the PDS disposition KEEP is always used and disposition DELETE for the work unloaded dataset Note A more detailed description of PDS transfer is given in Appendix C of this manual NUMBER OF USED BLOCKS nn BLOCKSIZE bl USED SPACE mm MIO BYTES A dataset shall be queued for sending Besides the size of the dataset in terms of dataset blocks nn the blocksize bl as well as the size in terms of millions of bytes mm will be displayed DATASET NOT RENAMED RC xxxx yyyyyyyy HEX A dataset with disposition DELETE is to be queued for sending The dataset will be renamed adding a timestamp to the dataset name An error occurred while renaming the dataset xxxx refers to the return code of the CATALOG macro yyyyyyyy to the diagnostic code For further information see DFSMS MVS 1 1 Diagnosis Reference for DFSMSdfp DATASET NOT DELETED RC xx yy A dataset with disposition DELETE shall be queued for sendin
22. in the interval 00 00 to 23 59 2 Format ENDTIME NNNN 0 lt NNNN lt 9999 minutes Specifies the interval when a send or receive transmission must have been completed This parameter is used together only with ERRJOB parameter 63 rvsMVS User Manual Appendix A Control parameters of program DF080A00 AA Call of DF080A00 within a program Interface program DF180A The following description of the interface for the call of DFO80A00 within a program makes possible for example to initiate sending of datasets within CICS or IMS transactions or other environments For reasons of program maintenance and because of the different addressing modes in an MVS XA environment the program DF080A00 should not be called directly by other programs Calling DFO80A00 should only be done by using the interface program DF180A The following description refers to the interface program DF180A A 4 1 Call of program DF180A When program DF180A is called parameters must be passed to the program in a field with following format The first two bytes of the field must contain a binary value indicating the length of the field without the first 2 bytes The following max 256 bytes may contain control parameters for program DF080A00 The unused partof the field must be filled with blanks The rules for coding of the control parameters are the same as described in section A 1 of this manual except the maximum length of 256 bytes which may be
23. kKkKKK kkkk kk kk kk kk kk kk kk KkKKKKK Kk kk Kk Kk kk kk kkk kkkxk kk kk kk KKKKKK KKKKKK kk kk kKkKKK k k k k k KkKKKKK kk KKKKKK SELECT OPTION gt SEND A DATASET 2 DISPLAY TRANSMISSIONS DELETE SEND REQUESTS CREATE RESIDENT RECEIVE ENTRY DISPLAY DELETE RESIDENT ENTRY NOT ACTIVE LIST ONLY NOT ACTIVE NOT ACTIVE NOT ACTIVE I INFORMATIONEN Only menu 2 and l are available They are similarly to description above but you can t change the entries of transmissions 23 rvsMVS User Manual 3 Sending Datasets 3 Sending Datasets The transmitting of a dataset must be initialized by inserting an Active Send Entry in the rvs Control Dataset queuing a dataset for transmission The queuing of a dataset will be realized by the program DF080A00 The program creates an Active Send Entry using the specified control parameter and inserts this entry in the rvs Control Dataset The rvs Monitor if active searches the rvs Control Dataset for Active Send Entries and uses the information of these entries to determine which dataset has to be send to which rvs stations Is there any connection to an rvs station existing the transmission of the dataset to the specified rvs station will be performed The execution of the program DFO80A00 requires the specification of some control parameters that are read via the SYSIN
24. of a sequential work dataset 78 B 3 8 Working method at the receiving station 78 B 4 Special User Utilities 3 1 eicere tierce inrer andes 79 B 4 1 Program DF148A providing for the own station id rvs ID 79 ro d M M 80 rvsMVS User Manual 1 Introduction 1 Introduction The VW Rechner Verbund System rvs enables computers to exchange data sets by means of teleprocessing file transfer The rvs Software enables transmissions of any sequential or partitioned organized datasets between computers whereas the transmission integrity is controlled by the rvs Software The rvs System consists mainly of two parts 1 thervs Monitor that handles the sending and receiving of datasets as well as the programs with which a rvs user may initiate control and monitor the sending and receiving of datasets 2 The connection between both parts is the rvs Control Dataset Kontrolldatei KD whose function will be explained in the next section This manual describes all steps that are necessary to initiate and control data transmissions The possibilities how to get informations related to the status of transmission are shown too For each of this steps excamples of jobs are available which illustrates the execution of this steps These examples of jobs can be used after checking and possibly changing of installation specif
25. sequential dataset by calling an exit In any case the parameter RJEZYES can be used when a job shall be transmitted and executed at the receiving station The prerequisites are a rvsMVS Monitor at the receiving station and an authorization of the sending station by the receiving station for this function and a fixed record length lrecl 80 of the job dataset to be sent Details of retransmitting the output may be discussed with the software manufacturer FORMAT TEXT This parameter works only when transmission of a dataset uses the ODETTE File Transfer Protocol In this case the content of the data to be sent is modified in the following way e Data is changed from EBCDIC code to ASCII code e Atthe end of any logical record control characters carriage return and linefeed will be added It is possible to use special code translation tables Please refer to the parameter CODETRNS SERIAL If you specify SERIAL YES the dataset will not be sent as long as other send requests of same dataset name and older queuing time exist STAMPS T a timestamp Thhmmsst is appended to the dataset name D a datestamp Dyyddd is appended to the dataset name B both a date and a time stamp Dyyddd Thhmmsst are appended to the dataset name If a new dataset name is specified the stamp is added to this new name respectively For very long dataset names the stamp is shortened STRTTIME Earliest sending time range 00 00 lt strttime
26. station e A resident receive entry with parameter GDG YES exists in the receiving station e The value specified for the DSN parameter in the sending station has the structure of a GDG dataset name That means the last part of the name must have the form GnnnnVmm where nnnn and mm are 4 respectively 2 digit decimal numbers These two ways don t exclude each other The next two examples shows how to prepare a dataset for sending with and without the rename function 1 Generating and Preparing of a GDG Dataset for Sending without Rename Function CREATE EXEC PGM OUTPUT DD DSN GDG BASIS NAME 1 DISP NEW CATLG SEND EXEC PGM DF080A00 STEPLIB DD DSN rvs LOADLIB DISP SHR SYSPRINT DD SYSOUT SYSIN DD SID ST1 DSN GDG BASIS NAME 0 DISP DELETE 2 Generating and Preparing of a GDG Dataset for Sending with Rename Function CREATE EXEC PGM OUTPUT DD DSN GDG BASIS NAME 1 DISP NEW CATLG SEND EXEC PGM DF080A00 STEPLIB DD DSN rvs LOADLIB DISP SHR SXSPRINT DD SYSOUT SYSIN DD 34 rvsMVS User Manual 5 Transmission of GDG Datasets SID ST1 DSNOLD ZGDG BASIS NAME 0 DISP DELETE DSN ABC BASIS GOOO00VO00 Remarks to example 2 e The DSN parameter also could be specified in a different way Le DSN ABC BASIS G1234V99 the numbers specified in the last part of the DSN have no influence to the version under which the dataset is allocated at
27. the dataset is treated as a sequential dataset WARNING INVALID COMBINATION OF JOB AND DEV TAPE DEV TAPE IGNORED WARNING INVALID COMBINATION OF JOB AND SYSOUT SYSOUT IGNORED A combination of the parameters JOB and DEVICE TAPE and or SYSOUT was requested The parameters DEVICE TAPE and SYSOUT have been ignored and set to DEVICE DISK as default A 7 Action Messages Action messages document whether the following demands e Creating of a new record e Modifying an existing record e Deleting an existing record of the rvs Control Dataset have been processed successfully or not ACTION DATASET dsname QUEUED FOR SENDING QUEUING DAY ddd yy TIME hh mm ss The dataset with name dsname has been queued for sending Queuing date and queuing time are also displayed 69 rvsMVS User Manual Appendix 0 Messages of program DF080A00 ACTION RECORD ADDED TO DATASET A new Resident Receive Entry has been created ACTION RECORD REPLACED IN DATASET An existing Resident Receive Entry has been modified overwritten ACTION RECORD DELETED FROM DATASET A Send Entry or a Resident Receive Entry has been deleted ACTION REQUEST NOT ACCEPTED Creating modifying or deleting a record has not been processed Error messages proceeding this message give further details 70 rvsMVS User Manual Appendix 0 Messages of program DF080A00 A 8 Error Messages
28. the receiving station Important is only the structure of the last part of the DSN e Specification of DSN ABC BASIS is also possible in this case the handling of the dataset as a GDG in the receiving station depends on the existence of a resident receive entry with parameter GDGZz YES 5 2 Receiving of GDG Datasets There are three prerequisites for a correct handling of a received file as a GDG dataset 1 Existence of a catalog entry for the GDG base name see IDCAMS Command DEFINE GDG If such a catalog entry does not exist the rvs monitor tries to define a GDG base for the file to be received automatically at start of reception In this case the following IDCAMS parameter will be used LIMIT 255 NOEMPTY NOSCRATCH and OWNER rvs 2 The dataset disposition CATALOG must become active 3 The parameter GDG YES must be specified within a resident receive entry for this file or the filename transmitted by the sender must be a GDG name this means the last part of the name must have the form GnnnnVmm where nnnn and mm are decimal numbers During reception of a GDG dataset the rvs Monitor makes it sure that the GDG dataset will be allocated with most actual version name that means with the next free versions number The version number which will be transmitted by the sender is meaningless If at the receiving station the highest existing GDG version is i e GDG BASIS G0028V00 and a dataset with name GDG BASIS
29. the transmission if necessary and e completed So it is always possible to get listings about all transmissions that have been carried out during the last days Additionally the rvs control dataset contains information about different specifications for controlling and processing of received datasets i e automatical job restart These specifications resides in Resident Receive Entries and are processed by the rvs Monitor during receiving a dataset 1 3 Identification of Datasets When a dataset will be transmitted from one station to another both stations must know which dataset is to be transmitted If i e after reception of a specific dataset a job shall be started the station must be able to identify different received datasets There are two rvs parameters that identify a dataset These parameters must be specified if a dataset shall be queued for transmission creation of an active Send Entry The parameters must also be used to specify processing options for a dataset to be received creation of a Resident Receive Entry A description of these parameters is following rvsMVS User Manual 1 Introduction 1 SID station identification specifies the name of the remote rvs station that means the station which receives data or sends data 2 DSN dataset name reference name for a specific dataset Normally this name is identical to the physical dsname of the dataset But the reference name may differ form the dsna
30. transmitting PDS some exceptional rules compared with processing sequential datasets must be obeyed 1 The DS name of a sending resp receiving PDS may only have a maximum of 42 characters 2 The disposition of a PDS at the sending station is always KEEP This is valid even when another value has been specified when queuing the dataset for sending 3 The parameter REPLACE is ignored when queuing a dataset for sending This means a possibly existing dataset with identical name at the receiving station will never be overwritten Received PDS are always new allocated 4 For a received PDS always the parameter DEVICE DISK becomes effective This means a received PDS will never be copied to tape This is valid even when another value has been specified 5 If a PDS with identical name already exists then rvs modifies the name of the received rvs by connecting a timestamp to the DS name dsname Thhmmss00 and tries to catalog this new name Only when this fails then rvs issues an error message and the dataset resides uncataloged on disk B 2 Sending a PDS Member as sequential Dataset Normally a PDS maybe with only one member will be created at the receiving station also if only a member of a PDS is transmitted When transmitting a single PDS member the sending station may control the storing of the sent member into a sequential dataset at the receiving station Following prerequisites are necessary for this procedure 76
31. who created the entry Example By entry of the value ST1 in the SID field and ABCDE in the DSN field of the entry menu of Option 5 the following screen format will be displayed If the field SID has been left blank or only a part of the SID has been specified every entry will be displayed with the SID respectively instead of REMOTE STATION kkkkkkkkkkkkkkkkkkkkkkkkkkkkkk DE520POO0 kkkkkkkkkkkkkkkkkk ROW 1 OF 3 x RVS DISPLAY UPDATE DELETE OF RESIDENT RECEIVE ENTRIES KKK KKK KKK KKK KKK KK ke e he KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KK kk He ke He He He ke ke He KKK ke e ke ke k k COMMAND gt SCROLL gt PAGE REMOTE STATION ST1 STATION NR 1 DATE 95 130 TIME 12 35 SPECIFY OPTION S DISPLAY ENTRY U UPDATE ENTRY D DELETE ENTRY DATASET NAME COMMENT ABCDE DATEI A0083A ABCDE DATEI A0250K ABCDEOO DATEI A0410K A1 kkkkkkkkkkkkkkkkkkkkkkkkkkk BOTTOM OF DATA KERR KKK ok ck dede dedede de ee eek e ee eek k k k k k 21 rvsMVS User Manual 2 rvs ISPF Panels After entering S in front of the indicated entry the following screen is displayed ce ke ke kc ke ke ke kc kc ke ke ke ke ke kk kk kk kk DE540PO00 F kk k kk kk kk kk kkk kk kkk ke ke ke ke kk e e kkk k RVS DISPLAY OF RESIDENT RECEIVE ENTRIES KKK KKK KKK KK IKK KKK IKK KKK KKK KKK IKK IKK KKK KKK KKK KKK KKK KKK KKK KKK KKK ke k e e k k kk k k k k k DATE 95 130 TIME 12 35
32. will be rejected when the retry threshold is reached If TRANSHOLDzNO is specified transmission retries will continue after the retry threshold has been reached 39 ERRJOB pdsname member Specifies the name of a job to be started when a transmission fails A send transmission fails if the number of retries reaches a specified maximum number as set by the parameter MAXRETRY A send transmission also fails if the transmission is not completed before a specified last transmission date and time as specified by the parameters ENDDATE and ENDTIME A receive transmission fails if a file is not received after a specified maximum number of retries as set by the parameter MAXRETRY A receive transmission also fails if reception of a file is not completed before a specified last transmission date and time as specified by the parameters ENDDATE and ENDTIME For parameter syntax refer to the parameter JOB Note that the parameters JOB and ERRJOB must refer to the same dataset name 40 ENDDATE N NNN Specifies the latest date when a send or receive transmission must have been completed This parameter is used together with the parameter ERRJOB to have a job started if a transmission is not finished before the specified date For parameter syntax refer to the parameter STRTDATE 41 ENDTIME HH MM NNNN 1 Format ENDTIME HH MM Specifies the latest time when a send or receive transmission must have been completed This parameter is us
33. 0 DIRECTION SEND REMOTE STATION ST1 STATION NR 1 QUEUING END DATASET NAME DAY TIME DAY TIME ABC DATEI1 D3181A 330 02 15 330 10 01 END ABC DATEI1 D3181A 327 01 55 329 12 26 END ABC DATEI1 T3052Y 330 11 53 ABC DATEI1 T3052Y 330 00 32 330 11 09 END ABC DATEI1 T32 K092A 329 12 34 330 10 55 END ABC DATEI1 T4052Y 326 12 46 329 12 24 END ABC DATEI1 T5592Z 327 00 07 330 09 52 ABE kkkkkkkkkkkkkkkkkkkkkkkkkk BOTTOM OF DATA KR k e ke de de dede de de ke ke He He He He de de de de de ke ke He He He He He e KK Lines with the comment END denote complete transmissions ABE mark interrupted RJE mark rejected transmissions A transmission may be rejected when a PDS is to be sent but the receiver is not able of receiving a PDS e g this function is not supported at this station Line 3 shows a dataset that is not completely transmitted By entering an H as line command the transmission is deferred as long as the dataset is not released by entering an F or by an operator The entry may be deleted by entering a D By entering a S in the first line the following screen will be displayed kkkkkkkkkkkkkkkkkkkkkkkkkkkkkk DE220PO00 kk kx x ee ke e e e e ke ke e ke ke e ke ke e ke ke e ke ke e ke ke e x RVS DISPLAY OF TRANSMISSION kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkxkkxkxkxk COMMAND gt DATE 96 330 TIME 12 30 PRESS gt ENTER lt TO REFRESH DISPLAY WHE
34. 1A USED WORKDATASET DDF LOAD T1234180 VOLUME WORK03 Note With the transmission of PDS appropriate information about the used temporary work dataset will be displayed A more detailed description of PDS transfer you find in Appendix C of this manual 17 rvsMVS User Manual 2 rvs ISPF Panels 2 3 Option 3 Deleting Send Entries Deleting send entries may be necessary if datasets should have not been queued for sending or if a dataset has been queued for a incorrect station After selecting option 3 the following screen will be displayed kkkkkkkkkkkkkkkkkkkkkkkkkkkkkk DE300POO0 ke x x e ke ce e e he ke e ke ke e ke ke e ke ke ke ke ke ke ke ke ke ek e x x RVS DELETE SEND REQUEST KKK KKK KK KKK IKK KKK e hee e KKK KKK IKK IKK KKK KKK KKK KKK IKK IKK KKK KK KKK KKK k k k k k k k kk k k kk k COMMAND gt TO DELETE A SEND REQUEST S SPECIFY THE FOLLOWING PARAMETERS 1 SID LIA PS 599 STATION ID OR INITIAL PART OF ID OF RECEIVER 2 DSN SESE ccc BLANK OR PATTERN FOR DATASET SELECTION LIST PF1 PF13 END PRESS END KEY TO TERMINATE Remarks to the Entry Fields STATION ID rvs station name for which a dataset has been queued for sending This field may be left blank or only an initial part of the SID may be specified DS NAME In case of many entries exist for one station a part of the dsname may be specified in order to get a dataset selection list e g userid cl or cl
35. 31er hio en tob eo bee bx e ope bna gun ae he aou aeuo ee usen n ux nae onakoa aieiaiei 8 2 1 Option 1 Queuing Datasets for Sending eee 9 2 2 Option 2 Displaying Transmissions eeeeeeeeseeeesseeeeenenen enne nnnm nnne 15 2 3 Option 3 Deleting Send Entries cccseccceseeesseeeeseeeeeeeeeseeeseseeeenseeeeeeeseseaeseseenenseeeees 18 2 4 Option 4 Creating Resident Receive Entries eere 19 2 5 Option 5 Displaying Changing Deleting of Resident Receive Entries 20 2 6 Option I CH dt EI 22 2 7 Displaying Transmissions If Control Dataset is Read Only 23 3 56ndilg DataSets E 24 3 1 Creating Send Entries queuing for sending eese 24 3 1 1 Messages while queuing datasets for sending sseessesssss 27 3 2 Deleting Send Entries aclara ed Dedicado Liter ee Lease ed sande 28 3 2 1 Messages that occur when deleting send entree 28 4 Receiving DataSels iussus savancva savandva sav uva sva acd aia aca cava adv nerd a dI UR wavs nk pex Eg au Vd a dvd sarani 29 4 1 Standard Processing see hii arte a eect ceeded 29 4 2 Control of Receiving by SCNnder cccsscccceeeeeseeeeseeeeseeeeneeeeeeeeseseaeenseeeeeseeeseeseseenenseeenes 29 4 3 Creating of Resident Receive Entries Transmission Control by the R
36. B 3 2 Transmission of a sequential work dataset Directly before transmitting a work dataset it is checked by use of exchanging control informations between sender and receiver whether the receiving station supports PDS transfer or not If it is not supported the work dataset will not be sent Appropriate error informations are issued resp entered in the Control Dataset Only when PDS transfer function is supported by the receiver too the work dataset will be sent like other sequential datasets A receipt that the dataset has been completely received is not sent before the work dataset has been successfully loaded into a PDS at the receiving station this means not immediately after the complete reception of the work dataset B 3 3 Working method at the receiving station At the beginning of transmission a sequential work dataset is new created at the receiving station The transmitted data will be saved on this dataset The DS name of the work dataset is formed by the following rules e f no Resident Receive Entry with Rename Function exists the name of the work dataset is taken from the sending station with the exception of the timestamp which is changed from ThhmmsstO to Rhhmmss00 e f a Resident Receive Entry with Rename Function exists the name that is specified at the DSNNEW parameter is extended by timestamp Rhhmmssth Here hh applies to hours mm to minutes ss to seconds and t to tenths of seconds of the que
37. EMOT TAPE DISK 49 rvsMVS User Manual Appendix A Control parameters of program DF080A00 abbreviation DEVR for DEVREMOT T for TAPE und D for DISK Specification whether the dataset shall be remain on disk or copied to a magnetic tape at the receiving station Attention see remarks on parameter 19 18 DISPREMO KEEP CATLG abbreviation DISPR This parameter is obsolete from rvs MVS V 1 3 08 on adapting of rvs to DFSMS From this release on all datasets are cataloged in the remote station However the parameter is still accepted but does not have a functional effect 19 REPLACE YES NO Specification whether an already existing cataloged dataset at the receiving station may be replaced by a dataset of an equal name REPLACE YES or not REPLACE NO Remarks concerning the parameters 15 to 19 e The parameters 15 to 19 are building a group and must be viewed in connection They enable a sending station to define processing specifications for the receiving station e f during queuing of a dataset for sending at least one of these parameters has been specified the following not specified parameters becomes active with the following default values VOLREMOT No default value UNITREMO the defined unit group coded in the rvs start parameter at the receiving station DEVREMOT DISK REPLACE NO e When transmitting a PDS the values DEVICE DISK and DISP CATLG are used anyhow even when other values
38. ENTRY x KKK He ke e KK Fe He ke Fe He e He He e e He e He e He He He e He He He He He He He He He e He He e He He e ke e ke He ke ke He He ke ek ke he ke e ke ke ke ke k ke k k k k k kk k k k k k COMMAND gt SPECIFY PARAMETERS BELOW 12 WRITE EVENT gt Y YES N NO SUBSYSTEM ID gt 50 ENEE M DLL WRITE EVENT TO JOB SCHEDULING SYSTEM 13 TO gt STATION ID THE DATASET IS TO BE ROUTED TO 14 SYSOUT EX o590900909095 SYSOUT CLASS COPIES gt ONLY IF SYSOUT CLASS IS SPECIFIED DESTINATION gt ONLY IF SYSOUT CLASS IS SPECIFIED 15 SPACE So eus NUMBER OF ALLOCATABLE TRACKS 16 EXPDT LIB du ooo EXPIRATION DATE OF DATASET FORMAT NNNN 17 STORCLASS Rae et E Ee STORAGE CLASS MGMTCLASS Soe 499999 MANAGEMENT CLASS SMS PARAMETERS DATACLASS So abo 50 DATA CLASS 18 CODETRANS So hao OSS CODE TRANSLATION YES NO OR NAME OF TABLE The entry fields are not described at this place The meaning of the parameters can be found in Chapter A 3 of this manual The field names of this screen mostly fit the parameters described in Chapter A 3 2 5 Option 5 Displaying Changing Deleting of Resident Receive Entries After selecting option 5 the following screen will be displayed kkkkkkkkkkkkkkkkkkkkkkkkkkkkkk DE500POO okk x e ke e ce e e e ke e ke ke e ke ke e ke ke e ke ke e ke ke ke ke kv ke x RVS DISPLAY UPDATE DELETE OF RESIDENT RECEIVE ENTRIES KKK KKK KKK KK IKK KKK IKK KKK IKK IKK
39. ER THAN 65535 PLEASE INCREASE BLOCKSIZE A dataset shall be queued for sending When determining the size of dataset the number of data blocks proved to exceed the maximum of 65535 for rvs Hence the dataset will not be queued for sending The problem may be solved by using an increased blocksize greater but less blocks or by deviding the dataset into several datasets ERROR DATASET NOT FOUND A dataset shall be queued for sending but the specified dataset can not be found The DS name DSN parameter might not be specified according to JCL rules 73 rvsMVS User Manual Appendix 0 Messages of program DF080A00 ERROR REQUESTED RECORD NOT FOUND NOT DELETED An entry Send Entry or Resident Receive Entry shall be deleted from the Control Dataset FREE S or FREE R This entry could not be found any more The Control Dataset is searched by the specified parameters SID or ORT and DSN When searching for Send Entries parameters VOLUME and or DSNOLD may be looked for too ERROR ERROR IN CONTROL DATASET RC XX Error occured when accessing the Control Dataset Such an error should not occur normally the Control Dataset might be defective ERROR REQUEST FAILED BY INSTALLATION EXIT Inserting deleting or changing a record is rejected by an installation specific exit within rvs The usage of this program exit might be e g to control which users are allowed to queue what kind of datasets Beside this message further message
40. EXT PIC X 60 VALUE SID ST1 DSN ABC DATEIO1 DISP DELETE CALL DF180A USING PARMFID IF RETURN CODE O0 GO TO 66 rvsMVS User Manual Appendix 0 Messages of program DF080A00 Messages of program DF080A00 When calling program DF080A00 messages will be produced and will be issued at the SYSPRINT DD statement In the following these messages are listed with some short explanations Hints Program DF080A00 includes two User Abends where when they occur no messages at all are issued at SYSPRINT 1 User Abend 1800 This Abend occurs when the program can not find installation specific parameters within the Control Dataset A possible reason may be when rvsMVS is new installed and the rvs Monitor has not been started at least once when starting the Monitor installation specific parameters are written into the rvs Control Dataset 2 User Abend 1801 This Abend occur when the SYSPRINT DD statement is not allocated and hence no messages can be issued Messages INPUT With this code word the input stream that is specified at SYSIN is issued So an easy control of incorrect specifications may be achieved The following messages are classified into four groups Information messages error messages warning messages and action messages A 5 Information Messages Information messages are issued in order to give more detailed informations e g the size of the dataset to be sent but also operative default value
41. G0056V04 or with the name GDG BASIS G0000V00 will be received so this dataset will be allocated at the receiving station with the version GDG BASIS G0029VO00 For parameter DSN and parameter DSNNEW in a resident receive entry only the GDG base names must be specified this means no names like 1 or GnnnnVmm Examples In order to enable an automatic jobstart after reception of the dataset GDG BASIS G0034V00 for dataset processing a Resident Receive Enrey must be created The following parameters are required SID DSN GDG BASIS JOBz If during reception the rename function shall be used so the following parameters are required SIDz DSNzGDG BASIS DSNNEWZABC NAME2 JOB 35 rvsMVS User Manual 5 Transmission of GDG Datasets In this case the received dataset will be allocated under the next free version of the GDG base name ABC NAME 2 SID DSN GDG BASIS GDG YES In this case the received dataset will be allocated under the next free version of the GDG base name ABC NAME2 It is sufficient to transmit only the GDG basename ABC NAME2 instead of ABC NAME2 GnnnnVmm 36 rvsMVS User Manual 6 Overview of Transmitted Datasets 6 Overview of Transmitted Datasets A listing of sent and received datasets is created by program DF078A00 This program should be called via procedure PDF00024A because the necessary dataset allocations depend on the local i
42. IAL If more than one file is to be sent to a certain station this priority is also used to determine the sequence in which datasets will be sent to this station Default value the default value is a value between 0 and 31 depending on the size of the dataset to be sent This value is determined by use of the following formula PRIO 10000000 filesize bytes 23 SERIAL YES NO Default SERIALZNO This parameter is used for a serialization of sending datasets If you specify SERIALZYES the dataset will not be sent as long as other send requests of same dataset name and older queuing time exist For this reason the dataset will be put into HOLD status 24 QTIME yydddhhmm The specification of a queuing time makes only sense for deleting send requests to distinguish send requests for a indentical dataset Input yy year ddd machine date hh Hour mm minute 51 rvsMVS User Manual Appendix A Control parameters of program DF080A00 25 TSTAMPz TIME YES DATE BOTH NO Default TSTAMPzNO YES TIME a timestamp Thhmmsst is appended to the dataset name DATE a datestamp Dyyddd is appended to the dataset name BOTH both a date and a time stamp Dyyddd Thhmmsst are appended to the dataset name If a new dataset name is specified the stamp is added to this new name respectively For very long dataset names the stamp is shortened 26 STRTTIME 99 99 Default STRTTIME Earliest sending
43. IKK IKK e He He KKK KK KKK KKK KK KKK KKK KKK e e ke e e KKK k k k k TO DISPLAY CHANGE A RESIDENT RECEIVE ENTRY SPECIFY THE FOLLOWING PARAMETERS 1 SID gt STATION ID OR INITIAL PART OF ID OF REMOTE STATION 2 DSN SSS 5o 6050o655098900850020900008060908000800925209859029 BLANK OR PATTERN FOR DATASET SELECTION LIST PF1 PF13 HELP PRESS END KEY TO TERMINATE 20 rvsMVS User Manual 2 rvs ISPF Panels Remarks to the Entry Fields STATION ID Name of the rvs station from which datasets are to be received origin sender of the datasets This field may be left blank or only an initial part of the ID may be specified DS NAME In case a lot of entries exist for one station a part of the dsname may be specified in order to get a dataset selection list e g userid cl or cl or for all datasets starting with your userid After entering appropriate values in every case the Resident Receive Entries will be displayed in a further screen which fulfill the selection criteria SID DSN By further specifications from this screen e all parameter values of a Resident Receive Entry will be displayed entry of S in the approprate field e parameter values of a Resident Receive Entry may be changed entry of U in the appropriate field e Resident Receive Entries may be deleted entry of D in the appropriate field Resident Receive Entries may only be changed or deleted by the TSO user userid
44. JE station This parameter can only be used in connection with the SYSOUT parameter 12 FREE S The specification of this parameter effects the deletion of a send entry In order to delete an existing send entry additionally the parameters SID and DSN must be specified If a multiple of send entries with the same SID and DSN parameter exists the VOLUME and or the DSNOLD parameter may be specified for further qualification Hints The deletion of a send entry is only possible until the transmission has not beeen started In this case the transmission can only be interrupted by the rvs operator Default value NONE 48 rvsMVS User Manual Appendix A Control parameters of program DF080A00 13 COMPRz VERT BLANK Abbreviation COM for COMPR V for VERT and B for BLANK Specification of using a specific procedure to compress data during the transmission This parameter works only when the receiving station supports an suitable procedure This parameter should only be used in case of long periods of data transmission B should only be specified when an adequate comparison shows better results by using the blank compression Default value COMPR VERT vertical compression Note This parameter works together with SNA partner station without OFTP protocol 14 DSNOLD name This parameter enables the sending of datasets under new name rename function name describes the physical DS name length max 44 charac
45. LECT OPTION gt 1 SEND A DATASET 2 DISPLAY TRANSMISSIONS 3 DELETE SEND REQUESTS 4 CREATE RESIDENT RECEIVE ENTRY 5 DISPLAY DELETE RESIDENT ENTRY I INFORMATION From this menu you are able to access the functions by selecting the option In the following sections the most important displays are shown As far as necessary some entry fields are connected with remarks entry fields are padded with points generally rvsMVS User Manual 2 rvs ISPF Panels 2 1 Option 1 Queuing Datasets for Sending After selecting option 1 the following screen will be displayed ck ck ke ke ck e ke ke e ke ke e ke ck ke ke ke e ke ke ke ke ke ke ke kk kk kk kk kk DEI100POO0 kk x ce ke e e e e ke ke ke e ke e e ke e kv kk x RVS TRANSMISSION OF A DATASET SEND e oe e e e e e e e e e e e e e e e e de e e de de e de de de ee e de e de de de de e e de ede de de dee dede dede de eee ee eee dece ce eee ce e ee ke ke ke ke kx kx kx kx x COMMAND gt SPECIFY PARAMETERS BELOW DISPLAY FURTHER OPTIONS gt Y YES N NO S SECURITY 1 STATION ID gt STATION ID OF RECEIVER LIST OF STATIONS ORES LDL US TIR ES x ce a ees m cC A M is pea ie 2 DSNAME LC MIA EE PP NASCE HUI gata Pa ele Beak at Cee NAME OF DATASET TO BE SENT S ANEW EDSNAME SE gt Po Mp Fm MO eM EFE Ee RENAME BLANK OR A NEW NAME FOR DATASET TO BE SENT 4 DISPOSITION K K KEEP D DELETE 5 ACCT1 ESES Do ACCOUNT NUMBE
46. N TRANSMISSION IS ACTIVE DIRECTION SEND REMOTE STATION ST1 STATION NR 1 USER VWUSER5 DATASET NAME ABC DATEI1 D3181A ACCT OVV3181 DATASET QUEUED AT 96 330 02 15 VOLUME W80116 START OF TRANSMISSION 96 330 10 00 DSORG PS END OF TRANSMISSION 96 330 10 01 LRECL 133 NUMBER OF TRANSMITTED BLOCKS 23 BLKSI 1330 RECFM FBM DATASET HAS BEEN COMPLETELY RECEIVED BY STATION ST1 DATASET HAS BEEN DELETED AFTER TRANSMISSION 16 rvsMVS User Manual 2 rvs ISPF Panels By inserting a S in the 5 line e g following screen will be displayed KKEKKKKKKKKKKKKKKKKKKKKKKKKKKEKE DF220P00 oe e e e e e ee e e ee eee eee ee eee e e e e ke e e ke kx kx kx kx X RVS DISPLAY OF TRANSMISSIONS c oe e e e e e ee e e e e e de e e e e e de e e de e e de e de e de de e de de ede ee de ede de dee e ede de dede ede eee eee ee cese eee e e ke ke ke ke kx kx kx x COMMAND gt DATE 96 330 TIME 12 30 PRESS gt ENTER lt TO REFRESH DISPLAY WHEN TRANSMISSION IS ACTIVE DIRECTION SEND REMOTE STATION ST1 STATION NR 1 USER VWUSER5 DATASET NAME ABC DATEI1 T32 K092A ACCT OVV3181 DATASET QUEUED AT 96 329 12 34 VOLUME PRV101 START OF TRANSMISSION 96 330 10 54 DSORG PO END OF TRANSMISSION 96 330 10 55 LRECL 80 NUMBER OF TRANSMITTED BLOCKS 3 BLKSI 1600 RECFM FB DATASET HAS BEEN COMPLETELY RECEIVED BY STATION ST1 DATASET HAS BEEN CATALOGED AFTER TRANSMISSION OLD DATASET NAME WAS DDF LOAD K09
47. R HERE 6 ACCT2 ZES ACCOUNT NUMBER RECEIVER 7 REMOTE OPTIONS gt N Y YES N NO NOT SUPPORTED BY ALL STATIONS DEVICE gt D D DISK T TAPE SYMB UNIT gt IF NO SPECIAL UNIT OR VOLUME IS VOLUME NO gt NEEDED LEAVE THESE FIELDS BLANK 8 JOB Eur ese rece D to s ee M CN ur ME AUTOMATIC JOBSUBMIT AFTER TANSMISSION SPECIFY DATASET AND MEMBERNAME PF1 PF13 HELP PRESS END KEY TO TERMINATE Remarks to the entry fields STATION ID The rvs station identifier of the receiver Alternatively you can use the parameter SIDLIST This parameter specifies the dataset name of a distribution list see also appendix A 2 parameter SIDLIST of this manual DSNAME Physiscal name of dataset to be sent max 54 characters This name must be specified according to ISPF rules If no quotes have been specified your own userid will be put before the dsname If a member of a PDS is to be transmitted the member name enclosed in parantheses must follow the dataset name This field must be specified in all cases NEW DSNAME This field must be specified only if the rename function shall be used that means if the dataset to be sent shall be allocated at the final receiving station with a changed dataset name in relation to the name specified in the DSNAME field If a PDS member with changed name is to be sent a member name may be specified too This field has the same restrictions as the DSNAME field that m
48. REMOTE STATION ST1 STATION NR 1 ACCOUNT NUMBER 0GS0083 DATASET NAME ABCDE DATEI A0083A NEW DATASET NAME ABCDE DATEI A0083A PINAL NS C DISK RECEIVE VOLUME SYMBOLIC UNIT SYSDA GDG STAMPS NO REPLACE OF DATASET NO JOB TO BE STARTED JOB PDS A JOBST1 WEN weno LITE VWUSER5 CREATION DATE 94 280 LAST USED DATE 95 130 2 6 Option l rvs information After selecting option the following menue will be displayed kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk DFEIOOPOO okck ck ke ck ke e ck e e e e he e e ke ke e ke ke e e ke ke ek e x rvs INFORMATION KKK KKK KKK KK e he ke he ke KKK KKK KKK IKK IKK e he e KK KKK KKK KKK KKK KKK KKK KKK ke k e e k k ke e k k k k k OPTION gt 1 CURRENT INFORMATION WHAT IS NEW WITHIN rvs 2 GENERAL rvs INFORMATION 3 LIST OF ALL rvs STATIONS 5 BROWSE OF THE rvs USER MANUAL The information for the options 1 to 3 are supplied by the rvs manager Thus the contents and the layout of the options depend on the installation definable in the starting CLIST rvs 22 rvsMVS User Manual 2 7 For displaying transmissions if control dataset is read only a new panel is provided Please use Displaying Transmissions If Control Dataset is Read Only CLIST RVSR in RVS CLIST DFOO0PRO VW RECHNER VERBUND SYSTEM kkk kkk kk KkKKKKK
49. RR x x x k k k k k k kk k kkk kkk kkk kk kkk kkk kkk It is only possible to queue PS files to distribution lists by using the parameter DISP KEEP No default value One of these parameters SID ORT or SIDLIST must be specified 2 a DSNAMEzname Abbreviation DSN Name of the dataset to be sent name is a reference name for the sending dataset between the sending and the receiving rvs station Generally this name is the same as the physical disk DS name of the dataset to be sent see 14 DSNOLD parameter The DS name of the dataset to be transmitted must be specified in the same structure as specified in the JCL that means full qualified and not included in quotes If a member of a PDS is to be sent the PDS name and the member name have to be specified in the usual form PDS name membername General for OFTP transmission Length max 26 characters for transmissions between OFTP stations Special for stations with TYPEZMVS Length max 44 characters max 44 characters max 8 character member if PDS dataset max 35 characters generationnumber if GDG dataset Syntax The rules of the syntax are the same as the rules of specifying DS names for datasets if the transmission works without renaming the dataset If you use the rename function there are restrictions using parentheses PDS or GDG datasets The generation number must be specified with one of the folling rules 1 0 and 1 9 Illega
50. S only Used OSID with ULS YES is invalid Further information may be found through issued information or error messages 75 rvsMVS User Manual Appendix B Transmissions of Partitioned Datasets PDS B Transmissions of Partitioned Datasets PDS rvsMVS offers the possibility of transmitting partitioned datasets PDS besides sequential datasets A prerequisite is the installation of rvsMVS on both sending and receiving station or at least rvsOS Release 4 0 Level 08 As a further prerequisite the transmission must be processed with the rvs specific transmission protocol SNA component Starting with rvsMVS version 2 2 00 transmission of PDS files are also supported whithin the ODETTE File Transfer Protocol OFTP Requirements are the installation of rvsMVS 2 2 00 or following versions on both sides and the specification TYPE MVS whithin the rvs stations tables for the remote station The PDS transfer is hereby also supported by the rvs components X 25 LU6 2 and TCP IP Remark The PDS transfer function uses the User fields of OFTP protocol records SSID and SFID If these fields are modified by user exits PDS transfer is impossible Functions of the PDS Transfer rvsMVS offers the possibility to transmit either a complete PDS or a member of a PDS It is not possible to transmit parts of a PDS several members except that all members are transmitted seperately B 1 Exceptional Rules when Transmitting PDS When
51. VOLKSWAGEN gedas Helease 03 01 00 User Manual 2006 02 14 rvsMVS User Manual This documentation is valid for rvsMVS release 3 For rvsMVS the following documentations are provided rvsMVS Installation Manual englisch Installation of rvs Usefull for Systems Programmer rvsMVS Benutzer Handbuch german Manual for rvs Users rvsMVS Operator Handbuch german Manual for rvs Operator rvsMVS Operation Manual english Manual for rvs Operator rvsMVS Messages and Codes english Overview about rvs messages and abend codes Distribution information will be given kindly gedas GmbH Jannine Muyshondt FB rvs Systems Pascalstr 11 D 10587 Berlin Tel 49 30 3997 1227 Fax 49 30 3997 1994 Email mailto Jannine Muyshondt gedas de Technical information will be given kindly gedas GmbH FB rvs Systems Pascalstr 11 D 10587 Berlin Tel 49 30 3997 1777 Fax 449 30 3997 1994 Email mailto rvs service gedas de Copyright 2006 by Volkswagen AG gedas deutschland GmbH 2 rvsMVS User Manual Contents Contents Ts WNTOGUGHONN e 5 1 1 rvs User Functions ecrire conie i Lese cru oed ce TE enbee i a ia iaaa 5 1 2 CR DnojiLrc 6 1 3 Identification of Datasets eeeeeeseeeeeeseeeeee eene nennen nnn nain nnnr inne nnn innen 6 1 4 AECH et EE 7 2 vs ISPF Panels 2 1 2 02 71
52. a PDS the sending dataset will be unloaded into a sequential dataset For this a sequential dataset is new allocated The DS name of the work dataset is formed by the following rules At end of the name DSN parameter or if specified DSNOLD parameter of the sending dataset a timestamp of kind Thhmmsst0 is appended hh applying to hours mm to minutes ss to seconds and t to tenth of seconds of the queuing time If the maximum of 44 characters of the DS name is exceeded it will be truncated to the first 44 characters When the queuing for sending is succeeded rvs will not touch the PDS resp member of the PDS any more but only the sequential work dataset is involved in the following transmission This work dataset will not be cataloged but will be deleted after complete transmission Hint 77 rvsMVS User Manual Appendix B Transmissions of Partitioned Datasets PDS When using the PDS transfer three different names may be used for the sending sended and received dataset The name of the DSN parameter of the DSNOLD parameter and finally of the sequential work dataset The following table shows which of these names are used X or not by the different programs functions for listing sent or still to be sent datasets Program Function Name from Name from Name of work DSN Parameter DSNOLD Parameter dataset Program DF078A00 X X rvs ISPF panels X X X rvs command N ORT X X
53. allocated Hints e If the rename function shall be used under the DSNNEW parameter the real disc name of the dataset to be received must be specified Under the DSN parameter that name must be specified that is allocated to the dataset at the transmitting station This is a reference name between the sending and the receiving station The transmission will be performed under this name The name specified under DSNNEW will only be used for disc allocation at the receiving station All list programs are using the name under DSN as search criterion e name must be specified in the same form as it has been specified in the JCL that means fully qualified and not included within quotes e f name is NULLFILE the dataset will not be saved Default value The name specified under the parameter DSN 16 GDG YES NO Specification whether the received file is to be handeled as a GDG GDG YES or not GDG NO The parameter GDG YES should only be specified in conjunction with the parameter DISP CATLG Additional a catalog entry for the GDG basename must be defined IDCAMS command DEFINE GENERATIONDATAGROUP in this case the specified values for DSN or DSNNEW parameter within a resident receive entry must only be the GDG basename s not names like 1 or GnnnnVmm Default value GDG NO 17 REPLACE YES NO 59 rvsMVS User Manual Appendix A Control parameters of program DF080A00 Specification whet
54. ameters 15 to 19 in the Appendix 9 2 of this manual Examples for queuing Partitioned Datasets The treatment of PDS requires some exceptional rules compared with sequential datasets A summary of these rules and some special features of PDS transfer are described in Appendix C 6 SID ST1 DSN ABC PDS01 The PDS with DS name ABC PDS01 is to be sent to rvs station ST1 The dataset will not be uncataloged and will not be deleted either after complete transmission because the sending of PDS always is carried out with DISP KEEP 7 SID ST1 DSN ABC PDS02 MEMBER1 The same as example 6 except that not the whole dataset ABC PDS02 will be transmitted but only member MEMBER 1 of this dataset In this case am PDS with name ABC PDS02 will be transmitted that contains only one member MEMBERt1 8 SID ST3 DSN ABC PDS N DSNOLD ABC PDS03 The same as Example 6 except that in this case the Rename function is used the PDS ABC PDSOS is to be sent with new name ABC PDS N to rvs station ST3 25 rvsMVS User Manual 3 Sending Datasets 9 SID ST3 DSN ABC N DSNOLD ABC PDS04 MEMBERA In this example only member MEMBERA of dataset ABC PDS04 is to be transmitted besides that the Rename function is used Two cases have to be distinguished e Dataset ABC PDSO04 has fixed or variable record format In this case member MEMBERA will be transmitted as sequential dataset This means a sequential dataset with name ABC N will
55. are specified Besides that no existing PDS at the receiving station will be modified no REPLACE on principle received PDS are always new allocated e The receiving station must authorize the sending station before the parameter become effective There is one authorization for the parameters 14 to 18 as well as a separate authorization for the REPLACE parameter As this authorization may be done is described in the rvsMVS Installation Manual building of the rvs Stations Table e The specification of at least one of these parameters suppresses the using of an available Resident Receive Entry at the receiving station Especially at the receiving station no user job will be started after receiving the dataset If the receiving station has the sending station not authorized to use these parameters but at least one of these parameters has been specified so the rvs Monitor issues a adequate message at the receiving station Also in this case a possibly available Resident Receive Entry will be ignored The dataset will be handeled as no Resident Receive Entry is available 50 rvsMVS User Manual Appendix A Control parameters of program DF080A00 20 RJE YES pointer This parameter enables in case the receiving station fulfills further prerequisites the complete using of the RJE function that means e Sending a job to the receiving station in a sequential dataset e Start and execution of the job at the receiving sta
56. assed by the rvs Monitor to the Operating System for execution The sender of this dataset has two possibilities to applicate this procedure the specification of the RJE parameter during queuing for sending see Chapter 9 2 or to insert a leading record in the dataset to be transmitted The contents of the record is columns 1 to 20 SYSOUT I INTRDR This record will be removed from the dataset during receiving A received job like this will be started by the rvs Monitor only if the entry for the sending station in the member STATIONS of the receiving station is authorized for this function How to do this authorization is described in 29 rvsMVS User Manual 4 Receiving Datasets the rvsMVS Installation Manual Building the rvs Stations Table Is this authorization missing the standard processing described above see section 3 1 will be executed Additionally the rvs Monitor issues an adequate message In any case an eventual existing Resident Receive Entry of the receiving station will be ignored e Specification of the volume or the unit group on which the dataset s are to be stored at the receiving station respectively e Specification of the device type disk or tape on which the dataset shall be stored respectively e Specification about the disposition to be executed at the receiving station respectively Specification whether an eventual existing and cataloged dataset with the same DS name shall be replaced
57. be created at the remote station ST3 with same content as member MEMBERA of dataset ABC PDSO04 e Dataset ABC PDS04 has an undefined record format e g load module libraries As in Example 8 a PDS with new name ABC N and with one member MEMBERA will be transmitted Examples for using external features 10 SID ST1 DSN XYZ SECOM DSNOLD ABC SECU The control if the Security Compression feature program is used based on rvsMVS license key options Y and Z and the parameters SECURITY EXT und COMPRESS GZIP in station Entry In this example the Security and the Compression Feature are called before sending the data set The data set ABC SECU will be transmitted as XYZ SECOM to station ST1 11 SID ST1 DSN XYZ SECOM DSNOLD ABC SECU SECURITY NO COMPRESS NO In this example the Security and the Compression Feature are not used before sending the data set The data set ABC SECU will be transmitted as XYZ SECOM to station ST1 26 rvsMVS User Manual 3 Sending Datasets 3 1 1 Messages while queuing datasets for sending The program DF080A00 writes messages to SYSPRINT for every queuing of a dataset e Listing the parameters entered via SYSIN e Possible messages for further information i e about the size of the queued dataset about the volume the dataset resides on and about incorrect specified parameters or parameter values e Messages about completed actions In case of a successful queuing of a data set with DS name
58. ce received data on a data specific disk volume or into a SYSOUT class After reception of a dataset an automatic job start initiated by the rvs Monitor is also possible to process the received dataset e Listing of executed transmissions or transmissions that are still to be executed with a history of at least 3 days e Listing of information that is used to control the reception of datasets 1 2 rvs Control Dataset The rvs Control Dataset is an interface connecting the rvs Monitor and the rvs user This dataset has a catalogue function within the rvs system If a dataset shall be transmitted to a rvs station a rvs Send Request Entry will be placed in the rvs Control Dataset in order to initiate the transmission When the rvs Monitor will be started or if the monitor is already active the rvs Control Dataset will be scanned for Active Send Request Entries periodically If such an entry has been found and a connection line session related to the remonte station is active the dataset will be transmitted An equivalent procedure is performed if no active line connection exists so far but the rvs Monitor is able to build up such a connection itself e g with automatic dial In this way you can any time get information about the status of all data transmissions which are e not yet started e just active but not yet finished in this case the record count will be saved in the rvs Control Dataset in order to enable a later restart of
59. creation of an Resident Receive Entry additionally to an error message the message REQUEST NOT ACCEPTED will be issued Reasons for an unsuccessful creation of an entry may be e Incorrect syntax of a parameter e A parameter value has been incorrect specified In case of an unsuccessful creation of an Resident Receive Entry the SYSPRINT protocol should be checked for error hints Appendix B in this manual contains a list of messages of program DF080A00 Hints An existing Resident Receive Entry will be replaced if the parameters SID and DSN of the entry to be created are the same as the values of the already existing entries During replacing a Receive Entry the specifications of the old entry will not be copied All required values must be specified again 4 4 Deleting Resident Receive Entries Deleting of Resident Receive Entries will be performed also by the program DF080A00 The job control is the same as used to create Resident Receive Entries see Chapter 3 3 only with different contents of the control statements In order to delete a Resident Receive Entry the parameters DSN SID and FREE R must be specified Example The deletion of Resident Receive Entries may also be executed by the means of the ISPF panels see Chapter 1 32 rvsMVS User Manual 4 Receiving Datasets SID ST1 DSN ABC DATEI01 FREE R The Resident Receive Entry for the dataset ABC DATEI01 related to stati
60. d at the sending or receiving station The creation of Resident Receive Entries is executed by program DFO80A00 The program creates one or more Resident Receive Entries using the specified control parameters and stores these entries into the rvs control dataset The rvs Monitor searches for these entries in case of receiving datasets The creation of Resident Receive Entries can also be executed with the help of the ISPF panels or by the rvs command processor see Chapter 1 and Chapter 8 30 rvsMVS User Manual 4 Receiving Datasets The execution of the program DF080A00 requires the specification of some control parameters which are read via SYSIN The rules for coding the control parameters and the control parameters itself are described in Chapter 9 1 9 3 Appendix of this manual The following JCL can be used for creation of Resident Receive Entries ABC JOB RESIDENT EXEC PGM DF080A00 PARM RESIDENT STEPLIB DD DSN rvs LOADLIB DISP SHR SYSPRINT DD SYSOUT SYSIN DD Control Parameter Statements Examples for control statements specified under SYSIN 1 SID ST1 DSN ABC DATEI01 DEV D The dataset with the dsname ABC DATEIO1 received from station SID ST1 shall remain on disk DEV D after reception and shall be cataloged DISP CATALG effects as a default value 2 SID ST1 DSN ABC DATEI01 DEV D VOL WORKO1 As example 1 but the dataset will be cataloged on disk volume WORKO1 3
61. d transmission fails if the number of retries reaches a specified maximum number as set by the parameter MAXRETRY A send transmission also fails if the transmission is not completed before a specified last transmission date and time as specified by the parameters ENDDATE and ENDTIME A receive transmission fails if a file is not received after a specified maximum number of retries as set by the parameter MAXRETRY A receive transmission also fails if reception of a file is not completed before a specified last transmission date and time as specified by the parameters ENDDATE and ENDTIME For parameter syntax refer to the parameter JOB Note that the parameters JOB and ERRJOB must refer to the same dataset name 30 ENDDATE N NNN Specifies the latest date when a send or receive transmission must have been completed This parameter is used together with the parameter ERRJOB to have a job started if a transmission is not finished before the specified date For parameter syntax refer to the parameter STRTDATE 62 rvsMVS User Manual Appendix A Control parameters of program DF080A00 31 ENDTIME HH MM NNNN 1 Format ENDTIME HH MM Specifies the latest time when a send or receive transmission must have been completed This parameter is used together with the parameters ERRJOB and ENDDATE to have a job started if a transmission is not finished before the specified date and time Values for latest send time must be
62. described in appendix A 3 The listing is sorted ascending by station identifier SID parameter and dataset name CDN parameter The following job is an example for the listing of Resident Receive Entries LDF0006 JOB STEP1 EXEC PGM DF077A00 PARM SID ST1 STEPLIB DD DSN rvs LOADLIB DISP SHR SYSPRINT DD SYSOUT KD DD DSN rvs KD DISP SHR TABLES DD DSN dsname DISP SHR LOG DD DSN dsname DISP SHR STATIONS DD DSN dsname DISP SHR Remarks The job LDFOOO6 lists all Resident Receive Entries for station ST1 40 rvsMVS User Manual 8 Use of external rvs amp Features 8 Use of external rvs Features The following chapters give you in the first part a short overview about the external rvs Features The second part describes the handling of this features for sending datasets by rvs to the receiving station 8 1 Feature Architecture In a layer architecture view rvs works between the network layer at the bottom and the application layer on top To connect applications with rvs there are some important interfaces e to give rvs the parameter to send data sets user interface with ISPF or batch program DF080A00 e to call rvs by applications call interface by DF180A e tocall applications after receiving a data set call interface using Resident Receive Entries rvs external Features are located at this level between the application layer and rvs It works as a part of t
63. eans specification of the dsname according the ISPF conventions rvsMVS User Manual 2 rvs ISPF Panels DISPOSITION KEEP The original dataset DSNAME will be transmitted The data is not copied and remains cataloged after end of transmission DELETE The original dataset DSNAME will be renamed by appending a timestamp when it is queued for sending The renamed dataset will be deleted at end of transmission REMOTE OPTIONS Indication whether the transmission shall be controlled by the sending station YES or not NO Related to this and the fields DEVICE DISPOSITION SYMB UNIT and VOLUME NO see Chapter 9 2 of this manual especially the parameters DEVREMOT UNITREMO and VOLREMOT as well as the remarks to these parameters For a detailed description of reception control of sender and receiver see Chapter 3 2 and 3 3 JOB specifies the dataset name of a job which is to be started by rvs after sending the file The queuing for sending is done by calling the program DF080A00 by means of this panel The messages that appear are the same as listed in Chapter 2 Appendix B of this manual contains a listing of all messages By specifying a Y in the field DISPLAY FURTHER OPTIONS the following screen will be displayed kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk DFEI10POO0 kk kk x ke e ke e e e e e e e ke ke ke ke e e e ke ke kv x 17 STRTTIME 18 STRTDATE 19 SENDWIN 20 CODETRNS v 5968 EARLIEST STARTTIME OF THE
64. eceiving Station 30 4 3 1 Messages issued when creating Resident Receive Entries 32 4 4 Deleting Resident Receive Entries eseeeeeeeeeeeeereeeeene nennen nnns 32 4 4 1 Messages issued during deleting Receive Entries AA 33 5 Transmission of GDG Dataset lueeeeeeeeeeeeeeeeeeeeeeneee nennen nennen 34 5 1 Sending of GDG Datasets eese esseeeeee seen enin nn nnne nnn nn nasa sinn n nnn nnna 34 5 2 Receiving of GDG Datasets cccscccssccesseeeeeeeeeeeeeseeeenseeeeeeeeescaeseseaeeeeeeesseesesseeenseeeeeenes 35 6 Overview of Transmitted Datasets ccccccceeseeesseeeeeeeeeeeeeeseeeeeeeeeeeeeeeeeeeeeeeeeeeees 37 7 Overview about Resident Receive EntrieS cssssseeeeeeeeeeseeeeeeeeeeeeeeeeeseeeeeeeeeees 39 8 Use of external rvs Features cscsssssssssscsesssssssssssssecesessescsesseseseseacsessessaeaeeceessess 41 8 1 Feature Architecture eeeeeeeeeeee eese esses eese nennen nennt nnns mnnn nnmnnn nnmnnn nnnm snnm 41 8 2 External Compression 2 ect raa i Toe ra EES 41 8 2 1 Steps to Use the External Compression Feature sss 42 8 3 e ATERT 42 rvsMVS User Manual Contents 8 8 1 Steps to Use the External Security Feaiure 42 A Control parameters of program DF0804A00 eeeeeeeeeeeeeeneeen 44 A 1 Rules for coding of con
65. ed together with the parameters ERRJOB and ENDDATE to have a job started if a transmission is not finished before the specified date and time Values for latest send time must be in the interval 00 00 to 23 59 2 Format ENDTIME NNNN 0 lt NNNN lt 9999 minutes Specifies the interval when a send or receive transmission must have been completed This parameter is used together only with ERRJOB parameter 54 rvsMVS User Manual Appendix A Control parameters of program DF080A00 A 3 Parameters for Resident Receive Entries 1 SID sid or ORTzsid rvs station identification sid is the name of that station from which the dataset shall be received origin sender of the dataset sid is a 3 byte chain of alphanumeric characters Instead of the keyword SID also the keyword ORT may be used When creating a Resident Receive Entry it is checked whether the specified station id is defined in the station table If it is not the creation of an entry will be rejected Nevertheless an entry with SIDZANY may be created anyway SID ANY means that this entry becomes active in case of matching the DSNAME regardless from which station the dataset is received No default This parameter must be specified 2 DSNAME name abbreviation DSN Name of the dataset to be received name is a reference name for the dataset to be transmitted between the sending and the receiving rvs station Generally this name is identical to the physical
66. eive Entry In order to delete an existing Resident Receive Entry additionally only the parameters SID and DSN are necessary Default value NONE 12 JOBzpdsname member Automatic job start after receiving a dataset rvs offers the possibility to start a job automatically i e to process the received dataset after receiving a special dataset from a specific station This job must be a member of a PDS with name pdsname before the dataset has been received While creating the Resident Receive Entry rvs checks whether a cataloged PDS with name pdsname is available rvs does not check whether the specified member member exists Hints e DEVICE TAPE and SYSOUT are ignored in combination with JOB parameter DEVICE DISK is set as default e When the JOB parameter is used the parameter DEV DISK should always be specified because the default value of this parameter may be different from the specified see parameter DEVICE There may arise problems when two or more datasets of identical names are to be received from one station within a very short time The first dataset is received and the specified job is started to process the dataset When the second dataset is received before the first dataset 57 rvsMVS User Manual Appendix A Control parameters of program DF080A00 has been deleted the receiving of the second file is rejected until the first one has been deleted The best solution for this problem i
67. ere oni td RTT RED 19 54 RI nnno RR 63 Deleting sa i iueeon etae ree 31 DIREGTION EE 15 Displaying Changing Deleting 20 RIES 55 OVetVIeW cite dpt che per 38 DISPOSIT n ptm b RIP 46 Return Cod g ees pt Pent ee 73 DISPOSITION tics ette rhetores 10 RIF Hs tege eege gn ege dees 12 50 DISPBREMOQ 5c gen hepb pma eben 49 SECURITY unsoansseueta tete Re 13 distribution jet see SIDLIST SECURITY create Send Request 52 DSNAME rehab e Pets 9 44 54 Send Entries DS NAME vue eR rem ee eter ed 15 Deleting see rne o Ro ieee ey 18 27 DSsN AME reete e eh ese bentes 18 Queulhg er r E E 9 23 43 DSNNEW Eed r meer 58 SENDW IN a eh tiie een 12 51 DSNODBEB xiii e EE eese 48 SERIA D utinam 12 50 EFCHEC K teer EAEE EEEE 51 SIDE ctt is erie a BE 43 54 ENDDATE ett sedis eth Seer 53 61 SIDLIS EE 43 ENDTIME pere 53 61 SPACE ter Goedert ettet RM 57 ERRJOB z pierde eee enis 53 61 STAMPS oerte EN 12 EVENT iore 10 STEATION ID 2 2 9 15 18 EVENT NAME este Render 11 STORCENS rediens ee ied 59 LENA RE 60 KRAN RRE 12 51 external COMpression esee 40 STRTITIME neenon 12 51 external re Beate 40 SUBSYSTEM ID esee eren 11 external Security aereo erm terrere herein ein 41 KE Ee IER EE 11 46 55 Feature Architecture sese 40 Rande Eden ee Eed 55 FORMAT eene reb rerit 12 50 TRANSHLED 5o itte Penis ere eee 53 61 BREBE 55
68. g Because of the fact that the dataset is empty the dataset will not be queued for sending but the disposition DELETE will be executed immediately An error occurred while deleting the dataset xx resp yy refer to the 68 rvsMVS User Manual Appendix 0 Messages of program DF080A00 return code of the SCRATCH macro For further information see e g IBM manual OS VS2 SPL Data Management DATASET HAS BEEN DELETED A dataset with disposition DELETE shall be queued for sending Because of the fact that the dataset is empty the dataset will not be queued for sending but the disposition DELETE will be executed immediately A 6 Warning Messages CAUTION SYSOUT SPECIFIED UNIT PARAMETER IGNORED When creating a Resident Receive Entry parameters SYSOUT and UNIT have been specified In this case the UNIT parameter is ignored CAUTION BLOCKLENGTH EXCEEDS TRACK CAPACITY OF 3330 DISK CAUTION BLOCKLENGTH EXCEEDS TRACK CAPACITY OF 3350 DISK When queuing a dataset it has been determined that the blocklength of the dataset exceeds the maximum track capacity of a 3330 disk resp 3350 disk This means the transfer of the dataset can not be processed if no disks with appropriate track capacity will be supplied WARNING INVALID DATASET ORGANIZATION PHYSICAL SEQUENTIAL ASSUMED When queuing a dataset it has been determined format 1 dscb that the dataset to be sent is neither sequential nor partitioned organized PDS In this case
69. he application layer controlled by rvs Monitor In the past there are some features comparable with this e to control output for SYSOUT e to send data to RJE e to handle PDS data sets which are located at the same external feature level The new External Compression and External Security Feature enhances this interface layer to prepare and to finish data transfer with more service Because of the layer architecture rvs handles this on top of the file transfer protocol Therefor such a file may be routed through other stations without any influence over or from this stations Especially in case of using OFTP as the file transfer protocol the temporarily stored file is not readable or processable without using special rvs programs We point out that this external features are a part of the rvs design and they are not processable with other communication products even if they are using OFTP 8 2 External Compression External Compression Feature consists of a program which works along the GZIP algorithm Data sets will be reduced in best cases until 30 percent only in the case of very small files the added process information will expand the user data set size During creation time the send request will be checked for fulfillment of the availability of the compression feature e ofthe own station installation of the external compression program s e of the partner station installation of the external compression program s at partne
70. her an existing and cataloged dataset is to be replaced REPLACE YES if a file with the same name is to be received or not REPLACEZNO If a dataset is to be received and cataloged but a file with this name is already existing and cataloged receiving of the dataset will be rejected if REPLACE NO is specified or valid by default This parameter is only valid for sequential files this means the rule by which received GDG datasets will be always allocated as a new files remains unchanged The parameter REPLACE YES is exclusive with the GDG function this means REPLACE NO is valid whenever the GDG function is used Remarks If REPLACE YES is specified an existing and cataloged file will be replaced independent whether the disposition of the file to be received is KEEP or CATLG If REPLACEZYES and the VOLUME parameter are specified and if a file is to be received but a dataset with the same name is already existing and cataloged the existing dataset will be replaced This means the volume parameter will be ignored in this case Default value REPLACE NO 18 TSTAMP TIME YES DATE BOTH NO Default TSTAMP NO TIME YES a timestamp Thhmmsst is appended to the dataset name DATE a datestamp Dyyddd is appended to the dataset name BOTH both a date and a time stamp Dyyddd Thhmmsst are appended to the dataset name If a new dataset name is specified the stamp is added to this new name respectively For very long data
71. hin the specified PDS ERROR COPY OF SPECIFIED MEMBER FAILED A member of a PDS shall be queued for sending It is necessary to copy the member into a sequential work dataset this procedure did not end successfully In this case further error messages will be displayed ERROR QUEUING OF UNLOADED PDS MEMBER FAILED A PDS or a member of a PDS shall be queued for sending An error has been detected Previously to this message further messages with a more detailed error description are issued ERROR REQUESTED DATASET IS EMPTY A dataset shall be queued for sending The dataset proved to be empty In this case the dataset will not be queued for sending but the disposition becomes effective immediately ERROR DATASET HAS RECORD LENGTH 0 AND NOT RECORDFORMAT UNDEFINED A dataset shall be queued for sending The logical record length of the dataset is 0 but the record format proved not to be undefined but fixed or variable hence the dataset will not be queued A record length of O is only accepted connected with record format undefined e g load module libraries ERROR RECORD LENGTH EXCEEDS MAXIMUM VALUE 32767 A dataset shall be queued for sending The logical record length proved to be greater than the maximum value 32767 Datasets with a greater record length than 32767 can not be read because of the data access method QSAM that is used by rvs Hence the dataset will not be queued for sending ERROR NUMBER OF BLOCKS GREAT
72. ic names i e dataset names 1 1 rvs User Functions For the rvs user the following questions may exist Where may datasets be sent to received from All computers with rvs or rvs compatible programs can work as sending or receiving station These programs must support at least one file transfer protocol that is used by rvs too Examples of these protocols such as File Transfer Protocol or ODETTE File Transfer Protocol are given in the VDA Recommendation 4914 or similar publications As further requirement equal line connections on both installations must be available What kind of datasets can be transmitted Any sequential or partitioned organized datasets may be transmitted independently of record format record or block length and contents of the dataset For instance program load modules may be transmitted too When the rvs Monitor does not communicate with rvsMVS but with a rvs compatible program restrictions in relation to the datasets to be transmitted are possible If for example File Transfer Protocol of the VDA Recommendation 4951 is used only sequential datasets with fixed record length may be transmitted rvsMVS User Manual 1 Introduction What user functions are supported by rvs By using rvs procedures batch jobs or the rvs ISPF panels the following functions may be executed e Queuing datasets for sending initiation of transmission e Controlling the reception of datasets i e to pla
73. ied or NONE is specified an event without subsystem name is produced In this case the event is written to all job scheduling subsystems depends on system EVENT NAME Name of event in OPC SPECIAL RESOURCE that is produced If no name is specified the physical dataset name of the received dataset is used as event name for the job scheduling subsystem DDNAME When queuing a dataset for sending the parameter DDNAME may be used instead of the DS name to identify the dataset that is to be sent In this case the DDN parameter must apply to the DD name the dataset is allocated to If more than one dataset is allocated the first dataset will be taken HOLD The parameter HOLD YES may be specified if the dataset to be sent shall not be immediately transmitted after establishing the line or the connection The parameter HOLD YES effects that the send entry will be set into the HOLD status The HOLD status may be reset by the rvs operator SYSOUT x or SYSOUT x pppp or SYSOUT Ge Pn This parameter may be specified if the dataset to be sent shall be placed in a SYSOUT class at the receiving station x refers to the SYSOUT class length 1 byte alohanumeric eppp specifies a SYSOUT program name length up to 8 bytes alphanumeric Specifying this the data will be processed with the special output writer oppp IT means the form number length 4 bytes alphanumeric The form number will be used if the data of a SYSOUT c
74. igital signature which protects the transmitted data set against changes and check the ownership of the transmitted data The implementation of this feature uses a hash function External Security Feature is based on an external program library run time version With setting the security parameter in the send request the following defaults are in effect and are not changeable with this feature version e for encryption DES3 with RSA e for hash value determination SHA1 During creation time the send request will be checked for fulfillment of the availability of the security feature e ofthe own station installation of the external security library e of the partner station installation of the external security library at the partners installation This is necessary to avoid postprocessing errors on the receiver side and file transfers which can t satisfied by the partner If one or both properties are missing the send request fails No default will be set 8 3 1 Steps to Use the External Security Feature The following chapter give a short description of How to use What to do Help is where 42 rvsMVS User Manual 8 Use of external rvs amp Features user Create a send request see chapter 2 USER Manual 1 Geta valid license with security code Y gedas Add the parameter SECURITY EXT GZIP to partner s station See chapter 6 2 0 entry Installation Manual Call rvs and select option 1 chapter 2 2
75. isk volume where the dataset to be received shall be allocated If this parameter is used in any case the parameter DEV DISK should be used too because the default value for this parameter may have an other specification see parameter DEVICE Default value NONE 5 DISP KEEP CATLG This parameter is obsolete from rvs MVS V 1 3 08 on adapting of rvs to DFSMS From this release on all datasets are cataloged after successful transmission While the transmission is active a timestamp is added temporarily as suffix to the dataset name However the parameter is still accepted but does not have a functional effect 6 TO sid or NACH sid The specification of this parameter effects that the received dataset will be atomatically queued for the rvs station sid In this case other parameters of the Resident Receive Entry as DISP or JOB will be ignored Default value NONE T ACCOUNT acct Abbreviation ACC Specification of an accounting key under which the transmission shall be accounted If this parameter is not specified the accounting key of the job userid that created the Resident Receive Entry will be taken acct may consist of any characters to a maximum length of 7 bytes Default value NONE Remarks An accounting like this will only take place if this has been defined during the Installation of rvs The following three parameters may be specified if the received dataset shall be copied into a sysout class
76. it is empty a send request will not be created but the disposition is executed This means if DISP DELETE is specified the empty file will be deleted If EFCHECK NO is specified no check is performed A send request is created even if the file is empty 31 JOBzpdsname member Automatic job start after sending the dataset rvs offers the possibility to start a job automatically aftersending the dataset This job must be a member of a PDS with name pdsname before the dataset has been queued 32 JSSEVENT NO YES Default NO Selection whether an event is written after sending of the dataset or not If YES is specified a job submit is not possible 33 JSSSYSIDz name NONE no Default Name of job scheduling subsystem e g OPCE the event is routed to If this parameter is omitted the corresponding rvs start parameter is used If this parameter is not specified or NONE is specified an event without subsystem name is produced In this case the event is written to all job scheduling subsystems depends on system 34 JSSEVTNMzname no Default Name of event in OPC SPECIAL RESOURCE that is produced If no name is specified the physical dataset name of the received dataset is used as event name for the job scheduling subsystem 35 COMPRESS NO If COMPRESSzNO is specified the send request will be handled without external Compression feature Also see the description s station table COMPRESS parameter in
77. its are used in your installation it may be possible that for example the queuing of datasets for sending is rejected by an exit In this case an appropriate error message is issued by rvs but the basic reason for rejecting the send request is not due to rvs and may only be cleared by the system programmer of your rvs installation rvs exits rvsMVS User Manual 2 rvs ISPF Panels 2 rvs ISPF Panels The rvs ISPF Panels offer the possibility to execute the following functions in an ISPF environment Queuing of datasets for sending Indication of queued sent or received datasets Deleting of Send Entries Creation of Resident Receive Entries Indicating deleting and changing of Resident Receive Entries Displaying rvs informations The screen formats are mainly self explaining in some cases you can get further explanations by pressing the PF1 key The rvs ISPF Panels are easily to be changed by the system programmer in order to satisfy the installation specific requirements Thus the following examples may not correspond to your own panels in all points After entering this command the following menu appears DF000P00 VW RECHNER VERBUND SYSTEM kkk kkk kk kk KkKKKKK kKkKKK kkkk kk kk kk kk KkKKKKK kk kk kk kk kxk k k k kkk kk kk KkKKKKK kkk KkKKKKK kk kk KkKKK kKkKKK kk kk kKkKKK kk kk kk kk KkKKKKK kk kk kk KkKKKKK SE
78. kkkkkxkxkxk RVS TRANSMISSION OF A DATASET SEND kkkkkkkkkkkkk k EXTERNAL SECURITY AND COMPRESSION SEND PARAMETER kdk dk k kkk k COMMAND gt SPECIFY PARAMETERS BELOW DISPLAY FURTHER OPTIONS gt N Y YES N NO 21 SECURITY gt E E EXT N NO 22 COMPRESSION gt G G GZIP E EXT N NO GZIP EXT PF1 PF13 HELP PRESS END KEY TO TERMINATE Remarks to the entry fields SECURITY If you specify SECURITY E normally is not necessary see rvsMVS license key and the parameters SECURITY COMPRESS in station Entry the external Security Feature will be called for this send request During creation of this send request the availability of this feature will be checked with e the stored security properties of the own station e the stored security properties of the partner station If one or both properties are missing the send request fails If you specify SECURITY N the external Security Feature will be not used for this send request COMPRESSION If you specify COMPRESSION E G normally is not necessary see rvsMVS license key and the parameters SECURITY COMPRESS in station Entry the external Compression Feature GZIP will be called for this send request During creation of this send request the availability of this feature will be checked with e the stored compression properties of the own station e the stored compression properties of the partner station 13 rvsMVS User Manual 2 rvs ISPF
79. l Index Index p Y 57 KEN TL RE 52 60 QDA RE 57 MAXRETRY eene totiens 52 61 AR LEE 57 Messages VEIEE ene emo ee E ERE ERR 57 DFO80A00 entere 66 ACCOUNT i teet teen eiae 46 55 while creating Resident Receive Entries 31 ACREMOTE eet etes 46 while Deleting Resident Receive Entries 32 Code translation sse see CODETRNS while deleting send entries sss 27 CODETRNS A 12 51 60 while queuing datasets esee 26 COMPR EE 48 MME Aen rtt eer petentes 59 COMPRESS create Send Request 52 hp sum 25 COMPRESSION hrere need 11 13 NEW DSNAME phe este ete me 9 Controldataset e aT era er en ra a 6 ORT ETE EE E E tre E 43 54 COPIES 5 TEE E E EET re 11 47 56 Partitioned Datasets essere 74 RENE EE 59 NR 36 RER neenon e prede 15 PRIORE e e ee pereunte 50 RRE 11 44 OTIME terrre ree reete 50 RI KE 47 56 Receiving Datasets DESTINATION eite teneret 11 Control by Resident Receive Entries 29 DE VICE E 44 54 Control by Sender 28 DEVREMOT hae 5 edente 48 Standard Drocesaing sse 28 DEOT TAQ ws entes 38 REMOTE OPTIONS eatem ieee 10 DEQ078 A00 aita bees 36 REPLEACE Soest aioe ai emn 11 49 58 DFO0804A00 eese 43 63 Resident Receive Entries DF48A iss occ onaiotem ae bebe mettere gs 77 Creating ere ere
80. l be renamed by appending a timestamp when it is queued for sending The renamed dataset will be deleted at end of transmission Exeception Processing of GDG datasets see Chapter 4 6 HOLD YES NO The parameter HOLD YES may be specified if the dataset to be sent may not be immediately transmitted after establishing the line or the connection The parameter HOLD YES effects the send entry to be put into the HOLD status The HOLD status may be reset by the rvs operator Default value HOLD NO 7 ACCOUNT acct Abbreviation ACC Specification of an accounting key Under this key the transmission will be accounted When this parameter is not specified the accounting key of that Job Userid will be taken the dataset has queued for sending acct can consist of any character chain of a maximum of 7 bytes Default value NONE Remarks An accounting like this will only take place when this has been specified while installation of rvs 8 ACREMOTEzacct Abbreviation ACR Specification of a accounting key under which the transmission will be accounted at the receiving station This value will be used at the receiving station only if there is no accounting key available acct can consist of any character chain of a length of 7 bytes Default value the accounting key that has been used under the parameter ACCOUNT The following three parameters may be specified when the dataset to be sent shall be placed in a SYSOUT
81. l characters combination are and Default value The name specified under DSNOLD 2b DDNAME name Abbreviation DDN When queuing a dataset for sending the parameter DDNAME may be used instead of the DS name to identify the dataset that is to be sent In this case the DDN parameter must apply to the DD name the dataset to be sent is allocated to No default value 3 DEVICE DISK TAPE Abbreviation DEV for DEVICE D for DISK T for TAPE This parameter is obsolete from rvs MVS V 1 3 08 on adapting of rvs to DFSMS From this release on only cataloged datasets may be queued for sending The device type is determined by rvs from the system catalogue However the parameter is still accepted but does not have a functional meaning 45 rvsMVS User Manual Appendix A Control parameters of program DF080A00 46 rvsMVS User Manual Appendix A Control parameters of program DF080A00 4 VOLUME volume Abbreviation VOL This parameter is obsolete from rvs MVS V 1 3 08 on adapting of rvs to DFSMS From this release on only cataloged datasets may be queued for sending The volume is determined by rvs from the system catalogue However the parameter is still accepted but does not have a functional meaning 5 DISPOSIT disp Abbreviation DISP KEEP The original dataset will be transmitted The data is not copied and remains cataloged after end of transmission DELETE The original dataset wil
82. lass shall be printed on a special formular COPIES Specification of a number of copies which shall be made during printing from a SYSOUT class n specifies the number of copies to be printed 1 to 99 This parameter can only be used in connection with the SYSOUT parameter DESTINATION Name of a RJE station length 6 characters alphanumeric After complete receiving of data by the rvs station the data will be transmitted to the RJE station This parameter can only be used in connection with the SYSOUT parameter COMPRESSION Parameter removed from the screen only available by using a job to create a send request REPLACE This parameter has been deleted from the panels because it is only supported by few partners However you may still use this parameter in program DF080A00 for queuing datasets 11 rvsMVS User Manual 2 rvs ISPF Panels RJE This parameter enables in case the receiving station fulfills further prerequisites the complete using of the RJE function that means e Sending a job to the receiving station in a sequential dataset e Start and execution of the job at the receiving station e Sending the job output back into a special sysout class of the receiving station As a prerequisite an output writer must be available at the receiving station which is able to copy the job output from the sysout class in a sequential dataset Additionally the output writer must initiate the retransmission of the
83. le may be omitted In this case the member STATIONS of the tables dataset will be dynamically allocated If a membername other than STATIONS is used for the stations table specification of this DD statement is mandatory in all cases 24 rvsMVS User Manual 3 Sending Datasets 2 SID ST1 DSN ABC DATEI01 DISP DELETE The dataset is renamed a timestamp is appended while it is queued for sending The dataset is deleted after end of transmission 3 SID ST1 DSN XXXXX ABCDEF DISP KEEP DSNOLD ABC DATEI04 In this example the rename function will be used the cataloged dataset with DS name ABC DATEIO4 is to be transmitted under the new DS name XXXXX ABCDEF to rvs station ST1 Because DISP KEEP is specified the dataset ABC DATEI04 remains cataloged after queuing for transmission and will not be deleted after transmission 4 SID ST3 DSN ABC DATEI03 As example 3 but the dataset queued for sending resides on a magnetic tape In case of using magnetic tapes the rvs operator must enter a send command before the dataset may be transmitted The Send command effects the start of a job which copies the dataset from tape to disk The transmission may not start until the dataset is copied to disk 5 SID ST5 DSN ABC DATEI05 DEVR DISK The dataset with DS name ABC DATEIO5 is to be sent to rvs station ST5 The data will be received on disk and will be cataloged in the remote station DISPR CATLG is default See remarks to par
84. m programmer See also Installation Manual Chapter 6 11 27 MAXRETRYznnn Default MAXRETRY 255 Specifies the maximum number of transmission retries that will be made The specified value must be in the range 0 255 A value of 0 means no specification i e transmission retries are handled according to rvsMVS default behaviour The effect of this parameter is determined by the parameter TRANSHOLD If TRANSHOLD is set to YES a send transfer will be set in hold status when the maximum number of transmissions has been reached For a receive transfer when the transmission retries has been reached further attempts to receive the file will be rejected If TRANSHOLD NO is specified transmission retries will continue after the specified maximum number of retries has been reached Refer also to the parameter ERRJOB with which a job can be started when the specified maximum number of retries has been reached 28 TRANSHLD YES NO Selects the action to take when the maximum number of retries has been reached the retry threshold For TRANSHLD YES a send transfer will be set in hold status when the retry threshold has been reached For reception of a file further attempts will be rejected when the retry threshold is reached If TRANSHOLDzNO is specified transmission retries will continue after the retry threshold has been reached 29 ERRJOB pdsname member Specifies the name of a job to be started when a transmission fails A sen
85. me if the rvs rename function will be used In cases like this the DSN parameter as a central search and control name will be used in all listings i e display of already executed transmissions In order to identify different datasets rvs always uses the combination of both of these parameters The expression identical dataset in this manual always refers to datasets where at the DSN parameter the same reference name is specified 1 4 Data Protection rvs itself does not provide any kind of data protection This means that there is no standard function within rvs for checking and eventually rejecting unauthorized access to datasets Especially it may always be possibible to create entries for sending any dataset with a job TSO session using program DF080A00 Only an installed system for controlling access authorizations e g RACF may reject user access to the rvs Control Dataset To us it seems not to be very efficient for implementating such functions to rvs by standard because of the in part very special requirements of data protection in different installations For this reason interfaces for different exits are implementated within rvs so an installation specific handling of data protection may be possible This applies to access control to datasets as well as access control of jobs that may be started by the rvs Monitor The interfaces of the exits are explained in detail in the Appendix of the Installation Manual If these ex
86. name following message appears DATASET name QUEUED FOR SENDING In case of an unsuccessful queuing the message REQUEST NOT ACCEPTED will be issued Reasons for an unsuccessful queuing for sending may be e The syntax of an parameter has been specified incorrectly e The parameter value is incorrect e The specified dataset is not available respectively the dataset name has been coded incorrectly quotes e The dataset to be transmitted is empty normally rvs does not transmit empty datasets In this case the queuing for sending will be rejected and the specified disposition KEEP or DELETE will be executed immediately Note For transmission of empty data sets refer to the parameter EFCHECK within this manual In case of an unsuccessful queuing the SYSPRINT protocol should be checked for error messages Appendix B in this manual contains a list of messages of program DF080A00 27 rvsMVS User Manual 3 Sending Datasets 3 2 Deleting Send Entries Deleting send entries will be executed also by the program DF080A00 The JCL used to delete send entries is the same as the JCL used to create send entries see Chapter 2 1 certainly the contents of the control cards must be changed In order to delete a send entry the parameters SID DSN and FREE S must be specified If a multiple of send entries exists with identical SID and DSN parameters the VOLUME and or DSNOLD parameters must be specified fo
87. nstallations The structure of the procedure PDF0002A is described in the rvsMVS Installation Manual The indication of datasets which have been sent or received or which are still to be sent may also be executed by the rvs ISPF panels see Chapter 1 Additional it is possible to create a sequential dataset containing a formatted copy of the rvs Control Dataset This formatted copy may be used as a basic dataset for creation of own listings with an own layout and for access from own programs A detailed description of this function is contained in the Appendix of the rvsMVS Installation Manual By calling the procedure PDF0002A two lists will be generated LDF0001 listing of sent datasets LDF0002 listing of received datasets The creation of one or both lists will be suppressed if no data for listing are available In this case no list output will be created The listing is sorted by following criteria e ascending selecting the second and third character of the dataset name e ascending selecting the stations ID of the receiver respectively the transmitter e ascending selecting the whole dataset name e descending selecting date and time of the transmission the termination time of the transmission will be selected By specifying of some parameters during calling the procedure a selection of transmissions can be done Specifying more selection criteria effects that only transmissions will be listed which fulfill all the criteria The
88. on ST1 shall be deleted 4 4 1 Messages issued during deleting Receive Entries The program DFO80A00 issues messages via SYSPRINT whether the entry has been deleted successfully or not If the entry has been successfully deleted the message RECORD DELETED FROM DATASET appears In case of an unsuccessful operation the message REQUEST NOT ACCEPTED will be issued Appendix B of this manual contains a list of messages issued by the program DFO80A00 33 rvsMVS User Manual 5 Transmission of GDG Datasets 5 Transmission of GDG Datasets The handling of GDG datasets preparing for sending and receiving is different to the handling of other datasets The effect of some parameters described in Chapter 9 is different for GDG datasets This affects the parameters DISP DSN and DSNNEW respective DSNOLD as well during preparing GDG datasets for sending as to control the reception of GDG datasets The following describes the handling of GDG datasets by rvs at the sending and at the receiving station 5 1 Sending of GDG Datasets The specification of the physical dataset name during preparation for sending should be done in the usual form i e DSN GDG BASENAME 0 During preparation for sending the rename function may be used The DSN can be specified as above i e DSNOLD GDG BASENAME 0 There are two ways to make sure that the dataset will be handled as a GDG in the receiving
89. owing informations will be issued Information about data compression and transmission speed Default value LVL L1 If important further information about the transmission will be issued for example the PDS and member name of a job started after receiving the dataset A short explanation about the most important specifications contains the preface of the listing The comment DS RECEIVED BY FINAL STATION in conjunction with sent datasets means the dataset has been completely received by the final receiver even if the transmission was not a direct but an indirect via relais stations Examples EXEC PDF0002A DAYz 1 Listing of all transmissions which are not older than one day EXEC PDF0002A DAY 7 SID ST1 Listing of all transmissions which took place within the last 7 days in relation to station SID ST1 38 rvsMVS User Manual 7 Overview about Resident Receive Entries 7 Overview about Resident Receive Entries The subsequently described batch program DF077A00 is used to list the Resident Receive Entries all or a subset of the rvs control dataset The listing of Resident Receive Entries may also be executed with the rvs ISPF panels see Chapter 1 Additional it is possible to create a sequential dataset containing a formatted copy of the rvs Control Dataset This formatted copy may be used as a basic dataset for creation of own listings with an own layout and for access from own programs A de
90. r identification If more than one send entry exist that match the specified values SID DSN and perhaps VOLUME or DSNOLD only the first of these entries will be deleted Hints If the transmission has already started the deletion of a send entry is not possible In this case only the rvs operator can interrupt the transmission Example SID ST1 DSN ABC DATEIO1 FREE S The send entry of the dataset ABC DATEIO 1 that has been queued for transmission to rvs station ST1 shall be deleted 3 2 1 Messages that occur when deleting send entries The program DFO80A00 informs via SYSPRINT whether the deletion has been successfuly executed If the deletion has been executed the following message appears RECORD DELETED FROM DATASET If the deletion was not successfully the message REQUEST NOT ACCEPTED will be issued Appendix B in this manual contains a list of messages of program DF080A00 Reasons for an unsuccessful deletion of a send entry may be e The syntax of a parameter is incorrect e A parameter value is incorrect e The specified dataset has already been transmitted 3 The deletion of send entries can also be executed by means of the ISPF panels see Chapter 1 28 rvsMVS User Manual 4 Receiving Datasets 4 Receiving Datasets Normally datasets will be received on disk Whether further processing steps are to be executed for a specific dataset i e the dataset will be cataloged a
91. r s installation This is necessary to avoid postprocessing errors on the receiver side and file transfers which can t satisfied by the partner If one or both properties are missing the send request fails and will be set to the default compression type see COMPRESS parameter in station table 41 rvsMVS User Manual 8 Use of external rvs amp Features 8 2 1 Steps to Use the External Compression Feature What to do Help is where user Create a send request see chapter 2 USER Manual 1 Geta valid license with compression code Z gedas Add the parameter COMPRESS GZIP to partner s station entry See chapter 6 2 0 Installation Manual Call rvs and select option 1 chapter 2 2 Insert the at least SID and DSNAME parameter and without select chapter 2 1 S for further options panel DF100P00 __ The rest will be done by rvsMVS automatically 8 3 External Security The security of rvs uses both a symmetric cipher DES and a public private key cipher RSA The encryption works by using a public private key cipher to share a key for the symmetric cipher Because of the symmetric key sharing the used symmetric key is different for each file transmission The actual data set being sent is then encrypted using the session key and sent to the partner It is possible to create and use private and public keys with a size between 768 and 2048 bit In case of encryption of a data set rvs provides a document s d
92. receive entry the rvs start parameter EXPDT will be taken With NONE no expiration date is used for dataset allocation 23 JSSEVENT NO YES Default NO Selection whether an event is written after receiving of a dataset or not If YES is specified a job submit is not possible 24 JSSSYSID name NONE no Default Name of job scheduling subsystem e g OPCE the event is routed to If this parameter is omitted the corresponding rvs start parameter is used If this parameter is not specified or NONE is specified an event without subsystem name is produced In this case the event is written to all job scheduling subsystems depends on system 25 JSSEVTNM name no Default Name of event in OPC SPECIAL RESOURCE that is produced If no name is specified the physical dataset name of the received dataset is used as event name for the job scheduling subsystem 61 rvsMVS User Manual Appendix A Control parameters of program DF080A00 26 CODETRNS YES NO tablename Default no code translation Code translation when a file is received this parameter is also valid for code translation within the ODETTE File Transfer Protocol FORMAT TEXT YES a code translation is done from ASCII to EBCDIC code translation table Installation Manual Chapter 6 11 NO no code translation is done Furthermore any code translation may be done by using system defined tables These tables are maintained by your rvs syste
93. rvsMVS Installation Manual 36 SECURITY NO If SECURITY NO is specified the send request will be handled without external Security feature Also see the description s station table SECURITY parameter in rvsMVS Installation Manual 37 MAXRETRYznnn Default MAXRETRY 255 Specifies the maximum number of transmission retries that will be made The specified value must be in the range 0 255 A value of 0 means no specification i e transmission retries are handled according to rvsMVS default behaviour The effect of this parameter is determined by the parameter TRANSHOLD If TRANSHOLD is set to YES a send transfer will be set in hold status when the maximum number of transmissions has 53 rvsMVS User Manual Appendix A Control parameters of program DF080A00 been reached For a receive transfer when the transmission retries has been reached further attempts to receive the file will be rejected If TRANSHOLD NO is specified transmission retries will continue after the specified maximum number of retries has been reached Refer also to the parameter ERRJOB with which a job can be started when the specified maximum number of retries has been reached 38 TRANSHLD YES NO Selects the action to take when the maximum number of retries has been reached the retry threshold For TRANSHLD YES a send transfer will be set in hold status when the retry threshold has been reached For reception of a file further attempts
94. s or other specifications about the dataset that may be found in the catalog where the dataset is cataloged DF080Bnn UPDATE OF RVS CONTROL DATASET DATE yyddd TIME hh mm PROGRAM LEVEL mm dd yy hh mm Start message of the program Besides version number of the program nn the CPU date and the time of the program call are issued If there has been made a PARM specification while calling the program this PARM specification is issued too e g PARM RESIDENT DEFAULT VALUE INVALID DISPOSITION CATLG ASSUMED A resident receive entry should be created The specified disposition UNCATLG or DELETE is not allowed for resident receive entries Thats why disposition CATLG is assumed 67 rvsMVS User Manual Appendix 0 Messages of program DF080A00 DEFAULT VALUE DSNAME FROM ALLOCATION A dataset shall be queued for sending but instead of specifying the DSN parameter the DDN parameter has been specified In this case the allocated DS name will be determined with the Job File Control Block of the existing dataset allocation DEFAULT VALUE VOL SER FROM ALLOCATION volume A dataset shall be queued for sending but instead of specifying the DSN parameter the DDN parameter has been specified In this case the respective volume where the dataset resides is determined with the JOB File Control Block of the existing dataset allocation DEFAULT VALUE VOLUME NUMBER S FROM SYSTEM CATALOG volume A cataloged dataset shall be queued
95. s to use timestamps see parameter TSTAMP within this section In the job the physical dataset name of the received file can be accessed to by specifying PFILE by the physical dataset name of the received dataset While creating the JCL it must be noticed that in lines where such replacements take place is enough space to insert the dataset name which normally takes more space than With introduction of the support of multivolume datasets version 2 2 05 the replacement of the following strings is no longer possible Additional characterstrings variables that are substituted by the rvs monitor before job submission 21D will be replaced by the ID of the remote station This is specially useful when a resident entry has been specified with SID ANY So the further processing of the dataset may be controlled according to its original station VFILE will be replaced by the virtual file name this is the dataset name which the sender passes to the receiver QDATE will be replaced by the date when the file was queued for transmission format Dyyddd yy year ddd day QTIME will be replaced by the time when the file was queued for transmission format Thhmmsst hh hours mm minutes ss seconds t 1 10 seconds 2RRUSR Will be replaced by RACF Userid who created the send entry SNA only 2Y YY Will be replaced by year e g 2005 UN Will be replaced by year e g 05 2N Will be replaced b
96. s with more detailed informations may be issued Only the rvs exit installer may decide what rules restrictions for queuing datasets for sending are existing ERROR USER ID xxxxxxx NOT FOUND IN USER TABLE ULS Error occurred whileaccessing the Permission Table Actual racfid user for this send request not found in ULS user table ERROR PERMISSION TABLE ENTRY FOR DATASET NOT FOUND ULS Error occurred while accessing the Permission Table Entry for queued data set not found in ULS Permission Table 74 rvsMVS User Manual Appendix 0 Messages of program DF080A00 A 9 Return Codes of Program DF080A00 Return Code Description 0 DFO80A00 has ended successfully The action has been executed successfully 4 Warning Action has not ended successfully E g a dataset could not be queued for sending because it is empty and the parameter EFCHECK NO was not specified 8 Error Action has abnormally ended because of an error condition E g incorrect parameters incorrect dataset specifications or dataset is not cataloged 12 Severe Error Action has abnormally ended due to a temporary error condition E g SID not found error while renaming or allocating the dataset to be send 24 ULS only Check of permission rights failed member missing 28 ULS only Matching entry in permission member for given dataset not found 32 ULS only Matching entry in member for user RACF not found 40 UL
97. set to be received dsname may be specified in the length of 1 to 44 characters PROCOPT NONE PROCOPT NONE JOB Only Resident Receive Entries will be listed where neither JOB SYS parameters nor SYSOUT parameters has been specified during the creation PROCOPT JOB Only Resident Receive Entries will be listed where the JOB parameter has been specified during the creation PROCOPT SYS Only Resident Receive Entries will be listed where the SYSOUT 39 rvsMVS User Manual 7 Overview about Resident Receive Entries parameter has been specified during the creation Default value NONE ZZ nn or LC2nn Specification of a maximum line number nn If a number of nn lines has been printed a skip to the next page will occur the listing contains machine control characters nn may be a value between 10 and 99 The default value is LC 68 The listing will be issued via the SYSPRINT DD statement In case of more parameters will be specified in the PARM field they must be separated by commas The use of more than one parameter effects a listing of those Resident Receive Entries which fulfil all selection criteria In case of specifying PARM SID ST1 DSN DDF in the EXEC statement all Resident Receive Entries for station ST1 with a dataset name which starts with DDF will be listed Each parameter of the Resident Receive Entries is connected to a leading key word These key words are the same as
98. set names the stamp is truncated 19 STORCLAS name NONE Name of the DFSMS parameter STORAGE CLASS This parameter is used for the allocation of received DFSMS managed datasets If this parameter is not specified in the resident receive entry the rvs start parameter SMSSTOCL will be taken With NONE no storage class is used for dataset allocation 20 MGMTCLAS name NONE Name of the DFSMS parameter MANAGEMENT CLASS This parameter is used for the allocation of received DFSMS managed datasets 60 rvsMVS User Manual Appendix A Control parameters of program DF080A00 If this parameter is not specified in the resident receive entry the rvs start parameter SMSMNGCL will be taken With NONE no management class is used for dataset allocation 21 DATACLAS name NONE Name of the DFSMS parameter DATA CLASS This parameter is used for the allocation of received DFSMS managed datasets If this parameter is not specified in the resident receive entry the rvs start parameter SMSDATCL will be taken With NONE no data class is used for dataset allocation 22 EXPDT yyyyddd nnnn NONE With this parameter the expiration date of the received datasets is determined yyyy year e g 1998 ddd day e g 365 this means 31 12 1998 or nnnn number of days from the current day on e g 30 current date 1 12 1998 expiration date 31 12 1998 If this parameter is not specified in the resident
99. tailed description of this function is contained in the Appendix of the rvsMVS Installation Manual Which Resident Receive Entries are to be listed and how detailed they are issued may be controlled via PARM parameter in the EXEC statement of program DF077A00 In this PARM field you can specify one of the following parameters in any combination LVL 0 1 2 The parameter LVL level controls how detailed the values of the Resident Receive Entries are issued LVL 0 Only that values will be listed which have been specified during creating the Resident Receive Entry as there are SID respectively ORT DSN ACCT DEVICE DISP UNIT and TO respectively NACH If no parameters has been specified the default values will become effective LVL 1 All PARM values will be listed which has been specified during creation of the entry or which were effective during creation of the entry or which have been effective as default value LVL 2 In addition to the values listed in connection to LVL 1 the creation date and the last used date of the entry will be issued A last used date of 0 means that the entry has not been used The default value is LVL 1 SID sid or sid means a three character stations ID Only Resident Receive Entries ORT sid of the station sid will be listed DSN dsname Only Resident Receive Entries which starts with dataset name dsname will be listed dsname is the entire dataset name or a part of the data
100. ter alphanumeric of the dataset to be sent When a member of a PDS is to be sent besides the DS name the member name has to be specified too in the usual form PDS name membername Hints If the rename function shall be used the DSNOLD parameter must be specified with the real disc DS name of the dataset to be sent For the DSN parameter the new reference name of the dataset must be specified The transmission than will be executed under this new reference name Additionally in all list programs this new name will be used as surchargument In order to avoid mistakes the new name specified under the DSN parameter should be specified in the meaning of a valid Job Control Language dataset name The specification of the real DS name of the dataset to be sent under the DSNOLD parameter must be done in the same form as in the JCL that means fully qualified and without including quotes Default value The name specified under DSN 15 VOLREMOT volume abbreviation VOLR Specification of the disk volume where the dataset shall be stored at the receiving station volume means a 6 character name of the adequate disk volume Attention see remarks on parameter 19 16 UNITREMOzunit abbreviation UNITR Specification on which symbolic unit group i e SYSDA the dataset shall be stored at the receiving station unit describes the max 6 character name of the unit group Attention see remarks on parameter 19 17 DEVR
101. time range 00 00 lt strttime lt 23 59 Default is the actual time 27 STRTDATE 9 999 Earliest sending date if the day 999 lower than the actual day next year is assumed i actual day default 9 0 lt strtdate lt 9 999 001 lt strtdate lt 365 28 SENDWIN hh mm hh mm Interval to start the transmission Possible values are 00 00 to 24 00 This parameter specifies the start of the transmission only Running transmissions will not be canceled by reaching the end of this interval 29 CODETRNS YES NO tablename Default no code translation Code translation when a file is received this parameter is also valid for code translation within the ODETTE File Transfer Protocol FORMAT TEXT YES a code translation is done from EBCDIC to ASCII code translation table Installation Manual Chapter 6 11 NO no code translation is done Also any code translation may be done by using system defined tables These tables are maintained by your rvs system programmer See also Installation Manual Chapter 6 11 30 EFCHECK YES NO Default EFCHECK YES Specification whether the file to be sent shall be checked for empty content EFCHECK YES or not If EFCHECK YES is specified or valid as default value the file to be sent is checked for 52 rvsMVS User Manual Appendix A Control parameters of program DF080A00 empty content If it is not empty the send request will be created If
102. tion Related to sent datasets or datasets which are queued for sending the name of the final rvs receiving station When you leave this field blank all defined stations will be searched You may also specify an initial part of the STATION ID e g Z for all stations beginning with Z DS NAME It is optional to specify this field If only a subset of the transmissions shall be listed a part of the dataset name may be specified This effects that only transmissions of datasets will be listed whose dsnames start with the specified part of the dataset name e g userid cl or cr or for all entries starting with your userid DAYS Selection of a time period of the last O up to 3 days or more The transmissions that took place in this period will be displayed Example After entering the values S DIRECTION ST1 STATION ID ABC DS NAME and 1 DAYS the following screen will be displayed If no STATION ID or only a part of the SID is specified every entry will be displayed with the SID respectively rvsMVS User Manual 2 rvs ISPF Panels kkkkkkkkkkkkkkkkkkkkkkkkkkkkk DE210P00 k kkkkkkkkkkkkkkkkkkkkkkk ROW 1 OF 7 RVS DISPLAY OF TRANSMISSIONS KKK Fe He He He ke kk ee ke kk ke ke kk ke ee ke ke kk ehe kc kk ee ke ko kk ee KKK RAK kc kc ke ke ko kc He e He ke kc kc kc ee koc kc e e He He He KEK KKK COMMAND gt SCROLL gt PAGE S ELECT ENTRY H OLD F REE D ELETE ACTIVE DATE 96 330 TIME 12 3
103. tion e Sending the job output back into a special sysout class of the receiving station As a prerequisit an output writer must be available at the receiving station which is able to copy the job output from the sysout class in a sequential dataset Additionally the output writer must initiate the retransmission of the sequential dataset by calling an exit In any case the parameter RJEZYES can be used when a job shall be transmitted and executed at the receiving station The prerequisits are a rvsMVS Monitor at the receiving station and an authorization of the sending station by the receiving station for this function and a fixed record length lrecl 80 of the job dataset to be sent Details of retransmitting the output may be discussed with the software manufacturer 21 FORMAT TEXT This parameter works only when the transmission of a dataset uses the ODETTE File Transfer Protocol or the FTP component of rvsMVS In this case the content of the data to be sent is modified in the following way e Data is changed from EBCDIC code to ASCII code e Atthe end of any logical record control characters carriage return and linefeed will be added It is possible to use special code translation tables Please refer to the parameter CODETRNS 22 PRIOznn Specification of a priority value nn may be a value between 0 and 99 Among others this priority is used to determine the sequence in which remote stations will be called automaticly AUTOD
104. tion of each type Send Resident Send or Resident Receive may be processed in a single call of the program DF080A00 7 The processing of entries of two or more types Send Resident Send or Resident Receive in a single call of the program DF080B00 is not possible These statements must be separated 8 Statements with an in column 1 will be treated as comments A 2 Parameters for queuing datasets for sending 1 a SID sid or ORTzsid rvs station identification sid is the name of the remote receiving station sid is a three character chain that consists of alphanumeric characters Keywords SID and ORT are synonymes The validity of the station id is checked and if not found in the rvs station table the creation of the send entry is rejected No default value One of these parameters SID ORT or SIDLIST must be specified 1b SIDLIST name Dataset name of a distribution list For each rvs station id contained in this list a send entry will be created The list must be a PS file or a PO member with format FB and LRECL 80 This file has to contain one rvs station id in a line position 1 3 Comment lines start with character at position one 44 rvsMVS User Manual Appendix A Control parameters of program DF080A00 Example HA KKK KK ke ke ke k k IK Top of Data 8 HII III III I I I I I I I I I I I I I I I I I I I I III I I IK DISTRIBUTION LIST EXAMPLE ABC XYZ okckckckck kk k kk kkkkkk Bottom of Data KE
105. trol parameters essere nnns 44 A 2 Parameters for queuing datasets for sending eee 44 A 3 Parameters for Resident Receive Entries eese 55 A 4 Call of DF080A00 within a program Interface program DF1804A 64 A 4 1 Call of program DF180A sssssssssssssssseeee ennt enne nnns nnne tennis 64 Messages of program DF0804A00 eeeeeeeeeeeeeneeeenn nnne nennen nennt nnn nnns 67 A 5 Information Messaggs neeseeeeeenereeen nennen enne nnne nnne nnn inse nnn insane nnmnnn nnmnnn nnn 67 A 6 Warning Messages eseeeeeeeeeeenee enne enne nnn nnne nnn anne nnmnnn intr nnmnnn nnmnnn nnana 69 A 7 Action Messages renuit etie crates cres te ce cti Reno cea Tace aie Ai 69 A 8 Error Messages terns Ee eld 71 A 9 Return Codes of Program DFO80A00 c c cccessccssseeeeseeeeeseeessaeseseeeeeseeeseeeseseaeeneeeeees 75 B Transmissions of Partitioned Datasets PDS cccssseeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeneees 76 B 1 Exceptional Rules when Transmitting PDS eese 76 B 2 Sending a PDS Member as sequential DataSet sese 76 B 3 Description of the procedure of PDS Transtfer esee 77 B 3 1 Queuing for Sending REENEN 77 B 3 2 Transmission
106. uing time If the maximum of 44 characters of the DS name is exceeded it will be truncated to the first 44 characters When the work dataset has been transmitted completely a PDS will be new allocated at the receiving station and the data are copied from the sequential dataset to the new PDS The name of the PDS is identical with the one of the work dataset but without timestamp When the PDS has been successfully loaded the work dataset will be deleted the PDS will be cataloged and a message about the successful reception of the PDS will be sent to the sender of the dataset 78 rvsMVS User Manual Appendix B Transmissions of Partitioned Datasets PDS B 4 Special User Utilities B 4 1 Program DF148A providing for the own station id rvs ID Some applications need to know the station id of the local rvs installation For this purpose program DF1484A fetches the rvs id from the control dataset and puts it into the allocated dataset Allocations DD rvsMSG DS Output Dataset LRECL 80 DD KD DS rvs Control Dataset You may leave off the allocation of the Control Dataset in this case it is allocated dynamically The module can be called in batch under TSO or from another program Output rvsMSG DF148A0 SID xxx XXX rvs station id Following return codes reg 15 are set by the program RC20 everything s ok RC 4 parameter record not found within control dataset RC 8 any other error 79 rvsMVS User Manua
107. used here It is also possible to pass the control parameters via SYSIN to program DFO80A00 In this case the field which is passed to program DF180A must indicate that the field does not contain control parameters This means the binary length value must be set to zero After call of program DF180A the return code may be tested in order to determine whether the activities could be executed without errors or not Activity in this case means one of the following things e Queuing of a dataset for transmission creating a send request Deleting a send request Creating of a resident receive entry Deleting a resident receive entry A returncode of 0 indicates that all activities have been executed successfully a returncode of 8 indicates that at least one activity could not be executed successfully If the length of the field passed to program DF180A exceeds the number of 256 bytes the program terminates abnormally with user abend 1805 64 rvsMVS User Manual Appendix A Control parameters of program DF080A00 Remarks e During call of program DF080A00 some messages are written to SYSPRINT see Appendix B of this manual Therefore the SYSPRINT DD name must be allocated in each case e For MVS XA users LINK attributes for program DF180A are AMODE ANY RMODE 24 e Program DF180A is reusable Example 1 Queuing of a dataset for transmission within an assembler program In this case the control parameter are passed to
108. y month 2D Will be replaced by day 2H Will be replaced by hour 2M Will be replaced by minute 2S Will be replaced by second 2MS Will be replaced by millisecond Attention All replacements are done before expansion of procedures if any 13 SPACE nnnn Abbreviation SP Specification of the disk space that will be allocated during reception nnnn specifies the max 4 character number of allocatable tracks 58 rvsMVS User Manual Appendix A Control parameters of program DF080A00 This parameter should only be specified when space problems occur during reception of specific datasets If at the sending station rvsMVS is installed this parameter will be ignored The space allocation will then be executed with a value that is computed by the sending station Default value SPACE 100 tracks respectively the value that is computed by the sending station 14 UNITzname Specification of a symbolic unit name name where the dataset to be received shall be allocated This specification should only be done when the dataset shall be received on a specific unit group Default value The value which has been defined in the rvs start parameter see rvsMVS Installation Manual 15 DSNNEWzname This parameter enables the reception of a dataset under a new name rename function name describes the maximum 44 character physically dataset name under which the received dataset shall be

User Manual - ServiceNet

Contents

Download Pdf Manuals

Related Search

Related Contents