Home

® User Manual

Contents

1. a use defaults SENDJOB C VDSN sending2 SID st2 JOB home rvs bin snd sh ee Job should start after data have been transmitted successfully SENDJOB C VDSN sending3 SID st2 JOB home rvs bin snd sh delet SENDJOB SENDJOB D VDSN sending3 SID st2 SS ee update SENDJOB SENDJOB U DSN sending2 SID st2 JOB home rvs bin sendok sh User Manual rvs Rev 01 04 2000 133 gedas deutschland GmbH Competence Center EDI rvs User Manual 4 2 9 Command USER Function modify rvs user table set user name set dialog language for user set privileges for user Qualifiers CREATE create entry in rvs user table DELETE delete entry in rvs user table UPDATE update entry in rvs user table If no qualifier has been specified the entry is either created or updated depending on whether it already exists or not Parameters UID optional user ID which identifies the entry to be modified a value different from the user ID of the current user may be specified only by a privileged user default current user NAME optional new name of user LANGUAGE optional new language setting e g E English D Deutsch PRIV optional new privilege for user U user O operator A administrator Examples x create new user default own UID USER C X create new user USER C UID newuser LANGUAGE d NAM
2. Modifying a send order This is how you modify a send order e Use the mouse to click the send order that you want to modify e Execute the menu command Edit Change The Change Send Entry dialog window then opens In this window you can modify all the fields for the send order e Carry out the changes desired e Confirm your entries with OK The send order has been modified rvsNT displays the modified order in the list of files which have not yet been sent Temporarily hold If you want to create a send order and then release it later you should carry out the following steps to put a temporary hold on it e Click Change Options in the New Send Entry dialog window e Enter the letter Hin the Start Time field e Confirm the entry by pressing the button OK Releasing a send order If you have put a hold on a send order you can also release it for subsequent execution This is how you release one or more orders for execution e Use the mouse to click on a single send order NOTE To find out how to limit the display to the send orders placed on hold or certain file types please refer to the chapter Select display criteria e Release the orders selected with Release or the Edit gt Release menu command 101 User Manual rvs Rev 01 04 2000 gedas deutschland GmbH Competence Center EDI rvs User Manual Restart send order rvsNT repeats an unsuccessful transmission attempt in accordance wi
3. Station ID of receiver File C rvs system readme tt file to be send New File Name Sendtest virtual file name Options Disposition M delete after Change Options Format C Text Fixec Variable Unstructured Input Code code of the local file A ASCII E EBCDIC OutputCode code on receivers side AsASCII E EBCDIC Start Time YY MM DD HH MM H hold at first Timestamp M add Label for serialisation only I save settings Cancel Help e Manually enter the station code for the receiving station in the Station ID field or e Use Select to open the Select Station selection window and select the station code Select Station Ed ID Description RSL remote station via SNA remote station via TCPIP RSX remote station via X 25 ISDN Test for ISDN communication 97 User Manual rvs Rev 01 04 2000 gedas deutschland GmbH Competence Center EDI rvs User Manual Example LOC LOC is the standard setting e f you want to send the file to your partner under a different name then enter the new file name into the New File Name field e Confirm the entries by pressing OK rvsNT then writes the send entry for transmission of the file to the rvs database The send order has been completed rvsNT displays the order in the list of files which have not yet been sent Y rysNT display of not transmitted datasets _ Oo x File Edit View Help Als xlelo
4. remote user id or pattern blank system 4 LOCAL USER gt user id or pattern blank system 5 DSNAME gt blank or pattern for dataset selection list 6 DAYS gt transmissions during last up to 999 days F1 HELP F3 ESC CANCEL Select one or more transmissions for display or deletion Functionkey lt F3 gt Abort selection return to previous panel Key lt ENTER gt If station ID or data set name is blank a selection list will be displayed Otherwise a list of matching entries will be shown 1 DIRECTION Determines the direction of transmission Chooe e R eceive display information about received files e S end display send entries default both 41 User Manual rvs Rev 01 04 2000 gedas deutschland GmbH Competence Center EDI rvs User Manual 2 3 4 STATION ID USER LOCAL USER Remote station ID Enter name or pattern of station ID of remote system If this field is blank or lt F4 gt is pressed while the cursor is positioned on this field a list of available station IDs will be displayed Use key lt S gt to select a station ID from that list and confirm your choise by pressing lt ENTER gt Your choice will be inserted into the current panel User ID at remote system When you are looking at send entries this is the receiver s name for transmissions received at your station this is the sender s user ID Enter name or pattern of user ID at
5. 4 2 4 Command Start Function e Start a session using rvs utilities e Open rvs database e Check whether current user is allowed to use the rvs utilities J start USER is issued implicitely by the C CAL Interface if not issued explicitely It is always performed implicitely when the batch interface starts execution Qualifiers USER default start session for rvs user Parameters RVSENV optional name of rvs environment data set Examples Use environment data set in rvs400 library RVS_NEW DAT RVSENV START USER RVSENV RVS_NEW DAT RVSENV 125 User Manual rvs Rev 01 04 2000 gedas deutschland GmbH Competence Center EDI rvs User Manual 4 2 5 Command End Function e Terminate session using rvs utilities e Close rvs database e END must be issued when the C CAL Interface is used It is performed implicitely by the batch interface Qualifiers none Parameters none Examples END 4 2 6 Command Send Function e Create e modify or e delete a send request to send a local data set to another rvs node Qualifiers CREATE default create a send request DELETE delete a send request HOLD set pending send request into held state RELEASE release send request which has been put into held prior SEND CREATE parameters DSN required name of local data set to be sent CODEIN optional code of local data set A ASCIl E EBC
6. File being received The list of files being received displays those files which have not yet been completely transmitted Your station and the partner station are presently transmitting the files This is how you display the files announced e Execute the menu command View Receive files File completely received The list of files which have been completely received displays those files which have been successfully transmitted to your station At this stage your station has acknowledged reception This is how you display completed send orders e Execute the menu command View Completely received files Update display If you want to update the list display then do the following e Click the update button or switch to a different display mode and then back again 3 6 3 Operate Send Requests and Received Transmission Hold send order Since rvSNT operates asynchronously there is always a certain time span between your send order and file transmission This depends on the rvs Monitor capacity and settings During this time you can still put a hold on a send order and modify it This is how you hold one or more send orders e Use the mouse to click on a single send order NOTE To find out how to limit the display to the send orders placed on hold or certain file types please refer to the chapter e Click the Hold button or execute menu command Edit gt Hold 100 How to Work Interactively with rvs
7. KK rvs Version 2 04 00 01 _ User Manual User Manual The products listed in this manual are protected by copyright rvs Version 2 04 00 01 User Manual 2000 by gedas PascalstraBe 11 10587 Berlin This manual is protected by copyright All rights reserved No part of this book may be used or reproduced in any form or by any means including photocopies microfilm or any other means or stored in a database or retrieval system without obtaining prior permission from gedas Rights are also reserved as far as lectures radio and television is concerned We reserve the right to make changes to the content of this manual without giving prior notice gedas is not liable for technical or printing errors or defects in this manual Moreover gedas shall not be liable for damage which is directly or indirectly caused by delivery performance and use of this material Contents Contents COMMIS isccucecicecnceewcccnvecwccuslecwccun lecwicus d daarnaa decwecus d daarnaa d daarnaa daai 3 1 ANWOOUCTION iaa i 6 1 1 Short Description of the System cceeceeceeeeeseeeeeeeeseeeeeseaeeseneeteaes 6 1 2 Target Group i c nes sues ivd eee iid aai ania ieas 9 1 3 Structure of this MANUAl cece ceeeteeeeeneeeeseeaeeeeeeaeeessenaeeeeseaas 9 1 4 Representation MOans eee cceeeeeeeeeneeeeeeeneeeeeeaeeeeeeaeeeeetaeeeeneea 10 2 OVErVIEW FVS w eccscsesesesescscssscssssessseseveveveveveveveve
8. Select display criteria e Click the Delete button or execute menu command Edit gt Delete 102 How to Work Interactively with rvs 3 6 4 Select display criteria You can select certain kinds of send orders for display in the entry list You can use the station code file name and status of the orders as selection criteria This is how you set the display criteria for send orders Execute the menu command View Select The Set selection criteria dialog window then opens Set selection criteria Ea Station ID FAR Select File Name TXT State Code fi l save settings as default Cancel Help e Enter the station code for the station s to be selected or e Use Select to open the Select Station selection window and select the station code e Enter the criterion for the files to be selected in the File Name field e Enter the status code to be selected in the State Code field This entry is optional NOTE You can use the wildcard characters and or a combination of and for entering selection criteria stands for any or even empty character string stands for one character of any value 103 User Manual rvs Rev 01 04 2000 gedas deutschland GmbH Competence Center EDI rvs User Manual Use one of the following characters as the status code no event queued not yet processed by rvs Monitor forwardable waiting for transmission proc
9. full Name Display help information No entry will be created leave display the display and return to the previous one If all necessary fields are filled the entry will be updated User ID which identifies the user on the system full Name or description of the user 93 User Manual rvs Rev 01 04 2000 gedas deutschland GmbH Competence Center EDI rvs User Manual Authorization Language Password Authorization to use rvs This authorization has no affect on the system authorization of this user e A Administrator e O Operator e U User Language to display panels and messages for this user e D German e E English Password for this user 94 How to Work Interactively with rvs 3 5 4 Information about rvs Information mask INFO OPTION Select one of these options 1 RVS NEWS if available may be listed using this option not yet implemented 2 General Informations about rvs may be listed not yet implemented 3 Lists all nodes that can be reached from the local station either directly or indirectly 4 Print rvs manual not yet implemented Information for options 1 and 2 is provided and maintained by your local rvs administrator copies Specify how many copies you want to print of rvs User Manual 95 User Manual rvs Rev 01 04 2000 gedas deutschland GmbH Competence Center EDI rvs User Manual 3 6 Interactive Sendin
10. 01 04 2000 gedas deutschland GmbH Competence Center EDI rvs User Manual Virtual Data Set Name For transfer and delivery a file is identified by its Virtual Data Set Name VDSN You can specify this VDSN in the NEW DSNAME field when you interactively create a send request see chapter Create Send Requests or in the DSNNEW parameter of the SEND CREATE command see Command When you do not specify a VDSN rvs uses the name of the file being sent to generate one When a transmitted file is being delivered to its recipient rvs uses the VDSN as one criterion to look for matching resident receive entries If none is found or the best matching entry does not define a data set name VDSN is also used to generate a local data set name under which the file will be stored rvsMVS uses VDSN as is so when sending to an MVS host make sure to specify a VDSN that adheres to MVS naming conventions and that starts with a high level qualifier that RACF is happy with Do not use quotes or apostrophes to delimit your data set name portable rvs uses VDSN to generate a name for the individual data set the name of the path or library where this file will be stored is taken from the local rvs environment talk to your local rvs administrator or see Operator Manual for more information on rvs configuration VDSN is also one criterion to specify a job that should execute after a send attempt see chapter Job Sta
11. Resident Receive Entries mask RE RV S5 _ DISPLAY UPDATE DELETE RESIDENT RECEIVE ENTRY To display change delete a resident receive entry specify parameters T MS Station id of sender name or pattern user id of sender name or pattern 1 SID 2 USER 3 DSN Mono gt gt gt a name or pattern of dataset as received blank all 4 LOCAL USER gt user id of local user name or pattern privileged users only F1 HELP F3 ESC CANCEL ENTER show list of entries The purpose of this panel is to display change or delete an existing resident receive entry Specify the following parameters to describe the resident receive entry you want to access Functionkey lt F3 gt Cancel request all receive entries remain unchanged 60 2 SID USER DSN How to Work Interactively with rvs Station ID of sender If this field is blank a list of available station IDs will be displayed Use key lt S gt to select a station ID from that list and confirm your choise by pressing lt ENTER gt Your choice will be inserted into the current panel This is one of the selection criteria incoming data set must have originated at a station with a matching name for this receive entry to be further considered as a possible action for the incoming file To be actually used all selection criteria must match User ID of sender Name or pattern of user ID of sender One of the select
12. SIDORIG SIDDEST with meaning SIDORIG sender s station ID SIDDEST receiver s station ID 2VDSN virtual data set name under which the data set was transmitted DTAVAIL date when the data set was available for sending FORMAT Record format of the file sent F fixed V variable T text U unstructured BYTES Number of bytes transmitted RECORDS Number of records transmitted with F or V format DTRCV date when data set was delivered to local user LABEL string if the send command contained a LABEL parameter Can be used to identify the send command The type of job submitted by rvs depends on the operating system E g under OS 2 a CMD data set and under Windows NT a batch file will be executed as background process whereas under OS 400 rvs will start a job using SBMDBJOB 21 User Manual rvs Rev 01 04 2000 gedas deutschland GmbH Competence Center EDI rvs User Manual e SECN command number of send command CN of SE Can be used to identify the send command e SKCN Number of the send command e UID sender s user ID In case of EERP the value is always QS e SID receiver s station ID e DSNTEMP name of temp data set this data set should be deleted at the end of the job DELETE 7DSNTEMP There are additional parameters of a jobstart after send attempt entry which may be set at creation time COMMENT a short text describ
13. To be actually used all selection criteria must match 68 Remote station id User ID of sender Local user or alias Data set name New data set name Add timestamp How to Work Interactively with rvs Name of remote station One of the selection criteria incoming data set must have originated from a sender with a matching name for this receive entry to be further considered as a possible action for the incoming file To be actually used all selection criteria must match User ID of local recipient One of the selection criteria incoming data set must be intended for a local user with a matching name for this receive entry to be further considered as a possible action for the incoming file To be actually used all selection criteria must match Virtual name under which the file is known during transfer One of the selection criteria incoming data set must be known by a matching name for this receive entry to be further considered as a possible action for the incoming file To be actually used all selection criteria must match Name under which the data set will be stored in the local system e Y es Generate a unique data set name when delivering the file e N o Otherwise 69 User Manual rvs Rev 01 04 2000 gedas deutschland GmbH Competence Center EDI rvs User Manual Disposition Replace of data set Job to be started Account Comment Created by use
14. ct He A Oy H HD eae cn cn t_record t_byte number of already sent byt hg in in in in in in in in cnt_maxrecl cnt_apsize cnt_lenvm cn_Se cn_sk cn_ie cn_1iz cn_re torte co ch ch ch cmd ch ch ch ch ch ch ch ch BROAOVBQNQQNAQaQ w S S S la ar status_ie ar status_iz ar dsn_local ar s_recfm ar s_ftype ar s_code ar s_codein ar s_codeout C ie tus_et tus_se tus_sk w K ta ta i ov IK lflpleldis RVSCAL_L_C1 RVSCAL_L_C1 RVSCAL_L_C1 RVSCAL_L_ RVSCAL_L_KS RVSCAL_L_KS RVSCAL_L_KS xf RVSCAL_L_KS RVSCAL_L me RVSCAL_L_ li l DSN RVSCAL_L_ state of send char s_disp RVSCAL_L_Cl char s_label RVSCAL_L_ SEUSRLABEL defined label SINT flg_tstamp INFO_SK user 139 User Manual rvs Rev 01 04 2000 gedas deutschland GmbH Competence Center EDI rvs User Manual SetSendEntry Commands define SET _HOLD 1 define SET RELEASE 2 define SET DELETE 3 define TRANSM SSION_SEND 1 define TRANSM SSION_RECV 2 define CN_START 0 5 1 2 Get next send entry from Database Prototype rvsGetNext Send PROCDEF int PROCKEYW rvsGetNextSend long prev_send_cn INFO _SK info Description of Parameters FUNCTIONVALUE
15. empty rvsNT Administrator Jol x File Edit View Monitor Database Window Monitor Log lt LICENSE_WARN gt ed Resident Receive Entries SID DSN ecelver real 3 z ry lt INCOMING_CALL Incoming call received LOC lt CONNECT Sender Connection with Station LOC with Credit 10 Odette Buffer 2C lt CONNECT_IND Responder Connection with Station LOC with Credit 10 Odette Buffer lt DISCONNECT Connection to Station LOC ended lt DISCONNECT Connection to Station LOC ended Press F1 to get help 106 How to Work Interactively with rvs Create RE If you want to start a program when a file arrives do the following e Execute the menu command Edit Add The Resident Receive Entries dialog window then opens Resident ReceiveEntry Eg Station i Name of sending Station od virtual DatasetName i new DatasetName Search Replace m Disposition Recordhandling C Replace Dataset Keep Standard New Dataset C Delete C Ignore Dataset Timestamp M CodeConverstaion none C Ascii gt Ebcdic C Ebedic gt Ascii C Table Program Search Comment cot e e Enter the station from which you expect to receive the file The dialog field Station is pre assigned with This means that the RE is valid for the reception of files from all stations e Inthe virtual Dataset Name field enter the file or the file specification f
16. gedas deutschland GmbH Competence Center EDI rvs User Manual typedef struct char protocol RVSCAL_L_Cl long cntn char inaddr RVSCAL_L_TCPIP_ADDR SINT i port SINT i_max_in SINT i_max_out char security RVSCAL_L_TCPIP_SEC INFO_TC typedef struct char lx name RVSCAL_ L_ LX NAME long lx _len char 1x val RVSCAL_L_ LX VALUE INFO_LX typedef struct c a i a i i a i har n n n n n n n n as cs a TO a G INFO_ST INFO_NK INFO_RT INFO_OP INFO_LU INFO_XP INFO_TC INFO_LX 1d RVSCAL_L_ STATID lg_st lg_nk Louk lg_op g_lu LG_Xp gte g_1x H o F H o F S f f f f f f f f S n T Op lu xP EC 1x INFO_STATION 5 2 1 2 Get next station entry from Database Prototype rvsGetNext Station PROCDEF i S1 Dpre nt PROCKEYW rvsGetNextStation char char SID Description of Parameters SIDPRE SID char input SID of previous station char output SID of next station found in ST Table 148 How to Work with rvs C CAL Interface 5 2 1 3 Update station entry from Database Prototype rvsUpdateStation PROCDEF int PROCKEYW rvsUpdateStation INFO_STATION info Description of Parameters info INFO_STATION input Struct with informations about station entry 5 2 1 4 Get station entries
17. gt station id of receiver 2 USER ID gt user id of sender 3 DATASETNAME gt virtual datasetname 4 SENDATTEMPTS gt number of sendattempts Fl HELP F3 ESC CANCEL EINGABE show list of entries The purpose of this panel is to select criteria you want to access Specify the following parameters to describe the job start after send attempt entry you want to access Functionkey lt F1 gt Display help information Functionkey lt F3 gt Cancel request all receive entries remain unchanged 1 SID Station ID of receiver If this field is blank a list of available station IDs will be displayed Use key lt S gt to select a station ID from that list and confirm your choise by pressing lt ENTER gt Your choice will be inserted into the current panel 77 User Manual rvs Rev 01 04 2000 gedas deutschland GmbH Competence Center EDI rvs User Manual 2 USER 3 DSN 4 ATTEMPTS User ID of sender Name or pattern of user ID of sender One of the selection criteria outgoing data set must have originated from a user with a matching name for this JobStart entry to be further considered as a possible action for the outgoing file To be actually used all selection criteria must match Name of data set to send Enter name of data set of JobStart after SendAttempt entry Leave blank or specify pattern to get a data set selection list Number of failed send attempts befor
18. if internal database error is occured 152 How to Work with rvs C CAL Interface 5 2 3 Functions to manage rvs Operator Commands This chapter describes the functions which are required to manage rvs Operator commands 5 2 3 1 Store operator command into Database Prototype rvsStoreOK PROCDEF int PROCKEYW rvsStoreOK char command Description of Parameters command char input command string 5 2 3 2 Wake the Monitor Prototype rvsWakeMonitor PROCDEF int PROCKEYW rvsWakeMonitor void Description of Parameters there are no parameter 5 2 3 3 Return Codes FUNCTIONVALUE int RVSCAL_OK if function succeeds RVSCAL_PARAMETER_CHECK if at least one parameter is incorrect RVSCAL_INVALID_NAME if parameter name doesn t exists RVSCAL_RC_WAKE FAILED if wake command failes RVSCAL_INTERNAL_ERROR if internal database error is occured 153 User Manual rvs Rev 01 04 2000 gedas deutschland GmbH Competence Center EDI rvs User Manual 5 2 4 Functions to manage Resident Receive Entries This chapter describes the functions which are required to manage Resident Receive Entries 5 2 4 1 Type Definition and Macros typedef struct char uid_local RVSCAL_L_USID char vdsn RVSCAL_L_VDSN char uid_sender RVSCAL_L_USID char sid_sender RVSCAL_L_STATID char dsn_local RVSCAL_L_ DSN char s_replace RVSCAL_L_ Cl char s_
19. table describing actions to take when a particular data set is delivered to a local recipient See Monitor SendeEintrag send entry internal rvs command controlling sending of files Order to rvs which file has to be sent to which station This entry is saved in the database Station identification rvs internal name of an OF TP partner station 170 SK Station T Transfer Component VDA VDSN Glossary SendeKommando send command internal rvs command controlling transfer of one file to one neighboring node A station is a node that can be addressed within a rvs network Each station is identified by a unique station ID SID Control program and line driver for a special access method Verband der Deutschen Automobilhersteller Adress Verband der Automobilindustrie e V VDA Abt Logistik Postfach 17 05 63 60079 Frankfurt Tel 069 7570 0 Virtual Data Set Name name under which file is Known during transfer and for delivery User Manual rvs Rev 01 04 2000 171 gedas deutschland GmbH Competence Center EDI rvs User Manual Index Basic Functional Characteristics 00 5 8 Confirm delete resident receive entry 71 deletion of job start after send attempt entry 85 Confirm deletion of send request neeese 58 USEr CNY ritti redipensid iiss 92 Create job start after send attempt entry e a E ER INi 80 JSra ana aa R a
20. 01 04 2000 gedas deutschland GmbH Competence Center EDI rvs User Manual The meaning of the values no event q queued not yet processed by Monitor f forwardable waiting for transmission process P pending waiting for completion e ended a active i in transit transmitter currently processing order In addition every event may also have these statuses h held by the system or operator S traffic with the destination suspended at present Exit rvsNT You can exit rvsNT at any time even if all of the send orders have not been completed or you have not yet saved several of the files which have been received The rvs Monitor continues to process your send orders and places arriving files into your user directory The next time you start rvsNT you can display the advance status of your send orders and any files which may have arrived e f you would like to exit rvsNT then use the File gt Exit menu command 34 How to Work Interactively with rvs 3 4 Interactive Sending and Receiving for UNIX and AS 400 This chapter describes how to send and receive data sets with rvs if you are using an ineractive application First it will be explained how you can create send requests The next chapter describes how you can display sent and received transmissions and the last chapter shows how you can operate with send and receive data sets 3 4 1 Create Send Requests This chapter describes how you can create
21. 111 resident receive entry 64 Resident Receive Entry 107 USCl CNTY ic reward ae lay 90 data conversion s 9 Delete AE AA 113 AE Ae a a lee 109 sent request 57 Display THES Sent atirei enai 99 job start after send attempt entry AEn EEE OE EETA 82 received files 0ceeee 100 resident receive entry 68 Resident Receive Entry 106 USET ENUY oo rrinin nieniu 91 Display Delete Transmissions c ceee 41 Display modes ee 31 Display of Transmissions 44 47 51 53 D EE EAEE 6 168 Exit rvSNT eeeeeeeeeeeeeees 34 Function rvscal prototyPe c ees 121 functional characteristics 8 Handling of Commands 117 Information about Job start after send attempt entries 77 key characteristics 8 List of data sets for transmission 58 job start after send attempt entries 0 ceeeeeceeeceeeceaeeeeseeees 78 USEF entries cceceeeeeeeee eee ee 88 Lists of Statis sresti aa aa 39 Macro definitions 118 mask CDRE doinenn 71 CDSET mata 58 CJSS minsti a 80 CRRE nainit aa 64 CGUSR aiani i 90 DDT O vasecistaieouee ils 41 DDT singura ota 44 DD TR aera 51 DELS Raeina an E 57 DISS t te Aine et 85 DSN Astin iat tees 58 DSP Rintie eaan 53 DSP eamin aa 47 DUSR otin a n 92 NEO nna aA 95 IND e teats a 27 JOro e hee etl 77 IOS Le Fe sects eta A nn ee 78 Peete tence t
22. 5 2 4 2 Get next command number of Resident Receive Entry from Database eee 154 5 2 4 3 Get Resident Receive Entry from Database 0 008 155 5 2 4 4 Configure Resident Receive Entries 155 5 2 4 5 Return COdCS cceesceesceceeeeeceeeeeesaeseeneeceeeeesaeeeeaaeeseneeenaees 156 5 2 5 Functions to manage Entries for Jobstart after Send Attempt 157 5 2 5 1 Type Definition and Macros eeeceeeeeeeseeeeeeeteeeeeenaeeeeeeaaes 157 5 2 5 2 Get next command number of Job Start Entry from Database ccccccesseeeesssteeeeeeeeees 157 5 2 5 3 Get Jobstart Entry from Database cceeceeeeeeseeeeeees 158 5 2 5 4 Configure Entries for Jobstart after Send Attempt 158 5 2 5 5 Return Godes isie aisea peen aana iaei a iaa aae 159 5 2 6 Functions to manage User Entries ceceeeeseeeeeeeeeeeeees 160 5 2 6 1 Type Definition ANd Macros eeeeceeeeeseeeeeenteeeeeenaeeeeeenaes 160 5 2 6 2 Get next User from Database cccesceeeseeesteeeeseeeenees 160 5 2 6 3 Get User Entry from Database cccccceeeeeeseeteeeeetees 160 5 2 6 4 Configure User EntrieS ccccceceeeeseceeeeeseeeeeseaeeeeneeenaees 161 5 2 6 5 Return COdeS cccccceesceceeeeeseeeeeeeaeeseneeseeeesaeeeeaaeseeneeesaees 161 5 2 7 rys Database FUNCTIONS c cscscssesstsstssessessesssesesesssesseseiesn 162 5 2 7 1 Type Definition ANd Macros eeeeeeeeeteeeeeenteeeeeenaeeeeeenaes 162 5 2 7 2 Dump
23. CODEOUT e TSTAMP n DSNNEW dsnnewl SID st2 UID user2 CODEOUT a TSTAMP y DSNNEW dsnnew2 s use defaults and serialize on LABEL SEND DSN LPDBI C SERIAL y LABEL 11 inittime HOLD CODEIN E FORMAT U DISP k SID st1 serialize again on LABEL SEND DSN rpu c SERIAL y LABEL 11 inittime 1991 07 01 10 35 FORMAT V SID st1 Wao ee serialize on data set without specifying the full data set name SEND DSN lpdbi c SERIAL y FORMAT f SID st1 RSS serialize again on data set and default for FORMAT SEND DSN lpdbi c SERIAL y STD st1 x delete SEND request unique SEND D DSN rpu c SID st1 129 User Manual rvs Rev 01 04 2000 gedas deutschland GmbH Competence Center EDI rvs User Manual 4 2 7 Command RESENTR Function Create update or delete a resident receive entry Qualifiers CREATE i Parameters UPDATE DELETE DSN SID ACCOUNT COMMENT DSNNEW JOB DISP REPLACE TSTAMP default create resident receive entry update resident receive entry delete resident receive entry required virtual name of incoming data set required station ID of sender optional accounting number or code optional comment describing action of
24. Database ecce A 162 5 2 7 3 Recover Database ausssesssesssrresrrrnesrrnnesrrnnnsrnnneernnnesnennee 163 5 2 7 4 Initialize Database cece ee enneeeeeeneeeeeeeaeeeeeeaeeeeseaaes 163 5 2 7 5 Delete Database ec ccceecceceeeeeceeeeeeeeeeeeeeeeeeeeneeeeeeennnees 164 Contents 5 2 7 6 Dump User Receive Js and Station Entries 164 5 2 7 7 Return Codes cccccecececeeeeececeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeees 165 5 2 7 8 Get the version of rvs Database c ccccccscssssesesesseseeseeees 165 5 2 7 9 Return Codes cccccccececeeeeeceeeeeeeeeeeeeeeeeeeeeeeeeseeeeeeeeeeeeeeees 165 5 2 8 Other FUNCHONS revs ii sdiawsv dicta aa i vectveuadcveaaitiavaveia dataves 166 5 2 8 1 Get SID from ODETTE ID or vice versa n e 166 5 2 8 2 List status of rvs Commands cccssceceseseeseseseseceseeseseeees 167 Glossary isir siececesiresecastessscesecracenesusassescdeesravevevanestaadeuernes 168 Tao EN e E T 172 5 User Manual rvs Rev 01 04 2000 gedas deutschland GmbH Competence Center EDI rvs User Manual 1 Introduction This chapter contains a short description of the rvs system an overview of the target group and the structure of the rvs manuals as well as the explaination of the representation means which are used in this manual 1 1 Short Description of the System What rvs is The abbreviation rvs stands for the German word Rechner Verbund System The rvs
25. The purpose of this panel is to display a specified received data set As long as this transmission is active you can refresh the status of transmission by pressing functionkey lt F5 gt Functionkey lt F3 gt Functionkey lt F5 gt Cmdnbr of IE DATE TIME Cmdnbr of IZ Cmdnbr of RE The program returns to the previous panel Refresh the status of active transmissions Internal number under which this data has been received in your local system Current date Current time Internal number under which this data set has been delivered to a local user Internal number of resident receive entry if this received data set has been processed by a matching resident receive entry 53 User Manual rvs Rev 01 04 2000 gedas deutschland GmbH Competence Center EDI rvs User Manual Account of RE Creator of RE Job ID of RE Local user Remote station ID Remote station name Remote user Data set name Format Account to which all rvs activities relating receiving and storing a data set is to be charged if resident receive entry is specified for this received data set User ID of creator of resident receive entry if specified for this received data set ID of batch job that further processed received information if a resident receive entry is specified for this data set Local user ID Station ID of remote station Name of remote station Remote user ID Local na
26. computer communication system is a well established base service for electronic data interchange EDI Task of the system is to guarantee transmisssion of electronic data between heterogenious computer platforms using different network protocols To do so rvs realizes a universal network model which can be configured by you within each network node It provides an efficient and reliable transport service for both standardized EDI message types and files of any format or content You can get only data files which have been provided explicitly by rvs This means that rvs does not provide an unauthorized access to remote data files The system was originally developed by Volkswagen AG and has been used in the German and European automobile industries for a number of years rvs uses the OFTP protocol The Volkswagen AG has been developed an extansion to the standard OFTP SNA LU6 2 rvs has become one of the most successful protagonists of EDI This portable version of rvs has been developed in order to complement the classical rvs product line which is based on MVS and VSE mainframes for use on midrange mini systems and personal computing Though the design and make of this product line differs considerably from the mainframe versions the functional spectrum is almost exactly the same as that of rvs MVS Introduction This version of rvs is written in the language C and has been developed under the principles of m
27. could not be opened or closed RVSCAL_USER_NOT_FOUND if user entry could not be found RVSCAL_DUPLICATE_USER if duplicate user entry has found in case of icmd USER_CREATE RVSCAL_INTERNAL_ERROR if internal database error is occured 161 User Manual rvs Rev 01 04 2000 gedas deutschland GmbH Competence Center EDI rvs User Manual 5 2 7 rvs Database Functions This chapter describes the functions which are required to manage rvs Database functions 5 2 7 1 Type Definition and Macros define RVSCAL_PIPE_NAME pipe rvsdb define RVSCAL OLEVENT_NAME rvsdb_olevent define RVSCAL PIPE TIMEOUT 90000 define RVSCAL_L_OLEVENT 14 define RVSCAL_L_PIPENAME 15 define DEL DB 0x01 define DEL LOG 0x02 define DEL_TMP 0x04 define DEL REMDB 0x08 define DUMP_RES 0x01 define DUMP_USER 0x02 define DUMP_JS 0x04 define DUMP_STATION 0x08 define aoe _RU_ALL DUMP_RES DUMP_USER DUMP_JS DUMP_STATION 5 2 7 2 Dump Database Prototype rvsDumpDB PROCDEF int PROCKEYW rvsDumpDB char environment char dsn Description of Parameters environment dsn char input name of the environment data set If environment is NUCL or an empty zero terminated string rvs will look for the default environment char input data set name of dump file 162 How to Work with rvs C CAL Interface
28. data set must have originated from a sender with a matching name for this entry to be further considered as a possible action for the outgoing file To be actually used all selection criteria must match Attention The user ID as selection criteria is not yet supported Virtual name of outgoing data set One of the selection criteria outgoing data set must be known by a matching name for this entry to be further considered as a possible action for the outgoing file To be actually used all selection criteria must match One of the selection criteria specify amount of send attempts after which the specified job should be started lf ATTEMPTS is greater than 0 the job will be started after the specified amount of failed send attempts lf ATTEMPTS is 0 the job will be started after a successfull transmission Default 0 81 User Manual rvs Rev 01 04 2000 gedas deutschland GmbH Competence Center EDI rvs User Manual 5 JOB Name of data set that can be started as a batch job to specify the following process e g e bat on MS DOS or WindowsNT e __CNTL on MVS e _ cmd on OS2 On AS 400 the job will be started with the OS 400 system command SBMDBJOB 6 COMMENT Brief comment describing the purpose of this entry used for display only Display Job Start after Send Attempt Entry mask SJSS DATE 2000 04 03 TIME 11 19 Command number 341 remote station SUM User ID sender
29. deutschland GmbH Competence Center EDI rvs User Manual 5 1 7 Send a file Prototype rvsCreateSendEntry PROCDEF int PROCKEYW rvsCreateSendEntry ch ch ch ch ch ch ch ch ch ch ch ar ar ar ar ar ar ar ar ar ar dsn disp format codein inittime serial label tstamp sid dsnnew char codeout ar S_msg Description of Parameters FUNCTIONVALUE int dsn disp format codein inittime serial label RVSCAL_OK if it was successfull RVSCAL_INTERNAL_ERROR if error occured char input filename of local file details see rvs User Manual char input disposition K keep D delete after transmission char input file format T F V U char input code of input file A ASCII E EBCDIC char input time of earliest send attempt YY MM DD HH MM SS char input serialization flag Y or N char input label of file for serialization 144 tstamp sid dsnnew codeout s msg How to Work with rvs C CAL Interface char input timestamp char input station ID of receiver char input virtual file name OF TP char input output code A ASCII E EBCDIC char output error message in case of error 5 1 8 Create a Send Entry Prototype rvsCreateSendEntryCmd PROCDEF int PROCKEYW rvsCreateSendEntryCmd char dsn char disp char form
30. functions which are required to manage rvs parameters 5 2 2 1 Type Definition typedef struct char s_parm RVSCAL_L_PARM_ NAME SINT i_type long len char s_val RVSCAL_L_PARM_VAL PARM STRUCT 5 2 2 2 Get parameter value from Database Prototype rvsGetParm PROCDEF int PROCKEYW rvsGetParm char parm PARM_STRUCT stparm Description of Parameters parm char input parameter name stparm PARM_STRUCT output Struct with informations about parameter entry 5 2 2 3 Get next parameter from Database Prototype rvsGetNextParm PROCDEF int PROCKEYW rvsGetNextParm char parm PARM_STRUCT stparm Description of Parameters parm char input previous parameter stparm PARM_STRUCT output Struct with informations about the next parameter entry 151 User Manual rvs Rev 01 04 2000 gedas deutschland GmbH Competence Center EDI rvs User Manual 5 2 2 4 Writes parameter value into Database Prototype rvsWriteParm PROCDEF int PROCKEYW rvsWriteParm char parm PARM_STRUCT stparm Description of Parameters parm char input parameter name stparm PARM_STRUCT input Struct with informations about parameter entry 5 2 2 5 Return Codes FUNCTIONVALUE int RVSCAL_OK if function succeeds RVSCAL_PARAMETER_CHECK if at least one parameter is incorrect RVSCAL_INVALID_NAME if parameter name doesn t exists RVSCAL_INTERNAL_ERROR
31. in the correct order That will help you to optimize your work with rvs 1 4 Representation means This chapter contains the description of the indications which are used in this manual and the explanation of the expressions which are marked Indications courier commands menu commands file names path names programs examples scripts qualifiers data sets fields options modes window names dialog boxes and statuses BOLD and IN parameters environment variables CAPITAL LETTERS variables links to other manuals sections and quotation mark i 3 chapters literature bold important names of operating systems proper names buttons function keys Expressions rvsX is the synonym of rvs for UNIX systems rvsNT is the synonym of rvs for Windows NT systems rvs400 is the synonym of rvs for AS 400 systems 10 Introduction Directories As user directories are found on different locations for the different operating systems we use the variable RVSPATH in this manual Default values are home rvs for AIX Solaris IRIX Linux and SCO users rvs for HP UX defpath rvs for SINIX c rvs for Windows NT Substitute the variable with your correct path Generally the file names on OS 400 systems are always written in capital letters User Manual rvs Rev 01 04 2000 gedas deutschland GmbH Competence Center EDI rvs User Manual 2 Overview rvs rvs is a reliable file transfe
32. in the local file system are rvs replacement markers and rvs replaces the character string DSN by the local file name of the received file Example c rvs usrdat kontol txt or e rvs usrdat konto2 txt etc Another example is to be found in the file c rvs system resentr bat 105 User Manual rvs Rev 01 04 2000 gedas deutschland GmbH Competence Center EDI rvs User Manual NOTE No binary file may be specified as a batch program it should be a readable and interpretable file Ensure that your batch program is sensibly structured because it is not checked by rvs Every version of an RE leaves a copy of the batch file in which the replacement characters are replaced by your actual values in the directory c rvs temp The copies are stored under the name re999999 bat whereby 999999 stands for a consecutive number If the behaviour of a RE is incomprehensible to you you should read in the last generated copy of the batch program file re999999 bat just which commands have been executed You can find more information in section How to work with rvs Batch Interface and rvs C CAL Interface rvscal Display resident receive entry If you would like to display the RE then use the View gt JobStart Receive menu command in the rvsNT Administrator The Resident Receive Entries window then opens lt displays a list of the previously created RE s The list is initially
33. informations about job start entry 158 How to Work with rvs C CAL Interface 5 2 5 5 Return Codes FUNCTIONVALUE int RVSCAL_OK if function succeeds RVSCAL_END_ FETCH if there is no matching jobstart entry RVSCAL_PARAMETER_CHECK if at least one parameter is incorrect RVSCAL_INVALID_DSN if invalid DSNNEW was spezified RVSCAL_INVALID_JOB if invalid JOB was spezified RVSCAL_INVALID_NAME if parameter name doesn t exists RVSCAL_INVALID_SID if SID RECEIVER isn t known RVSCAL_NOT_PRIVILEGED if user is not privileged in to configure entries for Jobstart after Send Attempt RVSCAL_DBERROR if database could not be opened or closed RVSCAL_JS_ NOT_FOUND if job start entry could not be found RVSCAL_DUPLICATE_JS if duplicate jobstart entry was found in case of icmd JS CREATE RVSCAL_INTERNAL_ERROR if internal database error is occured 159 User Manual rvs Rev 01 04 2000 gedas deutschland GmbH Competence Center EDI rvs User Manual 5 2 6 Functions to manage User Entries This chapter describes the functions which are required to manage User Entries 5 2 6 1 Type Definition and Macros typedef struct char uid RVSCAL_L_USID char S_priv RVSCAL_L_Cl char s_prof RVSCAL_L_ Cl char s_lang RVSCAL_L_LANG char s_name RVSCAL_L_ USERNAME INFO_USER define USER_UPDATE 1 define USER_DELETE 2 define USER_CREATE 3 5 2 6 2 Get nex
34. matching name for this receive entry to be further considered as a possible action for the incoming file To be actually used all selection criteria must match Name or pattern of local user ID who is the recipient of the incoming information You may specify something other than your own user ID only if you are defined as privileged user Default your current user ID To match a transfer from an MVS host this field must be left blank or it must contain an asterisk to match any ID because rvsMVS sends to your station not to an individual user One of the selection criteria incoming data set must be intended for a local user with a matching name for this receive entry to be further considered as a possible action for the incoming file To be actually used all selection criteria must match Virtual name of incoming data set One of the selection criteria incoming data set must be known by a matching name for this receive entry to be further considered as a possible action for the incoming file To be actually used all selection criteria must match 65 User Manual rvs Rev 01 04 2000 gedas deutschland GmbH Competence Center EDI rvs User Manual 5 6 7 DSNNEW ACCOUNT TIMESTAMP Specify name under which data set should be stored This is the only way in which you as a user can specify directory or library where the incoming file is to be placed Be careful however if
35. non text files are delivered without any conversion unless you specify A or E in this field Choose e A ASCII e E EBCDIC e blank as explained in previous paragraph default blank 38 How to Work Interactively with rvs Lists of Stations mask SIDL Option s S select Station ID F1 HELP F3 ESC local rvs station aaa X 25 VW AG ISDN aaa LU6 2 aaa TCP IP aaa X 25 via ISDN remote station via X 25 ISDN remote station via X 25 ISDN echo test via X 25 CANCEL RETURN PROCEED Row 1 9 End of table reached This mask is displayed whenever you request a selection list of rvs nodes that can be reached from the local station either directly or indirectly Functionkey lt F3 gt Functionkey lt F7 gt Functionkey lt F8 gt Key lt ENTER gt Specify option Leave display without selecting any station Page up Page down Confirm selection If a station ID is selected by entering the line command lt S gt the selected ID will be transferred into the appropriate field in the previous mask after you confirm your selection by pressing the lt ENTER gt key 39 User Manual rvs Rev 01 04 2000 gedas deutschland GmbH Competence Center EDI rvs User Manual Send data set Distribution List mask SNDDL The list of currently defined recipients of your data set is displayed Use line command option lt S gt to select a receiver for modific
36. of local data set optional desired code of data set at receiver optional determines whether data set is to be timestamped at receiver Currently this request cannot be passed to or via an MVS host see Data Set Names Time Stamping for more information 127 User Manual rvs Rev 01 04 2000 gedas deutschland GmbH Competence Center EDI rvs User Manual SEND DELETE HOLD RELEASE parameters DSN optional name of local data set to be sent SID optional station ID of receiver UID optional user ID of receiver defaults to empty string i e the remote system CMDID optional unique command number of send request The send entry to be processed can be identified either by specifying DSN SID and UID or by the unique command number CMDID of the send request If no parameter has been given or if more than one send request matches the specified parameters rvscal does not modify any send request and returns with an error The following examples demonstrate how commands may be specified in a data set that is used as input file to rvsbat including use of continuation lines the previous line ends with and comments in column 1 128 How to work with rvs Batch Interface and rvs C CAL Interface Examples nin use all parameters SEND C DSN C RVS LPDBI C SERIAL n LABEL 11 inittime NOW CODEIN A FORMAT T DISP d SID st1l UID userl
37. remote system An empty user ID indicates that the file should be delivered to or was sent from the rvs system at the target node not to or from an individual user User ID or pattern of local user When you are looking at send entries this is the sender s name for transmissions received at your station this is the recipient s user ID 42 5 6 DSNAME DAYS How to Work Interactively with rvs Name or pattern of local data set name A pattern may contain wildcard characters asterisk and question mark An asterisk matches any number of arbitrary characters a question mark matches any one character If a pattern is specified the list of transmissions will contain all matching entries If this field is blank or lt F4 gt is pressed while the cursor is positioned on this field a list of available matching data sets will be displayed Use key lt S gt to select a data set and confirm your choise by pressing key lt ENTER gt This selected data set will be inserted in this field automatically Specify how far back the system should look for matching entries You can specify at most 999 days the period of time however for which information about completed transmissions is kept in the system is determined by frequency and retention period for database cleanups 43 User Manual rvs Rev 01 04 2000 gedas deutschland GmbH Competence Center EDI rvs User Manual Di
38. send requests and afterwards how you can transfer them Transmission of a Data set mask SND Specify parameters below 1 STATION ID gt MJ station id of receiver blank list 2 USER gt user id of receiver blank system 3 DSNAME gt name of dataset to be sent 4 DISPOSITION gt K K keep D delete 5 FORMAT gt T text 6 INPUT CODE gt code of local dataset 7 ACCOUNT gt bwa account number of sender 8 INIT TIME gt H hold expl time YYYY MM DD HH MM 9 SERIALIZE gt N serialize sending of datasets Yes No 10 LABEL gt used to serialize send requests 11 NEW DSNAME gt rename 12 OUTPUT CODE gt code of dataset at receiver 13 TIMESTAMP gt N add timestamp Yes No F1 HELP F2 ADDITIONAL RECEIVERS F3 ESC CANCEL ENTER PROCEED Specify the necessary parameters to create a send entry for transmitting a data set 1 STATION ID Specify station ID of receiver s rvs node If you do not enter a value in this field a list of available station IDs will be displayed Use key lt S gt to select a station ID from that list and confirm your choice by pressing lt ENTER gt Your choice will be inserted into the current panel 35 User Manual rvs Rev 01 04 2000 gedas deutschland GmbH Competence Center EDI rvs User Manual 2 3 4 5 USER DSNAME DISPOSITION FORMAT Specify user ID of receiver An empty blank
39. trigger actions after rvsNT has attempted with or without success to send files by generating resident job start entries JS in the rvs Database A Js tells the rvs Monitor to start a program after an attempt to send a particular file or a selection of files Example The batch program sendjob bat should start after the third unsuccessful attempt to send a file This example is also to be found in the directory c rvs system You can also use rvs to switch parameters using the rvs batch interface The modified copies of the batch program also come into being here in the temp directory exactly as is the case with RE s You can find more information in section How to work with rvs Batch Interface and rvs C CAL Interface rvscal Display job start after send attempt If you would like to display the JS then use the View gt JobStart Send menu command in the rvsNT Administrator The Jobstart after Send Attempt window then opens It displays a list of the previously created JS s The list is initially empty v rvsNT Administrator File Edit View Monitor Database Window ajeleli Monitor Log lt LICENSE_WARN gt Ed Jobstart after Send Attempt SID _DSN Staion Vitual Dataset Program Comment lastused lt lt lt lt lt lt lt lt lt lt lt AA A j I Buffer 2C lt CONNECT_IND gt Responder Connection with Station LOC with Credit 10 Od
40. user ID indicates that the file should be delivered to the rvs system at the target node not to an individual user Transmissions to MVS VSE or 36 systems must not specify a recipient s user ID because these systems do not support person to person transfers This is also true if your file must be routed through one of these systems Specifies the name of the data set to be sent The data set must exist This field must have an entry Availability of data set after sending Choose e K to keep data set after sending e D to delete data set after sending default K Specifies type of data set and format of transmission Choose e T text file a stream of ASCII characters e U unstructured binary byte stream e V variable record length e F fixed record length e blank defaults to systemformat e g U for rvsNT and rvs2 F for rvs400 36 How to Work Interactively with rvs 6 INPUT CODE Specifies the code in which the data set is currently stored Choose e A ASCII e E EBCDIC e blank for T format data sets native code of system is assumed EBCDIC under OS 400 ASCII otherwise for other formats code is considered unknown and no conversion will take place 7 ACCOUNT Specifies the account code of sender Account code to which all activities relating to this send entry are to be charged default account code of current session 8 INIT TIME Specifies the earliest time to send th
41. 1999 All rights reserved 1999 07 26 16 54 31 I lt CMD_EXECUTED gt Command START USER successfully exe cuted SEND C DSN c temp readme txt SID LOC DSNNEW new txt 1999 07 26 16 55 24 gt gt gt SEND C DSN c temp readme txt SID LOC DSNNEW new txt 1999 07 26 16 55 24 I lt CMD_EXECUTED gt Command SEND CREATE successfully ex ecuted 1999 07 26 16 56 03 I lt CMD_EXECUTED gt Command END successfully executed c russre gt c russre gt Handling of Commands Commands can be written into the lt cmdfile gt or can be entered when calling rvsbat In both cases the syntax of the command strings is identical An example is given in the picture below SEND C DSN c temp readme txt SID LOC DSNNEW new txt For each command read from command input a message is written to stdout which gives information about success or failure of processing the command If rvsbat is started without input of a command file it can be breaked by lt STRG gt C 117 User Manual rvs Rev 01 04 2000 gedas deutschland GmbH Competence Center EDI rvs User Manual 4 2 Use the C CAL Interface To use the C CAL Interface it is necessary to link the rvscal library e rvscal dil for Windows NT dynamic link e rvscal a for UNIX systems static link e rvscal for AS 400 service program Then the user defined C program which uses this library has to include the header file rvscal h
42. 5 2 7 3 Recover Database Prototype rvsWriteDB PROCDEF int PROCKEYW rvsWriteDB char environment char dsn Description of Parameters environment char input name of the environment data set If environment is NULL or an empty zero terminated string rvs will look for the default environment dsn char input data set name of dump file 5 2 7 4 Initialize Database Prototype rvsInitDB PROCDEF int PROCKEYW rvsInitDB char environment char sid_loc Description of Parameters environment char input name of the environment data set If environment is NULL or an empty zero terminated string rvs will look for the default environment sid_loc char input local station ID 163 User Manual rvs Rev 01 04 2000 gedas deutschland GmbH Competence Center EDI rvs User Manual 5 2 7 5 Delete Database Prototype rvsDeleteDB PROCDEF int PROCKEYW rvsDeleteDB char environment const int delattrib Description of Parameters environ char input ment name of the environment data set If environment is NULL or an empty zero terminated string rvs will look for the default environment delattrib const int input attribute indicates which files should be deleted possible values are DEL_DB default remove all database files DEL_LOG remove logfiles DEL_TMP remove all files out of the temporary directory of rvs 5 2 7 6
43. DIC default local code 126 How to work with rvs Batch Interface and rvs C CAL Interface DISP FORMAT ACCOUNT INITTIME LABEL SERIAL optional disposition for local data set after send request has ended successfully K keep default D delete optional format used for transfer via ODETTE T text U unstructured binary F fixed V variable record length default record format of local data set U for rvsNT rvsX and rvs2 F for rvs400 accounting number or code optional earliest time when send request may be performed may be H hold N now default or an explicit time in the format YYYY MM DD HH MM optional user label up to 20 characters used to serialize on a preceeding send request if SERIAL Y or which can be used for serialization by a subsequent send request optional if set to Y yes the send requests will sent in the order you have created them see also LABEL The next request will only be sent if the previous is completely finished Repeatable Parameters Each group of repeatable parameters defines one receiver SID UID DSNNEW CODEOUT TSTAMP required station ID of receiver optional user ID of receiver if omitted or empty string system at remote station optional virtual data set name used for transfer for transfer to MVS host this must be a valid MVS data set name acceptable to RACF default virtual data set name is constructed from name
44. Dump User Receive Js and Station Entries Prototype rvsDumpRU PROCDEF int PROCKEYW rvsDumpRU char environment char dsn const int dumpattrib Description of Parameters environ char input ment name of the environment data set If environment is NULL or an empty zero terminated string rvs will look for the default environment dsn char input data set name of dump file The data set contents will get the input format useable with the rvs batch interface dump const int input attrib attribute indicates which files should be dumped possible values are DUMP_USER default dump all user entries DUMP_RES dump all entries for Jobstart after Send request DUMP_JS DUMP_STATION 164 How to Work with rvs C CAL Interface 5 2 7 7 Return Codes FUNCTIONVALUE int RVSCAL_OK if function succeeds RVSCAL_PARAMETER_CHECK if at least one parameter is incorrect RVSCAL_DSN_NOT_EXIST if given data set does not exist RVSCAL_INTERNAL_ERROR if internal database error is occured 5 2 7 8 Get the version of rvs Database Prototype rvsGetVersion PROCDEF int PROCKEYW rvsGetDBVersion char oszDBVersion Description of Parameters pszDBVersion char output version of rvs database 5 2 7 9 Return Codes FUNCTIONVALUE int RVSCAL_OK if function succeeds RVSCAL_PARAMETER_CHECK if at least one parameter is incorrect RVSCAL_ENVIRONMENT_NO
45. E ENTRY In this panel you can create a rvs User Entry In a user entry you can grant authorizations to work with rvs Furthermore you can specify the language to display masks and messages for the specified user Functionkey lt F1 gt Functionkey lt F3 gt Key lt ENTERs User ID full Name Authorization Display help information No entry will be created leave the display and return to the previous one If all necessary fields are filled the entry will be created User ID which identifies the user on the system full Name or description of the user Authorization to use rvs This authorization has no affect on the system authorization of this user e A Administrator e O Operator e U User 90 How to Work Interactively with rvs Language Language to display panels and messages for this user e D German e E English Password Password for this user Display User Entry mask SUSR This panel displays details about the rvs User Entry you selected in the previous panel Functionkey lt F1 gt Display help information Functionkey lt F3 gt leave the display and return to the previous one DATE Current date TIME Current time User ID User ID which identifies the user on the system full Name full Name or description of the user 91 User Manual rvs Rev 01 04 2000 gedas deutschland GmbH Competence Center EDI rvs User Manual Authorization
46. E x PRIV 0 USER C UID extrauser RSS SSS SS update existing user USER U UID newuser LANGUAGE e NAME y PRIV U x delete user USER D UID newuser How to work with rvs Batch Interface and rvs C CAL Interface 4 2 10 Command ACTIVATE Function e Activate a partner station e rvs will start a sender process which establishes the connection to the partner station All queued files will be transmitted After that the connection is closed Parameters SID required station ID of partner Examples a activate station ABC connect and send or receiv data sets ACTIVATE SID ABC 4 2 11 Command MODST Function Modify station table queued Attention This command overwrites old database entries other existing entries will not be deleted only DELST will delete an entry Parameters DSN required name of data set which contains a station table the file name can be a single input file or a directory which contains several input files Examples Nee ae modify station table K open the fil here UNIX file name read contents and put it into database MODST DSN home rvs init new_rdstat da User Manual rvs Rev 01 04 2000 gedas deutschland GmbH Competence Center EDI rvs 135 User Manual 4 2 12 Command DELST Function Delete entry station table Parameters SID S
47. ING eiriaa uini peaa nA kE iite iaaa E Caia paS eaea aiani 126 426 COMMANA Serg eraregi inaia a RE a 126 4 2 7 Gommand RESENTR cceceesccceceeccececseeeeecseeeeesseeeeesseneeessenaees 130 4 2 8 Command SENDIOB eeeceesceceeeeeeeeeeeeeeeeeeeeeeeeeeseaeeeseaeeeeeeeeas 132 4 2 9 COMMANC USER mereerin eiria e ainat 134 4 2 10 Conmand ACTIVATE C ea eia e E 135 42 11 COMmMAnd MODS Torse aaia E E 135 3 User Manual rvs Rev 01 04 2000 gedas deutschland GmbH Competence Center EDI rvs User Manual 4 242 Command DEUS T uaea esa a aaar aan aa teed beans 136 4 2 13 Command LISTPARM taera tiaan eniai siarane ana iania iiaia 136 4 2 14 Command SETPARM ccsceesceceeececeeeeeeeeeeeeeeeceeeeseaeeestaeeeeeeeeaas 137 5 How to Work with rvs C CAL Interface e 138 5 1 Sending and Receiving with C CAL Interface cseeeeeee 138 5 1 1 Type Definitions mirean ea A EAA ARRA 139 5 1 2 Get next send entry from Database ccccccceeeeeseeeeereeees 140 5 1 3 Geta send entry from Database 0 cccccccecsceeeeseeeeeeeeeens 141 5 1 4 Set debug mode eee eet ceenee cece ee taeeeeaaeseeeeeeeaeeesaeeseneeesaes 141 5 1 5 Ghange status Of SE oia riatanais aaa 142 5 1 6 Get next information entry cccccceeeeeeeeeeeseeeeeseeeeeeeeeeeeeeees 143 Sekn Senda TG a a eaa a aaa Aa as 144 5 1 8 Create a Send Entry ceeccecceceeeeeeeeeeeeeeeeeeeeeeeeseaeeeeeeeenaees 145 5 2 Administration with C CAL Inter
48. Language Password Authorization to use rvs This authorization has no affect on the system authorization of this user e A Administrator e O Operator e U User Language to display panels and messages for this user e D German e E English Password for this user Confirm Delete of User Entry mask DUSR In this panel you are asked to confirm that you really want to delete the displayed user entry Functionkey lt F1 gt Functionkey lt F3 gt Functionkey lt F5 gt DATE TIME Display help information Cancel delete request the displayed entry will remain active Leave display and return to previous panel Confirm delete request the displayed entry will be deleted Current date Current time 92 User ID full Name Authorization Language Password How to Work Interactively with rvs User ID which identifies the user on the system full Name or description of the user Authorization to use rvs Language to display panels and messages for this user Password for this user Update User Entry mask UUSR In this panel you can update a rvs User Entry This mask is similar to the mask Create User Entry CUSR In a user entry you can grant authorizations to work with rvs Furthermore you can specify the language to display masks and messages for the specified user Functionkey lt F1 gt Functionkey lt F3 gt Key lt ENTER gt User ID
49. NETID L_LU62_NETID RVSCAL_L_LU62_LUNAME L_LU62_LUNAME RVSCAL_L_LU62_TPNAME L_LU62_TPNAME RVSCAL_L_LU62_UID L_LU62_UID RVSCAL_L_LU62_PASSW L_LU62_PASSW RVSCAL_L_LU62_PROF L_LU62_PROF RVSCAL_L_LU62_MODE L_LU62_MODE RVSCAL_L_LU62_PIP_DAT L_LU62_PIP_DAT RVSCAL_L_ LX_NAME L_LX_NAME RVSCAL_L_ LX _VALUE L_LX_VALUE RVSCAL_L_LOGMSG L_LOGMSG RVSCAL_L_ NETID RVSCAL_L_ODETTEID RVSCAL_L_ERRMSG 512 RVSCAL_L_ODETTEID RVSCAL_L_ OFTP_EERP RVSCAL_L_ OFTP_USERD RVSCAL_L_OPSW RVSCAL_L_ PARM NAME RVSCAL_L_ PARM VAL RVSCAL_L_ PHONE RVSCAL_L PIPEBUFFER RVSCAL_L PRIORITY RVSCAL_L_ RECMNT RVSCAL_L_ SEUSRLABEL RVSCAL_L_ STATID RVSCAL_L_ STATNAME RVSCAL_L_TCPIP_ADDR RVSCAL_L_TCPIP_SEC RVSCAL_L_USID RVSCAL_L_ USERNAME RVSCAL_L_VDSN RVSCAL_L_X25_ADDR RVSCAL_L_X25_ALIAS RVSCAL_L_X25_CUG RVSCAL_L_X25_FAC RVSCAL_L_X25_LINK RVSCAL_L_X25_SUBADDR RVSCAL_L_X25_USDTA RVSCAL_L_X25_ISDNNO RVSCAL_L_X25_TIMEOUT SID_START pew L_ODETTEID L_OFTP_EERP L_OFTP_USERD L_OPSW L_PARM_NAME L_PARM_VAL L_PHONE 20000 L_PRIOR L_RECMNT L_SEUSRLABEL L_STATID L_STATNAME L_TCPIP_ADDR L_TCPIP_SEC L_USID L_USERNAME L_VDSN L_X25_ADDR L_X25_ALIAS L_X25_CUG L_X25_FAC L_X25_LINK L_X25_SUBADDR L_X25_USDTA L_X25_ISDNNO L_X25_TIMEOUT TY 120 How to work with rvs Batch Interfac
50. R RESENTR U DSN incoming2 SID st2 REPLACE n JOB home rvs bin rcev sh 131 User Manual rvs Rev 01 04 2000 gedas deutschland GmbH Competence Center EDI rvs User Manual 4 2 8 Command SENDJOB Function Create update or delete a jobstart after send attempt entry Qualifiers CREATE default create jobstart after send attempt entry UPDATE update jobstart after send attempt entry DELETE delete jobstart after send attempt entry Parameters VDSN required virtual name of data set that is sent SID required station ID of receiver ATTEMPTS optional number of send attempts determines in which case the job should start value 0 the job starts if data set has been transmitted successfully value greater than 0 determines the number of attempts to send the data set in vain after that the specified job should start default 0 JOB optional name of data set containing a job to be submitted after data has been transmitted successfully or sending of data has been attempted in vain if specified the data set must exist COMMENT optional comment describing action of resident receive entry up to 50 characters default empty string 132 How to work with rvs Batch Interface and rvs C CAL Interface Examples s use all parameters SENDJOB C VDSN sending1 SI D st2 ATTEMPTS 1 JOB home rvs bin send faill sh COMMENT This is a test JS
51. SER 22 define RVSCAL DUPLICATE USER 23 define RVSCAL NEIGHBOR_STATION 24 define RVSCAL RC WAKE FAILED 25 define RVSCAL WRITE INTO PIPE 26 define RVSCAL DSN _NOT_EXIST 27 define RVSCAL ENVIRONMENT NOT_EXIST 28 define RVSCAL DUPLICATE _JS 29 define RVSCAL_JS_NOT_FOUND 30 define RVSCAL FRROR GETVERSION 31 define RVSCAL ERROR _MALLOC_INFOELEMENT 32 define RVSCAL ERROR MALLOC _SIDELEMENT 33 define RVSCAL INTERNAL ERROR 99 define RVSCAL_NOCMD RVSCAL END FETCH 119 User Manual rvs Rev 01 04 2000 gedas deutschland GmbH Competence Center EDI rvs User Manual others defin defin defin defin defin defin defin defin defin defin defin defin defin defin defin defin defin defin defin defin defin defin defin defin defin defin defin defin defin defin defin defin defin defin defin defin defin defin defin defin defin defin defin defin defin defin defin defin defin defin TVPDDADDDODADADADAAADAADADAADAIAADADAADAIAAADAADAADAADAIAADAAADAAAADAADADAADAAD MD O RVSCAL_L_ ACCT RVSCAL_L_USID RVSCAL_L_Cl LCI RVSCAL_L_DBVERSION L_DBVERSION RVSCAL_L_DSN 255 RVSCAL_L_DT L_DT RVSCAL_L_JOBID L_JOBID RVSCAL_L_KS L_KS RVSCAL_L_ODETTEID L_ODETTEID RVSCAL_L_ LANG L_LANG RVSCAL_L_LU62_
52. SS RE virtual datasetname LOOPTEST Program to start home umr bin lsa Job will be started in case of successfull transmission Comment last used at i created by umr F1 HELP F3 ESC EXIT In this panel displays details about the JobStart after SendAttempt entry you selected in the previous panel Functionkey lt F1 gt Display help information Functionkey lt F3 gt Leave display and return to previous panel 82 DATE TIME CmndNbr Station ID User How to Work Interactively with rvs Current date Current time Internal number of this entry Station ID of receiver If this field is blank a list of available station IDs will be displayed Use key lt S gt to select a station ID from that list and confirm your choice by pressing lt ENTER gt Your choice will be inserted into the current panel This is one of the selection criteria outgoing data set must have destinated to a station with a matching name for this entry to be further considered as a possible action for the outgoing file To be actually used all selection criteria must match User ID of sender Name or pattern of user ID of sender One of the selection criteria outgoing data set must have originated from a sender with a matching name for this entry to be further considered as a possible action for the outgoing file To be actually used all selection criteria must match Attention The user ID as s
53. T_ EXIST if environment data set does not exist RVSCAL_ERROR_GETVERSION if version couldn t be determined 165 User Manual rvs Rev 01 04 2000 gedas deutschland GmbH Competence Center EDI rvs User Manual 5 2 8 Other Functions This chapter describes how to get SID from ODETTE and vice versa as well as how to get the list status of rvs commands 5 2 8 1 Get SID from ODETTE ID or vice versa Prototype rvsgetsid char rvsgetsid char s_odette_id j Description of Parameters FUNCTIONVALUE char NULL if no SID found or DB error pointer to string containing rvs SID s_odette_id char input pointer to string containing ODETTE ID max 26 bytes Prototype rvsgetodid char rvsgetodid char s_sid Description of Parameters FUNCTIONVALUE char NULL if no ODETTE ID found or DB error pointer to max 26 byte string s_sid char input pointer to string containing rvs SID 166 How to Work with rvs C CAL Interface 5 2 8 2 List status of rvs Commands Prototype rvslistcmd typedef struct char status short errorcode RVSCMD int rvslistcmd long l_cmdid RVSCMD p_info Description of Parameters FUNCTIONVALUE int RVSCAL OK if rvslistcmd succeeded _ cmdid long input the CMDID command number of the command which was processed return value of rvscal p_info struct RVSCMD output pointer to a struct which contains information about
54. _receiver RVSCAL_L_ STATID long cnt_sendatt char dsn_batchjob RVSCAL_L_DSN char uid_creator RVSCAL_L_USID char comment RVSCAL_L_ RECMNT char dt_lastused RVSCAL_L_ DT INFO_JS define JS_UPDATE 1 define JS DELETE 2 define JS CREATE 3 5 2 5 2 Get next command number of Job Start Entry from Database Prototype rvsGetNextJS PROCDEF int PROCKEYW rvsGetNextJS const long cn_pre long lpcn_js Description of Parameters cn_pre const long input command number of previous entry Ipcn_js long output command number of next entry for jobstart after a send request found in JS table 157 User Manual rvs Rev 01 04 2000 gedas deutschland GmbH Competence Center EDI rvs User Manual 5 2 5 3 Get Jobstart Entry from Database Prototype rvsGetJS PROCDEF int PROCKEYW rvsGetJS const long cn_js INFO_JS jsinfo Description of Parameters cn_js const long input command number of jobstart entry jsinfo INFO_JS output struct with informations about jobstart entry 5 2 5 4 Configure Entries for Jobstart after Send Attempt Prototype rvsJobStartEntry PROCDEF int PROCKEYW rvsJobStartEntry const int icmd INFO_JS jsinfo Description of Parameters icmd const int input command to specify what should be done JS_UPDATE updates a jobstart entry JS_DELETE deletes a jobstart entry JS_CREATE creates a jobstart entry jsinfo INFO_JS input struct with
55. abstraction level thus providing more control and flexibility They are described in section How to Work with rvs C CAL Interface 4 1 Start the rvs Batch Interface The batch interface can be invoked as specified below rvsbat c e lt xenv dsn gt i lt cmd input file gt l lt language gt q t Note the invocation and parameter passing mechanism are dependend on the target operating system The command line parameters have the following meaning e c continue with rvsbat after an error occured during execution of a utility command By default rvsbat will terminate after an error e e use non default environment data set e icmdfile do not read commands from stdin but from cmdfile The command input file may contain the following elements Comment lines starting with Commands may extend over several lines by specifying as the last character in the line to be continued 116 How to work with rvs Batch Interface and rvs C CAL Interface e llanguage use message language given by character language e q execute user commands in quiet mode i e do not echo them to standard output feedback about success or failure of the operation will still be provided e t use test mode The following picture shows an example for Wondows NT Eingabeaufforderung Microsoft R Windows NT TM C Copyright 1985 1996 Microsoft Corp c russro gt rusbat rusNT R2 03 00 00 Beta c gedas
56. ailable as online help see function key lt F1 gt below 3 1 Input and Output Fields When you are asked to provide information to rvs the panels will provide input fields which are separated by arrows gt from their descriptions positions and maximum lengths of input fields are indicated by a series of underscores in the following sections Read only information is presented to you in output fields which are separated by colons from their descriptions positions and maximum lengths of output fields are indicated by periods 23 User Manual rvs Rev 01 04 2000 gedas deutschland GmbH Competence Center EDI rvs User Manual Example Mask SNDL on page 39 includes five input and two output fields Data set to be sent is 1 STATION ID 2 USER 3 TIMESTAMP a 50 character output field it is introduced with a colon rvs will display the name of the data set that you want to send in the part of the mask that is now filled with periods Since you are specifying additional receivers the data set name does not change and this field is read only describes a character input field where the station ID of the node at which this new intended receiver is located can be entered are all input fields also If your entry is shorter then the maximum field size you need not fill the field with blanks trailing blanks are ignored the line below the list of supported function ke
57. akls Ei Jobstart after Send Attempt SID DSN Station Virtual Dataset Prog x C rvs system resentr bat Starts batch file sendjob bat after Attempt Press F1 to gethelp Modify Js If you want to modify a Js e Select the entry to be modified in the Jobstart after Send Attempt window e Execute the menu command Edit Edit The Jobstart after Send Attempt dialog window then opens and displays the properties of the entry e Process the entry properties and confirm your entries with OK 112 How to Work Interactively with rvs Delete Js If you want to delete a Js e Select the entry to be deleted in the Jobstart after Send Attempt window e Execute the menu command Edit Remove rvSNT will then ask you to confirm your delete command t sNT Administrator x AN Do you really want to deiete jobstart entry 0 e lf you are sure you want to delete the entry confirm the command with Yes With No you cancel the operation without deleting the entry 113 User Manual rvs Rev 01 04 2000 gedas deutschland GmbH Competence Center EDI rvs User Manual 3 7 3 User Entries Only those users may work with rvsNT who are registered in the rvsNT database In order to display or modify user data e Open the User Table in the rvsNT Administrator by using the View User menu command The user table contains at least the table entry for your own data olki r
58. all rvs activities relating to receiving and storing a data set is to be charged Data set name should be made unique by adding of time stamp Choose e Y yes e N no Default N Determines what should be done with the data set when processing completes Choose e K eep Data set will be kept after processing and cataloged if these are seperate actions on the local system e Delete Data set will be deleted after processing This option only takes effect if there are jobs to process Default K 75 User Manual rvs Rev 01 04 2000 gedas deutschland GmbH Competence Center EDI rvs User Manual 9 10 11 REPLACE JOB COMMENT Specifies what should be done when a data set with the same name already exists Choose e R eplace This option only takes effect if DISPOSITION K and a data set with the specified name does already exist e N ew Create a new data set name e I gnore Incoming data set will be ignored Default N Name of data set that can be started as a batch job to specify a following process e g bat on MS DOS ___ CNTL on MVS Brief comment describing the purpose of this entry used for display only 76 How to Work Interactively with rvs 3 5 2 Job Start after Send Attempt This chapter contains a description of how to operate with job starts after send attempt entries Job Start after Send Attempt Entries mask JS 1 STATION ID
59. anguage given by character language e t use test mode for use by rvs administrator only The dialog interface of UNIX systems starts out with the following initial mask the masks for AS 400 are similar to those of UNIX 26 How to Work Interactively with rvs RechnerVerbundSystem mask INI RRRRRRR VV VY SSSSSS RR RR VY VY ss S RR RR VV VV SSS RRRRRR VV VY SSS55S RR RRR W W SSS RR RR VVVV S ss RR RR VV SSSSSS OPTION gt E send a dataset display delete transmissions delete send requests resident receive entries send job entries user entries informations BOO RUN ya ae aD Sh oe Fl HELP F3 ESC EXIT Select the action you want to perform next In most cases follow up panels will be displayed to ask for additional input or to display requested information Active function keys are displayed in the bottom line and help you navigate the panels If you need help press functionkey lt F1 gt to get more information about each field in the displayed panel SELECT OPTION Select the number of the option that describes the task you want to perform 1 send a data set A panel will be displayed where you can specify e name of data set to be sent e station ID and user ID of recipient e special processing options 27 User Manual rvs Rev 01 04 2000 gedas deutschland GmbH Competence Center EDI rvs User Manual 2 display delete transmissions 3 delet
60. anual 4 2 3 Syntax of Command Strings A utility command must follow the syntax rules specified below e It consists of acommand verb an optional command qualifier like CREATE DELETE etc The qualifier may start either with or and may be abbreviated to a single letter values of non repeatable parameters specified as lt parameter name gt lt parameter value gt There must not be blanks around the sign values of repeatable parameters send command only they follow the same syntax rules as those for non repeatable parameters A group of repeatable parameters is enclosed in parentheses There may be arbitrary many groups of repeatable parameters e Command verb qualifiers and parameter names may be specified in uppercase lowercase or mixed case e Parameter values are converted to uppercase if not protected by single or double quotes If a parameter value is to contain the protecting character itself the protecting character must be specified twice E g the following parameter specifications are equivalent PARM test string or parm test string wo Non protected parameter values may contain any alphanumeric character They may not contain a set of special characters e g blanks single or double quotes and parentheses e Different parameter specifications must be delimited by at least one blank 124 How to work with rvs Batch Interface and rvs C CAL Interface
61. at char codein char inittime char serial char label char tstamp char sid char dsnnew char codeout char s_msg Description of Parameters FUNCTIONVALUE int PARAMETERS command number of send entry if it was successfull RVSCAL_ERROR_CREATESEND if error occured see chapter Send a file 145 User Manual rvs Rev 01 04 2000 gedas deutschland GmbH Competence Center EDI rvs User Manual 5 2 Administration with C CAL Interface This chapter describes the functions to manage Station Table Entries rvs Parameters rvs Operator Commands Resident Receive Entries Entries for Jobstart after Send Attempt User Entries Database Functions For all this functions a type definition is given as well as the corresponding prototypes and return codes 5 2 1 Functions to manage Station Table Entries This chapter describes the functions which are required to manage the Station Table entries 5 2 1 1 Type Definitions typedef struct char netid RVSCAL_L NETID char statname RVSCAL_L_ STATNAME char phone RVSCAL_L_PHONE INFO_ST typedef struct char ftp RVSCAL_L_C1 char protocol RVSCAL_L_Cl char autodial RVSCAL_L Cl SINT pr_nk SINT flg_suspnd INFO_NK typedef struct char sidneighb RVSCAL_L_STATID SINT PERE INFO_RT 146 typedef struct char char char long long long long char c
62. ataset in a specific number of attempts Attempts gt 0O 1 Station ID gt I station id of receiver 2 User ID gt user ID of sender 3 virt datasetname gt virtual datasetname 4 Attempts gt 0 number of send attempts 5 Program gt Program to start 6 Comment gt F1 HELP F3 ESC CANCEL ENTER CREATE ENTRY In this panel you can create job start after send attempt entry In a job start after send attempt entry a user may specify what actions should be taken when a data set has been attempt to send Functionkey lt F1 gt Display help information Functionkey lt F3 gt No entry will be created Key lt ENTER gt If all fields are specified the entry will be created 1 STATION ID Station ID of receiver If this field is blank a list of available station IDs will be displayed Use key lt S gt to select a station ID from that list and confirm your choice by pressing lt ENTER gt Your choice will be inserted into the current panel This is one of the selection criteria outgoing data set must have destinated to a station with a matching name for this entry to be further considered as a possible action for the outgoing file To be actually used all selection criteria must match 80 2 3 4 USER DSNAME ATTEMPTS How to Work Interactively with rvs User ID of sender Name or pattern of user ID of sender One of the selection criteria outgoing
63. ation use lt D gt to delete a receiver from the list Functionkey lt F2 gt The propram displays a panel to define an additional receiver for this data set Functionkey lt F3 gt Abort creation of the send entry all information in the distribution list is discarded Functionkey lt F7 gt Page up Functionkey lt F8 gt Page down Key lt ENTER gt Send data set Data set to be sent Name of data set that should be delivered to one or more receivers Select option Enter an option in this column to modify or delete a receiver from the distribution list e Option s Modify one or more parameters of this receiver e Option D Delete this receiver from the distribution list STATION Station ID of receiver USER User ID of of receiver OUTPUT CODE Code in which data set will be sent e A ASCII e E EBCDIC e blank default TIME STAMP Data set name should be made unique by adding a time stamp e Y es A time stamp will be added e N o No time stamp will be added NEW DSNAME_ Name in which the data set is to be delivered 40 How to Work Interactively with rvs 3 4 2 Display Send Requests and Received Transmissions This chapter describes how you can display send requests and received transmissions Display Delete Transmissions mask DDTO Specify parameters below 1 DIRECTION gt R receive S send 2 STATION ID gt id or pattern of remote station blank list 3 USER gt
64. cal to those useable for rvsbat The function rvscal is described in chapter How to work with rvs Batch Interface and rvs C CAL Interface On the other hand the dedicated functions are on a lower abstraction level thus providing more control and flexibility They are described in the following chapters 5 1 Sending and Receiving with C CAL Interface This chapter describes the functions which are required to manage send entries using the C CAL Interface For all this functions a type definition and the corresponding prototypes are 138 How to Work with rvs C CAL Interface 5 1 1 Type Definitions typedef struct SINT i_error SINT 1_type char s_uid RVSCAL_L_USID char s_jobid RVSCAL_L_JOBID char sid_neighb RVSCAL_L_STATII char sid_dest RVSCAL_L STATID ID char char char 1 1 yx destination sid_sender RVSCAL_L STATI s_vdsn RVSCAL_L_VDSN D dt date ch ch ch Gh ch ch lo _created RVSCAL_L_ DT and time x7 job creation ar ar ar ar ar ar n e i o5 0a BON is rece haou aaoaoaoaaqo crock e E eA ch ct Q 5 _avail d RVSCAL_L_ n RVSCAL_L_ RVSCAL_L_D RVSCAL_L RVSCAL_L _sendatt ived RVSCAL_L_ DT DT DT T DT DT number of send iias attem lon on es on on on on on on on on Q Q Q
65. ching name for this receive entry to be further considered as a possible action for the incoming file To be actually used all selection criteria must match User ID of sender One of the selection criteria incoming data set must have originated from a sender with a matching name for this receive entry to be further considered as a possible action for the incoming file To be actually used all selection criteria must match Name or pattern of local user ID who is the recipient of the incoming information You may specify something other than your own user ID only if you are defined as privileged user Default your current user ID This is one of the selection criteria incoming data set must be intended for a local user with a matching name for this receive entry to be further considered as a possible action for the incoming file To be actually used all selection criteria must match 74 4 DSNAME DSNNEW ACCOUNT TIMESTAMP DISP How to Work Interactively with rvs Name of incoming data set Virtual name under which the file is known during transfer One of the selection criteria incoming data set must be known by a matching name for this receive entry to be further considered as a possible action for the incoming file To be actually used all selection criteria must match New name of data set that should be given to the recipient s copy of the received data Account in which
66. disp RVSCAL_L_Cl SINT flg_stamp char s_printdef RVSCAL_L_Cl char dsn_batchjob RVSCAL_L_DSN char uid_creator RVSCAL_L_USID char accnt_rcv RVSCAL_L_ ACCT char comment RVSCAL_L_ RECMNT char dt_lastused RVSCAL_L_ DT INFO_RE define RE UPDATE 1 define RE DELETE 2 define RE _CREATE 3 5 2 4 2 Get next command number of Resident Receive Entry from Database Prototype rvsGetNextRE PROCDEF int PROCKEYW rvsGetNextRE const long long lpcn_re cn_pre Description of Parameters cn_pre Ipcn_re const long input command number of previous resident receive entry long output command number of next resident receive entry found in RE table 154 How to Work with rvs C CAL Interface 5 2 4 3 Get Resident Receive Entry from Database Prototype rvsGetRE PROCDEF int PROCKEYW rvsGetRE const long cn_re INFO_RE reinfo Description of Parameters cn_re reinfo const long input command number of resident receive entry INFO_RE output struct with informations about resident receive entry 5 2 4 4 Configure Resident Receive Entries Prototype rvsResidentResceiveEntry PROCDEF int PROCKEYW rvsResidentReceiveEntry const int icmd INFO_RE reinfo Description of Parameters icmd reinfo const int input command to specify what should be done RE_UPDATE updates a resident receive entry RE_DELETE deletes a resident receive en
67. displays If available lt PageUp gt is equivalent to lt F7 gt scrolls down list displays If available lt PageDowns gt is equivalent to lt F8 gt Depending on the system and terminal type not all function keys required could be mapped to keys indicated as F keys on the keyboard If you have problems with function keys you can use the numerical keypad fields on your keyboard instead 25 User Manual rvs Rev 01 04 2000 gedas deutschland GmbH Competence Center EDI rvs User Manual 3 3 Start Interactive Applications This chapter describes the start of the interactive applications for the different operating systems For UNIX systems you can use the dialog interface to admnistrate and to receive and or send files with rvs In additional you have the Operator Console see Operator Manual for the rvs administration 3 3 1 Dialog Interface rvsdia for UNIX and AS 400 systems The dialog interface can be invoked as rvsdia e lt envdsn gt l lt language gt t for UNIX systems where items within square brackets are optional The dialog interface can be used for adminstration and for sending and receiving tasks For AS 400 systems you start the dialog interface using the rvs400 main window command WRKRVS The command line parameters have the following meaning e e set alternate environment data set for use by rvs administrator only e l language use message l
68. e starting a job List of Job Start after Send Attempt Entries mask JSSL This panel displays a list of JobStart after SendAttempt Entries Use line command lt S gt lt U gt or lt D gt to get more information about the entry update or delete it respectively Functionkey lt F1 gt Functionkey lt F2 gt Functionkey lt F3 gt Functionkey lt F7 gt Functionkey lt F8 gt Key lt ENTERs DATE Display help information Display a mask to add a new entry Ignore any selection and leave display Page up Page down Confirm selection Current date 78 TIME Specify option SID Data set name Job Name Attempts How to Work Interactively with rvs Current time Enter one of these options to the left of one of the displayed JobStart after SendAttempt entries e S Display the entry e U Update the entry e D Delete the entry Station ID of receiver Name or name pattern of outgoing data set that will be processed by this JobStart entry Job that will be started after the specified amount of sendattempts Number of Sendattempts before the specified job will be started 79 User Manual rvs Rev 01 04 2000 gedas deutschland GmbH Competence Center EDI rvs User Manual Create Job Start after Send Attempt Entry mask CJSS Specify which program has to start after sending of a specific dataset Attempts 0 or if it was not possible to send the d
69. e and rvs C CAL Interface Prototype of function rvscal int rvscal char s_cmd int p_l_cmd char p_c_msglvl char s_msg int p_l_msg long p_cmdid Note parameter list has been designed in this way in order to be callable by other programming languages e g FORTRAN as well Description of Parameters RETURNVALUE S_CMD P L CMD P_C_MSGLVL int 0 if rvscal succeeded although the message text may have been truncated different from 0 if any failure occured There are two types of error codes e errors detected by the command parser are due to an invalid command syntax The error codes are in the range between 1 and 7 A detailed description is given in Messages and Codes e Any other error occured while rvs tries to execute the specified command The message string returned via S_MSG contains a description of the error reason char input pointer to character array with command string the array size must be at least P_L_CMD 1 int input length of command string S_CMD must be zero terminated if P_L_CMD is larger than length of command string char output returns the message level may be I informal W warning E error S Severe 121 User Manual rvs Rev 01 04 2000 gedas deutschland GmbH Competence Center EDI rvs User Manual S_MSG P_ L MSG P_CMDID char update pointer to a character string of length at
70. e data set Choose e H Data set is put in held status it will not be sent until released by you or freed by the rvs operator e explicit time Year Month Day Hour Minute YYYY MM DD HH MM e blank now 9 SERIALIZE Specify whether this data set belongs toa group of serialized transmissions see LABEL field Choose e Y es for serialized sending of data set e N o for non serialized sending of data set default N 37 User Manual rvs Rev 01 04 2000 gedas deutschland GmbH Competence Center EDI rvs User Manual 10 11 12 LABEL NEW DSNAME OUTPUT CODE Name of group of serialized send requests User specified descriptive label for this entry It is used to serialize on another send entry with the same label if serialization was requested when there is more than one other send entry with the same label the latest one is used to serialize on Rename data set for transmission This field specifies the name under which the file is known during transmission resident receive entries at the destination must specify this name to further process the incoming data set If this field is left blank the original data set name is used Note Make sure to specify a valid MVS data set name when sending to an MVS host Specify code in which data set should be delivered to recipient By default T format data sets are delivered in the native code of the receiver s system
71. e name already exists Choose e R eplace This option is only meaningful if DISPOSITION K and a data set with the specified name does already exist e N ew Create a new data set name e I gnore Incoming data set will be ignored Default N 10 JOB Name of data set that can be started as a batch job to specify a following process e g bat on MS DOS e CNTL on MVS 11 COMMENT Brief comment describing the purpose of this entry used for display only 67 User Manual rvs Rev 01 04 2000 gedas deutschland GmbH Competence Center EDI rvs User Manual Display Resident Receive Entry mask RE1 Cmdnbr of RE 330 Remote station R User ID of sender Local user or alias es Dataset name LOOP New dataset name Add timestamp N Disposition D Replace of dataset N Job to be started Account umr Comment Created by user umr Creation date 2000 04 03 10 36 Last used date Fl HELP F3 ESC CANCEL This panel displays details about the resident receive entry you selected in the previous panel Functionkey lt F3 gt Leave display DATE Current date TIME Current time Cmdnbr of RE Internal number of resident receive entry Remote station Station ID or pattern of remote station One of the selection criteria incoming data set must have originated at a station with a matching name for this receive entry to be further considered as a possible action for the incoming file
72. e send requests 4 resident receiv entries You will be able to specify selection criteria for the display of transmissions both sent and received Select the transmission you are interested in e to view details such as status number of bytes etc e cancel a send request Choose this option if you know the parameters of the send request you want to delete you will not see a selection list You will be able to specify selection criteria for the display of resident receive entries you want to work with Select the resident receive entry RE you are interested in e to view details e to modify any field in the RE or e to delete the entire RE Through this selection you will be able to create a new entry too 28 How to Work Interactively with rvs 5 job start after send You will be able to specify attempt entries selection criteria for the display of job start after send attempt entries you want to work with Select the job start after send attempt entry JS you are interested in e to view details e to modify any field in the JS or e to delete the entire JS Through this selection you will be able to create a new entry too 6 user entries You will get a list of all rvs users and you will be able e to view details to modify a user entry to remove a user entry to create a new entry Informations This option provides access to additional on line
73. ecords for F and V format data sets always zero for T and U format data sets DTRCV date when data set was delivered to local user LUID recipient s i e local user ID UID sender s user ID SID sender s station ID DSNTEMP name of temp data set this data set should be deleted at the end of the job DELETE 7DSNTEMP The type of job submitted by rvs depends on the operating system E g under OS 2 a CMD data set will be executed as background process whereas under OS 400 rvs will start a job using SBMDBJOB 18 Overview rvs REPLACE if DISP K keep REPLACE determines the actions performed by rvs when it has received a data set that matches the name of an existing local data set R replace existing data set N create new data set name this is the default I ignore incoming data set TSTAMP make name of incoming data set unique by using a time stamp or other means A resident receive entry can be created using the rvs utilities via e the dialog interface chapter How to Work Interactively with rvs by filling the corresponding mask e the batch interface chapter How to work with rvs Batch Interface and rvs C CAL Interface rvscal or e the C CAL Interface chapter How to Work with rvs C CAL Interface 19 User Manual rvs Rev 01 04 2000 gedas deutschland GmbH Competence Center EDI rvs User Manual 2 5 Jobstart after Send Attempt A jobstart after se
74. ee A 60 PRE E AET A A AR A EE 68 REU ortie ad 62 REU enea e a 73 oB EE A E E A E 39 SISS at ioe atone 82 SND trann Goosen inst ie 35 SND DL ariaa ateata 40 LS a E AE AES 91 JSS e a 86 USR creer Staten aea 88 VUSR a rn ai ae a 93 MasterTransmitter 169 Modify Sie seer ea ae 112 PibeecesAc est anaa ae e aus 109 Monitor commands 170 NEW USED cece eeeeee eee ee sees 114 172 physical network 6 7 171 LE A Se On One oa 115 Platforms cceceeeeeeeeeeeeeeee 7 Send12 20 31 32 33 40 41 57 58 77 78 80 82 85 portable version 000 6 86 157 158 159 164 170 Prototyp Send data set rvsCreateSendEntry 144 bidet Yate pete tvsCreateSendEntryCmd 145 distribution list ee 40 rvsDeleteDB c0cccseeeeeeees 164 Send order rvsDeleteStation 0 149 rvsDumpDB nsise 162 a A ATS A as se rvSDUMPRU eee 164 TAGs ees ate 102 rvsFreeSuspendedCommands et 0 brie Ma ibaa t ite E A A AT 150 A AVS 0 ho nennen 158 aoe NOIE ae 1 A rvsGetNextlE a a T43 REDD Sor tates varie ote tate ot rvsGetNextUS 0 cee 157 SO aota 114 ryvsGetNextParm s es 151 rysGetNextRE n se 154 Status display 2 0 32 rvsGetNextSend 008 140 rvsGetNextStation 2 148 Time stamping 15 rvsGetNextUser 008 160 nai rysgetodid sierran 166 Transmission of rysGetParm uu eee 151 data cl iin
75. eees 77 3 5 3 Yser Distans a a ae irae e a AR 88 3 5 4 Information about rVS ssssssseieiseesieieisrsrernrsrrsrsrsrernrsrssrerens 95 3 6 Interactive Sending and Receiving for Windows NT 0008 96 3 6 1 Create Send Requests ccc ccceeeeeeseeeeeeeeeeeeeeseeeseaeeeeneeeeaes 96 3 6 2 Display Send Requests and Received Transmission 99 3 6 3 Operate Send Requests and Received Transmission 100 3 6 4 Select display criteria ceecccceeeeeeeeeeeeeeeeeeseaeeeeaeeeeneeee 103 3 7 Interactive Administration for Windows NT ccceceeeeseeeeees 105 3 7 1 Resident Receive Entries ccccccecesceeceeeeeeeeseneeeeeeeeeeeees 105 3 7 2 Job Start after Send Attempt ceccceceeeeeeeeeeeeeteeeeneeees 110 3 7 3 UsermEntriesS in titative des eta nel iia 114 4 How to work with rvs Batch Interface and rys C CAL Interface rvSCal scseessssesesessssscesreees 116 4 1 Start the rvs Batch Interface sisccsest int sce cfaid tosastaoneechsvatseasuabieiavaeancs 116 4 2 Use the C CAL Interface cccccccsscceceesseeeeessneeeeecsueeesesseeeeseaas 118 4 2 1 Header File rvscal ocsececcccceseesenceceeeeeeeeeeeeeeeeeeeeeenueeeeeeeeneees 118 4 2 2 Description of COMMANAS ccccceeeeeeeeeteeeeeseteeetteeeeeneeteaes 123 4 2 3 Syntax of Command StringS ccccceeeeseeceeeeseeeeeeeaeeeeeeeees 124 4 2 4 COMMAN Start en eieaa eE eee ELAES EREEREER REAT 125 425 COMMANG B
76. election criteria is not yet supported 83 User Manual rvs Rev 01 04 2000 gedas deutschland GmbH Competence Center EDI rvs User Manual virtual DS Name Job to submit Job will be started after Comment Last used at Created by Virtual name of outgoing data set One of the selection criteria outgoing data set must be known by a matching name for this entry to be further considered as a possible action for the outgoing file To be actually used all selection criteria must match Name of data set that can be started as a batch job to specify the following process e g e bat on MS DOS or Windows NT e CNTL on MVS e cmd on OS2 On AS 400 the job will be started with the OS 400 system command SBMDBJOB One of the selection criteria specifies amount of send attempts after which the specified job should be started Brief comment describing the purpose of this entry used for display only Date and time when this entry was last used to detremine the actions that occured when a data set was attempt to send User ID of person who created this entry 84 How to Work Interactively with rvs Confirm Delete of Job Start after Send Attempt Entry mask DJSS In this panel you are ask to confirm that you really want to delete this displayed JobStart after SendAttempt entry you selected in the previous panel Functionkey lt F1 gt Functionkey lt F3 gt Functionk
77. esesesesesesesees 12 2 1 Data Set Names sicccnticet ci sibtistencel GW evhatieataiahercudiesssiatiseuienes 13 2 2 Code CONVELSION skiera riran nran aR EEEN NEERA E ERIE 16 29 SOMAlIZALON ei sann A E A NEA E ETS 16 2 4 Resident Receive Entries ccccccceceeeeeeeeceeceeeeeeeseeseaeeeeeeeeeeees 17 2 5 Jobstart after Send Attempt cccccceeeeeseeceeeeeeeneeeseeeeeeeeeeeeeeees 20 3 How to Work Interactively with rvs ssesseeeees 23 3 1 Input and Output Fields eee eeee eee eceeeeeeeeceeeeeseaeeeeeeeeeaeeeeeeeeeaas 23 3 2 FUNCION KEYS jis iain ndeie loti ar a dle ieee hee 25 3 3 Start Interactive Applications eccccceeeeececeeeeceeeeeeeaeeeeaeeeeeeeees 26 3 3 1 Dialog Interface rvsdia for UNIX and AS 400 systems 26 3 3 2 rvsNT Adminstrator rvsmgr exe for Windows NT 30 3 3 3 rvsNT rvsdiant exe for Windows NT nesses 31 3 4 Interactive Sending and Receiving for UNIX and AS 400 35 3 4 1 Create Send Requests ccccccceeeeseeeeeeeeeeeeeeseeeeseaeeseeeeeaes 35 3 4 2 Display Send Requests and Received Transmissions 41 3 4 3 Operate Send Requests and Received Transmissions 57 3 5 Interactive Administration for UNIX and AS 400 ceecseeeeeees 60 3 5 1 Resident Receive Entries ccccccceeesecceceeeeeeeeeeneeeeeeeeeteees 60 3 5 2 Job Start after Send Attempt c cceeseeeeceeeeeeeeeeeeeeeeeeneee
78. ess pending waiting for completion DO o m Q ended w active H in transit transmitter currently processing order deleted D IQ held by the system or operator n traffic with the destination suspended at present If you want to repeatedly use this setting then activate the Save Setting as Standard selection box Confirm the entry by pressing the button OK 104 How to Work Interactively with rvs 3 7 Interactive Administration for Windows NT This chapter describes how to administrate resident receive entries jobs after send attempts and user lists You must call the application rvsmgr if you want to work interactively with rvs 3 7 1 Resident Receive Entries When a file is received the rvs Monitor stores it in the directory c rvs usrdat Then it logs reception in the rvsNT Administrator and in the rvs log book You can trigger other actions when receiving files by generating resident receive entries RE in the rvs Database A RE tells the Monitor to start a program when a particular file or selection of files has arrived Example When a file with the extension TXT TXT arrives the batch program copy bat should start see the following This batch program copies the received file from the user data directory c rvs usrdat into the directory d temp copy DSN d temp DSN stands for DataSetName and states where the file was placed
79. ette Buffer lt DISCONNECT gt Connection to Station LOC ended 0 lt DISCONNECT gt Connection to Station LOC ended Press F1 to get help 110 How to Work Interactively with rvs Create JS If you want to start a program after an attempt to send a file do the following e Execute the menu command view gt Add The Jobstart after Send Attempt dialog window then opens Jobstart after Send Attempt Ed Station f Virtual Data Set Name f Jobstart after 3 my Error Send Attempts um Success P C rvs system sendjob bat Search Program Comment Starting batch process sendjob bat after Attempt Coreei _ Enter the station you want to send the file to In the Virtual Data Set Name field enter the file or the file specification for which the Js is to apply e Use Search to select the batch program that should start after the attempt to send the file e If you only want the program to start in the event of an unsuccessful attempt then select Error and under Send Attempts enter the number of unsuccessful attempts after which the program should start e Confirm the entries by pressing OK 111 User Manual rvs Rev 01 04 2000 gedas deutschland GmbH Competence Center EDI rvs User Manual The rvsNT Administrator writes the new entry t the rvs Database and displays it in the list of JS s rvsNT Administrator File Edit View Monitor Database Window
80. ew name Ignore 10 JOB gt automatic job submit after receiving specify complete dataset name containing job to be submitted 11 COMMENT gt comment concerning resident receive entry F1 HELP F3 ESC CANCEL ENTER create entry In this panel you can create a resident receive entry In a resident receive entry a user may specify what actions should be taken when a data set has been received When changes become necessary a new entry will be created and the old one will be deleted Functionkey lt F3 gt No resident receive entry will be created Key lt ENTER gt If all fields are specified the resident receive entry will be created 1 STATION ID Station ID of sender If this field is blank a list of available station IDs will be displayed Use key lt S gt to select a station ID from that list and confirm your choice by pressing lt ENTER gt Your choice will be inserted into the current panel This is one of the selection criteria incoming data set must have originated at a station with a matching name for this receive entry to be further considered as a possible action for the incoming file To be actually used all selection criteria must match 64 2 3 4 USER LOCAL USER DSNAME How to Work Interactively with rvs User ID of sender Name or pattern of user ID of sender One of the selection criteria incoming data set must have originated from a sender with a
81. ey lt F5 gt DATE TIME CmndNbr Remote Station User ID of sender virtual data setname Attempts Job Display help information Cancel delete request the displayed entry will remain active Leave display and return to previous panel Confirm delete request the displayed entry will be deleted Current date Current time Internal number of this entry Station ID of receiver User ID of sender Name or pattern of user ID of sender Virtual name of outgoing data set Specifies amount of send attempts after which the specified job should be started Name of data set that can be started as a batch job to specify the following process 85 User Manual rvs Rev 01 04 2000 gedas deutschland GmbH Competence Center EDI rvs User Manual Comment Brief comment describing the purpose of this entry used for display only Created by user User ID of person who created this entry Creation date Date and time when this entry was created Last used date Date and time when this entry was last used to detremine the actions that occured when a data set was attempt to send Update Job Start after Send Attempt Entry mask UJSS In this panel you can update JobStart after SendAttempt entry In a JobStart after SendAttempt entry a user may specify what actions should be taken when a data set has been attempt to send This mask is similar to the mask Create Job Start after Send Attempt Entr
82. face eesseeeseeeseesseeesr eese resrnees 146 5 2 1 Functions to manage Station Table Entries c ceee 146 5 2 1 1 Type Definitions sss e aT EAA 146 5 2 1 2 Get next station entry from Database seese essees eneee 148 5 2 1 3 Update station entry from Database eee eeeeeeeeees 149 5 2 1 4 Get station entries from Database ccecceeeeeeteeteeees 149 5 2 1 5 Delete station entry from Database eee eeeeeeeeeeee 149 5 2 1 6 Free all suspended Command5s ccccceeceeeseeeeeteeeenees 150 5 2 1 7 Return COdeS cecceeeesceceeeeeceeeeeesaeseeneeceeeeeaeeeeaaeseeneessaees 150 5 2 2 Functions to manage IVS Parameters sscisicidundatsibticsercdernecidse 151 5 2 2 1 Type Definition 2 0 eceeeeceeeeeeeeeeeeeeeeeaaeeeeneaaeeeeseaeeeeeaas 151 5 2 2 2 Get parameter value from Database ceecceseeeeeees 151 5 2 2 3 Get next parameter from Database cccceeeeeeeeeerees 151 5 2 2 4 Writes parameter value into Database ceeeees 152 5 2 2 5 Return CodeS iieiea ea Na 152 5 2 3 Functions to manage rvs Operator Commands 153 5 2 3 1 Store operator command into Database 0 ceeeees 153 5 2 3 2 Wake the Montola aA EAEE 153 5 2 3 3 Return CodeSeia s 08 1 ta naan aaa ae Eaa iaaa 153 5 2 4 Functions to manage Resident Receive Entries 5 154 5 2 4 1 Type Definition and Macros eeeeeceeeeeseeeeeeeteeeeeeneeeeeenaes 154
83. from Database Prototype rvsGet Station PROCDEF int PROCKEYW rvsGetStation char osz_SID INFO_STATION info Description of Parameters psz_SID char input SID of station info INFO_STATION output Struct with informations about station entry 5 2 1 5 Delete station entry from Database Prototype rvsDeleteStation PROCDEF int PROCKEYW rvsDeleteStation char psz_SID Description of Parameters psz_SID char input SID of station 149 User Manual rvs Rev 01 04 2000 gedas deutschland GmbH Competence Center EDI rvs User Manual 5 2 1 6 Free all suspended Commands Prototype rvsFreeSuspendedCommands PROCDEF int PROCKEYW rvsFreeSuspendedCommands void Description of Parameters there is no parameter 5 2 1 7 Return Codes FUNCTIONVALUE int RVSCAL_OK if function succeeds RVSCAL_END_FETCH if there are no stations with this SID or no entries greater than SIDPRE RVSCAL_DBERROR if database could not be opened RVSCAL_NEITHER_X_NOR_ISDN if neither X25 address nor ISDN address is specified RVSCAL_NEIGHBOR_STATION if there are routing links to this station in case of delete RVSCAL_PARAMETER_CHECK if at least one parameter is incorrect RVSCAL_INTERNAL_ERROR if internal database error is occured 150 How to Work with rvs C CAL Interface 5 2 2 Functions to manage rvs Parameters This chapter describes the
84. g The respective successive command numbers for send entries SE send command Sk and information entries IE identify the individual transmission steps These numbers can also be found in the rvsNT Log Book file c rvs temp rlco 1log The rvs Monitor logs the transmission time Use the push buttons under the menu line to quickly execute the most frequently used commands The push buttons change in accordance with the display mode Status display The status field displays the progress of the send order selected or that of the order arriving Send In the send or completely sent display modes the status field shows three events SE SK QE see table below 32 How to Work Interactively with rvs Receive In the receive or completely received display modes the status field shows three events IE IZ QS see table below Sample send order Status qq SE q SK q QE Abbr Event status Possible values status chain Send order SE RE entry la f p SK Send command q a i QE Acknowledgement receipt sent by recipient Reception arrival IE Information receipt q f p e QS Acknowledgement transmission back f a i to sender P e Each event normally runs through the status chain in the order of possible values indicated Some statuses have such a short duration that they are only briefly visible 33 User Manual rvs Rev
85. g and Receiving for Windows NT This chapter describes how to send and receive data sets with rvs if you are using an ineractive application First it will be explained how you can create send requests The next chapter describes how you can display sent and received transmissions and the last chapter shows how you can operate with send and receive data sets 3 6 1 Create Send Requests This is how you send a file to a business partner e Execute the menu command Edit New Send Entry You can also execute this command by using F2 or by pressing the push button New Send Entry The Choose file to be sent dialog box will open Chocse file to be send Suchen in I system gj j amp 3 rdbtab dat thdedre hip thdddt0 hlp F beeprvs bat 3 Rdkey dat thdedrec hip thdddtt ir S Ecneb dil 3 Rdmini dat thdedse hip thdddtr hip gt ex25 dl 3 Rdstat dat thdedse1 hip thddelsr hl liesmich txt readme txt thdens hip thddmlhip a Neu mas F resentr bat D thderre hlp D trhddsnl hlg El Dateiname readme txt Dateityp all Files z Cancel e Select the file which you would like to send to your partner and confirm your selection with Open Example c rvs system readme txt 96 How to Work Interactively with rvs The New Send Entry dialog window then opens and displays the file name selected in the File field New Send Entry x Station ID Loc Select
86. har char char char char char INFO_OP typedef struct char char char char char char char SINT SINT SINT INFO_LU typedef struct char char long char char char char char char SINT cha SIN SIN SIN cha cha long INFO_XP r T T T r How to Work with rvs C CAL Interface odetteid RVSCAL_L_ODETTEID pswfrom RVSCAL_L_OPSW pswto RVSCAL_L_OPSW i_sendblocks i_recvblocks i_ocreval i1_oexbuf codein RVSCAL_L_ Cl codeout RVSCAL_L Cl userfield RVSCAL_L_OFTP_USERD eerp_in RVSCAL_L_OFTP_EERP eerp_out RVSCAL_L_OFTP_EERP vdsnchar RVSCAL_L_ OFTP_EERP retry RVSCAL_L_DT netid_lu RVSCAL_L_ LU62_NETID luname RVSCAL_L LU62_LUNAME tpname RVSCAL_L_LU62_TPNAME userid RVSCAL_L_LU62_UID password RVSCAL_L_LU62_PASSW profile RVSCAL_L_LU62_PROF mode RVSCAL_L_LU62_MODE i_security flg_sync flg_conv alias RVSCAL_L X25 ALIAS recv_alias RVSCAL_L X25 ALIAS citi xaddr RVSCAL_L_X25_ADDR subaddr RVSCAL_L_X25_SUBADDR timeout RVSCAL_L X25 TIMEOUT isdnno RVSCAL_L_ X25 _ISDNNO link RVSCAL_L_ X25 LINK fac RVSCAL _L_ X25 FAC flgdbit cug RVSCAL_L_X25_CUG flgregrev flgaccrev flgfastsel usrdata RVSCAL_L X25 _USDTA vc RVSCAL_L_ Cl cntsessions User Manual rvs Rev 01 04 2000 147
87. hin each of these two code families special characters like square brackets or national language characters like accented letters or umlauts may be assigned different codes in different code pages within a family rvs distinguishes between text files format T and non text files formats F V and U Text files are always transmitted in ASCII and delivered in the local code of the target system Non text files are transmitted as is without any conversion unless you specifically request code conversion by specifying INPUT CODE and OUTPUT CODE when creating the send entry You also may involve a code conversion for received files by configuring a resident receive entry 2 3 Serialization Sometimes it may be important that a number of data sets arrive in a specific order at their destination to make sure they will be processed in proper sequence Even though rvs will start processing send entries in the order in which they were submitted there is no guarantee that the data sets will arrive in just this order the line may break down while one file is being sent and another file may be transmitted before restart of the interrupted transmission is attempted To enforce the proper sequence e specify a LABEL when creating the send entry for the first data set in your series This label consists of up to twenty characters of your choice e use the same label in the LABEL field and specify SERIALIZE Y for all subsequent da
88. iiseiriuniadines issevi 35 rysGetRE s es 155 Update rvsGetSendEntry eee 141 f rvsgetsid as AicecSicnctesticteceneSeine 166 job start after send attempt entry rvsGetStation ccccccccceccecees 149 ceeteeeneeneenees seeeteneneenteneneeneeetiees 86 rvsGetUSer siise 160 resident receive entry 73 rvsGetVersion ccccccccceceeeees 165 USEF ONY iniiis 93 YVSIN tDB ooo eeeeeeseeseeeeseeeeees 163 Update display 99 100 rvsJobStartEntry ceee 158 IVSIISTCM onone 167 User rvsResidentResceiveEntry 155 MOA Y oseese 115 rvsSetDebugMode 141 FW ea eteerta cheer stls ies 114 rvsSetSendEnttty ee 142 Saven eaa aS 115 rvsStoreOK MERETE ELUN KEER KUIR ROEE 153 user interface ERANA 1 8 rvsUpdateStation 149 VSUSET oe ceeeceseesceeseeseeseenseeees 161 User Modification 115 rvsWakeMonitor cacce 153 rvsWriteDB c0cccceseeeeeeeee 163 User table rysWriteParm seess 152 MOAI iaa rnd datetes 114 Receive17 31 33 60 62 What rvs is oann 6 64 68 71 73 154 l What rys iS NOt 7 Resident Receive Entries17 60 62 154 Window areas aaisan 32 rvs database 2 2 2 0 7 8 173 User Manual rvs Rev 01 04 2000 gedas deutschland GmbH Competence Center EDI rvs
89. information about rvs 29 User Manual rvs Rev 01 04 2000 gedas deutschland GmbH Competence Center EDI rvs User Manual 3 3 2 rvSNT Adminstrator rvsmgr exe for Windows NT The rvsNT administrator is used for configuring administering and operating rvsNT In order to carry out these activities the rvsNT Administrator is equipped with several detail windows The configuration assumes administrator user rights at the system level and in the rvsNT environment Start the program rvsNT Administrator by invocation in the rvs file or by means of Start Programs gt rvs rvs Administrator The rvsNT Administrator then opens with the Monitor Log window which displays the current rvs Monitor activities Y rysNT Administrator ol x File Edit View Monitor Database Window a e 2 w Monitor Log lt MO_STARTED gt rpmoms New console RVSCNS started lt INIT_CMD gt rpm Reading initial commands lt OK_READ gt RYSCNS cleanup days 3 ss yes lt CLNUP_DEL_ 35 gt Cleanup of RVS data base purge all SendStatistics with DTEND lt 1997 09 18 12 47 lt CLNUP_START gt Cleanup of RVS data base purge all commands with DTDONE lt 1997 09 18 12 47 22 lt CLNUP_NONE gt Cleanup of RVS data base ended there are no commands to be purged lt XMT_START gt MasterTransmitter started Press F1 to get help 30 How to Work Interactively with rvs 3 3 3 rvsNT rvsdiant e
90. ing the purpose of the resident receive entry A jobstart after send attempt entry can be created using the rvs utilities via e the batch interface chapter How to work with rvs Batch Interface and rvs C CAL Interface rvscal or e the C CAL Interface chapter How to Work with rvs C CAL Interface e the rvsdia user interactive interface chapter How to Work Interactively with rvs 22 How to Work Interactively with rvs 3 How to Work Interactively with rvs This screen interactive interface to rvs lets you e define send entries to transmit one data set at a time to one or more recipients at your local station or at one or more remote rvs nodes e display the status of your transmissions e delete send entries as long as rvs did not start processing them yet e create resident receive entries to influence the way incoming data is being stored or further processed e create resident send entries in order to trigger actions when files are sent or couldn t be sent respectively e modify or delete resident receive and send entries In the following sections the masks panels screens are shown as they appear under the different operating system Minor differences may exist for the different systems e g lt ESC gt is not used on an AS 400 screen Each mask is followed by a help text describing the purpose of the screen and the meaning of it s fields These help texts are also av
91. int prev_send_cn info REMARKS RVSCAL_OK if we found a next send entry RVSCAL_END_FETCH if there are no send entries greater than PREV_SEND_CN RVSCAL_INTERNAL_ERROR if internal database error is occured int input Command no of previous send entry struct INFO_SK output Struct with informations about next send entry with command number greater than prev_send_cn rvsGetNextSend looks for the next send entry with a value greater than prev_send_cn When the function is called the first time prev_send_cn must be CN_START CN_START caused rvsGetNextSend to read all entries from the rvs database and save it to an internal list Every call of rvsGetNext Send with prev_send_cn CN_START will refresh that list 140 How to Work with rvs C CAL Interface 5 1 3 Get a send entry from Database Prototype rvsGetSendEntry PROCDEF int PROCKEYW rvsGetSendEntry const long send_cn INFO _SK info Description of Parameters FUNCTIONVALUE int send_cn info RVSCAL_OK if we found the informations about this send command RVSCAL_END_ FETCH if there is no send entry with given command number RVSCAL_INTERNAL_ERROBR if internal database error occured int input Command number of a send entry struct INFO_SK output Struct with informations about send entry 5 1 4 Set debug mode Prototype rvsSetDebugMode PROCDEF int PROCKEYW rvsSetDebugMode int mode Descrip
92. into the C source code 4 2 1 Header File rvscal h This chapter describes how to define a macro and explains a prototype of rvscal Macro definitions storage class definitions if defined _LITYPE_INCLUDED typedef char STRING if defined OS400 typedef int SINT else typedef short SINT endif endif include rixstd h ifdef NT define PROCDEF extern _ declspec dllimport define PROCKEYW elif _AFXDLL define PROCDEF extern cC define PROCKEYW else define PROCDEF define PROCKEYW endif 118 How to work with rvs Batch Interface and rvs C CAL Interface return codes define RVSCAL OK 0 define RVSCAL_END_FETCH 1 define RVSCAL_CLOSE_FAILED 2 define RVSCAL_OPEN_FAILED T3 define RVSCAL_ERROR_CREATESEND 4 define RVSCAL PARAMETER CHECK 5 define RVSCAL_DBERROR 7 define RVSCAL_INVALID_NAME 12 define RVSCAL INVALID SID 13 define RVSCAL RE NOT FOUND 14 define RVSCAL NEITHER _X NOR_ISDN 15 define RVSCAL_INVALID_DSN 16 define RVSCAL INVALID JOB 7 define RVSCAL NOT PRIVILEGED 18 define RVSCAL DUPLICATE RE 19 define RVSCAL INVALID UID 20 define RVSCAL INVALID OWN_PRIV 2a define RVSCAL INVALID U
93. ion criteria incoming data set must have originated at a station with a matching name for this receive entry to be further considered as a possible action for the incoming file To be actually used all selection criteria must match Remote station Descriptive name of the remote system name 71 User Manual rvs Rev 01 04 2000 gedas deutschland GmbH Competence Center EDI rvs User Manual User ID of sender Local user or alias Data set name Comment Created by user Creation date date One of the selection criteria incoming data set must have originated from a sender with a matching name for this receive entry to be further considered as a possible action for the incoming file To be actually used all selection criteria must match User ID of local recipient One of the selection criteria incoming data set must be intended for a local user with a matching name for this receive entry to be further considered as a possible action for the incoming file To be actually used all selection criteria must match Virtual name under which the file is known during transfer One of the selection criteria incoming data set must be known by a matching name for this receive entry to be further considered as a possible action for the incoming file To be actually used all selection criteria must match Brief comment describing the purpose of this entry used for display only User ID of
94. ion criteria incoming data set must have originated from a sender with a matching name for this receive entry to be further considered as a possible action for the incoming file To be actually used all selection criteria must match Name of received data set Enter name of data set of resident receive entry Leave blank or specify pattern to get a data set selection list One of the selection criteria incoming data set must be known by a matching name for this receive entry to be further considered as a possible action for the incoming file To be actually used all selection criteria must match 61 User Manual rvs Rev 01 04 2000 gedas deutschland GmbH Competence Center EDI rvs User Manual 4 LOCAL USER Name or pattern of local user ID who is the recipient of the incoming information You may specify something other than your own user ID only if you are defined as privileged user Default your current user ID List of Resident Receive Entries mask REL DATE 2000703729 TIME 09 54 Options S display entry U update entry D delete entry Dataset name StationID sender Action F1 HELP F2 NEW ENTRY F3 ESC EXIT 1 row End of table reached This panel displays a list of resident receive entries Use line command lt S gt lt U gt or lt D gt to get more information about the entry update or delete it respectively Functionkey lt F1 gt Display help information Fu
95. is completed e K keep and catalog data set e D delete data set Note that the data set will be deleted BEFORE the optional batch processing is completed Therefore specify D only if you want to ignore the incoming file in any case DSNNEW a new local data set name that shall be used for the received data set A pattern contains wild card characters or matching one or indefinitely many characters respectively 17 User Manual rvs Rev 01 04 2000 gedas deutschland GmbH Competence Center EDI rvs User Manual JOB name of a batch job data set which will be started when the data set has been delivered This batch file may contain substitution patterns rvs substitutes them before submitting the job to the operating system for execution DSN name of local data set where received information has been stored VDSN virtual data set name under which the data set was transmitted DTAVAIL date when the data set was available for sending FORMAT record format of received data set F fixed record length V variable record length T text file character stream U unstructured file byte stream MAXRECL The meaning of this field depends upon the record format of the received data set F format length of each record V format maximum length a record may have T and U format always 0 zero BYTES number of transmitted bytes RECORDS number of transmitted r
96. iver Data set name Name of data set to be sent List of Data sets for Transmission mask DSNL This panel lists all available local data sets for transmission It is displayed whenever you request a data set selection list Select a data set to include its name in the previous panel Functionkey lt F3 gt Leave this list without selecting a data set and return to the previous mask Functionkey lt F7 gt Page up Functionkey lt F8 gt Page down Key lt ENTER gt Confirm selection 58 How to Work Interactively with rvs Specify option If a data set name is selected by entering the line command lt S gt the selected name will be transferred into the appropriate field in the previous mask after you confirm your selection by pressing the lt ENTER gt key Local DSN Name of the local data set 59 User Manual rvs Rev 01 04 2000 gedas deutschland GmbH Competence Center EDI rvs User Manual 3 5 Interactive Administration for UNIX and AS 400 This chapter describes how to administrate resident receive entries jobs after send attempts and user lists as well as how to call for information of rvs You must call the application rvsdia if you want to work interactively with rvs 3 5 1 Resident Receive Entries This capter describes how to operate resident receive entries how to start a job after send attempt how user lists can be administrated and how you can get informations about rvs
97. least P_L_MSG 1 the character string receives a message from rvscal which gives information about the success of calling rvscal int update on input P_L_MSG 1 is the size of the buffer used to receive the message from rvscal on output P_L_MSG gives the actual length of the message text This value does not include the zero terminator but S_MSG is zero terminated long output the CMDID command number the command which was processed see table below The following commands s_cmd are supported start end send print receiver resentr sendjob user activate modst delst listparm setparm start rvs utility session terminate session create modify hold or release or delete a send request print documentation about rvs delete a single receiver from send request create update or delete a resident receive entry create update or delete a entry for starting jobs after send attempts create modify or delete entry in rvs user table activate a rvs station modify station table read a station table file delete a station table entry list a rvs parameter set a rvs parameter 122 How to work with rvs Batch Interface and rvs C CAL Interface The CMDID returned by rvscal has the following meaning depending on the command passed to rvscal Command meaning of CMDID SEND CREATE number of created send entry SEND DELETE number of send entr
98. me of data set that has been delivered Format in which data set is received e T text file a stream of ASCII characters e U unstructured binary byte stream e V variable record length e F fixed record length e blank Systemformat 54 Data set queued at date Data set queued at time Start of transmisson date Start of transmission time End of transmission date End of transmission time Data set delivered at date Data set delivered at time How to Work Interactively with rvs Date of creation for sending of this data set on remote station year month day Time of creation for sending of this data set on remote station hour minute Date when transmission on remote station was started year month day Time when transmission on remote station was started hour minute Date of end of transmission on remote system year month day Time of end of transmission on remote system hour minute Date when data set was delivered on local system year month day Time when data set was delivered on local system hour minute 55 User Manual rvs Rev 01 04 2000 gedas deutschland GmbH Competence Center EDI rvs User Manual bytes blocks Number of transmitted bytes blocks Blocksize Number of attempts to receive status line Data set received as disposition line Units bytes or blocks in which amount of tra
99. n S display U update D delete User ID full Name Authorization Language bwa Administrator Deutsch pW Administrator Deutsch Fi HELP F2 NEW ENTRY F3 ESC EXIT F5 REFRESH Row 1 2 End of table reached This panel displays a list of rvs user entries Use line command lt S gt lt U gt or lt D gt to get more information about the entry update or delete it respectively Functionkey lt F1 gt Display help information Functionkey lt F2 gt Display a mask to add a new entry Functionkey lt F3 gt Ignore any selection and leave display Functionkey lt F7 gt Page up Functionkey lt F8 gt Page down Key lt ENTER3 gt Confirm selection DATE Current date TIME Current time 88 Specify option UID full Name Authorization Language How to Work Interactively with rvs Enter one of these options to the left of one of the displayed user entries e S Display the entry e U Update the entry e D Delete the entry User ID full Name or description of the user Authorization to use rvs Language to display panels and messages for this user 89 User Manual rvs Rev 01 04 2000 gedas deutschland GmbH Competence Center EDI rvs User Manual Create User Entry mask CUSR R VS CREATE USER ENTRY 1 User ID 2 full Name 3 Authorization A Admin O Operator U User 4 Language D Deutsch E English Fi HELP F3 ESC CANCEL RETURN CREAT
100. nctionkey lt F2 gt Display a mask to add a new entry Functionkey lt F3 gt Ignore any selection and leave display Functionkey lt F7 gt Page up Functionkey lt F8 gt Page down Key lt ENTER gt Confirm selection DATE Current date 62 TIME Specify option DATA SET NAME SID UID sender Local User Action How to Work Interactively with rvs Current time Enter one of these options to the left of one of the displayed resident receive entries e S Display resident receive entry e U Update resident receive entry e D Delete resident receive entry Name or name pattern of incoming data set that will be processed by this resident receive entry Station ID of sender User ID of sender Name or pattern of local user ID who is the recipient of the incoming information Indicates last action you performed against the list entry UPDATE DELETE in the Current session 63 User Manual rvs Rev 01 04 2000 gedas deutschland GmbH Competence Center EDI rvs User Manual Create Resident Receive Entry mask CRRE G MSs station id of sender 1 gt rae user id of sender 3 LOCAL USER gt user id of receiver 4 DSNAME gt dataset name 5 DSNNEW gt only if to be renamed 6 ACCOUNT gt bwa account number 7 TIMESTAMP gt N add timestamp Yes No 8 DISP gt K disposition Keep Delete 9 REPLACE gt N replace dataset Replace N
101. nd attempt entry supersedes the default actions performed by rvs when ether a data set is sended to another rvs station or a number of send attempts is made in vain It is characterized by the following parameters all of them may have pattern values VDSN virtual data set name used for transmission The first two characters have the value QS in case of End to End Responses EERP to distinguish between file transmission and EERP transmission The value QS i e determines the reaction if the transmission of an EERP failes SID station ID of receiver An additional parameter controls the behaviour of this jobstart after send attempt entry ATTEMPTS determines in which case the job should start 0 starts in case of sucsessfull transmission default n starts if the specified number of send attempts fails If a data set is tried to send by rvs which matches these three parameters rvs monitor will start a job specified in following parameter tA pattern contains wild card characters or matching one or indefinitely many characters respectively 20 Overview rvs JOB name of a batch job data set which will be started This batch file may contain substitution patterns rvs substitutes them before submitting the job to the operating system for execution DSN name of local data set that has been sent In case of an EERP we don t have a local data set name The value of 7DSN has the appearance QS
102. node Status of transmission will be displayed in line 20 50 How to Work Interactively with rvs disposition line Disposition of data set will be displayed in line 21 new dsn line Virtual data set name i e the name under which the data set is known during transmission will be displayed in line 22 Display of Transmissions receive mask DDTR DATE 2000 03 29 TIME 09 51 Local user 2 i Dataset name Options S display additional information Dataset name as received Station ID sender Date Time STATUS Fi HELP F3 7ESC CANCEL ENTER REFRESH No Data End of table reached Information about receive entries is displayed Functionkey lt F3 gt Terminate and return to previous panel Functionkey lt F5 gt Refresh status of active receiver Functionkey lt F7 gt Page up Functionkey lt F8 gt Page down DATE Current date TIME Current time 51 User Manual rvs Rev 01 04 2000 gedas deutschland GmbH Competence Center EDI rvs User Manual Local user Data set name Select option Data set name as received Station ID of sender Date Time STATUS Local user ID whose entries are shown Name of local data set Option S display additional information about this received data set Name of data set as received virtual data set name User ID of sender Date when data set was delivered Time when data set was delivered Status of received data set Thi
103. nsmitted Therefore it is suited particularly to transmit large quantities of data even under difficult conditions The compression of data during transfer increases transmission line throughput Besides a menu controlled interface a single command line interface is provided That means that you can call rvs within batch or command files A program C CAL Interface allows you to call rvs services out of a user application program Message LOG files are provided for revision purposes rvs supports multiple languages in messages operator console and user interfaces presently English and German Introduction e The data conversion if wanted can be carried out Text files are automatically converted to the code EBCDIC or ASCIl used on the target partner system e The earliest date time of a transmission can be defined for each file to be transferred e A serialization facility allows the transfer of files in a sequence which you can define 1 2 Target Group This manual is intended as a reference for persons who are assigned to work with rvs The following skills are required to be able to use rvs e knowledge of the current operating system e understanding of the basic functions of rvs e knowledge of the current rvs configuration as set up by the rvs operator Before starting to work it is advisable to have read this book 1 3 Structure of this Manual rvs consists of the following manuals e Ins
104. nsmitted data is measured Total number of bytes or blocks transmitted up to now This value is updated whenever RECVBLOCKS buffers or blocks have been transferred see rvs operator manual for a description of parameter RECVBLOCKS Blocksize of transmitted file zero for file formats T and U Total number of attempts both successful and unsuccessful to receive file from neighboring rvs node Status of transmission will be displayed in line 20 Virtual data set name i e the name under which the data set is known during transmission will be displayed in line 21 There may be two different virtual data set names if the sender sent the original data set to different users In that case the first VDSN is the label for the entire send request and the second one is the VDSN used for delivery to you Disposition of data set will be displayed in line 22 e g whether the data set has been ignored or written to disk 56 How to Work Interactively with rvs 3 4 3 Operate Send Requests and Received Transmissions This chapter describes how you can operate data sets with rvs if you are using an ineractive application It will be explained how to delete send requests Delete Send Request mask DELSR To delete send requests specify the following parameters station id of receiver blank disp list user id of receiver 1 SID 2 USER 3 DSN nouow vyv blank or pattern for dataset selecti
105. odern design and the use of CASE Tools What rvs is not rvs is not an online system It neither supports direct terminal like access to other sites nor does it provide a communication pipe from application to application on a data record level to the end user You cannot directly execute transfers in your own application you rather can place send orders in the rvs database which will be handled asynchronously rvs is not a job scheduling system rvs does not care about the contents of the data sets it is transporting It only acts as a transparent transport medium and performs no semantical interpretation of the data it carries rvs is not a EDI converter But additional components for converting between specific message formats e g VDA ODETTE EDIFACT can be purchased via gedas deutschland GmbH rvs is not a network control or monitoring tool Supported Platforms The following versions of portable rvs are currently available rvsX for SINIX using LU 6 2 X 25 ISDN and TCP IP rvsX for AIX using LU 6 2 X 25 ISDN and TCP IP rvsX for HP 9000 using LU 6 2 X 25 ISDN and TCP IP rvsX for IRIX using ISDN and TCP IP rvsX for Linux using ISDN and TCP IP rvsX for SCO using ISDN and TCP IP rvsX for Solaris using ISDN and TCP IP rvs400 for IBM AS 400 systems using LU 6 2 X 25 ISDN and TCP IP e rvsNT for MS Windows NT using LU 6 2 X 25 ISDN and TCP IP User Manual rvs Rev 01 04 2000 gedas deut
106. on list Fil HELP F3 ESC CANCEL ENTER PROCEED In this panel you specify a send entry that you want to delete All fields must be specified Functionkey lt F3 gt Cancel delete request no send entry will be deleted Key lt ENTER gt When all fields have been specified lt ENTER gt will check whether such a send entry exists and can still be deleted because it has not been processed yet If the entry is available a delete confirm panel will be displayed If SID or DSN is still empty a selection list will be shown 1 SID Station ID of receiver If this field is blank a list of available station IDs will be displayed Use key lt S gt to select a station ID from that list and confirm your choice by pressing lt ENTER gt Your choice will be inserted into the current panel 57 User Manual rvs Rev 01 04 2000 gedas deutschland GmbH Competence Center EDI rvs User Manual 2 USER User ID of receiver 3 DSN Name of data set Enter name of data set or blank or pattern for data set selection list Confirm Delete of Send Request mask CDSE1 You are asked to confirm that you really want to delete the selected send entry Functionkey lt F3 gt Cancel delete request the send entry will be kept Functionkey lt F5 gt The displayed send request will be deleted and the file will not be transmitted Station ID of receiver Station ID of receiver User ID of receiver User ID of rece
107. on should be executed as specified by the user when the entry was created hour minute Earliest point in time system defined that this transmission should be executed year month day For queued commands this is the time when rvs will attempt to execute the command for pending or ended commands this is the last time when rvs attempted to execute it Earliest point in time system defined that this transmission should be executed hour minute Date when transmission started year month day User Manual rvs Rev 01 04 2000 49 gedas deutschland GmbH Competence Center EDI rvs User Manual Start of transmission time End of transmission date End of transmission time bytes blocks Number of transmitted bytes blocks Blocksize Number of attempts to send status line Time when transmission started hour minute Date when transmission ended year month day Time when transmission ended hour minute Units bytes or blocks in which amount of transmitted data is measured Total number of bytes or blocks transmitted up to now This value is updated whenever SENDBLOCKS buffers or blocks have been transferred see rvs Operator Manual for a description of parameter SENDBLOCKS Blocksize of transmitted file zero for file formats T and U Total number of attempts both successful and unsuccessful to send file to neighboring rvs
108. or which the RE is to apply Virtual Dataset Name is the file name that is used for the ODETTE transfer and has to be agreed upon by both sides e If you want to change the file name after it has arrived enter the new file name in the field new Dataset Name 107 User Manual rvs Rev 01 04 2000 gedas deutschland GmbH Competence Center ED I rvs User Manual e Disposition determines whether the received file is deleted or kept after reception and execution of the RE e If you have decided in favour of Keep disposition and there is already a file with the same name in the user directory c rvs usrdat you may choose in the checkbox Replace whether you would like to replace the existing file to create a new file with a distinct name default or to ignore the incoming file e Specify in the field Recordhandling whether the received file is to be stored as a text file with a line feed after every record This specification only applies to files that are received in Fixed or Variable format Select Text here if the line feed is to be switched on e Inthe field CodeConversion you may specify whether a code conversion is to take place Select a special conversion table by means of Search For standard conversion click Ascii Ebcdic or Ebcdic gt Ascii e Use Search to select the batch program that should start when the file arrives e Confirm the entries by pressing OK The rvsNT Administrator writes the new entry to the rv
109. person who has created this entry Date when this resident receive entry was created 72 How to Work Interactively with rvs Creation date time Time when this resident receive entry was Last used date date Last used date time created Date when this entry was last used to determine the actions that occured when data was received Time when this entry was last used to determine the actions that occured when data was received Update Resident Receive Entry mask REU The purpose of this panel is to update an existing resident receive entry This mask is similar to the mask Create Resident Receive Entry CRRE To update the displayed entry overwrite text in those fields you want to change and confirm by pressing key lt ENTER gt The old entry will be deleted and a new one will be created Functionkey lt F3 gt Key lt ENTER gt Cancel modification request the displayed resident receive entry will remain unchanged Update the existing resident receive entry 73 User Manual rvs Rev 01 04 2000 gedas deutschland GmbH Competence Center EDI rvs User Manual 1 2 3 STATION ID USER LOCAL USER Station ID of sender To change this field overwrite it with a new station ID or blank it out to get a list of all availiable statio ids to select a new one This is one of the selection criteria incoming data set must have originated at a station with a mat
110. ption internal rvs command controlling delivery and routing of received files IZ InformationsZustellung information delivery internal rvs command delivering received files to one local recipient J K L M MasterTransmitter The MasterTransmitter of the rvs rvsxmt system coordinates send and receive processes to ensure the optimal use of the net capacity Monitor rvsmon The monitor is the main task of a rvs system It controls all other processes and initiates automatic follow up jobs if necessary N O ODETTE Organization for Data Exchange by Tele Transmission in Europe 169 User Manual rvs Rev 01 04 2000 gedas deutschland GmbH Competence Center EDI rvs User Manual OFTP Operator Console rvscns OSI P PDF Protocol RE rvsmon S SE Send Entry SID ODETTE File Transfer Protocol The ODETTE File Transfer Protocol is the definition of a file transfer protocol by the ODETTE Group IV for OSI Layers 4 to 7 International Protocol used in many business fields Industry Commerce Finance The operator console Provides the administrator with rvs functions to control the rvs system Open System Interconnection Portable Document Format To connect two different computers they have to follow the same protocol This protocol defines actions and reactions as well as the language spoken Residenter Empfangseintrag resident receive entry rvs
111. r Creation date date Creation date time Last used date date e K eep Data set will be kept after processing and cataloged if these are seperate actions on the local system e Delete Data set will be deleted after processing e g in combination with print data R eplace Replace existing data set e N o Create new data set name e gnore Ignore incoming data set Name of data set that will be started as a batch job when data is received Account to which all rvs activities relating to receiving and storing a data set is to be charged Brief comment describing the purpose of this entry used for display only User ID of person who created this entry Date when this entry was created Time when this entry was created Date when this entry was last used to determine the actions that occured when data was received 70 How to Work Interactively with rvs Last used date Time when this entry was last used to time determine the actions that occured when data was received Confirm Delete Resident Receive Entry mask CDRE In this mask you are asked to confirm that you really want to delete this displayed resident receive entry Functionkey lt F3 gt Cancel delete request the displayed entry will remain active Functionkey lt F5 gt The displayed entry will be deleted DATE Current date TIME Current time Remote station id Station ID of the remote system One of the select
112. r service which can be used as a stand alone utility to send receive and distribute data sets rvs can also be integrated into electronic document interchange EDI applications to automate data exchange between network nodes and users In accordance with different degrees of automation there are three interfaces to rvs to generate send and receive entries Dialog is an interactive full screen utility to create Interface individual entries one at a time query functions tell you about the status of your requests Batch Interface reads commands from a data set This input data set is a simple text file that can be prepared with any editor or it might be generated as an output file by another application program C CAL allows application programs to generate rvs Interface command entries directly by calling C language functions Send entries are analyzed by rvs It creates send commands and starts sender processes which transfer your data set to the appropriate neighboring node s in the OFTP network for delivery or further routing The send entry remains pending until positive acknowledgment has been received from the recipient Incoming files are accepted by the receiver processes and placed in temporary files After that they are delivered to the to local recipient or send entries are created respectively to forward them to remote stations if necessary Delivery of incoming files can be influenced by resident receive en
113. resident receive entry up to 50 characters default empty string optional local name to be used for received data set default local data set name is constructed from virtual data set name optional name of data set containing a job to be submitted after data has been received if specified the data set must exist default no job will be submitted optional determines what should be done with the incoming data set after processing has been completed D delete K keep default K optional determines action of rvs when local data set does already exist and DISP K may be R replace existing data set N create new data set with unique name or I ignore incoming data set default N optional may be Y yes or N no tells rvs whether the data set name is to be timestamped to make it unique when the data set is received default N 130 How to work with rvs Batch Interface and rvs C CAL Interface Examples K use all parameters RESENTR C DSN incomingl SID st2 DSNNEW local dsn REPLACEK n DISP k JOB home rvs bin rev sh COMMENT This is a test RE gt use defaults RESENTR C DSN incoming2 SID st2 REPLACE i DISP d aia ea aie no UID DISP RESENTR C DSN incoming3 SID st2 REPLACE r x delete RESENTR RESENTR D DSN incoming3 SID st2 Pe ioe ee update RESENT
114. rt after Send Attempt for more informations 1 VDSNs are used in the ODETTE file transfer protocol to pass the file name to the next node Maximum length 26 characters and character set used when generating a default VDSN are due to the ODETTE protocol 14 Overview rvs Time Stamping When time stamping is requested rvs generates unique data set names when it delivers the file by using a numeric qualifier or by adding or replacing the last part of the name by a numerical value For data sets with otherwise identical names this number indicates the delivery sequence of the data sets unless one or more old ones have been deleted rvs uses the smallest available number The file systems currently supported by portable rvs do not allow addition of a real time stamping i e date and time of delivery to the file name with the exeption of UNIX systems and Windows NT Time stamping may be requested in a resident receive entry It is done when the data set is delivered 15 User Manual rvs Rev 01 04 2000 gedas deutschland GmbH Competence Center EDI rvs User Manual 2 2 Code Conversion You are probably aware that text files are stored on most systems in one of two computer codes namely ASCII American National Standard Code for Information Interchange or EBCDIC Extended Binary Coded Decimal Interchange Code While the assignment of digits and letters of the Latin alphabet is standardized wit
115. s database and displays it in the list of RE s rvsNT Administrator File Edit View Monitor Database Window fea Resident Receive Entries SID DSN Virtual Dataset Prog lt CONNECT_IND a Responder Connection with Station LOC with Credit 10 Odette Buffer lt DISCONNECT gt Connection to Station LOC ended lt DISCONNECT gt Connection to Station LOC ended Press F1 to gethelp 108 How to Work Interactively with rvs Modify RE If you want to modify a RE e Select the entry to be modified in the Resident Receive Entries window e Execute the menu command Edit Edit The Resident Receive Entries dialog window then opens and displays the properties of the entry e Process the entry properties and confirm your entries with OK Delete RE If you want to delete a RE e Select the entry to be deleted in the Resident Receiv Entries window e Execute the menu command Edit Remove rvSNT will then ask you to confirm your delete command t sNT Administrator Ez AN Do you really want to deete resident receive entry for station and virtual data set name e If you are sure that you want to delete the entry then confirm the command with Yes With No you cancel the operation without deleting 109 User Manual rvs Rev 01 04 2000 gedas deutschland GmbH Competence Center EDI rvs User Manual 3 7 2 Job Start after Send Attempt You can
116. s field may show up to three statuses e g EEE after processing is completed e TIE command that controls processing of entire transmission when it ends a receipt for the sender is created e ET description of one local or remote recipient status can be Q or E e 1Z command that controls delivery to one local recipient Commands may be in one of these statuses e D deleted by operator e E ended normal termination e H setin hold status by operator e P pending e g IE may be waiting for all deliveries to complete e Q queued waiting to be processed 52 How to Work Interactively with rvs Display of Transmission receive mask DSPR RV S DISPLAY OF TRANSMISSION RECEIVE Cmdnbr of IE 337 DATE 2000 04 03 TIME 11 06 Cmdnbr of IZ 338 Cmdnbr of RE Account in RE Creator of RE Job ID of RE Local user Remote station X3UM RVSSTAT aix3_umr Remote user Dataset name home umr rvsxbr usrdat TEST2 Format U Dataset queued at rri redius eas 2000 04 03 11 05 Start of transmission ss essrasss 2000 04 03 11 05 End of CLANMSMUSS OT as no srs esa oe 2000 04 03 11 05 Dataset delivered at sesassesu 2000 04 03 11 05 Number of transmitted bytes 4096 Blocksize 0 Number of attempts to receive ie Dataset has been completely delivered Dataset received as TEST2 TEST2 Dataset has been written to disk Fl HELP F3 ESC CANCEL ENTER REFRESH
117. schland GmbH Competence Center EDI rvs User Manual Basic Functional Characteristics The main function of rvs is the reliable transfer of files rvs is suitable both for the transfer of large files and for the transfer of many small files rvs supports many networks with many stations which are based on different platforms Various data formats are supported thereby The key characteristics of rvs are rvs works asynchronously i e its processing is not under your direct control You just places a send order in the rvs database by means of a menu controlled user interface or out of a batch file or program rvs processes the send orders as soon as possible The advantage is that you or your application program does not need to wait for completion of a file transfer The connection to the communication partner is automatically established when necessary The automatic submission of jobs after reception of a data set is supported by means of resident receive entries Wildcarding of data set names user IDs and station IDs is supported The file transfer is possible for the following record formats U Unstructed T Text file F Fixed V Variable Extensive security and authorization checking is performed rvs automatically repeats the transmission after an unsuccessful connection attempt or disruption of a connection In the event of disruption rvs only transmits the parts of a file which have not yet been tra
118. splay of Transmissions send mask DDT1 l RVS DISPLAY OF TRANSMISSIONS SEND l DATE 2000 03 29 TIME 09 50 Local user Dataset name 2 Options S disp add info D del recv C cancel H hold R release send req New dataset name StationID receiver Date Time Status Fi HELP F3 ESC CANCEL ENTER REFRESH No Data End of table reached Information about send entries is displayed You may request additional information line command option lt S gt or you may modify those entries for which processing has not yet started Functionkey lt F1 gt Displays help information Functionkey lt F2 gt Add anew send entry Functionkey lt F3 gt Terminate and return to previous panel Functionkey lt F5 gt Refresh status of active transmissions Functionkey lt F7 gt Page up Functionkey lt F8 gt Page down DATE Current date TIME Current time Local user Name or pattern of sender s local user ID Data set name Name of tranfer data set 44 Select option New data set name SID Date Time How to Work Interactively with rvs e Option s display additional information about this transmission e Option c cancel send request e Option H put send request in hold status e Option R release send request for transmission lt D gt lt C gt and lt H gt can only be used as long as processing of send entry has not yet started lt R gt can only be used if request is held
119. status h Name under which data set is known during transmission VDSN Virtual Data Set Name For single recipient this is the name under which it will be delivered Station ID of receiver Earliest point in time that this transmission should be executed as defined when this entry was created month day Earliest point in time that this transmission should be executed as defined when this entry was created hour minute 45 User Manual rvs Rev 01 04 2000 gedas deutschland GmbH Competence Center EDI rvs User Manual STAT Status of transmission at this time This field may show up to three statuses e g EEE after processing is completed namely status of SE command that controls processing of entire send entry when it ends the data set has reached its recipient ET description of one local or remote recipient status can be Q E or D SK command that controls transmission to the neighboring node Commands may be in one of these statuses D deleted by operator or user E ended normal termination H set in hold status by operator or user P pending e g SK is waiting for receipt Q queued waiting to be processed S suspended all traffic to the neighboring node has been suspended by local rvs operator SK only I in transfer ongoing transmission F forwardeable transmission may start 46 How to Work Interactively with rvs Displa
120. t QE 19 created by Q35 18 lt CMD_TERMINATED gt Q5 18 terminated status e lt CMD_TERMINATED gt QE 19 terminated status e lt CMD_TERMINATED gt SK 15 terminated status e lt SE_SENT gt SE 14 successfully sent C KBProg rvs system readme txt for KONRAD at LOC lt CMD_TERMINATED gt SE 14 terminated status e a 3 6 2 Display Send Requests and Received Transmission Display files sent You can choose between two lists to display the send orders Not yet completed The list of send orders which have not yet been completed displays those files for which you have chosen to hold transmission or which are waiting in the queue of files to be transmitted e Execute the menu command View Send files inorder to display the send orders which have not yet been completed Completed The list of completed send orders displays those files which have been successfully transmitted and acknowledged by the recipients e Execute the menu command View Completely sent files in order to display the list of send orders which have been completed Update display If you want to update the list display do the following e Click the update button or switch to a different display mode and then back again 99 User Manual rvs Rev 01 04 2000 gedas deutschland GmbH Competence Center EDI rvs User Manual Display received files You can choose between two lists to display the received files
121. t User from Database Prototype rvsGetNextUser PROCDEF int PROCKEYW rvsGetNextUser char userpre char user Description of Parameters userpre char input previous user name user char output next user name found in BT table 5 2 6 3 Get User Entry from Database Prototype rvsGetUser PROCDEF int PROCKEYW rvsGetUser char user INFO_USER usinfo Description of Parameters user char input user name usinfo INFO_USER output struct with informations about user entry 160 How to Work with rvs C CAL Interface 5 2 6 4 Configure User Entries Prototype rvsUser PROCDEF int PROCKEYW rvsUser int icmd INFO_USER usinfo Description of Parameters icmd const int input command to specify what should be done USER_UPDATE updates a user USER_DELETE deletes a user USER_CREATE creates a user usinfo INFO_USER output struct with informations about user entry 5 2 6 5 Return Codes FUNCTIONVALUE int RVSCAL_OK if function succeeds RVSCAL_END_ FETCH if there is no matching user entry RVSCAL_PARAMETER_CHECK if at least one parameter is incorrect RVSCAL_INVALID_OWN_PRIV if user wants to decrease his own privileges RVSCAL_INVALID_UID if parameter UID is empty RVSCAL_INVALID_USER if user does nt exist or wants to delete himself RVSCAL_NOT_PRIVILEGED if user is not privileged in to configure user entries RVSCAL_DBERROR if database
122. ta sets e make sure you create all send entries that are linked by a common label in the proper sequence 16 Overview rvs rvs will not start a serialized transfer until it has received the receipt for the predecessor This will ensure transfer in the specified order 2 4 Resident Receive Entries A resident receive entry supersedes the default actions performed by rvs when a data set is received from another rvs station It is characterized by the following parameters all of them may have pattern values DSN virtual data set name used for transmission SID station ID of sender UID user ID of sender must be empty if sending rvs does not support distribution lists in particular this is true for MVS VSE and 36 hosts LUID user ID of local user to whom data set is being sent must be empty if sending rvs does not support distribution lists You may only specify a value different from your own user ID if you are defined as a privileged user If a data set which matches all these four parameters is received by rvs the resident receive entry will be used by the rvs monitor to determine how to deliver the received data set There are additional parameters of a resident receive entry which may be set at creation time ACCOUNT id used for local accounting COMMENT a short text describing the purpose of the resident receive entry DISP determine what should be done with the data set when processing
123. tallation Manual The Installation Manual describes the installation of the rvs software on different platforms The new installation procedure and the update installation procedure will be explained step by step e User Manual The User Manual describes how to transfer files to partners and vice versa The three basic interface methods interactive batch and API are described The available manual is theUser Manual e Operator Manual The Operator Manual describes how you can work with rvs using the console It contains tips how to maintain your data and a description of the utilities as well as how to configure rvs after the installation Furthermore this manual contains information on the technical background of rvs e Messages und Return Codes Manual This manual describes all messages and error codes which will be displayed on the rvs Monitor and in the log file User Manual rvs Rev 01 04 2000 gedas deutschland GmbH Competence Center EDI rvs User Manual The Installation Manual the User Manual and the Operator Manual are available as printed and as electronic documents The electronic document is available in Portable Document Format PDF The Messages and Return Codes Manual is only available as electronic document We have planned to create tutorials for the operator and the user These manuals will contain all important steps how to work with rvs An explanation will be given step by step and
124. tation ID of station to be deleted Examples i delet ntry ABC in database DELST SID ABC 4 2 13 Command LISTPARM Function e List the value of a rvs parameter e n batch mode the message I value appears e In C programs the value is given as a string in the rvscal output parameter S_MSG Parameters parameter name of rvs parameter Examples ee ee show the value of the parameter SLEEP LISTPARM SLEEP 136 How to work with rvs Batch Interface and rvs C CAL Interface 4 2 14Command SETPARM Function Set the value of a rvs parameter Parameters parameter name of rvs parameter Examples a set the value of the parameter SLEEP SETPARM SLEEP 2 137 User Manual rvs Rev 01 04 2000 gedas deutschland GmbH Competence Center EDI rvs User Manual 5 How to Work with rvs C CAL Interface The following sections describes how to use the C language functions that may be linked into an application program to execute rvs utility commands Please check rvscal h that is contained in the rvs distribution for last changes of structures and function prototypes Note For all tasks sending and receiving data files as well as administration of rvs you have to do with rvs you can either e call the general function rvscal using string commands or e use several dedicated functions The string commands of rvscal are identi
125. ted You may need this number when communicating with your local rvs operator e g to have a send request deleted for which processing already started 47 User Manual rvs Rev 01 04 2000 gedas deutschland GmbH Competence Center EDI rvs User Manual DATE TIME Local user Account Remote station ID Remote station name Remote user Data set name Format Data set queued at date Current date Current time Local user ID of sender Account to which all rvs activities relating to this send request are being charged Station ID of remote station Name of remote station Remote user ID Name of data set to be transmitted Format in which data set is sent e T text file a stream of ASCII characters e U unstructured binary byte stream e V variable record length e F fixed record length e blank Systemformat Date of creation of this send entry year month day 48 Data set queued at time Earliest time to send user date Earliest time to send user time Earliest time to send system date Earliest time to send system time Start of transmission date How to Work Interactively with rvs Time of creation of this send entry hour minute Earliest point in time that this transmission should be executed as specified by the user when the entry was created year month day Earliest point in time that this transmissi
126. th the time specified by means of the DTCONNnn parameter You can avoid this waiting period and immediately start a new attempt at transmission The rvs Monitor then treats the send order as though you had created it for the first time This is how you restart one or more send orders Use the mouse to click on a single send order e Click the Hold button or execute menu command Edit gt Hold e Release the orders selected with Release or the Edit 7 Release menu command Remove send order You can remove a send order from the database If you remove a send order which has the status forwardable or held then your partner will not receive the file which was intended for him A send order that has already been completed remains executed It is not possible to revoke the order You can only remove the entry from the rvs database This may make sense in some cases in order to improve management of transmission activities NOTE The rvs Monitor constantly purges the rvs database of send entries which have been completed since a particular period of time KEEPDAYS parameter Thus you do not have to remove the send orders in order to clean the rvs database This is how you remove one or more send orders from the order list e Use the mouse to click on a single send order which you want to remove NOTE To find out how to limit the display to the send orders placed on hold or certain file types please refer to the chapter
127. the command CMDID RVSCMD status char output character which contains the status of the command a d e h p q s f see chapter Display of Transmissions Send mask DDT1 RVSCMD errorcode short output short integer which contains an error code if it is different from 0 167 User Manual rvs Rev 01 04 2000 gedas deutschland GmbH Competence Center EDI rvs User Manual Glossary A Access Method ASCII Batch Interface rvsbat C Communication Module rvscom D Dialogue Interface rvsdia E EBCDIC EDI EDIFACT EERP ET ETSI The access method describes the way by which two stations are connected American National Standard Code for Information Interchange The batch interface of rvs offers user functionality for automatic background use The communication module of the rvs system connects to another station and sends or receives files The dialogue interface of rvs provides interactiv user functionality Extended Binary Coded Decimal Interchange Code Electronic Data Interchange Electronic Data Interchange for Administration Commerce and Transport End to End Response ODETTE expression EmpfangerTabelle table of recipients internal rvs table describing one recipient European Telecommunications Standards Institute 168 Glossary G H HPFS High Performance File System OS 2 IE InformationsEingang information rece
128. tion of Parameters FUNCTIONVALUE int MODE RVSCAL_OK if debug mode is set RVSCAL_INTERNAL_ERROBR if internal database error is occured int input mode type 141 User Manual rvs Rev 01 04 2000 gedas deutschland GmbH Competence Center EDI rvs User Manual 5 1 5 Change status of SE Prototype rvsSetSendEntry PROCDEF int PROCKEYW rvsSetSendEntry long int cn_se int SetCmd char szSID char s_msg Description of Parameters FUNCTIONVALUE int RVSCAL_OK if no error occured RVSCAL_INTERNAL_ERROR if internal database error occured cn_se long int input command no of SE returned by CreateSendEntry SetCmd int input Command type SET_HOLD Hold this send entry SET_RELEASE Release this send entry SET_DELETE Delete this send entry szSID char input Station ID of receiver s_ msg char output Error message text in case of error 142 How to Work with rvs C CAL Interface 5 1 6 Get next information entry Prototype rvsGetNextIE PROCDEF int PROCKEYW rvsGetNextIE long int prev_ie_cn INFO_SK p_info Description of Parameters FUNCTIONVALUE int RVSCAL_OK if no error occured RVSCAL_INTERNAL_ERROR if internal database error is occured prev_ie_cn long int input command no of previous info entry p_info struct INFO_SK output data struct containing info about entry 143 User Manual rvs Rev 01 04 2000 gedas
129. tries will only take effect after restarting the rvsNT Administrator e Confirm the entries by pressing OK Save If you set up or modify a user use OK in order to save the modified parameters If you delete the rvsNT database or reinstall rvsNT you will also delete all users Subsequent initializing of the database only retains the administrator who has set up rvsNT In order to avoid losing your entries you can save the users and the job start entries or even the entire rvs database and restore them later If you choose to do so you can find more information in the Operator Manual section Database Maintenance for Windows NT 115 User Manual rvs Rev 01 04 2000 gedas deutschland GmbH Competence Center EDI rvs User Manual 4 How to work with rvs Batch Interface and rvs C CAL Interface rvscal This chapter describes how to start the two interfaces and which parameters you can use Furthermore a description of the corresponding global commands is given The syntax of the commands is explained as well as the prototype of the function rvscal Note For all tasks sending and receiving data files as well as administration of rvs you have to do with rvs you can either e call the general function rvscal using string commands or e use several dedicated functions The string commands of rvscal are identical to those useable for rvsbat On the other hand the dedicated functions are on a lower
130. tries which tell rvs under which name the file should be stored and whether a batch job should be started to further process incoming data 12 Overview rvs With any of the above mentioned interfaces one send entry will be created for each data set Specifying entire subdirectories or libraries is not yet supported Please contact your local rvs administrator to arrange where you can find files that have been received and for which there is an active resident receive entry necessary 2 1 Data Set Names In this manual we use the terms file and data set as synonyms The syntax for valid data set names is operating system specific Equivalent names may be specified as myid invoice dat under UNIX c myid invoice dat under OS 2 on a PC and under Windows NT MY ID DATA INVOICE under OS 400 on an AS 400 MYID INVOICE DATA under MVS on an IBM host sysdrv userdisk myid invo under VMS ona VAX ice data These names are case sensitive on some systems e g UNIX and may or may not be case sensitive on others e g OS 2 if the High Performance File System HPFS is being used Security systems such as RACF under MVS may impose additional constraints on what is considered a legal data set name on a particular local system These differences may cause problems or inconveniences as described below when a file is sent to a different operation system 13 User Manual rvs Rev
131. try RE_CREATE creates a resident receive entry INFO_RE input struct with informations about resident receive entry 155 User Manual rvs Rev 01 04 2000 gedas deutschland GmbH Competence Center EDI rvs User Manual 5 2 4 5 Return Codes FUNCTIONVALUE int RVSCAL_OK if function succeeds RVSCAL_END_FETCH if there is no matching resident receive entry RVSCAL_PARAMETER_CHECK if at least one parameter is incorrect RVSCAL_INVALID_DSN if invalid DSNNEW was spezified RVSCAL_INVALID_JOB if invalid JOB was spezified RVSCAL_INVALID_NAME if parameter name doesn t exists RVSCAL_INVALID_ SID if SID SENDER isn t known RVSCAL_NOT_PRIVILEGED if user is not privileged in to configure resident receive entries RVSCAL_DBERROBR if database could not be opened or closed RVSCAL_RE_NOT_FOUND if resident receive entry could not be found RVSCAL_DUPLICATE_RE if duplicate resident receive entry has found in case of icmd RE_CREATE RVSCAL_INTERNAL_ERROR if internal database error is occured 156 How to Work with rvs C CAL Interface 5 2 5 Functions to manage Entries for Jobstart after Send Attempt This chapter describes the functions which are required to manage Entries for Jobstart after Send Attempt 5 2 5 1 Type Definition and Macros typedef struct char vdsn RVSCAL_L_VDSN char uid_sender RVSCAL_L_USID char sid
132. x Entry No New File Name Station Disposition Time State 14 SENDTIEST Details File Name SENDTEST Local Name CAKBProgivsisystemveadme txt Receiver LOC local station State hq Additional Information Command Numbers Date Time Transmitted 0 Bytes SE 14 Disposition 1997 09 21 14 38 48 Block Size 0 Bytes SK 0 Start of Transmission Format u End of Transmission Send Attempts 0 Send Attempt at dataset won t be deleted after successful transmission E Delete Hold Release Select Refresh Press F1 for Help 15 02 The rvs Monitor reads the send order at the next read cycle and executes it In the example the rvs Monitor recognizes through the station code LOC that its own station is the target and copies the file into the c rvs usrdat directory 98 How to Work Interactively with rvs NOTE You can view the activities of the rvs Monitor in the rvsNT Administrator in the Monitor Log window Monto lt NEW_CMD_CREATED gt SK 15 created by SE 14 lt NEW_CMD_CREATED gt IE 16 created by SK 15 lt NEW_CMD_CREATED gt IZ 17 created by IE 16 lt IZ_DELIVERED gt Delivery 17 SENDTEST 1997 09 21 14 38 46 received at 1997 09 21 15 02 39 from L Stored in c kbprog rvs usrdat SENDTEST lt CMD_TERMINATED gt IZ 17 terminated status e lt NEW CMD CREATED gt Q5 18 created by IE 16 lt CMD TERMINATED gt IE 16 terminated status e lt NEW_CMD_CREATED g
133. xe for Windows NT Prerequisites You should have a system which has been set up for operating rvsNT and the required access rights e Start the rvsNT program in the rvs file The rvsNT window then opens with display of not transmitted data sets Y rysNT display of not transmitted datasets oll File Edit View Help olaj xele 2 x Entry No New File Name Station Disposition Time State Details File Name Local Name Receiver State Additional Information Command Numbers Date Time Transmitted Bytes SE Disposition Block Size Bytes SK Start of Transmission Format IE End of Transmission Send Attempts Send Attempt at New Send Entry Delete Hold Release Select Refresh 14 35 The window displays the transmission information in four different display modes Display modes Send Receive Completely sent Completely received 31 User Manual rvs Rev 01 04 2000 gedas deutschland GmbH Competence Center EDI rvs User Manual Window areas Depending on the rvsNT display mode the entry list will display the list of files which have been sent or received The details area provides you with more detailed information on the currently selected file file name sender or recipient local name or original name and status of the file In the additional information you can see the currently transmitted data quantity block size file format and the number of dialling attempts only for sendin
134. y CJSS Functionkey lt F1 gt Display help information Functionkey lt F3 gt Terminate action and return to previous panel Key lt ENTER gt If all fields are specified the entry will be updated 1 STATION ID Station ID of receiver This is one of the selection criteria and so you will not be able to change this entry 2 USER User ID of sender This is one of the selection criteria and so you will not be able to change this entry 86 3 4 6 DSNAME ATTEMPTS JOB COMMENT How to Work Interactively with rvs Virtual name of outgoing data set This is one of the selection criteria and so you will not be able to change this entry Number of send attempts before starting the specified job This is one of the selection criteria and so you will not be able to change this entry Name of data set that can be started as a batch job to specify the following process e g e bat on MS DOS or Windows NT CNTL on MVS e cmd on OS2 On AS 400 the job will be started with the OS 400 system command SBMDBJOB Brief comment describing the purpose of this entry used for display only 87 User Manual rvs Rev 01 04 2000 gedas deutschland GmbH Competence Center EDI rvs User Manual 3 5 3 User List This chapter describes how you can create display confirm and update user entries List of User Entries mask USRL Date 2000 03 29 Time 09 58 Optione
135. y being deleted SEND HOLD number of send entry being held see footnote below SEND RELEASE number of send entry being released see footnote below RESENTR CREATE created resident receive entry RESENTR DELETE deleted resident receive entry RESENTR UPDATE number of new resident receive entry SENDJOB CREATE created jobstart after send attempt entry SENDJOB DELETE deleted jobstart after send attempt entry SENDJOB UPDATE number of new jobstart after send attempt entry RECEIVER DELETE number of corresponding send entry LISTPARM not equal 0 invalid parameter SETPARM not equal 0 invalid parameter MODST not equal 0 error occured while loading station table any other command Q 4 2 2 Description of Commands This section describes the syntax and the set of valid commands used either by the rvs C CAL Interface rvscal or the rvs batch interface rvsbat The examples given below use two syntactical extensions only available with the batch interface e comment lines start with a in column 1 e commands can be continued in the next line by specifying a as the last character of the line to be continued If the send entry could not be identified uniquely by the specified parameters the number of the first matching command is returned 123 User Manual rvs Rev 01 04 2000 gedas deutschland GmbH Competence Center EDI rvs User M
136. y of Transmission send mask DSPT RV S DISPLAY OF TRANSMISSION SEND Cmdnbr of SE 329 DATE 2000 04 03 TIME 11 00 Cmdnbr of SK Local user umr Account gt umr Remote station UMR f rvssta at pcumr emote user Dataset name home umr profile Format 3 U Dataset queued at urosa sre radiu 2000 04 03 10 27 Earliest time to send user 2000 04 03 10 27 Earliest time to send system Stabe Of Granon SSO esai ROG GOL CLANSMLSSTLON su ere naa esas ole e umber of transmitted bytes 0 Blocksize 0 Number of attempts to send 8 SE queued ET queued SK Dataset will be kept after transmission New dataset name is TEST Fl HELP F3 ESC CANCEL ENTER REFRESH for active transmissions The purpose of this panel is to display a specified send transmission As long as this transmission is active you can refresh the status of transmission by pressing functionkey lt F5 gt Functionkey lt F3 gt The program returns to the previous panel Functionkey lt F5 gt Refresh the status of active transmissions Cmdnbr of SE Internal number under which this send request is being processed You may need this number when communicating with your local rvs operator e g to have a send request deleted for which processing already started Cmdnbr of sk Internal number of the send command SK created from the send request SE Evaluates to 0 if no SK has yet been crea
137. you used a pattern in any of the selection criteria above DSNNEW cannot contain any wild cards and more than one matching data set may arrive before you processed the old one If you do not specify a fully qualified data set name rvs will try to generate one using information from your current path or library The full name will be shown when the panel is redisplayed after the resident receive entry has been created Please check that the name is what you intended it to be Make sure that sub directories or libraries exist when files are being delivered rvs will not create directories or libraries and deliveries will fail if they do not exist Account to which all rvs activities relating to receiving and storing a data set is to be charged Generate unique data set name when delivering file by adding a time stamp as dsn qualifier On systems where this is not possible numerical values will be used as last qualifiers Choose e Y yes e N no Default N 66 How to Work Interactively with rvs 8 DISP Determines what should be done with the data set when processing completes Choose e K eep Data set will be kept after processing and cataloged if these are seperate actions on the local system e Delete Data set will be deleted after processing This option only takes effect if there are jobs to process Default K 9 REPLACE Specifies what should be done when a data set with the sam
138. ys is another output field as indicated by the periods This is the message field where various information about successful or unsuccessful completion of system actions will be displayed Warnings regarding missing or erroneous input values will appear here too 24 How to Work Interactively with rvs 3 2 Function Keys On most systems you can use the following set of function keys to control the rvs dialog interface Function key 1 will be called lt F1 gt in this text etc lt F1 gt lt F2 gt lt F3 gt lt F4 gt lt F5 gt lt F7 gt lt F8 gt requests on line help A brief explanation of the input field where the cursor currently is located will be displayed To view the entire help text for the panel use function key lt F1 gt to display context sensitive help then press lt F1 gt again press lt ENTER gt to get to the next page press lt ESC gt to leave help displays a mask to create a new entry list displays exits panel ignoring any input you may have made On systems that support an Escape key lt ESC gt is equivalent to lt F3 gt displays selection lists if available In general this key will work for fields where you are asked to specifiy a station ID or a local data set name updates the current panel when on going transmissions are displayed or confirmes that you really want to perform an action like deleting a send request scrolls up list
139. ysNT Administrator File Edit View Monitor Database Window ajelee Monitor Log Press F1 to get help NUM 2 Sort You can sort the table according to any column by using the mouse to click the column header New user If you would like to set up a new user e Execute the menu command Edit Add The User dialog window then opens and displays the User Table parameters User ID NEW Full Name New User Language Engish v Administrator cores 114 How to Work Interactively with rvs Enter the user identification Enter the user name Select the language for screen dialog Use the mouse to click on the user access authorization Confirm the entries by pressing OK NOTE A basic user may use the program rvsNT to send and receive files A user with administrator rights may in addition to this use the program rvsNT Administrator to configure the rvs system An Operator has the same rights as an User This type of user is reserved for future use User Modification If you would like to modify an existing user e Select the user to be modified in the User window e Execute the menu command Edit Edit The User dialog box will open You can now edit all of the user data parameters You can select German or English in the language field rvsNT will then display all the menus and messages in the selected language NOTE If you want to modify your own user data then the en

Download Pdf Manuals

Related Search

Related Contents

QIG English  Dyson 921000-02 Use and Care Manual : Free Download, Borrow, and Streaming : Internet Archive  Manual/Electric Portable Patient Lift - PHC  T。SHーDA 東芝H ー ロ投光器取扱説明書 保管用    Topcom Protalker PT-1078  White Rodgers 1F95EZ-0671 Specification Sheet (French)  パーデューペグボード  TBM。SK Bーuet。。th モノラルヘッドセット 取扱説明書  MANUAL DO USUÁRIO  

Copyright © All rights reserved. Failed to retrieve file