Home

- ServiceNet

1. d Fo T 59 5 1 MORMON pe LEES ten 59 5 3 Customizing rvsXP Monitor parameters seen 62 6 How to work interactively with rvsXP 65 6 1 Starting rvsXP Administrator rvsmgr exe 65 6 2 Star ng TvsXP eke sou Sei etes time Ebr edo veru ite Weeds 66 6 3 How to send and receive files with rvsXP 69 6 3 1 Creating send OFdblS restos utei ro e RON man ocupada a dca ace aiat aas 69 63 22 saan dV MAL E 73 6 3 3 Displaying send requests and received files 73 6 3 4 Handling files to be sent and received 75 6 3 5 Selecting display criteria su s ae adda ee aan 77 6 4 Administration with Soter ook cat ee epe duro eps 79 6 4 4 Resident receive entries uou Ria 79 6 4 2 Job start after send ERU eee ae 83 rvsXP User Manual Rev 2004 05 28 3 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual 6 4 3 m 86 7 rvsXP database maintenance seceeeeessseeeeeee
2. The Select Backup File dialog opens and displays the files with the LOG extension in the rvsXP system folder Select the file which contains the user table and follow on processing which are to be restored Confirm your selection by clicking Open rvsXP then opens the rvs Restore Jobstart Entries and User command prompt window and restores the saved entries for follow on processing in the rvs database Restoration of the data has been successfully completed if the command prompt window closes without error Note The command prompt window appears only briefly in case of a small number of users and entries Start rvsXP Monitor 94 rvsXP database maintenance 7 4 3 Restoring the rvsXP database To restore the entire rvsXP database using a complete back up Stop rvsXP Monitor Execute the menu command Database gt Import The Select Backup File dialog opens and displays the files with the LOG extension in the rvsXP system folder Select the file containing the rvsXP database to be restored Confirm your selection by clicking Open rvsXP then restores the rvs database and displays any errors in the rvsXP Restore Database dialog Restoration of the data has been successfully completed if the message 0 error s occurred appears Start rvsXP Monitor 7 5 Cleaning up the rvsXP database cleanup Purpose of The larger the rvsXP database the more time is required by rvsXP t
3. Sending 707 KEYDIR environment variable A3 2 L Language environment variable A3 3 Launching rvsdiant exe 66 rvsmgr exe 65 Lc command A7 4 LDSNPRIO parameter A7 7 License key Adapting 20 NT 20 LID parameter A7 7 Line driver A7 5 Line type neighboring station 40 LINK parameter 49 53 Link test 25 Listcmd command 41 3 Listdbv command 41 3 Listing Key 110 User entry 86 listparm command 41 2 A1 4 listst command 47 4 LITRACELEVL parameter 64 LITRACELVL parameter A1 7 A1 9 A1 16 LMPRIO parameter A1 7 LOC see Local station Local station 30 Activate 27 Managing 30 Setting up 30 Log file for troubleshooting A2 2 Log files 7 A2 1 Brief description 42 7 rico log A2 1 rlog log 42 7 rlstat log 42 7 Troubleshooting A2 2 Lp command 7 4 Ls command A1 4 M Managing Local Station 30 Partner station 30 MasterTransmitter A4 2 MAX IN parameter 46 MAXCMD parameter 41 7 Maximum sessions parameter 46 MAXRECL parameter 7 7 A1 12 MAXSENDERS parameter A1 7 A1 14 MAXX25RCV parameter 48 52 58 A1 7 A1 15 Monitor 2 A4 2 Starting 59 Stopping 67 Monitor parameters 62 Adapting 63 64 CNSMSGS 42 1 NUMRLOGS 42 1 NUMRLSTATS 42 1 RLCOMAXSIZE 42 1 RLOGMAXSIZE A2 1 RLSTATMAXSI 42 1 MSGPRIO parameter A1 7 Multiple languages 7 N N parameter 46 50 53 NAME parameter A1 2 Neighboring nodes parameter 44 Network link test 25 New user 67 NK line type table 33 Numbe
4. Ck CK CK Ck ck ck KC CK C CC CCS S S S A KG KM KG Kk KR ko ko koX CS C C C C Ooo C5 0 C CO C C 5 C CO C GO QC OO Oro O CO C C Ove O Ore CD C9 CO Included Components may contain two or more feature codes T TCP IP communications X X 25 native ISDN communications Not all features are available on all platforms at this time OOOO QC cC C5 C5 C5 C5 CD 5 0c OO cp CE OPWNE OOOO O OQ OOOO C5 C5 Expiration date The license expiration date is designated YYTTT where YY means the year TTT the day of year of the respective year Note Do not modify any of the fields in the license key file unless explicitly asked to do so by gedas GimbH rvsXP User Manual Rev 2004 05 28 gedas deutschland GmbH Fachbereich rvs Systems 21 rvsXP User Manual 22 Function Tests 3 Function Tests Test without The present chapter describes two types of function tests For one of the network tests you send a file from your working environment to yourself thus ensuring rvsXP correctly accepts and processes the jobs For this test you do not yet need a functional network link because rvsXP Monitor simply copies the data sets internally when you send to yourself
5. The following illustrations show how to exchange your encrypted data with a partner You have both successfully installed rvsXP and both have a key pair consisting of the private and the public key Partner 1 has the PR1 PU1 key pair Partner 2 has the PR2 PU2 key pair E PR1 PUT PU2 Keep the private key for yourself Send your public key to your partner and he will send you his public key 98 Encryption configuration Key administration PR1 PR2 PU1 gt lt PU2 Each of you must import the partner s public key into the rvsXP database This completes the preparations for a long time of securely exchanging any number of files Import of PU2 PR2 Import of PU1 rvsXP User Manual Rev 12 03 2004 gedas deutschland GmbH Fachbereich rvs Systems 99 rvsXP User Manual Your partner encrypts a file with your public key and sends it to you getiZOUA AMQ fE lt 1 26 8 9 You decrypt the file you received do so you need your private key your own public key and the partner s public key PR1 PU1 PU2 decrypted file Invoice No 877 Customer 100 Encryption configuration Key administration 8 2 Overview of the rvsXP key administration In order to use encryption with rvsXP please
6. BBCREATE User notification messages are generated and passed to the rvsums user exit if BBCREATE is enabled BBCREATE 1 The default action is to send this message as UNIX mail type mail to read the message prevents the creation of user notifications rvsXP User Manual Rev 2004 05 28 A1 15 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual SSCREATE XMCREATE LITRACELVL and ODTRACELVL CNSMSGS STATISTICS Statistics records will be created for every attempted transfer when flag SSCREATE is enabled SSCREATEz1 These records contain the station ID of the neighboring station as well as time and completion code of the attempted or completed transfer SSCREATE 0 prevents generation of these records Currently no utility to analyze these records is provided XMCREATE create xfer message controls generation of detailed information about successful transfers in the SRVSPATH db rlog log system log file XMCREATE 1 default writes a log message in the following cases Whenever a data set is successfully sent to a neighboring station even before an acknowledgement has been received whenever a send entry completes after receiving acknowledgements from all recipients and whenever a data set has been delivered to a local user XMCREATE 0 suppresses generation of these LOG messages When communication errors occur helpful trace information can be found in the trace data sets if the values
7. Network A second test is a network line test you can execute by activating the line test local station 3 1 Sending a file to yourself To this end proceed as follows Start the rvsXP Administrator program in the rvs folder Start rvsXP Monitor if it has not already been started Start the rvs program with the Start Program Dia command The rvsXP rvsDia window then opens and displays the list of files which have not yet been sent Create a new send entry with New Send Entry The Choose file to be sent dialog box opens Select any file and confirm your selection with Open Example C rvs system readme txt The New Send Entry dialog opens and displays the file name selected in the File field Enter the station code for your station in the Station ID field or Choose Select to open the Select Station dialog and select the ID Example LOC LOC is the default setting To send the file to the recipient with another name type the new file name inthe New Name text box rvsXP User Manual Rev 2004 05 28 23 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual New Send Entry EE C rvs system readme txt teadmeReceived txt delete after transmission Serialization F add C Fired Variable Unstructured SEAN Confirm your entries with OK This will save the send entry for transmission of the file in the rvsXP datab
8. rvsNT establishes the connection to the partner station and transmits the currently pending files Activating a station means establishing an OFTP connection to this station As soon as the connection has been established each side has the opportunity to send any files that may possibly be available If no file is ready to be sent the connection is closed Set working In order to set the station working execute the menu command Edit gt Enable rvsXP is now ready for communication with the partner station The status is Enabled This is the standard setting for a station A connection is established to this station as soon as data is available to be sent to this station Stopping working In order to stop the station working execute the menu command Edit gt Disable rvsXP performs no send orders to the partner station but keeps them the queue until you set the station working again The status is Disabled Saving When you set up or change a station save the changed parameters by pressing OK When Windows XP is restarted rvsXP continues to work with these parameters However if you delete the rvsXP database or reinstall you also delete the newly set up stations Subsequent initializing of the database only provides the specified standard configuration of the station table In order to avoid losing your entries you may back up the station table in a separate file and restore it later For further
9. E oF A 5 Extended A Standard Double click on the rvsXP Monitor entry The rvs Monitor Properties Local Computer window opens Click on the Start button If the attempt is successful the rvsXP Monitor status will change to Started The entry is rvs Monitor Started Automatic Local System Carry out the following steps if you want to stop rvsXP Monitor with the rvsTraylcon Right click the rvsTraylcon Execute the menu command Start rvs Monitor rvsXP Monitor starts The rvsTraylcon shows a green triangular arrow in a white circle if it is started Carry out the following steps if you want to start rvsXP Monitor from within the rvsXP program environment while it is in operation e Startthe rvsXP Administrator program in the rvs folder Execute the menu command Monitor gt Start rvsXP Monitor starts The rvsXP Monitor has been started if the stop symbol is active on the tool bar 60 rvsXP Monitor 5 2 Stopping rvsXP Monitor ways to stop You can stop rvsXP Monitor from the operating system level or from rvsXP Administrator the tool for rvsXP operation Operation of rvsXP requires administrator user rights at the system level and in the rvsXP environment Stopping at system Carry out the following steps if you want to stop rvsXP Monitor at the level system level XP classic Windows style e Choose Start gt Settings gt Control Panel StartAdministrative Tools gt Services
10. SEPRIO 50 ME SNARCV SSCREATE Hel STATISTICS 2 Hep SYNCDL 500 SYNCTO 120 TIMESTAMP 2 il TMAXCON 0 TSTODPRCT 90 B Apply TCPIPRCV Double click the parameter in the parameter list Enter the desired value into the input field Confirm your entry with Apply Use Close to exit the parameter list Activate the parameter by stopping and starting the rvsXP Monitor rvsXP User Manual Rev 2004 05 28 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual Alternative Command level ATTENTION Multiple selection You can also use the rvsXP Administrator gt Edit gt OperatorCommand command to display or edit a parameter Use listparm NAME in this case to list one or several parameter values NAME can be the name of a parameter to list this one value awildcard to list all parameters whose names match this wildcard wildcards are described in the following Chapter Wildcards or ALL to list all parameters You can modify the NAME parameter using the following command setparm name value No plausibility check is made on the value you specify Thus the results are unpredictable if you specify invalid values or wrong data types 1 2 Wildcards Some commands support wildcards This means that the values you specify for these parameters may include wildcards asterisk and or question mark to select more than o
11. Service status Stopped Pause You can specify the start parameters that apply when you start the service from here Start parameters Resume Apply Choose Automatic inthe Startup type field and confirm with OK The rvsXP Monitor startup type changes to Automatic rvsXP User Manual Rev 2004 05 28 gedas deutschland GmbH Fachbereich rvs Systems 17 rvsXP User Manual Expanding access rights Assigning rvs Monitor special user rights By default the rvs Monitor service runs under the system user of the local machine He has no access rights for network directories If it is necessary for the rvsXP Monitor or the processes it controls e g a batch job from a resident receive entry to access network directories the rvs Monitor service must work under a user authorized to do so To this end proceed as follows Double click on rvs Monitor Thervs Monitor Properties Local Computer window opens Click the Log On tab rvs Monitor Properties Local Computer General Recovery Dependencies Log on as Local System account This account Password 9990990090009900 Confirm password 990909990900000099 You can enable or disable this service for the hardware profiles listed below Hardware Profile Service Profile 1 Enabled Enable This Account and then click the Browse button to choose a user After selecting a use
12. at system level system level XP classic Windows style e Choose Start gt Settings gt Control Panel StartAdministrative Tools gt Services Search the list of Services for rvs Monitor and select the service by clicking the appropriate line rvsXP User Manual Rev 2004 05 28 59 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual Starting with rvsTraylcon Starting from the rvsXP environment u Services File Action View Help E E u Services Local rvs Monitor Name Description Status Startup togonas Bs Print Spooler Loads files Started Automatic Local System Start the service Sy Protected Storage Provides pr Started Automatic Local System SB QoS RSVP Provides Manual Local System 84 Remote Access Aut Createsa Started Manual Local System S amp aRemote Access Con Createsa Started Manual Local System Sis Remote Desktop He Manages a Manual Local System SisRemote Procedure Provides th Started Automatic Local System SaRemote Procedure Manages t Manual Network 5 S amp sRemote Registry Enablesre Started Automatic Local Service 884 Removable Storage Manual Local System 84 Routing Remot Offers rout Disabled Local System zarys Monitor Automatic Local System Sy Secondary Logon Enables st Started Automatic Local System Ss Security Accounts Stores sec Started Automatic Local System
13. creator Creator of the files unknown string Example c gha creater gha In the dialog Creator o owner Owner of the files unknown string In the dialog Owner f from First day of validity period today string TT MM JJJJ YYYY MM DD You can choose between the German TT MM JJJJ and the international YYYY MM DD date version In the dialog begin t to string Last day of validity period TT MM JJJJ YYYY MM DD In the dialog end 102 Encryption configuration Key administration Parameters Description Default value string Validity period d D t T2day m M month j J y Yzyear h H hours i lzminutes s S seconds You must decide upon one unit of time Example 1m 1 month or 5D 5 days In the dialog period 3 months s size value Key size in bit maximum 2048 bits must be divisible by 8 In the dialog KeySize 1024 168 Creates a key pair with 768 bits In the dialog 768 bit 1024 Creates a key pair with 1024 bits In the dialog 1024 bit 2048 Creates a key pair with 2048 bits In the dialog 2048 bit Use the exact current time normally the validity period starts at 00 00 00 UTC In the dialog start today Print process information not reasonable on batch systems be quiet be verbose Example 1 Example 2 genkey TC2private TC2public Generate
14. from all station table related database tables Freecmd CN cn SID sid Free command with command number cn from hold status or release all suspended transfers to neighbor station sid Holdcmd CN cn SID sid Put command with command number cn in hold status or suspend all transfers to neighbor station sid Listdbv List version and creation date of the rvsXP database Listcmd CN n STATUS x rvsXP User Manual Rev 2004 05 28 A1 3 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual Le Listparm Lp Listst Ls Opcmd Setparm Sp Start Stop System Is an alias of Li st cmd List details of command with number n or type and number of all commands whose status is x active The command is being processed deleted This entry was logically deleted executed Processing of the command ended forwardable ready to be sent SK or QS held The command was set to hold it cannot be processed until released i e set to status q in transit The command is currently being sent SK or QS pending The command was partially completed The command is waiting for some event e g SE is in this status after SKs have been created until all receipts are received RE is always in this status waiting for information that matches it to come in q queued Ready to be processed S suspended Ready to be sent but suspended because all traffic to neighbor stations has been stopped SK or
15. 00013003210 AIL3UZ Advanced Send password Receive password Connection Routing Advanced Route Neighbour Node RST Priority Dott 1 100 44 Configuration of rvsXP 4 1 5 Setting up TCP IP communication Connection Advanced TCP IP IP Address 23 1 234 8 3305 Cancel If you have selected the TCP IP connection on the Connection type tab you can edit the line parameters for the network connection on the TCP IP tab with TCP IP protocol Local station rvsXP supports multiple TCP IP reception under various Internet addresses at the same time You can add additional TC parameter sets on your local station LOC using the TCP IP button below the TCP IP tab Press the Remove button to delete the currently displayed set rvsXP will automatically assign a number for the receiving channel Port when you add a new record Selftest via Advanced TCPAP TCPAP IP Address 192163010 Start Port 3305 Sessions 5 Remove Insert ISDN x25 Cancel rvsXP User Manual Rev 2004 05 28 45 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual Note Enable the Start checkbox to activate the recipient If the configured recipient is to be automatically active after the rvsXP Monitor has been started a
16. 1 rlog log 41 14 A1 16 A2 1 rlstat log 41 16 A2 1 Flag SSCREATE A1 16 Follow on processing Backing up 91 Restoring 94 FORCEDEND parameter 7 6 A1 9 Forwarding see Routing Forwarding Support Service A4 1 Freecmd command 7 3 FSS 4 1 Function test rvsXP 23 G genKey program 101 Glossary 44 1 GNU 44 2 GNU zip algorithm 9 A4 2 H Holdcmd command 41 3 Holding Send order 5 Holding temporarily Send order 5 IEPRIO parameter 41 2 A1 6 Importing Key 105 IN parameter 37 INADDR parameter 46 INIT environment variable A3 2 INITCMDS parameter A7 7 Initializing rvsXP database 92 Input code parameter 37 Installation rvsXP 15 Interface C Cal 7 Command prompt 7 User 7 IP address parameter 46 ISDN tab 47 ISDN connection 73 41 ISDN Facilities parameter 50 ISDN number parameter 49 ISDN protocol parameter 49 ISDN reception 58 ISDN UserData parameter 50 ISDN FAC parameter 50 ISDN PROT parameter 49 ISDN TEI parameter 50 ISDN USRDT parameter 50 ISDNNO parameter 49 IZPRIO parameter 417 2 A1 7 J Job rvskeyimp 105 Jobstart entry Creating 84 Displaying 84 Editing 85 Removing 86 K KEEPDAYS parameter A1 7 A1 14 Key Creating 101 Deleting 708 Importing 705 Listing 170 Key administration 101 Configuration 97 Key features 6 Key file rvsXP User Manual Rev 2004 05 28 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual
17. 105 8 5 Distribution of keys rvskeydst 107 8 6 Deleting imported keys rvskeydel 108 8 8 Configuration of offline compression eseeeseeenne 111 9 Code CONVERSION gu Leu n ELM 113 9 1 Automatic code conversion with integrated conversion tables 114 9 2 Code conversion with user code tables 115 9 21 Structure of the code conversion tables 115 9 3 How to perform a code conversion 116 9 3 1 Code conversion when sending files 116 9 3 2 Code conversion when receiving files 118 10 5 d Yt FN FIRE D qu de 121 10 1 Configuration of ORACLE ustedes uto C ire tte Sete edP ince 121 10 2 Configuration Of IVSXDP ci eer Re RR IRSE cunei lu Fea ED ER d 122 10 3 Microsoft SQL Server configuration eeseeeeeseeeeneeee 124 Appendix Appendix 1 The rvs parameters Appendix 2 Log files Appendix 3 Environment variables Appendix 4 Glossary Index Introduction 1 Introduction The present chapter gives a brief introduction to the rvs system describes the struct
18. 6 Representation means 74 How to work interactively with rvsXP 6 3 4 Handling files to be sent and received rvsXP and This chapter describes how you can handle files with rvsXP if you are interactive operation using an interactive application Holding a send order Since rvsXP operates asynchronously there is always a certain time span between your send order and file transmission This depends on the rvsXP Monitor load and settings During this time you can still put a hold on a send order and modify it To hold one or more send orders 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 Chapter Selecting display criteria on page 77 Click the Hold button or choose Edit Hold from the menu Modifying a send order To modify a send order Use the mouse to click the send order that you want to modify Execute the menu command Edit Update The Change Send Entry dialog opens In this dialog you can modify all the fields for the send order Carry out the desired changes Confirm your entries with OK The send order has been modified rvsXP 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 Click Chang
19. 95 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual Possible parameter modification Dynamic adaptation during operation of rvsXP Monitor using the rvsXP Administrator See Customizing rvsXP Monitor parameters on page 62 or Interactively issue the command as a single operator command or Static adaptation by integrating the command in the C rvs init rdmini dat initialization file By default the file contains the cleanup days 3 ss yes entry That means that completed or deleted transmissions remain stored for 72 hours in the rvsXP database until rvsXP Monitor deletes them along with the transmission statistics Carry out the following steps if you want to modify the parameters for the restart Open the C rvs init rdmini dat file To do so click the Monitor Parameters icon the rvs folder Search for the cleanup entry and modify it to meet your requirements Save the file and close the text editor Stop rvsXP Monitor and then start it again in order to activate the modified settings 96 Encryption configuration Key administration 8 Encryption configuration Key administration The present chapter describes the key administration for secure data exchange It describes how to generate import and distribute keys as well as how to list and delete imported keys 8 1 Encryption basics This is make unauthorized reading of information impossible you modify the enc
20. A1 6 IN 37 INADDR 46 INITCMDS 7 7 Input code translation 37 IP address 46 ISDN facilities 50 ISDN number 49 ISDN protocol 49 ISDN user data 50 ISDN FAC 50 ISDN PROT 49 ISDN TEI 50 ISDN USRDT 50 ISDNNO 49 IZPRIO 41 2 A1 7 KEEPDAYS Af1 7 A1 14 LDSNPRIO A1 7 LID A1 7 LINK 49 53 LITRACELEVL 64 LITRACELVL 7 7 A1 9 A1 16 LMPRIO A7 7 MAX IN 46 MAXCMD A1 7 Maximum sessions 46 MAXRECL 41 7 A1 12 MAXSENDERS A1 7 A1 14 MAXX25RCV 48 52 58 A1 7 A1 15 MSGPRIO A1 7 N 46 50 53 NAME 41 2 Neighboring nodes 44 NUMRLOGS 41 7 NUMRLSTAT 41 7 OCREVAL 37 A1 7 A1 13 Odette 35 Odette Id 35 ODETTEID 35 ODTRACELVL 7 8 A1 9 A1 16 OEXBUF 37 39 A1 8 A1 13 OKPRIO 7 8 ORETRY A1 8 OTIMEOUT A1 8 OUT 38 Output code translation 37 Parallel sessions 42 50 53 PHONE 34 Phone 34 PKI 39 A1 11 PORT 46 Port 46 PRIORITY 42 44 Priority 42 44 PROTOCOL 41 PSESSIONS 42 PSWFROM 35 PSWTO 35 QEPRIO 41 2 A1 8 QSPRIO 41 8 QZPRIO A1 2 Rcv Timeout 50 53 RCVTIMEOUT 50 53 RECBLOCKS 37 Receive 35 37 rvsXP User Manual Rev 2004 05 28 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual Receiver 47 Receiver number 46 50 53 RECVBLOCKS A1 6 A1 13 Remote 34 RLCOMAXSIZE A1 9 RLDBMAXSIZE A1 9 RLOGMAXSIZE A1 9 ROUTING 41 9 RSTATMAXSIZE A1 9 rvskeydel 708 rvskeydst 107 rvskeyimp 106 SCPRIO 9 SDSNMAX A1 9 SDSNPRIO 41 9 SECURITY 7 9 Self test via 41
21. Delst 7 3 Freecmd 41 3 Holdcmd 7 3 Lc A1 4 Listcmd 47 3 Listdbv 41 3 Listparm A1 2 Listst 7 4 Lp A1 4 Ls A1 4 41 4 Setparm 64 7 2 A1 4 Sp A1 4 Start 47 4 Stop A7 4 System 41 4 Communication module A4 2 Communications Manager SINIX 44 1 Configuration Key administration 97 Configuration of rvsXP 29 Connection parameter 47 rvsXP User Manual Rev 2004 05 28 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual Connection establishment 6 Active 42 Connection type 47 ISDN 73 TCP IP 74 X 25 14 Creating genKey 101 Jobstart entry 64 Resident receive entry 80 rvsXP database 92 Send order 69 User entry 87 CUG parameter 50 54 D Data administration see Managing the rvsXP data base Data conversion 7 Database Backing up the complete database 92 Cleaning up 95 Reinitializing 92 Removing 92 Retention time of completed jobs 95 DB environment variable A3 2 DBLOG environment variable A3 3 DBNAME environment variable A3 3 DBPSW environment variable A3 3 DBUSER environment variable A3 3 Definition Routing 43 Delay parameter 42 Delcmd command 47 3 Deleting Key 708 Delst commana A7 3 Dialog Choosing a file to be sent 69 Display of not transmitted datasets 66 Program start after send attempt 84 Resident receive entries 80 rvsXP administrator 65 User 87 88 Dialog interface 4 7 Starting 65 Directories 11 Display mode 66 Reception 6
22. For more detailed information on the RVSPATH parameter see Chapter 1 6 Representation means 118 Code conversion Enter your resident receive entry parameter Inthe Code Table field you can define the path and name of the rvsXP system code conversion table from EBCDIC to ASCII SRVSPATH init rtcea dat or SRVSPATH system rtcae dat Press the lt Enter gt key to create the new resident receive entry Result An EBCDIC file received via the defined resident receive entry will be saved as an ASCII file Create a resident receive entry with user specific code conversion table Startthe rvsXP Administrator with right mouse button rvsTraylIcon gt rvs Administrator or Start gt Programs gt rvs gt rvs Administrator Choose Job Receive The Resident Receive Entries window appears e Choose Edit gt Add to add a new resident receive entry Enter your resident receive entry parameter Specify path and name of the user defined conversion table e g SRVSPATHNarcdirNrtcusr dat inCode Table Press the Enter key to create the new resident receive entry Result A file received via the defined resident receive entry will be processed converted with the user defined code table 9 For more detailed information on the RVSPATH parameter see Chapter 1 6 Representation means rvsXP User Manual Rev 2004 05 28 119 gedas deutschland GmbH Fachbereich rvs Systems rvsXP U
23. Logs TCPIP READY 1696 TCP IP Receiver ready to accept incoming calls Port lt i Monitor lt LGW gt XMT COMPROC FINI 11 communication processes are finished c Statistics El Active Panel B Database B 8 Export a Import B Settings Parameters E Options Environment B Start Program Dia b Key Admin R Tray Icon Press F1 to get help F5 for refresh rvsXP User Manual Rev 2004 05 28 65 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual Requirements 6 2 Starting rvsXP rvsdiant exe You need a system which has been set up for operating rvsXP and the required access rights Start the rvsXP program inthe rvs folder inthe rvsXP Administrator using Program Diaor with the rvsTraylcon The rvsXP window opens with display of not transmitted datasets V rvsDia display of completely transmitted datasets E ni xi Eile Edit View Help Dia xol amp Entry No File Name Disposition Time m Details File Name Local Name Receiver State Additional Information 34 Command Numbers Date Time Transmitted SE Disposition Block Size Format SK Start of Transmission Send Attempts IE End of Transmission Encryption Compression Send Attempt at New Send Entry Press F1 for help F5 for refresh The window displays the transmission informatio
24. Rsx Filename c rvs keydirRSX30 pub Creator not specified Owner not specified Creation Time Sat Feb 21 08 13 02 2004 r Version Serial Number 001 Version 001 Mode 001 Cf public m Run of Validity Begin End sat Feb 21 01 00 00 2004 Fri May 21 00 00 00 2004 delete the current key entry rvsXP User Manual Rev 12 03 2004 gedas deutschland GmbH Fachbereich rvs Systems 109 rvsXP User Manual Choose the private or public key highlighted in the rvsKey dialog above in the rvsKey dialog Click the Delete button Answering the following query with Yes causes the key to be deleted in the rvsXP database and from the list in the rvsKey dialog The key will not be deleted if you choose No 8 7 Listing of imported keys rvskeylst The rvskeylst tool lists all keys that have been imported into the database with their complete data This command does not support any options You can launch the xvskeyl1st tool via the command prompt or the graphic interface Launching via the command prompt Syntax rvskeylst Example of result D WO1 BEGIN 2001 02 22 00 00 00 END 2001 05 22 1 00 00 FILE D LOC BEGIN 2001 02 22 00 00 00 END 2001 05 22 5 0 5 0 2 00 00 FILE Launching via the graphic interface After launching rvskey1st the key entries are shown the graphic rvsKey Start rvsKey with Start gt Run
25. Send 55 57 SENDBLOCKS 37 A1 9 A1 13 SEPRIO 41 9 SESSIONS 50 53 SID 34 SIDNEIGHB 44 SIDTRACE A1 7 A1 9 SIDTYP 34 SLEEP 7 9 A1 14 SNARCV 41 10 Station 34 Station ID 34 Station name 34 STATISTICS A1 10 A1 16 STATNAME 34 SYNCDL 41 10 SYNCTO 41 10 TCPIPROV 46 57 A1 10 A1 15 TEI 50 TIMEOUT 49 53 Timeout 49 53 TIMESTAMP 41 10 TMAXCON 41 10 TSTODPRCT 41 10 USEPKI A1 11 USERDATA 49 53 VC 54 VDSNCHAR 38 A1 11 VFTYP A1 12 Virtual 34 Virtual circuit 54 Window size 37 X 25 address 49 53 X 25 Facilities 49 X 25 facilities 53 X 25 UserData 49 X 25 UserData rvsNT 53 XADDRESS 49 53 XMCREATE 41 12 A1 14 A1 16 Parameters obsolete RETRY 7 8 Parameters reserved USERFIELD 41 11 Partner station Activate 27 Managing 30 Setting up 30 Password administration 36 PATH environment variable A3 2 PDF 44 3 Performing Code conversion 176 118 PHONE parameter 34 Phone parameter 34 PKI parameter 39 A1 11 Platforms 5 PORT parameter 46 Portable Document Format 44 3 PRIORITY parameter 42 44 Priority parameter 42 44 Program Activate A1 14 Key 101 rvsbat 44 1 rvscom A4 2 rvsdia A4 1 rvskeydel 708 rvskeydst 107 rvskeylst 110 rvsmon A4 2 rvssp A2 2 rvsxmt A1 14 A4 2 Properties Station 37 34 55 Protocol A4 3 PROTOCOL parameter 47 Protocol files 7 PSESSIONS parameter 42 PSWFROM parameter 35 PSWTO parameter 35 Q QEPRIO parameter 7 2 A1 8 QSP
26. also increase the memory requirements for sender and receiver These values may be negotiated down at the start of each transmission so that unilateral changes may have no effect What you really determine is the maximum amount of memory you are willing to allocate to ODETTE KEEPDAYS Searching in a large database generally takes longer than looking for something in a small one A larger database however retains more information on completed transmissions KEEPDAYS determines the Transmission time for a 4 5 MB data set between two OS 2 nodes was reduced by about a factor of 10 from more than an hour to a few minutes by changing the values of these parameters from 10 to 10000 rvsXP User Manual Rev 2004 05 28 A1 13 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual CMDDELETE and XMCREATE SLEEP DTCONNxx MAXSENDERS number of days you want to keep information about ended or deleted transmissions unless you use cleanup days n explicitly specifying the retention period in the command itself For CMDDELETE 1 all related entries will be removed physically from the database when a command ends or when it is logically deleted This keeps the size of the database as small as possible If you choose this option you should leave XMCREATE at its default value 1 In this way detailed LOG messages will be created after sending or receiving a data set All users should have access to the log da
27. and type rvskey or Start the program rvsKey inthe rvs folder Start gt Programs gt rvs gt Key Administration or Start the program in the rvsXP Administrator with Start Program gt Key Admin 110 Encryption configuration Key administration 015 File Tools Help C Ug N Import Delete Generate E stations Info BP oc TEM FDAF49CF ey 948 6222 S FDAF49CF SID RSX z RSL Filename cirvs keydir RSX30 pub RST a a RSX Creator not specified 3 E 2 Owner not specified Creation Time Sat Feb 21 08 13 02 2004 r Version Serial Number 001 Version 001 Mode 001 Cf public m Run of Validity Begin Sat Feb 21 01 00 00 2004 End Fri May 21 00 00 00 2004 e f you want to refresh the list select Reload in the File menu 8 8 Configuration of offline compression If the offline compression module was purchased it is enabled by the rvsXP license key Offline compression is enabled when the key file rdkey dat located in the rvsXP init folder contains the Z module There are none additional configuration steps required for offline compression Offline compression may be switched on for each send job separately It is handled automatically when receiving files rvsXP User Manual Rev 12 03 2004 111 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual 112 Code co
28. as a system service In order to install Windows service the rvsXP Monitor as a system service it is necessary that you belong to the Windows XP Administrator group Windows offers various ways to open the list of Services This list provides functions for managing and controlling services Use the Services dialog to start stop pause or continue the rvsXP Monitor service Note The term Service means a program that can be started from the operating system and works in the background 5 1 Starting rvsXP Monitor ways to start You can start rvsXP Monitor from the operating system level from rvsXP Administrator the tool for rvsXP operation or directly via the rvsTraylcon Operation of rvsXP requires administrator user rights at the system level and in the rvsXP environment Depending on your choice during the rvsXP installation the startup type for this service is Automatic or Manual Startup type Manual The user must manually start the service if the Manual startup type was chosen At first the status of the rvsXP Monitor service is stopped represented by a blank entry in the status column To start the service Highlight the xvs Monitor line Click the Start button Setting to automatic If you want to start rvsXP Monitor every time the system starts you can set the startup type to Automatic Click the Startup type button and choose Automatic Starting Carry out the following steps if you want to start rvsXP Monitor at the
29. by the switching exchange The same applies to connection requests from group members to participants not being a member of the closed user group This service attribute is called Closed User Group CUG Virtual Circuit X 25 are referred to as channels and are assigned a vc channel ID each virtual circuit There are SVC switched virtual circuits and PVC permanent virtual circuits for leased lines You often need to specify the number of channels when configuring an X 25 layer These are enabled by the X 25 access provider and often charged for according to their number You need at least 2 SVC for parallel receiving and sending What are virtual stations Receiving at virtual stations 4 1 8 Setting up a virtual station Virtual stations are used to represent stations outside the OFTP network for the OFTP network They allow files to be sent to destination stations outside the OFTP network ODETTE IDs uniquely define the stations in an OFTP network Each virtual station must also be assigned an own ODETTE ID A virtual station can also send and receive These stations are specially flagged with the SIDTYP V parameter value in the ST database table To configure them you only need the OP database table in addition because virtual stations have their own ODETTE ID Upon receipt in an OFTP system the file is not forwarded if the final file receiver s SID SIDDEST database parameter matches the SID of the local
30. characters parameter 38 AP DISPLAY INTERVAL environment variable A3 2 Appendix 413 125 ARCDIR environment variable A3 2 ASCII 37 A4 1 ASCII EBCDIC conversion 113 AUTODIAL parameter 42 B Backing up Station 56 Station table 90 User table and follow on processing 97 Back up Backing up rvsXP tables 90 Backing up the station table 90 Database complete 97 Overview 89 Recommended procedure 89 Restoring 94 Restoring the rvsXP database 95 Restoring the station table 94 Restoring user table and follow on processing 94 rvsXP 89 User table and follow on processing 97 Write to log A3 3 BACKUP parameter A7 5 Basic functions 6 BBCREATE parameter 7 5 A1 15 BBPRIO parameter 41 2 A1 5 Block size parameter 57 39 Blocks During reception 37 During sending 37 BRICKOFTPTI parameter 41 5 C Cal interface 7 CDWAIT parameter 42 CDWAIT parameters 7 5 Cleaning up see Cleaning up the rvsXP database Cleanup command 95 A1 3 A1 14 Closed User Group parameter 50 54 CMDDELETE parameter 95 A1 5 A1 14 CMDTRACE parameter A7 5 CMX 44 1 CNSMSGS monitor parameters A2 1 CNSMSGS parameter A7 5 A1 16 Code conversion 773 During reception 178 During sending 776 Performing 116 Code translation parameter 37 CODEIN parameter 37 A1 5 CODEOUT parameter 37 A1 5 Command Cleanup A7 3 Listparm A1 2 A1 4 Command descriptions 47 3 Commands Act A1 3 Activate A1 3 Cleanup 95 A1 14 Delcmd A1 3
31. characters before CR LF MS Windows systems or LF UNIX systems Specify the maximum record size for files of the Variable format Input Output Code Code Table For detailed description of these options and different file formats please the read the Chapter 9 Code conversion Encryption compression To send a file with encryption and or compression you must enable the appropriate options For further information please see the Chapter entitled 8 Encryption configuration Key administration For more information on compression please refer to Chapter 8 8 Configuration of offline compression rvsXP then writes the send entry for transmission of the file to the rvsXP database The send order has been completed rvsXP lists the job in the list of files waiting to be sent rvsXP User Manual Rev 2004 05 28 71 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual y rysDia display of not transmitted datasets mi xj File Edit View Help 015 xlelo 2 Entry No 48 New File Name NOTES DOC m Details LOC gt LOC Disposition Time 04 28 File Name NOTES DOC Receiver Loc State Additional Information Transmitted 0 Block Size 0 Format u Send Attempts 0 Encryption NO Compression NO SE 48 SK 0 Local Name Command Numbers C docsinotes doc qq Date Time Disposition 2003 04 28 23 28 41 Start of Tra
32. delete an acknowledgement for a received file choose the received file and execute the menu command Edit gt Remove EERP 6 3 5 Selecting 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 To set the display criteria for send orders Execute the menu command View Select The Set selection criteria dialog opens Set selection criterias x Station ID FAR Select File Name State Code save settings as default Cancel Help Enter the station ID for the station s to be selected or Choose Select to open the Select Station dialog and select the ID Enter the criterion for the files to be selected in the File Name field Enter the status code to be selected in the State Code field This entry is optional rvsXP User Manual Rev 2004 05 28 77 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual 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 Use one of the following characters as the status code y Fh Q h no event queued not yet processed by rvsXP Monitor forwardable waiting for transmission process pending waiting for completion ended act
33. desired you can define the send time H the file will be set to hold status until you release it Release occurs in the rvsXP gt display of not transmitted datasets gt Edit Release window Start Time Exact time If you want that the file to be sent your partner at an exact time you continued should indicate the start time in the format YY MM DD HH MM or YYYY MM DD HH MM Example 2004 05 28 10 28 no entry blank the file will be sent immediately Station ID Serialization If you activate these two options the files would arrive at their destination in a specific order All files sent in the same group must have the same ID name The Serialization checkbox must also be enabled For more information on Serialization please refer to Chapter 6 3 2 Serialization Format Choose the format of the file to be transmitted from one of the following Text a string of ASCII characters Fixed fixed record length Variable variable record length Unstructured binary file none system format i e unstructured for rvsXP Note Windows XP does not support the fixed and variable mainframe formats to send files in one of these formats you have to convert the files with the rvsut2fv utility before sending Please see the Reference manual Part Ill Utilities Record size Specify the fixed record size the receiver is to interpret the file with for files in the Fixed format The record length is the number of
34. gt New Send Entry gt Change Options gt Format Text This file will be transmitted as an ASCII file stipulated by the ODETTE protocol and will be converted into EBCDIC by the rvsMVS station Direction rvsMVS gt rvsXP When sending a text file from an OS 390 system you must define the format of the file T format so this EBCDIC text file will be converted to ASCII code before sending Text files are transmitted only in ASCII format Odette The rvsXP system will receive the text file in ASCII Example 2 Direction rvsXP gt rvsMVS Non text file Normally an OS 390 system requires rvsMVS files in the F fixed or V variable format to be able to store and process them without problems As a Windows XP system is able to work only with files in the T Text or U unstructured binary format you have to convert them to the pseudo fixed or pseudo variable format before sending For this purpose rvsXP offers the rvsut2fv tool For more details on this tool and its command syntax please refer to the rvs Reference 5 The code pages vary as they depend on the respective operating system rvsXP User Manual Rev 2004 05 28 113 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual manual Part Ill Utilities The rvsXP station is then to send the converted file in the F or V format and also set the parameters for the input and output code Start gt Programs gt rvs gt rvsXP gt Ed
35. information please see the Chapter entitled 7 1 1 Backing up the station table 56 Configuration of rvsXP Automatic reception 4 2 TCP IP reception If you want to be ready to receive via TCP IP rvsXP must start a TCP IP of calls receiver that waits for incoming calls To set up rvsXP to receive calls automatically via TCP IP Execute the Settings Parameters menu command in the rvsXP Administrator The rvsXP Parameters dialog window for editing the parameters will open In order for the TCP IP receiver to start automatically start when the rvsXP Monitor starts you have to set the value of the rvs TCPIPRCV parameter to 1 i x Parameter SECURITY p SENDBLOCKS 1000 SEPRIO 50 SIDTRACE SLEEP 30 Close SLEEP 30 SSCREATE STATISTICS 2 Heb SYNCDL 500 SYNCTO 120 TIMESTAMP 2 gl TMAXCON 0 TSTODPRCT 90 TCPIPRCV fil Apply Double click TCPIPRCV in the parameter list Enter the desired value 1 into the input field Confirm your entry with Apply Use Close to exit the parameter list Activate the parameter by stopping and starting the rvsXP Monitor A message of the type TCPIP READY TCP IP Receiver ready to accept incoming calls Port 3305 indicates your readiness to accept calls rvsXP User Manual Rev 2004 05 28 57 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual Automatic reception of calls 4 3
36. more detailed output about deleted entries by the user with the cause of deletion if specified with de 1cmd STATISTICS 7 has the same effect as STATISTICS 6 but includes routing STATISTICS 0 prevents the creation of the statistics log file 3 For more detailed information on the RVSPATH parameter see Chapter 1 6 Representation means A1 16 Appendix 2 Log files Appendix 2 Log files Several log files are written during rvsXP operation Their size and number can be controlled by means of rvsXP Monitor parameters rvsXP Administrator Settings gt Parameter 2 1 Brief description of LOG files The Monitor Log file rlco log System start In the Monitor Log view the C rvs temp rico 1log file is messages displayed It is created from scratch each time rvsXP Monitor starts Its maximum size is restricted by the RLCOMAXSIZE Monitor parameter Only those message classes specified in the CNSMSGS Monitor parameter are written to this file The permanent rlog log Monitor log file rvsXP log All rvsXP log messages are written to the C rvs db rlog log file messages regardless of the CNSMSGS parameter It will not be deleted when rvsXP Monitor restarts Its maximum size is restricted by the RLOGMAXSIZE parameter When the file reaches this size it is renamed by replacing the file extension by a consecutive number Then a new C rvs db rlog 1log file is generated and updated The maximum number of generati
37. new receiver which in turn will wait for incoming calls MAXX25RCV if set to 0 prevents any incoming X 25 or ISDN traffic It must be set to 0 if only TCP IP communication is used You must define additional entries in the X 25 routing table on high performance systems if MAXX25RCV is greater than 1 For further details read 4 1 4 Setting up the routing connection 1 6 3 TCP IP receiver TCPIPRCV If you want to communicate via TCP IP rvsXP has to start a receiver and waiting for incoming calls You must set the value of the TCPIPRCV MAX IN parameter Set TCPIPRCV to 0 if you use TCP IP only If a TCP IP receiver accepts an incoming call MasterTransmitter will start a new receiver on the same port which in turn will wait for incoming calls The number of calls you can accept on each port corresponds to the MAX_IN values defined for your local station in your station table 1 6 4 Optional features Providing these optional services takes time and uses up disk space We therefore recommend that you enable them as soon as they are no longer needed AECCHECK AECCHECK is a flag telling rvsXP Monitor to check whether the originator of the command currently being processed has the authority to issue this particular command In a future multi console environment this could be used to prevent certain consoles from stopping the Monitor for example Currently this feature is not fully supported so AECCHECK should remain at 0 disabled
38. of the file containing the key to send a key file to a communication partner The station IDs SIDs can be either handed over as parameter or in the form of an input file one line for each station ID You can launch the rvskeydst program via the command prompt only Launching via the command prompt Syntax rvskeydst f FILE s lt SID gt 1 FILE Options f FILE The file containing the key where the full path must be specified with FILE rvsXP User Manual Rev 12 03 2004 107 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual s lt SID gt The ID of the station to which the key will be sent repeatable 1 lt FILE gt The file containing a list of station IDs Example rvskeydst f C rvs keycreate C45PUB pub s 11 s a34 s gedas rvskeydst f C rvs keycreate C45PUB pub 1 C rvs list sendlist1 lst 8 6 Deleting imported keys rvskeydel The rvskeydel1 tool deletes keys that previously were imported into the rvsXP database It deletes the key from the database and the respective key file in the key folder The 1 option creates a list containing the delete statements for all keys in the database The output comprises two lines for each key one with all key data one with the appropriate delete statement To use this list for deleting keys you must pipe the output into a file All delete statement lines have been commented out with REM a
39. station LID In this case the file is delivered locally and EERP is created and a post processing script starts if necessary In a routing case the finals receiver s SID SIDDEST does not match the local station s SID In this case a send entry is created that forwards the file to the actual receiver Upon receipt of an EERP a verification as to whether the receiver Odette ID in the EERP matches that of a virtual station is performed In this case the file is delivered locally and EERP is created and a post processing script starts if necessary 54 Configuration of rvsXP Sending from The send job is given the SIDORIGIN parameter for sending from virtual virtual stations stations This parameter must be filled with the station s SID when sending from a virtual station When this has been done the value of SIDORIGIN is written to the SFID as sending station for the file to be sent Setting up virtual The process of creating and setting up virtual stations is basically stations identical with that of other stations Refer to Chapter 4 1 Setting up rvsXP stations Updating removing The process of editing and removing virtual stations is basically identical virtual stations with that of other stations See also Chapter 4 1 9 Editing the partner station 4 1 9 Editing the partner station Editing properties To edit the parameters of an existing station norder to do so open the station table in the xvsXP Administ
40. take these steps Check the rvsXP license key If the Encryption module was purchased the rvsXP license key SRVSPATH N init rdkey dat contains the Y module Generating keys Generate a key pair for your local station To do so use the Key Admin application in the rvsXP Administrator or the genKey tool see Chapter Creating private and public keys Importing keys Import your private key and your own public key for your local station in rvsXP To do so use the Key Admin application in the rvsXP Administrator or the rvskeyimp tool see Chapter Importing Keys rvskeyimp CAUTION Please handle the private key file very carefully to ensure your privacy Distributing and Send the own public key file to the partner stations that shall importing public participate in encrypted file transfer You can do this rvsXP Use the keys rvskeydst tool see Chapter Distribution of keys rvskeydst Geta public key file from each of your partner stations that may participate in encrypted file transfer Import the keys in rvsXP database To do so use the Key Admin application or the rvskeyimp tool see Chapter Importing Keys rvskeyimp e Check rvsXP key configuration to ensure availability of the local private key and of the partner public keys To do so use the Key Admin application or the 1 rvsXP tool see Chapter Listing of imported keys rvskeylst Encryption may be enabled for each send job separat
41. the follow on processing In order to back up the station table with all the parameters for partner stations e Start rvsXP Monitor Openthe Station Table window with the Stat ions menu command Execute the menu command Edit Export Stationtable The Select Backup File dialog then opens and displays the files in the rvsXP system folder with the DAT extension Enter the file name under which you want to back up the station table 90 rvsXP database maintenance Confirm the entry by clicking Open rvsXP then backs up the station stable and displays any errors in the rvs Dump Stationtable dialog Back up has been successfully completed if the message Done with 0 errors appears 7 1 2 Saving the user table and follow on processing We recommend you back up the user table and follow on processing each time you make changes to them You can revert to this back up if you wish to restore the previous settings for users and follow on processing after a re initialization of the rvsXP database You thus avoid performing the set up again Such a back up is also ideal to establish a clean initial database state in conjunction with a back up of the station table Table back up To save the user table and the follow on processing Stop rvsXP Monitor e Start rvsXP Administrator with the rvsTraylcon commandrvs Administrator orchoose Start All Programs gt rvs gt rvs Administrator Exec
42. the following record formats U unstructured T text F fixed record length V variable record length Extensive security and authorization checking is performed Introduction Basic functions rvs automatically repeats the transmission after an unsuccessful continued connection attempt or disruption of a connection rvs only transmits the parts of a file not yet transmitted when a disrupted transmission is resumed 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 Online or offline compression more effectively uses the transmission line capacity The rvs encryption ensures data security during network data transmission The graphical user interface features menu control Besides a graphical menu controlled interface the rvs batch interface rvsbat is provided That means that you can call rvs from within batch or command files With a C Call interface application programs can call functions of the C language to directly generate rvs command entries The ODETTE File Transfer Protocol OFTP is used The ISDN X 25 TCP IP and SNA LU6 2 line protocols communication are supported however not all system environments support the complete range of protocols Message LOG files are provided for revision purposes rvs supports multiple
43. 04 25 B E Logs CLNUP NONE gt Cleanup of RVS data base ended there no commands to be purged XMT START gt MasterTransmitter started Hf Monito SP START gt Service Provider started Compression yes Security no Statistics TCPIP READY gt 548 TCP IP Receiver ready to accept incoming calls Port 3305 Active Panel 8 Database Settings 4 Start Program Press F1 to get help F5 for refresh Open the station table with the Stations menu command Link test between To test the link between local and remote station proceed as follows local and remote Start with the local station first unless you are sure it functions correctly station Choose the local or partner station to be tested and choose Edit gt Activate rvsXP Monitor reads the operator command and executes it The Monitor Log window shows the rvsXP Monitor activities A message of the type O lt CONNECT gt Sender Connection established with station LOC with credit 100 Odette buffer 2047 indicates a successful link test BH Fie Edit View Monitor Database window 2 la xi amp e X EF COPYRIGHT rvsXP3 01 00 c gedas 2004 11 rights reserved El ws INIT CHD gt rpm Reading initial commands 8 Stations K READ gt RVSCNS cleanup days 3 ss yes 5 Users CLNUP DEL 55 gt Cleanup of RVS data base purge all SendStatistics with DTEND lt 2003 B By Jobs
44. 399 71 777 telefax 49 30 399 71 994 email rvs service gedas de There you may obtain the desired license When you install a full rvsXP version you receive a license key file that does not contain an expiry date i e there is no temporal restriction License key update Startthe Machine ID application in the rvs folder The program now displays a three or four character machine identification number on the screen nform your sales partner of the machine identification number and he will send you a license key by email Make a backup copy of the old C rvs init rdkey dat file in order to be able to restore the original file status You should save the received license key as rdkey dat file in the Init folder The license key has now been adapted Chapter 1 6 Representation means for more information 20 Installation of rvsXP Structure of the license key data rdkey dat file 0000000000 Customer Number NT Product 3 00 00 Release 5LTX Included Components TESTINSTALLATION Customer Name Part one Customer Name Part two reserved reserved reserved reserved reserved Computer Model TESTVERSION PHYSICAL CPU DENTIFICATION 94211 Expiration Date CA580BE5 20189735 612035F9 77AD6591 162D0D7F 18FAB129 53B14EA4 79390F44 WKAR ALKIRE KER REAR gedas GmbH 1999 m make a success of rvs
45. 7 Sending 67 Displaying Jobstart entry 64 Received files 4 Refreshing 74 Resident receive entry 80 Send order 3 Transmissions 73 User entry 86 Displays Refreshing 74 DTCONNnn parameter 41 6 DTCONNxx parameter 47 74 E EBCDIOC 37 A4 1 EBCDIC ASCII conversion 773 EDI A4 1 EDIFACT A4 1 Editing Jobstart entry 85 Resident receive entry 82 Send order 5 User 88 User entry 86 Editing parameters A7 7 EERP A4 1 EERP see also End to End Response EERP OUT parameter 38 A1 6 EERP IN parameter 37 A1 6 Electronic Data Interchange 44 1 Encryption 7 8 and electronic signature 97 Asymmetrical method 97 Basics 97 Features 9 Key administration 101 rvsXP principle and procedure 98 Symmetrical method 97 End to End Response 37 43 A1 6 A4 1 Environment variable AP DISPLAY INTERVAL A3 2 ARCDIR A3 2 DB 43 2 DBLOG A3 3 DBNAME A3 3 DBPSW A3 3 DBUSER A3 3 INIT A3 2 Input dialog A3 1 KEYDIR A3 2 Language A3 3 PATH A3 2 PORT A3 2 SAMPLES A3 2 SERVER A3 2 SPOUTDIR A2 2 Index SYSTEM A3 2 TEMP A3 2 USRDAT A3 2 Environment variables A3 2 Setting A3 7 SPFILESDIR A3 2 SPINDIR A3 2 SPOUTDIR A3 2 Equipment See System requirements Establishment of an active connection 42 ETSI A4 1 Exit rvsXP 68 Explanation of special terms A4 1 F FACILITIES parameter 49 53 Features Encryption 9 Offline compression 9 Files rdkey dat 20 rdmini dat 62 64 96 rlco log A2
46. 76 Starting 78 Startup mode 76 rvs parameter Working with 7 7 rvs parameters 7 73 rvsbat 44 1 rvsbat program 44 1 rvscom A4 2 rvscom program A4 2 rvsdia A4 1 rvsdia program A4 1 rvsdiant exe Launching 66 Starting 66 rvskeydel program 108 rvskeydst program 107 rvskeyimp program 105 rvskeylst program 770 rvsmgr exe Launching 65 Starting 65 rvsmon A4 2 rvsmon program A4 2 rvssp program 42 2 rvsTraylcon 29 rvsxmt 44 2 rvsxmt program 41 14 4 2 rvsXP Configuration 29 Display mode 66 Exiting 68 Installation 15 Sending a file 23 Starting 66 Window areas 67 rvsXP administrator Starting 30 65 rvsXP back up 89 rvsXP database Cleaning up 95 Managing 89 rvsXP User Manual Rev 2004 05 28 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual rvsXP database see Database rvsXP function test 23 rvsXP HighPerformance 727 rvsXP Monitor 47 4 Changing startup type 76 Starting 59 Startup type 76 17 Stopping 67 rvsXP Monitor parameters 62 Adapting 63 64 rvsXP test 23 rvsXP Traylcon 30 S SAMPLES environment variable A3 2 Saving User 88 SCPRIO parameter 47 9 SDSNMAX parameter 41 9 SDSNPRIO parameter 47 9 SECURITY parameter A7 9 Selecting display criteria 77 Self test via parameter 47 Send File 23 Send parameter 35 37 Send order Creating 69 Displaying 73 Editing 75 Holding 75 Releasing 76 Removing 6 77 Restarting 76 Temporar
47. CLE database gt DBPSW lt ORACLE user password gt These variable values have been defined when installing and configuring Oracle Note ORACLE user must be an existing rvsXP user with administrator rights 13 For more detailed information on the RVSPATH parameter see Chapter 1 6 Representation means rvsXP User Manual Rev 2004 05 28 123 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual Requirements Example for UNIX environment tnsnames ora TNSNAMES ORA Network Configuration File opt oracle product 8 1 7 network admin tnsnames ora Generated by Oracle configuration tools RVSORA GEDAS DE DESCRIPTION ADDRESS_LIS ADDRESS rvsaix3 PORT CONNECT DATA SERVICE NAME rvsora gedas de PROTOCOL TCP HOST 1521 Isa 1 Example excerpt from RVSPATH rvsenv dat rvsXP environment file rvsenv dat DBNAME rvsora DBUSER skk RVSORA GEDAS DE DBPSW skk 10 3 Microsoft SQL Server configuration The SQL Server database version 8 0 and later must have been set up prior to the installation of SQL Enterprise Manager The installer queries the link parameters to the Microsoft SQL Server and saves them to the rvsenv dat file DBNAME lt host gt lt database name gt DBUSER lt database user gt DBUSER lt database user password gt Befor
48. CLNUP START gt Cleanup of RVS data base purge all commands with DTDONE lt 2003 04 25 tl Loge EET START ucl ti lei dd there are no commands to be purged bil SP START gt Service Provider started Compression yes Security no 9 Statistics TCPIP READY gt 548 TCP IP Receiver ready to accept incoming calls Port 3305 Active Panel lt OK_READ gt RVSCNS ACTIVATE SID LOC amp B Database S 1808 puegetug call eovatpelot Dos i Settings INCOMING CALL gt Incoming call received LOC 2 4 Start Program CONNECT IND gt Responder Connection with Station LOC with Credit 99 Odette Buffer CONNECT x Sender Connection with Station LOC with Credit 99 Odette Buffer 20 TCPIP READY gt 1300 TCP IP Receiver ready to accept incoming calls Port 3305 lt DISCONNECT gt Connection as receive to Station LOC ended DISCONNECT gt Connection as send to Station LOC ended Press F1 to get help F5 for refresh e Check the output in Monitor Log for error messages Eliminate any errors that occur in accordance with the advices in the Messages and Return Codes manual rvsXP User Manual Rev 2004 05 28 27 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual 28 Configuration of rvsXP 4 Configuration of rvsXP This chapter describes how to configure your rvsXP system i e how to perform network and other basic configurations and how to assign r
49. ED gt IE 44 terminated status mj Database NMEW CMD CREATED gt QE 47 created by Q 46 Settings CMD TERMINATED gt 05 46 terminated status iG Start Program lt CMD_TERMINATED gt QE 47 terminated status e CMD TERMINATED gt SK 43 terminated status e SE SENT gt SE 42 successfully sent C docs notes doc for Konrad CMD TERMINATED gt SE 42 terminated status e NEW CMD CREATED gt SK 49 created by SE 48 P lt NEW CMD CREATED gt IE 50 created bv 5Ki49 Press F1 to get help F5 for refresh How to work interactively with rvsXP 6 3 2 Serialization Purpose Sometimes it may be important that a number of files arrive in a specific of serialization order at their destination to make sure they will be processed in proper sequence Even though rvsXP 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 specify a label when creating the send entry for the first file in your series display of not transmitted datasets New Send Entry button use the same label and enable the Serialization checkbox for all subsequent files create all send entries linked by the
50. Eua Fea ira DEVO drawn Na fac V dU aa fada ae 13 2 1 SVSIBITEPOOuSrmelllss andes Lc 13 2 2 Connection type installation 13 2 3 Installing DS E sus e a eec tee 15 2 4 The rvsXP program environment iori ceni ette eene detenta ceps deis 19 2 5 How to obtain a license bsc piombo Po ene ta eoo pedet otii 20 3 Function lada tria esie Spe i ode cid RE 23 3 1 Sending a file to yourself ror eer el tenete E eS buc pedes 23 3 2 Testing the connection with the local and the partner stations 25 4 Gonflguratlon of IVSXP uadit ecc cedat etie Cai 29 4 1 Setting up rvsXP stations 2 3 inen Um Ext dat s das eus 30 4 2 Setting up ODETTE parameters 2 2 Rte 35 4 1 8 Setting up the neighboring station sssseneenm 40 4 1 4 Setting up the routing connection 42 431 5 Setting up TCP IP communication ice in ER LI Cited eee Ree RR PHA 45 4 1 6 Setting up the ISDN parameters sees 47 4 1 7 Setting up X25 parameters Rer de tet dk oc qu ap 51 4 1 8 Setting up a virtual station dien 54 4 1 9 Editing the partner station siccat eei sienna Rr e hides vt eri PU Erro ux s 55 4 2 TCP IP reception E 57 5 FS XP MORIIOE i decederet
51. IP protocol and click the Properties button Set the IP addresses for your environment and confirm with the OK button Note The network administrator will provide you with the IP addresses Confirm the entries by pressing the OK button and close the Network connections window 2 3 Installing rvsXP Start installation Start Windows XP and log in as an XP user with administrator rights Insert the data medium labeled rvsXP in a drive Skip the next three instructions if the rvsXP Installer starts automatically Choose Start gt Run Enter D Nsetup exe to run the installation program if your CD ROM drive is drive D Confirm the entry by pressing OK The rvsXP installer now starts and guides you through the installation Follow the installer instructions You can confirm the rvs target folder or select another Please note that file and path names must not contain any spaces You may choose between German or English as user languages We recommend LOC as the station ID for the local station However you may choose a different ID Important The installer automatically enters the current XP user as rvsXP user with rvsXP administrator privileges in the rvsXP database rvsXP User Manual Rev 2004 05 28 15 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual Automatic or manual service start Change startup type Heed the appropriate dialog during installation if you wish t
52. ISDN X 25 reception If you want to be ready to receive via X 25 ISDN rvsXP must start a receiver that waits for incoming calls on the X 25 ISDN line To set up rvsXP to receive calls automatically via X 25 ISDN Execute the Settings gt Parameters menu command in the rvsXP Administrator The rvsXP Parameters dialog window for editing the parameters will open In order for X 25 and ISDN reception to start automatically when the rvsXP Monitor starts you have to set the value of the rvsXPMAXX25RCV parameter to 1 IIT RM 2x Parameter UD LOC LITRACELVL 0 LMPRIO 20 MAXCMD 10 MAXRECL 99999 Close MAXSENDERS 1 AXX2BRCV 0 MSGPRIO 60 NUMRLOGS NOLIMIT NUMRLSTATS NOLIMIT OCREVAL 99 ODTRACELVL D OEXBUF 2048 OKPRIO 10 x MAXK25RCV i Apply Double click MAXX25RCV in the parameter list Enter the desired value 1 into the input field Confirm your entry with Apply Use Close to exit the parameter list Activate the parameter by stopping and starting the rvsXP Monitor A message of the type ISDN READY ISDN Receiver ready to accept incoming calls No 005361186751 indicates your readiness to accept calls 58 rvsXP Monitor 5 rvsXP Monitor This chapter describes how to start and stop rvsXP Monitor as well as how to customize the Monitor parameters for Windows XP rvsXP Monitor as Usually the rvsXP Monitor works
53. IX systems This is the maximum record length for files of the Variable format For this purpose the files must be available in the appropriate format otherwise transmission errors will occur Empty lines will be replaced with a record containing exactly one space The following optional parameters are available for sending files in the fixed or variable format with the rvs batch interface VFTYP defines whether files in the F or V format are to be sent using the method mentioned before T The file is a text file and will be handled in line with the method described before MAXRECL Maximum record length if VFTYP T is set V_rvs internal format Files in the F or V format have been formatted with rvsut2fv exe Default V internal format Creation of LOG messages with detailed information about what was transferred from and to whom after each successful data set send or receive process Default 1 enabled A1 12 Appendix 1 The rvs parameters 1 5 Description of selected rvs parameters rvsXP contains a number of optional and security related features which you may not need all the time at your installation Each active function consumes resources processor time and hard disk access The sum of all functions can significantly affect the performance of rvsXP components Data transmission As an example consider transmission of a large data set To be able to mechanism resume transmission after a line failu
54. ORACLE HOME ORACLE SID rvslnx4 export ORACLE SID export DBID ORA PATH SPATH SORACLE_HOME bin export PATH LD_LIBRARY_PATH SLD_LIBRARY_PATH home bwa rvs system home bwa rvs lib opt oracle product 8 1 7 1ib export LD LIBRARY PATH 11 For more detailed information on the RVSPATH parameter see Chapter 1 6 Representation means rvsXP User Manual Rev 2004 05 28 121 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual Configuration file Example AIX AIX ORACLE SID rvsora export ORACLE_SID export DBID ORA PATH SPATH SORACLE HOME bin export PATH Two configuration options are offered 1 rvs and Oracle run on the same computer 2 rvs and Oracle run on different computers For option 2 When rvs and Oracle are running on different computers the communication between both systems takes place via a LAN supported by both systems Here the normal Oracle Client Server solution would be used Server The Oracle Server software must be installed and configured on the database server The so called LISTNER must also be configured on this server Client The rvs OFTP server and Oracle client must be installed and configured on the client 10 2 Configuration of rvsXP The following steps are necessary 1 rvsXP and Oracle running on the same computer Add the following variable definitions to the S
55. QS ho Oe name pattern ALL Is an alias of Listparm lists one more or all rvsXP parameters SID sid Is an alias of Listst Lists all station table entries involving station ID sid DSN dsn CMD cmd TIME hh mm ss REPEAT hh mm ss Reads operator commands from external data set DSN which must be fully qualified or executes an operator command specified in cmd if TIME is specified the operation will be rescheduled for the specified time of day if REPEAT is specified the command will be executed immediately and repeated indefinitely after the given interval has expired name value Is an alias of set parm modifies one rvsXP parameter XMT CID console id Start MasterTransmitter or one console XMT RVS END FORCE XMT END CID console id pattern Stop rvsXP Monitor normally or with FORCEDEND MasterTransmitter or one or more consoles stop xmt and stop XMT END are equivalent commands Stop without parameters stops rvsXP Monitor CMD cmd Pass command cmd to operating system for execution A1 4 Appendix 1 The rvs parameters ACTPCOUNT parameter for ActivePanel only AECCHECK BACKUPINT BBCREATE BBPRIO BRICKOFTPTI CDWAIT CMDDELETE CMDTRACE CNSMSGS CODEIN CODEOUT 14 rvs parameter overview The interval after which the statistical information about the active lines wil
56. RECVBLOCKS Send Number of blocks sent between two resuming positions for error correction Default 0 i e SENDBLOCKS from the parameter table applies SENDBLOCKS EERP Send transmission EERP End to End Response acknowledgement Values NEVER Partner does not send EERP file dispatch ends with successful transmission Do not wait for acknowledgement NORMAL Wait for acknowledgement by partner after successful file transmission File dispatch ends with receipt of EERP Default NORMAL EERP IN rvsXP User Manual Rev 2004 05 28 gedas deutschland GmbH Fachbereich rvs Systems 37 rvsXP User Manual Parameters Meaning of advanced Odette parameters Database parameter EERP OUT Receive transmission EERP acknowledgement NORMAL Prepare acknowledgement after successful reception of a file send EERP only if a connection to the partner still exists otherwise at next connection IMMEDIATE Prepare acknowledgement after successful file reception Establish connection if there is no connection to the partner and send EERP to the partner NEVER Partner does not expect EERP File reception ends with successful transmission Do not acknowledge reception HOLD Prepare acknowledgement after successful file reception However do not send acknowledgement but wait for operator release Send EERP after release only if a connection to the partner still exists otherwise at
57. RIO parameter A7 8 QZPRIO parameter 7 2 R RCVTIMEOUT parameter 50 53 rdkey dat file 20 Index rdmini dat file 62 64 96 RECBLOCKS parameter 37 Receive parameter 35 37 Received files Displaying 74 Receiver parameter 47 Receiver number parameter 46 50 53 Reception Resident receive entry 79 With code conversion 778 with ISDN 58 with TCP IP 57 with X 25 58 Record formats 6 Recreating rvsXP database 92 RECVBLOCKS parameter 41 8 A1 13 Refreshing Display 74 Displaying 74 Release Station 56 Releasing Send order 76 Remote parameter 34 Removing Jobstart entry 86 Resident receive entry 83 Send order 6 77 User 88 User entry 88 Renaming Station 55 Replacement markers 9 Requirements 70 Resident receive entry Creating 80 Displaying 80 Editing 82 Receiving 9 Removing 83 Restarting Send order 76 Restoring Database 95 rvsXP database 95 Station table 94 User table and follow on processing 94 Resumed transmission Automatic 7 RETRY parameter obsolete 41 8 RLCOMAXSIZE monitor parameter A2 1 RLCOMAXSIZE parameter A7 9 RLDBMAXSIZE parameter A7 9 rlog log file A1 74 A1 16 A2 1 RLOGMAXSIZE Monitor parameter A2 1 RLOGMAXSIZE parameter 7 9 rlstat log file A7 76 A2 1 Route tab 43 Routing 42 Set up 43 ROUTING parameter 47 9 RSTATMAXSIZE parameter A7 9 RT routing table 33 rvs batch interface 7 A4 1 rvs Monitor A4 2 Specify
58. RVSPATH 2 rvsenv dat rvsXP environment file DBNAME lt ORACLE System ID gt DBUSER lt ORACLE user DBPSW ORACLE user password gt ORACLE System ID ORACLE user and ORACLE user password have been defined during Oracle installation and configuration Note ORACLE user ORACLE user password must identical to that used by a rvsXP user with administrator rights 12 For more detailed information on the RVSPATH parameter see Chapter 1 6 Representation means 122 rvsXP HighPerformance Example RVSPATH rvsenv dat PATH c rvs DB c rvs db NIT e rvs init SYSTEM c rvs system TEMP c rvs temp USRDAT c rvs usrdat SAMPLES c rvs samples ARCDIR ce rvs arcdir KEYDIR c rvs keydir SPFILESDIR c rvs temp SPINDIR c rvs temp in SPOUTDIR c rvs temp out DBLOG N LANGUAGE D MODE p PORT 2956 SERVER blnwskk2 AP DISPLAY INTERVAL 1000 DBNAME rvsora DBUSER gkk DBPSW skk 2 rvsXP and Oracle running on two different computers If Oracle is running on an external computer this computer must be defined in the file SORACLEHOMENnetworkNadminNtsnames ora Add the following variable definitions to the SRVSPATHNrvsenv dat rvsXP environment file DBNAME lt ORACLE System ID gt DBUSER ORACLE user ORA
59. The send job will remain in the rvsXP database and rvsXP will continue attempting to send the file to the partner Your script program will be launched after each fifth unsuccessful attempt for example rvsXP only calls your script and does not perform any plausibility check Confirm your entries with OK rvsXP Administrator writes the new entry to the rvsXP database and displays it in the list of resident entries i amp rvsXP Administrator inix File Edit View Monitor Database Window 7 B xi E3 Jobstart after Send Attempt SID DSN station Virtual Dataset Program Comment C lrvsisystemisendjob bat Starts batch job sendjob bat after sen o ws 4 Stations Users Jobs Receive zi E Logs H Database Settings B 4 Start Program Press F1 to get help F5 for refresh NM 4 Editing a job start entry If you want to modify a job start entry Select the entry to be modified in the Jobstart after send attempt window Execute the menu command Edit Update The Jobstart after send attempt dialog opens and displays the properties of the entry Editthe entry properties and confirm your entries with OK rvsXP User Manual Rev 2004 05 28 85 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual Deleting a job start entry If you want to delete a resident send entry Select the entry to be deleted in t
60. al ISDN card In this configuration several applications can share the same Brick router The Brick router supports the Remote CAPI interface This means that every computer in your LAN uses the Brick router as if it were a local ISDN card in the computer rvsXP User Manual Rev 2004 05 28 13 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual X 25 connection TCP IP connection Note gedas deutschland GmbH has successfully tested the following ISDN devices for use with rvsXP Device Manufacturer Remarks EICON DIVA Server Eicon http www eicon de BRI 2M EICON DIVA Pro 2 0 Eicon http www eicon de EICON DIVA 2 0 Eicon http www eicon de AVM B1 AVM http www avm de not suitable for X 31 AVM Fritz Card AVM http www avm de only Classic and BIANCA BRICK XS BinTec http www bintec de with remote CAPI rvs Support will provide you with the current list of tested devices phone 49 30 399 71 777 telefax 49 30 399 71 994 email rvs service gedas de If you want to use rvsXP to exchange data via an X 25 type network you need the following equipment X25 network connection Interface hardware for interfacing the X 25 network in your computer Driver software for operation of the X 25 card under Windows XP If you already have this equipment then you install the X 25 interface as follows Install the interface card in y
61. ansmitted again in the event of error Choose Large values for reliable data lines in order to use the line quality for greater transmission speeds Small values for poor line quality in order to minimize the time required for repeated data transmission Tip to increase transmission speed In order to increase the efficiency during the data exchange you can use off line compression see 1 3 Encryption and offline compression and 6 3 1 Creating send orders The size of compressed ODETTE blocks is set with parameter block size OEXBUF rvsXP User Manual Rev 2004 05 28 gedas deutschland GmbH Fachbereich rvs Systems 39 rvsXP User Manual 4 1 3 Setting up the neighboring station The Connection type tab contains information about the path via which the partner station is to be reached Connection Ix 25 m Advanced 25 25 Address Link NETX25 Card o Advanced Port 0 Cancel You can use the mouse to fold out the Connection combo box and choose the desired connection type Depending on the selection made the tab below changes and shows the pertaining parameters Multiple reception The connection type defines the reception type for the local station Just as your local station can feature reception devices you can set up several connection types rvsXP supports multiple reception for TCP IP ISDN and X 25 Selftest via Advanced TCP IP ISDN
62. arameter SIDTRACE 3 Detailed tracing for all stations Default 0 LMPRIO Priority for LOG messages as external LM commands Default 20 MAXCMD Maximum number of external commands read simultaneously Default 10 MAXRECL Maximum record length for data sets with record format F or V to be received Default 99999 MAXSENDERS Maximum number of concurrent senders No sender will start if MAXSENDERS 0 Default 1 MAXX25RCV Maximum number of concurrently active or prestarted 1ist ening receiver processes for X 25 communication Default 0 MSGPRIO Send priority for operator to operator messages Default 60 NUMRLOGS Number of rlog log files that can be generated Default NOLIMIT NUMRLSTAT Numberof rlstat log files that can be generated Default NOLIMIT OCREVAL ODETTE credit value window size of OFTP Maximum number of sent blocks without confirmation Default 99 rvsXP User Manual Rev 2004 05 28 A1 7 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual ODTRACELVL OEXBUF OKPRIO ORETRY OTIMEOUT QEPRIO QSPRIO RECVBLOCKS RETRY Request line tracing between sender and OFTP 0 No tracing 1 Minimum tracing request names only for station specified in SIDTRACE 2 Detailed tracing parameter values etc for station specified in SIDTRACE 3 Detailed tracing for all stations Default 0 ODETTE exchange buffer size in bytes 1019 for UNIX and 2048 for OS 400 the largest ODETTE cmd SFID max size
63. as is without any express or implied warranty In no event will the authors be held liable for any damages arising from the use of this software Permission is granted to anyone to use this software for any purpose including commercial applications and to alter it and redistribute it freely subject to the following restrictions 1 The origin of this software must not be misrepresented you must not claim that you wrote the original software If you use this software in a product an acknowledgment in the product documentation would be appreciated but is not required 2 Altered source versions must be plainly marked as such and must not be misrepresented as being the original software 3 This notice may not be removed or altered from any source distribution Jean loup Gailly Mark Adler jloup gzip org madler alumni caltech edu If you use the zlib library in a product we would appreciate not receiving lengthy legal documents to sign The sources are provided for free but without warranty of any kind The library has been entirely written by Jean loup Gailly and Mark Adler it does not include third party code If you redistribute modified sources we would appreciate that you include in the file ChangeLog history information documenting your changes Communication module rvscom The rvs communication module connects different stations and sends or receives files MasterTransmitter xrvsxmt The MasterTransmitter of t
64. ase The job to send the readme txt to your station has been created rvsXP lists the job in the list of files waiting to be sent Go to the rvsXP Administrator The Monitor Log window shows the rvsXP Monitor activities The rvsXP Monitor reads the send job and executes it Using the LOC station ID rvsXP Monitor recognizes the own station as the target and copies the file to the C rvs usrdat folder 24 Function Tests 015 File Edit View Monitor Database Window 7 a kaLal r lt INIT_CID gt rpm Reading initial commands Ivs lt OK_READ gt RVSCNS cleanup days 3 ss yes a Stations CLNUP DEL 55 gt Cleanup of RVS data base purge all SendStatistics with DTE CLNUP START gt Cleanup of RYS data base purge all commands with DTDONE lt Users CLNUP NONE gt Cleanup of RYS data base ended there are no commands to be 15 88 Jobs XMT START gt MasterTransmitter started a g Logs SP START Service Provider started Compression yes Security no LE Monitor lt NEW_CMD_CREATED gt K 13 created by SE 12 f Statistics NEW CMD CREATED gt 1 14 created by 5 13 NEW CMD CREATED gt IZ 15 created by IE 14 Active Panel IZ DELIVERED gt 12 15 Delivery of READMERECEIVED TXT 2003 04 28 16 17 10 8 Database Stored in c rys usrdat READMERECEIVED TXT H Settings CMD TERMINATED gt IZ l5 terminated stat
65. at is found will be used Format MM DD YY HH MM SS Defaults Increasing time intervals so that rvsXP will not be kept busy trying to reach a station that may be having hardware problems For longer wait periods minutes have been added to the defaults so that retries will not occur at precisely the same time DTCONNO1 00 00 00 00 01 00 DTCONNO2 00 00 00 00 02 00 DTCONNOS 00 00 00 00 03 00 DTCONNOS5 00 00 00 00 05 00 DTCONNO7 00 00 00 00 07 00 DTCONN10 00 00 00 00 10 00 DTCONN15 00 00 00 00 15 00 DTCONN20 00 00 00 00 20 00 In addition DTCONNO is the wait period for all other commands Send transmission EERP End to End Response acknowledgement Values NEVER Partner does not send EERP file dispatch ends with successful transmission Do not wait for acknowledgement NORMAL Wait for acknowledgement by partner after successful file transmission File dispatch ends with receipt of EERP Default NORMAL Receive transmission EERP acknowledgement NORMAL Prepare acknowledgement after successful reception of a file send EERP only if a connection to the partner still exists otherwise at next connection IMMEDIATE Prepare acknowledgement after successful file reception Establish connection if there is no connection to the partner and send EERP to the partner NEVER Partner does not expect EERP File reception ends with successful transmission Do not acknowledge reception HOLD Prepare acknowledgemen
66. ations only While transfer to a remote station at a given time is possible via a particular data line only several remote stations can send the data to your station via different data lines and line protocols This is why connection parameters of the remote station always relate to one line type Depending on the station s equipment the parameters for the local station can comprise several lines and protocols Properties for Station LOC Local Station f xj r Station Station ID LOC Comment Local station Phone Odette Odette ID 00013003036GEDASRVSCC Rd Selftest via Advanced ispN x25 IP Address 100 100 030 Start Port 7 Max Sessions fe Remove Insert TCPAP ISDN x25 Cancel Use this dialog to view and edit the station properties Click the Advanced buttons in this window to open additional property dialogs for the Odette and Connection parameters areas 32 Configuration of rvsXP The abbreviations in this dialog stand for Station The parameters that identify a station locally on your computer Odette Parameters rvsXP needs for the ODETTE protocol Connection For remote stations only Connection type by which the station is reachable Self test via Corresponds to the connection with remote stations Path used to reach the local station during a self test X 25 ISDN TCP IP Detai
67. bilindustrie 36 VFTYP parameter 7 12 Virtual parameter 34 Virtual Circuit parameter 54 Virtual station Editing 55 Interactive operation 87 Receiving at 54 Removing 55 Sending from 55 Setting up 34 54 Statistics 76 Virtual channels 75 Virtual dataset name 87 85 What is 54 What is rvs 5 What rvs is not 6 Wildcards 7 2 Window areas 67 Window size parameter 37 Working with rvs parameters A1 1 rvsXP User Manual Rev 2004 05 28 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual X X 25 tab 57 X 25 address parameter 49 53 X 25 communication 74 X 25 connection 74 47 X 25 Facilities parameter 49 53 X 25 or ISDN receivers Number A7 15 X 25 reception 58 X 25 UserData parameter 49 53 XADDRESS parameter 49 53 XMCREATE parameter A1 12 A1 14 A1 16 XP X 25 ISDN table 33 Z ZIP algorithm A4 2 l 10
68. c rvs usrdat liste txt d temp Another example is to be found in the file C rvs system resentr bat Note You must not specify a binary executable file such as exe as the batch program It should be a readable and parseable file Ensure that your batch program is sensibly structured because it is not checked by rvsXP Troubleshooting tip Each time you execute an RE a copy of the batch file in which the replacement markers are replaced by your actual values is saved in the C rvs temp folder The copies are named reXXXXXX bat XXXXXX stands for a consecutive number If the behavior of a RE is incomprehensible to you you should read in the last generated copy of the batch program reXXXXXX bat file just which commands have been executed The number of the jobs XXXXXX must not exceed 32 000 Windows XP restriction rvsXP User Manual Rev 2004 05 28 79 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual Note If you want rvsXP not to save copies of the batch programs reXXXXXX bat file in the C rvs temp folder you should add the following command to your batch file DELETE DSNTEMP For more information about rvsXP replacement markers and how to define resident receive entries using the rvs batch interface rvsbat please refer to the rvs Reference Manual Displaying resident receive entry Choose Job Receiveinthe rvsXP Administrator to display resident rec
69. ck the rvsTraylcon Execute the menu command Stop rvs Monitor rvsXP Monitor stops The rvsTraylcon shows a white cross in a red circle if rvsXP Monitor is stopped rvsXP User Manual Rev 2004 05 28 61 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual Stopping from the rvsXP environment What can be customized Start settings Carry out the following steps if you want to stop rvsXP Monitor from within the rvsXP program environment while it is in operation Startthe rvsXP Administrator program in the rvs folder Execute the menu command Monitor gt Stop or e Launch the das Stop rvs Monitor program the rvs folder rvsXP Monitor stops It has been stopped if the stop symbol is not active on the tool bar 5 3 Customizing rvsXP Monitor parameters The Monitor parameters determine the operational mode of the rvsXP Monitor the main component of the rvsXP system By customizing the Monitor parameters you can modify the rvsXP Monitor in accordance with your system environment and your own requirements You should customize the Monitor parameters in order to minimize the load on your system and in order to enhance the performance parameters OCREVAL OEXBUF RECVBLOCKS and SENDBLOCKS for more information please see the Appendix The rvs parameters control the Monitor Log Book display make optimal use of data line quality monitor communication processes with ot
70. ckmark This file helps you restore the database entries that were created after the last database back up Attention This will influence the rvsXP performance and resource requirements extremely Language Language for message display German DBNAME Name of database when using an SQL database DBUSER Name of database user when using an SQL database DBPSW Password for database access when using an SQL database rvsXP User Manual Rev 2004 05 28 gedas deutschland GmbH Fachbereich rvs Systems A3 3 rvsXP User Manual A3 4 Appendix 4 Glossary Appendix 4 Glossary ASCII American Standard Code for Information Interchange Batch interface rvsbat The rvs batch interface provides functions for background processing CMX Communications Manager SINIX Dialog interface rvsdia The rvs dialog interface of provides interactive user functionality EBCDIC Extended Binary Coded Decimal Interchange Code EDI Electronic Data Interchange EDIFACT Electronic Data Interchange for Administration Commerce and Transport EERP End to End Response ODETTE term for an acknowledgement at the end of a send transmission ETSI European Telecommunications Standardization Institute FSS Forwarding Support Service rvsXP User Manual Rev 2004 05 28 A4 1 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual GNU zip algorithm This software is provided
71. commands file names path names programs examples scripts options qualifiers data sets fields modes window names dialog boxes and statuses BOLD and IN CAPITAL Parameters environment variables variables LETTERS Inverted commas Links to other manuals sections and chapters literature Bold Important terms names of operating systems proper names buttons function keys Terms and variables Program names rvsXP is the synonym of rvs for Windows XP systems rvsNT is the synonym of rvs for Windows NT systems rvsX is the synonym of rvs for UNIX systems rvs400 is the synonym of rvs for OS 400 systems Here the naming operating system is mentioned only Directories As user directories are found on different locations for the different operating systems and respective hardware software environments we use the RVSPATH variable in this manual Default values are C Nrvs for Windows XP 2000 WS 2003 and NT home rvs for AIX Solaris IRIX Linux and SCO users rvs for HP UX defpath rvs for SINIX Substitute the variable with your correct path rvsXP User Manual Rev 2004 05 28 11 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual Installation of rvsXP 2 Installation of rvsXP This chapter describes the system requirements installation of ISDN 25 and TCP IP protocols and of rvsXP 2 1 System requirements Hardware and You need the following e
72. dentification UID Note Heed upper and lowercase spelling The spelling of your rvsXP user ID must match that of the Windows XP user name To ensure this copy the exact spelling of your Windows XP user name from the Windows XP User Administration Enter the complete user name Select the language for screen dialog Use the mouse to click on the user access authorization Confirm your entries with OK Note A basic User may use the rvsXP program to send and receive files An Operator has user rights and may also execute operator commands A user with Administratorrights may in addition to this use the rvsXP Administrator program to configure the rvsXP system rvsXP User Manual Rev 2004 05 28 87 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual Removing a user User dialog If you want to remove a user Execute the menu command Edit Remove To remove the user answer the query that appears with Yes If not answer with No Editing a user To edit an existing user Select the user to be edited in the User window Execute the menu command Edit gt Update The User dialog opens You can now edit all of the user data parameters You can select German or English in the language field rvsXP will then display all the menus and messages in the selected language Note If you want to modify your own user data then the entries will only take effect after restarting the rvsXP Adm
73. e To set up a new station click the right mouse button on the free area below the station list and choose Add execute the menu command Edit gt Add The dialog window Properties for Station opens It comprises three sections with station parameters The Station area shows the parameters that identify a station locally on your computer Odette shows the parameters relevant for the ODETTE protocol The bottom section of the dialog contains the parameters for the line and the pertaining line protocol Properties for Station RST Remote Station r Station Station ID fr ST Comment Remote station via TCP IP Phone Odette Odette ID 00023003036GEDASRYSCC Advanced Send password Receive password Connection Advanced IP Address fi 23 1 234 8 Port 3305 rvsXP User Manual Rev 2004 05 28 31 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual Simultaneous reception via several lines The dialog shows depending on the feasibility of pertaining parameters different property fields for your local station and the remote stations The local station is always physically present and can never be a virtual station Neither do you need a password to communicate with your own local station This is why fields such as virtual Send password and Receive password are available for remote st
74. e by clicking the appropriate line Installation of rvsXP amp Services File Action View Help eo MehB rai amp Services Local Name Spooler Sy Protected Storage 005 RSVP rvs Monitor Start the service Remote Access Aut Remote Access Con Remote Desktop He Remote Procedure S4Remote Procedure Remote Registry Removable Storage Routing and Wis Secondary Logon Sy Security Accounts ait A Standard Double click on Monitor The rvs Monitor Properties opens rvs Monitor Properties Local Computer nana General Log On Recovery Dependencies Status Started Started Startup T Automatic Automatic Manual Manual Manual Manual Automatic Manual Automatic Manual Disabled Automatic Automatic Automatic Description Log On As Local System Local System Local System Local System Local System Local System Local System Network 5 Local Service Local System Local System Local System Local System Local System Loads Files Provides pr Provides n Creates Creates Manages a Provides th Manages t Enables re Started Started Started Started Offers rout Enables st Started Stores sec Started Local Computer window tysMonitor Service name Display name Description Path to executable c rvs system rvsmon exe Startup type Automatic
75. e Options in the New Send Entry dialog Enter the letter H in the Start Time field Confirm the entry by pressing OK rvsXP User Manual Rev 2004 05 28 75 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual Automatic repetition Removing before transmission No revoking after transmission Releasing a send order If you have put a hold on a send order you can also release it for subsequent execution To release the execution Use the mouse to click on a 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 Chapter Selecting display criteria on page 77 Release the orders selected with Release or the Edit gt Release menu command Restarting a send order rvsXP repeats an unsuccessful transmission attempt in accordance with the time specified by means of the DTCONNnnparameter You can avoid this waiting period and immediately start a new transmission attempt rvsXP Monitor then treats the send order as though you had created it for the first time To restart one or more send orders Use the mouse to click on a send order Click the Hold button or choose Edit Hold from the menu Release the orders selected with Release or the Edit gt Release menu command Deleting a send order You can remove a send order from the database If you remove a send order which has the status forwardable or held the
76. e Search the list of Services for rvs Monitor and select the service by clicking the appropriate line Services 5 File Action View Help m E u Services Local rvs Monitor Name Description Status Startup Type Log On As Sa Print Spooler Loads files Started Automatic Local System Stop the service 84 Protected Storage Provides pr Started Automatic Local System Restart the service Sis QoS RSVP Provides Manual Local System S sRemote Access Aut Createsa Started Manual Local System SisRemote Access Con Creates a Started Manual Local System S amp sRemote Desktop He Manages a Manual Local System Sis Remote Procedure Provides th Started Automatic Local System S sRemote Procedure Manages t Manual Network 5 BaRemote Registry Enables re Started Automatic Local Service 884 Removable Storage Manual Local System Sa Routing and Remot Offers rout Disabled Local System Servs Monitor Started Automatic Local System Sy Secondary Logon Enables st Started Automatic Local System Ba Security Accounts Stores sec Started Automatic Local System BR d i Extended A Standard Z Click the Stop button Windows XP will now try to end the service If the attempt is successful the rvsXP Monitor status will change to not started Stopping with Carry out the following steps if you want to stop rvsXP Monitor with the rvsTraylcon rvsTraylcon Right cli
77. e following special characters UNIX all letters digits and the following special characters ODETTE All capital letters digits and the following special characters amp CHECK RE same as ALL but it is necessary that a RE exists Default ODETTE rvsXP User Manual Rev 2004 05 28 A1 11 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual VFTYP XMCREATE The way how files with a fixed or variable format will be converted prior to transmission V_rvs internal format only useful for rvs for variable and fixed formats S Format of ft SINIX useful also for ft SINIX T Text format each line is terminated by carriage return and line feed Each line is converted into one output record The record length is defined in MAXRECL Files in the fixed or variable format can be stored as text files For this purpose you should use the VFTYP parameter VFTYP T means received files in format F or V will be stored as text files carrying a CR LF at the end of the each line You can also control this in the resident receive entry by setting the VFTYP parameter to T Files can be sent in the fixed or variable format without prior conversion by the rvsut2fv exe utility To do this you can additionally specify the record length inthe New Send Entry dialog The record length for files with the fixed format is the length of each record before linefeed CR LF for MS Windows systems or LF for UN
78. e name that is used for the ODETTE transfer and has to be agreed upon by both sides The name length must not exceed 26 characters Confirm your entries with OK The file size limit is at the moment 2 GB New Send Entry xj Station ID Lad Station ID of receiver Select File Ddocswotesdoo Search New File Name virtual file name Options Disposition delete after transmission Change Options Start Time H hold at first Label Serialization Timestamp add Format Tex C Fired Variable Unstructured Recordsize x record size in case of fixed or variable Format Input Code code of the local file amp 45 11 E EBCDIC Output Code 3 code on receivers side amp amp SCII E EBCDIC Codetable Search fal Encryption Compression save settings Cancel Help Options At the bottom of the New Send Entry dialog you will find various options that can be useful when sending a file Click the Change options button if you wish to change any of these options For details refer to the table below 70 How to work interactively with rvsXP Options Transmission settings and actions Disposition Click the delete after transmission checkbox to have files deleted on your local computer after successful transmission Otherwise it would not be deleted Start Time rvsXP sends files immediately If this is not
79. e rvsXP can the access the database a database and a user with database owner privileges for this database must have been set up on the database host Make sure to set ANSI NULL default in the database properties The SQL server must allow SQL server authentication 14 For more detailed information on the RVSPATH parameter see Chapter 1 6 Representation means 124 Appendix rvsXP User Manual Appendix 1 The rvs parameters Purpose Controlling the rvsXP Monitor function Where do find what Appendix 1 The rvs parameters The function of rvsXP Monitor and its related components may be influenced by changing parameter values To edit the rvsXP parameters from the rvsXP Administrator e rvsXP Administrator gt Settings gt Parameter 1 1 How to use rvs parameters You can use a magnitude of parameters to customize rvs processes Chapter ryg parameter overview provides a detailed description of all parameters Tips how to choose rvs parameter values are given in Chapter Description of selected rvs parameters To modify a parameter Execute the Settings Parameters command in the rvsXP Administrator The rvs Parameters dialog for editing the parameters will open In order for the TCP IP receiver to start automatically start when rvsXP Monitor starts you have to set the value of the rvsXP parameter to 1 x Parameter SECURITY n SENDBLOCKS 1000
80. ed over a network This is especially useful for none private wide area networks e g when using the internet Data may be compressed offline before network connection is established in this way network costs are significantly reduced All formats and character sets are supported You can also configure compulsory encryption Both encryption and offline compression work automatically after having been configured once on a station by station base The described features work directly between sender and receiver Routing stations conveniently forward the encrypted and compressed files Compression and encryption are available if both partner stations sender and receiver use rvs OFTP routing is not affected i e encryption does not affect the routing stations on the way On MVS systems the encryption and compression subsystem enables extended file format information which prevents loss of file format information e g block size blocked ASA Com Secure is an independent product for offline encryption and compression developed by rvs that also runs with other OFTP products other than rvs Introduction Encryption features Symmetric and The security of rvs uses both symmetric 3DES and public private key asymmetric encryption RSA Symmetric encryption uses the same key for both encryption encryption and decryption The public private key manner uses two different keys each for encryption a
81. eeeessennenseneeeeeeensenneneeeeesenseseeneeeonenes 89 7 1 Back up backing up rvsXP tables te d boo eset dran 90 7 1 1 Backing up the station tabla eet aree eu dex kg fe 90 7 1 2 Saving the user table and follow on processing 91 7 2 Backing up Backing up the rvsXP database 91 7 3 Delete and reinitialize rvsXP database 92 7 4 Restoring rvsXP data from a back up 94 7 4 1 Restoring the station table odori sie Qe Erba de Due Sud 94 7 4 2 Restoring the user table and the follow on processing 94 7 4 3 Restoring the wsxP database ciere tor oett dese cesi e gc Raga 95 7 5 Cleaning up the rvsXP database cleanup 95 8 Encryption configuration Key administration eee 97 8 1 Encryption basis er Nm 97 8 1 1 Encrypted transmission with icit 97 8 1 2 rvsXP encryption principle and procedure 98 8 2 Overview of the rvsXP key administration 101 8 3 Creating private and public keys 101 8 4 Importing Keys rvs key tp
82. eive entries The Resident Receive Entries dialog opens It displays list of the previously created resident receive entries The list is initially empty r sxP Administrator ini xi File Edit view Monitor Database Window 7 Resident Receive Entries SID DSN Station Virtual Dataset Name Program _ comment lestused m 8 Database Settings Start Program Press F1 to get help F5 for refresh Creating resident receive entries If you want to start a program when a file arrives do the following e Choose Edit gt Add The Resident Receive Entries dialog opens 80 How to work interactively with rvsXP Resident Receive Entry x Station RST hd of sending station Virtual data set name New data set Search r Replace r Disposition Record handling C Replace dataset Keep E New data set C Delete C Ignore data set Timestamp Code conversion none C Ascii gt Ebedic Ebedic gt Ascii C Table Table Program C rvs system resentr bat Comment Starts batch program resentr bat OK Cancel Help Enter the station from which you expect to receive the file The Station contains by default In other words RE applies to file reception from all stations Enterthe file or the file specification for whic
83. ely rvsXP automatically decrypts the files received 8 3 Creating private and public keys To use the rvsXP encryption function you must have created the key pairs comprising the private and the public key with the genKey tool This is an easy to use program which randomly creates a new key pair at any call You can launch the genKey program in two ways via the command prompt or the graphic interface For more detailed information on the RVSPATH parameter see Chapter 1 6 Representation means rvsXP User Manual Rev 12 03 2004 101 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual Launching via the command prompt Syntax genkey chefmopstv 768 1024 2048 owner creator from to help size private key public key Theprivate key in the dialog Private Key File and public key in the dialog Public Key File parameters stand for the files where the generated keys will be saved Only these two parameters are required to produce a new key pair The other parameters are optional The table below gives an overview of all optional parameters with explanations and default values The character in the Parameter column separates the two possible variants of the same optional parameter Examples genKey h genKey h These two calls display the genKey help Options Parameters Description Default value h help Print this message c
84. ens and displays the files in the rvsXP system folder with the LOG extension Enter the file name under which you want to save the rvsXP database Confirm the entry by clicking Open rvsXP then saves the rvs database and displays any errors in the rvs Dump Database message window Back up has been successfully completed if the message End appears Start rvsXP Monitor 7T 3 Delete and reinitialize rvsXP database First you must delete the rvsXP database contents Attention If you delete the rvsXP database you will irrevocably lose any incomplete data transmissions and all settings which you have made in the rvsXP Administrator If you are absolutely sure that you want to rvsXP reinstall your database carry out the following steps Make sure that all send and receive entries have been completed Pay attention to the send orders and receive entries which make use of the serialization function Backupthe tables which you would like to restore after initialization of the rvsXP database is complete Further instructions are contained in the Chapter 7 1 Execute the menu command Monitor gt Stop Use the preferred backup method to back up the station tables users tables and the job start entries or the entire rvsXP database For appropriate instructions please read Chapter 7 1 Delete the rvsXP database To do so start the Delete rvs Database program in the rvs program folder 92 rvsXP databa
85. erties x Delay Parallel Sessions J No Limit Active Connection Setup v Priority 1 100 rvsXP User Manual Rev 2004 05 28 gedas deutschland GmbH Fachbereich rvs Systems 41 rvsXP User Manual reserved for future use Parameters Connection parameter meaning Database parameter Delay Time in seconds to wait after receiving a file before a CDWAIT Change Direction CD is initiated Parallel sessions Maximum number of active simultaneous connections via PSESSIONS this line Default 1 no restrictions Active connection Specifies the send behavior for a pending send order AUTODIAL establishment Values Values v Sender should automatically start as soon as a file is Y v ready for dispatch N O O Pending send orders do not trigger a send action Default v Priority The priority number is planned for rvsXP updates It is PRIORITY Preparing files for fetching What is routing Without routing Establishment of an active connection It is occasionally necessary for files to be made only available and not to be sent immediately On the contrary the partner station is to establish the connection and fetch the available files as and when required The partner bears the costs for the connection Active connection establishment must be switched off for this case 4 1 4 Setting up the routing connection The forwarding of files throughout several OFTP
86. es the data does not suffer any unnoticed corruption during transmission For this purpose rvsXP calculates the checksum of a given file and encrypts this checksum using the private key The recipient station decrypts the encrypted checksum with the sender s public key and compares it with the checksum of the decrypted file A matching checksum indicates the file was not corrupted during transmission rvsXP User Manual Rev 12 03 2004 97 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual Creating a key pair Distributing public keys safely storing private keys Importing an external public key 8 1 2 rvsXP encryption principle and procedure Each participant in encrypted communication creates a key pair on his system consisting of the public key and the private key The recipient makes his public key available to all partners he expects to receive data transmissions from The respective sender thus can encrypt the data for precisely the partner who sent him the public key in question There is no security risk in openly transmitting the public key as it is not suited for decryption The partner does not share his private key and stores it in a safe place He can use this key to decrypt all data encrypted with the public key He can no longer read encrypted messages destined for him if he loses this key Once a partner has received another partner s public key he must import it into the rvsXP database
87. et of parameters Click the Advanced button to the right of the parameter input boxes to openthe TSDN Advanced dialog where you can edit these and other parameters ISDN Advanced ISDN Number 0301 234567890 25 Address 12 Karte 10 Link 551 128 Protocol Packetsize Alias Timeout x 25 Facilities x 25 Userdata Terminal Identifier Parallel Sessions ISDN Facilities ISDN Userdata Close User Group DBit THIN Receiver Number tae 48 Configuration of rvsXP Edit the parameters and click the OK button to save the changes or click the Cancel button to discard the changes The table below explains the individual parameters Parameters Meaning of parameters ISDN Database parameter ISDN number An ISDN number under which the partner station may be reached For the 1TR6 ISDN standard the single digit EndSelectionNumber ESN is assigned to the local station Default ISDNNO X 25 address 15 digit X 25 DTE address of the partner station This number is optional It is however advisable for an ISDN connection to enter the ISDN number here as some partners expect an X 25 address XADDRESS Link Link name determines the type of connection within your computer It is derived from the values for card type and card number CAPI2mn Values for m and n m A no Diehl Eicon card 0 Diehl Eicon ca
88. eters RLCOMAXSIZE RLDBMAXSIZE RLOGMAXSIZE ROUTING RSTATMAXSIZE SCPRIO SDSNMAX SDSNPRIO SECURITY SENDBLOCKS SEPRIO SIDTRACE SLEEP Maximum file size for console messages r1co log Default 200000 Maximum file size for logging of database actions rldb log Default 1000000 Maximum file size for log messages rlog log Default 2000000 Determines the global rvsXP routing behavior O OUT Routing is allowed for send jobs only The own local station must not function as a router B BOTH Standard OFTP routing routing is allowed in send and receive direction Default B Maximum file size for statistical logs rlstat log Default 2000000 This parameter refers to the cooperation between rvsXP Monitor and service provider Change after consultation with rvs Support only Default 10 Maximum size for a data set to be considered short in Kbytes units of 1024 bytes Default 100 Send priority for short data sets Default 40 Use of encryption OPT Optional Use of encryption if NO No encryption FORCED Compulsory Default OPT Number of buffers or records that the Sender sends before looking at FORCEDEND again Default 1000 The priority for new SEs should be at least as high as the highest priority of valid for SE Default 50 ID of station that shall be traced if LITRACELVL or ODTRACELVL are at least set to 1 or 2 Default is blanks If you need to trace incoming da
89. file to be sent see Chapter 6 3 1 Creating send orders Click the Search button in the Codetable area to specify the path to your own conversion table e g RVSPATH NarcdirNVrtcusr dat Result A file will be sent and converted as specified in the user code table Sending with Automatic ASCII to EBCDIC code conversion code conversion via rvsbat Create job file with ASCII to EBCDIC code conversion Example Create the job file e g job containing send c dsn lt file to be sent gt format U codein A sid lt recipient gt codeout E Start the job with rvsbat ijoborrvsbat ijob Result The ASCII file lt file to send will be sent as an EBCDIC file Code conversion with user specific code conversion tables Create a job file in which you explicitly specify the conversion tables Example Create a job file e g job containing send c dsn lt file to be sent format U sid lt recipient gt codetrans t codetable lt path and name of user code table gt Start the job with rvsbat ijoborrvsbat ijob Result file ile to be sent in the U format will be sent and converted as specified in the user code table codetrans t able indicates you are using your own conversion table 7 For more detailed information on the RVSPATH parameter see Chapter 1 6 Representation means rvsXP User Manual Rev 2004 05 28 117 gedas deutschland GmbH Fachbereic
90. g 56 Setting 56 Station table Backing up 90 Restoring 94 STATISTICS parameter 47 70 A1 16 STATNAME parameter 34 Status display 67 Stop rvsXP processes 7 4 Stop command 41 4 Stopping Monitor 67 Station 56 SYNCDL parameter A7 70 SYNCTO parameter A7 70 System command 7 4 SYSTEM environment variable A3 2 System requirements 73 T Tab ISDN 47 Route 43 TCP IP 45 X 25 51 Table NK line type 33 ODETTE parameters OP 33 Routing table RT 33 ST station 53 TC TCP IP 33 XP X 25 ISDN 33 TCP IP tab 45 TCP IP connection 74 TCP IP reception 57 TCPIPRCV parameter 46 57 A1 10 A1 15 TC TCP IP table 53 TEI parameter 50 TEMP environment variable A3 2 Test rvsXP 23 TIMEOUT parameter 49 53 TIMESTAMP parameter A7 70 TMAXCON parameter A7 70 Transmission buffer 37 Transmission time 7 Transmissions Displaying 3 Traylcon see rvsTraylcon Troubleshooting A2 2 TSTODPRCT parameter A7 70 Typographic conventions 77 U USEPKI parameter A1 11 User Backing up 91 Editing 88 Removing 88 Saving 88 User entry Creating 87 Displaying 86 Editing 86 Listing 86 Removing 88 Sorting 86 User interface 7 User rights 78 User table Backing up 91 Restoring 94 USERDATA parameter 49 53 USERFIELD parameter reserved A1 11 USRDAT environment variable A3 2 V VC parameter 54 VDA see Verband der Deutschen Automobilin dustrie VDSNCHAR parameter 38 A1 11 Verband der Automo
91. gedas rvsXP ersion 3 01 User Manual rvsXP User Manual The products listed in this manual are protected by copyright rvsXP Version 3 01 User Manual 2004 by gedas deutschland GmbH 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 1 Introduction Marce MT 5 1 1 Short description of the system eo e Feet t d ber IR ru 5 1 2 llus eL 5 1 3 Encryption and offline compression 8 1 4 E 9 1 55 Structure of the rvs documentation 22222 2 10 1 6 Representation means i oco ads nneenasen 11 2 Installation of TVSXP ossi od iie eon lax qd Dev
92. h rvs Systems rvsXP User Manual 9 3 2 Code conversion when receiving files This chapter describes how to use the code conversion for receiving files 9 3 2 1 Using resident receive entries created with rvsXP Creating a resident receive entry with ASCII to EBCDIC code conversion Startthe rvsXP Administrator with right mouse button rvsTraylIcon gt rvs Administrator or Start gt Programs gt rvs gt rvs Administrator Choose Job Receive The Resident Receive Entries window appears e Choose Edit gt Add to add a new resident receive entry Enter your resident receive entry parameters In the Code Conversion field you can define the direction of the code conversion none ASCII gt EBCDIC or EBCDIC gt ASCII the path and name of the rvsXP system code conversion table from ASCII to EBCDIC SRVSPATH8 init rtcae dat SRVSPATH system rtcae dat Press the lt Enter gt key to create the new resident receive entry Result An ASCII file received via the defined resident receive entry will be saved as an EBCDIC file Creating a resident receive entry with EBCDIC to ASCII code conversion Startthe rvsXP Administrator with right mouse button rvsTraylIcon gt rvs Administrator or Start gt Programs gt rvs gt rvs Administrator Choose Job Receive The Resident Receive Entries window appears e Choose Edit gt Add to add a new resident receive entry
93. h the RE is to apply in the Virtual data set name field Virtual data set name is the file name that is used for the ODETTE transfer and has to be agreed upon by both sides The name length must not exceed 26 characters f you want to change the file name after it has arrived enter the new file name in the New data set name field Disposition determines whether the received file is deleted or kept after reception and execution of the RE When you decide upon Disposition keep and the C rvs usrdat folder contains a file with the same name you can enable the Replace option to choose whether to replace the existing file create a new file with a unique name default or ignore the file being received Specify in the Record handling field whether the received file is to be stored as a text file with a line feed after every record This applies to files that are received in Fixed or Variable format only Select Text here if the line feed is to be switched on rvsXP User Manual Rev 2004 05 28 81 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual Inthe Code Conversion field you may specify whether a code conversion is to take place Select a special conversion table by means of Search For default conversion ASCII ISO 8859 Latin 1 and EBCDIC CECP 037 click ASCII EBCDIC or EBCDIC ASCII Use Search to select the batch program that should start when the file arrives Confirm
94. he Connection type area Your partner station is not a direct neighbor station of yours Connection Routing Route Neighbour Node nsi Priority 1 100 Cancel OK Complete the Route tab The RT database table contains the neighbor station information by means of which the station selected target station is to be reached rvsXP User Manual Rev 2004 05 28 43 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual Possible parameters are Parameters Connection parameter meaning Database parameter Neighboring nodes Station ID of partner station neighbor station which SIDNEIGHB knows the path to the target station The station ID has to be in the station table Priority Priority number of neighbor station It determines the data PRIORITY transmission route The integer value ranges between 1 and 100 The neighbor station with the lowest value comes into operation The priority at the time when the send command is prepared is decisive Sample set up of a target station The destination MAR is reached with routing via RST Setup station name MAR Setup ODETTE parameters of target station O001300 Setup connection type Routing Select neighbor station RST Properties for Station Remote Station r Station Station 10 Virtual Comment Example Station Odette Phone m Odette Odette 10
95. he Jobstart after Send Attempt window Execute the menu command Edit Remove rvsXP will ask you to confirm your delete command rvsXP Administrator ad Do you really want to delete jobstart entry 12 Yes No Ifyou are sure you want to delete the entry confirm the command with Yes With No you cancel the operation without deleting the entry For more information about the rvs batch interface rvsbat and how to define alternative resident job start entries using this interface please refer to the rvs Reference Manual 6 4 3 User administration Only those users may work with rvsXP who are registered in the rvsXP database In order to display or modify user data Open the user table in the rvsXP Administrator with User The user table contains at least the table entry for your own data V rvsXP Administrator I ini x or Database Window g Stations cmm Ey Jobs Receive Send B t Logs Database m Settings Bm Start Program Press F1 to get help F5 for refresh Sorting Use the mouse to click the column header to sort the table by any column 86 How to work interactively with rvsXP New user User dialog To set up a new user Choose Edit gt Add The User dialog opens and displays the User Table parameters x User ID Full Name Steve Miler Lanquage Engish Privileges se o Cancel Enter the user i
96. he rvs system coordinates send and receive processes to ensure the optimal use of the net capacity Monitor rvsmon rvs monitor is the main component of the rvs system It controls transmissions sent and received and initiates automatic follow up jobs if necessary ODETTE Organization for Data Exchange by Tele Transmission in Europe Get the complete description of OFTP from http www odette org A4 2 Appendix 4 Glossary OFTP 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 OSI Open System Interconnection PDF Portable Document Format Protocol To connect two different computers they have to follow the same protocol This protocol defines actions and reactions as well as the language spoken rvsXP User Manual Rev 2004 05 28 A4 3 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual 4 4 Index A Acknowledgement During reception 38 A1 6 During sending 37 A1 6 Act command 7 3 Activate Local station 27 Partner station 27 Station 56 Activate command 7 3 Activate program 7 14 Active connection establishment parameter 42 ACTPCOUNT parameter A7 5 Adaptation License key 20 Adapting Monitor parameters 63 64 AECCHECK parameter 41 5 41 15 Allowed
97. her stations manage the size and number of the log files The rvsXP database which works as a central information source provides the rvsXP Monitor with all the information required for the tasks to be executed When the rvsXP database is initialized the initialization program first creates a parameter table for the Monitor parameters with default values which determine the default behavior of rvsXP Monitor You can modify these values by editing the C rvs init rdmini dat file which is the source for modification of the parameter table in the rvsXP Monitor start phase Changes will only take effect when the Monitor is started again if you modify the file while rvsXP Monitor is in operation Dynamic modification of the monitor parameters cannot be achieved in this way 62 rvsXP Monitor Changes during operation Dynamic modification With rvsXP Administrator you can dynamically modify the parameters during Monitor operation In order to do so you have to enter individual operator commands Carry out the following steps if you want to change a monitor parameter without stopping rvsXP Monitor Click Settings gt Parameters inthe rvsXP Administrator menu tree The rvsXP Parameters dialog window for editing the parameters will open rvs Parameter x Parameter FORCEDEND 0 a MAXSENDERS 2 Double click the parameter that you want to modify Enter the desired value parameter val
98. his function Monitor and for user access In order to get the best possible performance rvsXP operates with an automatic cleanup function which removes information on completed or deleted transmissions from the database after a certain retention period Default Information about completed actions e g transmissions is deleted Immediate deletion immediately from the rvsXP database by default Parameter CMDDELETE rvsXP Administrator Settings Parameter CMDDELETE controls this function It has the value 1 by default If you want to keep information about completed actions for some time set this parameter to value 0 This does however place a burden on the rvsXP database and we therefore recommend that by default you set the CMDDELETE parameter to 1 If you want an overview of files sent and received or if you require this information for archiving purposes use the rvsXP SRVSPATH db rlstat log statistic file see Appendix Log files Retention time of The CLEANUP parameter finally determines how long such finished jobs completed jobs are to be retained in the database if CMDDELETE 0 You can determine the information retention time by using the operator command cleanup The general command is Cleanup days n ss yes no n represents the period in units of 24 hours with yes or no you specify whether you also want to delete the associated entries in the transmission statistics rvsXP User Manual Rev 2004 05 28
99. hose stations for which the parameter has not been set Values SECURITY NO Encryption is impossible The job aborts with an error message if a send job requires encryption SECURITY OPT Encryption possible as an option and can be specified in the send job SECURITY FORCED Encryption is compulsory A warning is issued and the send job is converted into an encrypted job if a send job is scheduled without encryption Reception of the file is refused if the partner station sends an unencrypted file A send job for station S is processed according to the SECURITY entry for station S regardless of whether S is a neighboring station or is reached via routing Default SECURITY OPT SECURITY rvsXP can obtain public keys from partners via LDAP Interface from a PKI public key infrastructure You can specify to use PKI instead of the rvsXP key memory for a particular station using the PKI parameter Possible values PKl YES PKl NO Default NO USEPKI Routing Determines the global rvsXP routing behavior O OUT Routing is allowed for send jobs only The own local station must not function as a router B BOTH Standard OFTP routing routing is allowed in send and receive direction Default B ROUTING Tip The greater the number the more improbable the data transmission will be interrupted for entry of the restarting positions but the greater will be the quantity of data to be tr
100. ia rvsXP and rvsbat with code conversion Automatic ASCII to EBCDIC code conversion Start the rvsXP program using right mouse button rvsTraylIcon gt rvs or Start gt Programs gt rvs gt rvsXP Choose Edit New Send Entry The Choose file to be sent dialog opens Select the desired file and confirm your selection with Open Specify other send parameters Station ID and New Name Specify the format of the file to be sent in the Opt ions area see Chapter 6 3 1 Creating send orders Specify A for ASCII as Input Code Specify E for EBCDIC as Output Code Result An ASCII file will be sent as an EBCDIC file Note If your partner station expects a file in the F fixed or V variable format you should convert it with the xvsut2 v rvsXP utility For more details on this tool and its command syntax please refer to the Reference manual Part Ill Utilities Code conversion with user specific code conversion tables Startthe rvsXP program using right mouse button rvsTraylIcon gt rvs or Start gt Programs gt rvs gt rvsXP e Choose Edit gt New Send Entry The Choose file to be sent dialog opens Select the desired file and confirm your selection with Open 116 Code conversion Specify other send parameters Station ID and New Name Specify the other send parameters Station ID and New Name Under Options specify the format of the
101. ily hold 75 SENDBLOCKS Monitor parameter 62 SENDBLOCKS parameter 37 A1 9 A1 13 Senders Number A1 14 Sending File 69 Key file 107 With code conversion 716 Sending a file 23 69 SEPRIO parameter A7 9 Serialization 7 73 SERVER environment variable A3 2 Services rvs Monitor 76 Starting 78 Startup type 77 SESSIONS parameter 50 53 setparm command 64 A1 2 A1 4 Setting Environment variables A3 7 Set up Local station 50 Partner station 30 Routing 43 SID A1 4 SID parameter 34 SIDNEIGHB parameter 44 SIDTRACE parameter 47 7 A1 9 SIDTYP parameter 34 SLEEP parameter A7 9 A1 14 SNARCV parameter 47 70 Sorting User entry 86 Sp command 41 4 SPFILESDIR environment variable A3 2 SPINDIR environment variable A3 2 SPOUTDIR environment variable A2 2 A3 2 SQL server link 121 Requirements 124 SSCREATE flag A1 16 SSCREATE Parameter A1 10 ST station table 33 Start rvsTraylcon 29 rvsXP administrator 30 Start command 41 4 Starting Dialog interface 65 rvsdiant exe 66 rvsmgr exe 65 rvsXP 66 rvsXP administrator 65 rvsXP Monitor 59 State of jobs 67 Station Activate 56 Backing up 56 Properties 31 55 Release 56 Renaming 55 Setting the status 56 Status change 56 Stopping 56 Station parameter 34 Station properties 34 Station ID parameter 34 Station list 69 Station name parameter 34 Station parameters Virtual 34 Station status Index Editin
102. inistrator Confirm your entries with OK Saving a user If you set up or modify a user use OK in order to save the modified parameters rvsXP will use the modified parameters after a restart of rvsXP Monitor If you delete the rvsXP database or reinstall rvsXP you will also delete all users Subsequent initializing of the database only retains the administrator who has set up rvsXP In order to avoid losing your entries you can save the users and the job start entries or even the entire rvsXP database and restore them later To do so please refer to Chapter Saving the user table and follow on processing on page 91 88 rvsXP database maintenance 2 ways to back up and restore 7 rvsXP database maintenance The rvsXP database is the memory of rvsXP both as to what happened in the past and what still has to be done If the rvsXP database is damaged or contains inconsistent entries files may be sent twice or not at all This chapter describes how to maintain the rvsXP database for Windows XP You will be given recommendations on how to apply strategies for backing up and restoring the database environment and entries suitable for a respective application case The following table shows the back up and restore functions implemented in the rvsXP database along with their characteristic features Method 1 covers backing up of tables and comprises the following steps Saving the station table and Saving the use
103. input boxes to open the X 25 Advanced dialog where you can edit these and other parameters x 25 Address 234567890 7 Link gt Karte o Port Facilities Userdata Timeout Parallel Sessions Close User Group hn Virtual Circuit Cancel Edit the parameters and click the OK button to save the changes or click the Cancel button to discard the changes The table below explains the individual parameters 52 Configuration of rvsXP differentiating the various recipients through which the local station can be reached Each number has a tab with a set of XP parameters rvsXP automatically assigns and manages this number Default 0 Parameters Meaning of parameters Database X 25 parameter X 25 address 15 digit X 25 DTE address of the partner station XADDRESS Specification is optional for an ISDN connection It is however advisable for an ISDN connection to enter the ISDN number here as many partners expect an X 25 address Link Link name determines the type of connection within your LINK computer It is derived from the values for port card type and card number EICONn for X 25 Eicon cards n Port number of the configured X 25 port beginning with 1 Example EICON1 NETX25mn for TECCOM cards Values form and n m Number of the X 25 card installed in the computer beginning with 0 n Port number of the configured X 25 port beginning w
104. is 99999 bytes Default 2048 Priority for operator commands Default 10 Indicates the ODETTE error group for which a retry will be initiated after a request has been interrupted Indication occurs using a bit field with each bit position assigned to a particular error code 1 means Restarting is performed 0 means Restarting is suppressed The bits stand for the following errors 1 Transmission is interrupted 2 File not found or cannot be opened 3 File cannot be read 4 File size is too big error code in SFNA permitted with repetition 5 Unspecified reason error code in SFNA permitted with repetition 6 File size is too big error code in SFNA not permitted with repetition 7 Unspecified reason error code in SFNA not permitted with repetition 8 File size is too big error code in EFNA 9 Invalid record count error code in EFNA 10 Invalid byte count error code in EFNA 11 Access method failure error code in EFNA 12 Unspecified reason error code in EFNA Default 10111000111011111111 ODETTE time out value in seconds Default 600 Priority of OE commands Default 30 Priority of OS commands should lie between MSGPRIO and SDSNPRIO Default 30 Number of buffers or records the receiver writes before closing temporary data set Default 1000 Parameter is no longer used in rvsXP Transmission repetition after unsuccessful attempt Default 00 00 00 00 01 00 A1 8 Appendix 1 The rvs param
105. it gt New Send Entry gt Options gt Format Fixed Variable gt Input Code A Output Code E The input code is A for ASCII the output code is E for EBCDIC rvsXP supports code conversion both during sending and receiving of files You can force a code conversion of received files by setting up an appropriate resident receive entry For the code conversion you can use two sorts of code conversion tables those integrated in rvsXP or your own conversion tables 9 1 Automatic code conversion with integrated conversion tables The rvsXP code conversion tables meet the following standards ASCII ISO 8859 Latin 1 and EBCDIC CECP 037 The code conversion tables are located as rtcae dat and rtcea dat files in the SRVSPATH system folder The meaning of the letters in those file names is rvs translate Conversion code EBCDIC ASCII The SRVSPATH system rtcae dat file contains the conversion table for ASCII gt EBCDIC conversion and the SRVSPATH system rtcea dat file the respective conversion table for EBCDIC gt ASCII conversion To have a conversion performed according to these conversion tables you must copy the following files to the SRVSPATH init folder SRVSPATH system rtcae dat SRVSPATH system rtcea dat For more detailed information on the RVSPATH parameter see Chapter 1 6 Representation means 114 Code conversion 9 2 Code conversion wi
106. ith 0 Example NETX2500 Card number 0 with port number 0 Default NETX2500 Facilities Special information or facilities for an X 25 transmission FACILITIES see the information of the X 25 service in use Userdata User data for an X 25 transmission see the information of USERDATA the X 25 service in use Timeout Cancellation time in seconds after which the TIMEOUT communication program aborts the connection if the partner station or CAPI does not reply Default 30 Parallel Maximum number of parallel active connections The SESSIONS sessions following applies for reception As soon as a call has been accepted the master transmitter starts a new receiver until the maximum number is reached Timeout Only valid for the local station Cancellation time in RCVTIMEOUT seconds after which the receiver interrupts the waiting for incoming calls and reconnects to the card driver Receiver Number Applies to the remote station only Number for N rvsXP User Manual Rev 2004 05 28 gedas deutschland GmbH Fachbereich rvs Systems 53 rvsXP User Manual Parameters Meaning of parameters Database X 25 parameter Closed User Group ISDN and X 25 allow for the formation of a closed user CUG group All members of such a group can communicate with each other via the public telecommunication network Connection requests to group members received from participants not being a member of the closed user group will be rejected
107. ive in transit transmitter currently processing order deleted held by the system or operator If you want to repeatedly use this setting then enable the Save Setting as Standard check box Confirm the entry by pressing OK 78 How to work interactively with rvsXP 6 4 Administration with rvsXP This chapter describes how to administrate resident receive entries jobs in rvsXP Administrator after send attempts and according to user lists 6 4 4 Resident receive entries When a file is received the rvsXP Monitor stores it in the SRVSPATHNusrdat folder Then it logs reception in the rvsXP Administrator the SRVSPATH db rlog 1log rvsXP log book Action during You can trigger other actions when receiving files by generating resident reception receive entries RE in the rvsXP database A RE specifies a program that is to start when a particular file or selection of files has arrived Example When a file with the extension TXT TXT arrives the batch program kopiere bat should start This batch program copies the received file from the C rvs usrdat user data folder to the D t emp folder copy DSN Ntemp DSN stands for DataSetName and states where the file was placed in the local file system are rvsXP replacement markers and rvsXP replaces the DSN character string by the local file name of the received file Example c rvs usrdat kontol txt Ntemp copy
108. l Rev 2004 05 28 73 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual Two display choices If you want an overview of files sent and received or if you require this information for archiving purposes use the rvsXP SRVSPATH db rlstat 1log statistic file Execute the menu command View gt Completely sent files in order to display the list of send orders which have been completed Refreshing the view If you want to update the list display then do the following Click the Refresh View button or switch to a different display mode and then back again Displaying received files You can choose between two lists to display the received files 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 To display the files announced e Choose View gt Receive 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 To display completed send orders e Choose View gt Completely received Refreshing the view If you want to update the list display then do the following Click the Refresh View button or switch to a different display mode and then back again 3 For more detailed information on the RVSPATH parameter see Chapter 1
109. l be updated The unit is the percentage of the actual file size Default 10 Checks authority to execute a command integrated in rvsXP Monitor Default 0 disabled Back up interval in minutes Default 720 Creation of user notifications BB command Default 0 disabled Priority of user notifications BB command Default 90 Time to wait for data by BRICK ISDN Adapter Default 20 Time in seconds before executing an OFTP change direction after receiving a file Default 0 disabled Removes each command and its related entries from rvsXP database as soon as command ends or is being deleted Default 1 enabled Default 0 IDs of LOG messages to be sent to operator console The following message codes are defined Action Security Error Information Line driver ODETTE Report Severe error Warning Long messages Default ABEILORSW zomor mu r Default input code local file when creating a send job Default A Default output code file at recipient when creating a send job Default X rvsXP User Manual Rev 2004 05 28 A1 5 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual DTCONNnn EERP_IN EERP_OUT FORCEDEND IEPRIO Wait periods until an unsuccessful connection attempt is repeated nn is the number of unsuccessful attempts CNTRETRY in SK There need not be a parameter for each value of nn if a particular one is not defined the next smaller one th
110. l data and restore them when needed Save the rvsXP database Chapter 7 2 Restore the rvsXP using a database dump All data and settings of the rvsXP environment are completely backed up restored Benefit One step only Disadvantage All processes including unsuccessful ones are restored normally undesired junk data is backed up restored as well Recommendation Use for regular backing up transmission data and prior to software updates We recommend that you also back up the cleaned up rvsXP environment station table user table and follow on processing Chapter 7 4 3 External database Backing up the station table Note rvsXP HighPerformance uses an external database instead of an internal rvsXP database Perform maintenance according to the conditions of this database environment For further information please refer to Chapter 10 describing the SQL server and Oracle interface 7 1 Back up backing up rvsXP tables 7 1 1 Backing up the station table We recommend that you back up the station table after rvsXP installation and prior to each setting up editing station settings You can revert to this back up if you wish to restore the previous station settings after a re initialization of the rvsXP database You thus avoid setting up the stations again A station table back up is also ideal to establish a clean initial database state in conjunction with a back up of the user table and
111. languages in messages operator console and user interfaces presently English and German The data conversion if wanted can be carried out Text files are automatically converted to the code EBCDIC or ASCII used on the target partner system The earliest date time of a transmission can be defined for each file to be transferred A serialization facility allows the transfer of files in a sequence which you can define rvs automatically generates receipt acknowledgments EERP as per the ODETTE standard and supports partner related control mechanisms during acknowledgment transmission The user can choose to have the acknowledgments immediately sent by default when suitable or after manual intervention only he can also delete individual receipts without sending them rvs supports the integration of applications and users as virtual stations These do not exist as real stations but as a representation can receive or send data rvsXP User Manual Rev 2004 05 28 7 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual Encryption even from V2 05 onwards Sender and receiver use rvs Product independent of rvs 1 3 Encryption and offline compression rvs provides powerful customizable functions that add useful features to the rvs data transmission solution rvs is able to encrypt and decrypt files in order to ensure privacy of the data when being transmitt
112. leting 6 4 2 Job start after send attempt You can trigger actions after rvsXP has attempted with or without success to send files by generating resident job start entries JS A job start entry specifies the program that is to start after the first attempt to start a particular file or a selection of files Example The batch program send job bat is to start after the third unsuccessful attempt to send a file This example is also to be found in the C NrvsNsystem folder The modified copies of the batch program are also saved in the SRVSPATHNtemp folder exactly as is the case with RE The copies are stored under the name jsXXXXXX bat where XXXXXX stands for a consecutive number You can examine these files for correctly executed commands for troubleshooting purposes The number of the jobs XXXXXX must not exceed 32 000 Windows XP restriction Note If you want rvsXP not to save copies of the batch programs jsXXXXXX bat file in the rvsXP temp folder you should add the following command to your batch file DELETE DSNTEMP rvsXP User Manual Rev 2004 05 28 83 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual Displaying job start after send attempt Choose Job Sendinthe rvsXP Administrator to display resident job start entries JS The Jobstart after Send Attempt window opens It displays a list of the previously created JS s The list is initially empty rvsXP Administra
113. losed An EERP available for dispatch during this time will be sent and the connection closed thereafter Default 120 Maximum number of concurrently prestarted 1i stening processes for TCP IP communication 0 No TCP IP receiver will be started 1 A TCP IP receiver will be started Default 1 Creation of a timestamp to distinguish data sets with the same data set name 0 000 999 three digit counter for MS DOS file names 1 000000 999999 counter 2 Thhmmss time 3 Dyymmad Thhmmss date and time 4 Thhmmssmsms date and time in milliseconds Default 2 only time Maximum number of simultaneously running operator consoles 0 no limit Default 0 Percentage of non error returns from ODETTE simulation program when rvsXP runs in test mode 1 requests prompting for return values Default 90 A1 10 Appendix 1 The rvs parameters USEPKI USERFIELD VDSNCHAR rvsXP can obtain public keys from partners via LDAP Interface from a PKI public key infrastructure To use PKI instead of the rvsXP key memory for a particular station use the rvsXP parameter USEPKI Note USEPKI is the global parameter You can specify the usage of PKI with the PKI parameter for each station Possible values USEPKI YES USEPKI NO Default NO Reserved for future application Range of allowable characters to be transferred within an ODETTE transmission ALL no restrictions OFTPUNIXS All capital letters digits and th
114. ls of the connection type chosen with Connection orSelf test Routing Parameters you need if you want to send files to an indirectly reachable station via your neighbor node The rvsXP database saves the parameters in following tables ST NK RT TC Stationtable Odette parameter line type NachbarKnoten neighbor node Routingtable X 25 ISDN parameters and TCP IP networks Enter the remaining parameters for the new station Confirm your entries with OK rvsXP User Manual Rev 2004 05 28 gedas deutschland GmbH Fachbereich rvs 33 Systems rvsXP User Manual 4 1 1 Setting up station parameters Properties for Station RST Remote Station x Station Station ID RST ituak Comment Remote station via TCP IP Phone The Station area uses three parameters to identify the station Parameters Meaning of Database station properties parameter Station ID Partner station identity marker consisting of up to 16 SID characters Station name Station name optional Enter a descriptive name for the STATNAME station so that the station will be easily recognized by the user Phone Optional telephone number for the contact person atthe PHONE partner station Virtual Indicates whether or not the station is a virtual station SIDTYP Additional information See Setting up a virtual station on page 54 Possible va
115. lues L Automatic assignment for the local station cannot be chosen as station property in the dialog V virtual selected R remote not selected remote non virtual station Default R remote not selected Note Do not confuse the optional phone number for the contact partner with the phone number used for data transmission Type the latter in the connection parameters for X 25 or ISDN depending on the connection type 34 Configuration of rvsXP For routing no passwords 4 1 2 Setting up ODETTE parameters Ddette Odette ID D0023003036GEDASRVSCC Advanced Send password pox Receive password The Odette area contains information required by rvsXP for ODETTE file transfer If you access the partner station via a neighboring station connection type Routing you do not have to enter the parameters for passwords This information has already been entered at the neighboring station In this case rvsXP ignores the existing entries during the communication process Parameters Meaning of Odette parameters Database parameter Odette Id In contrast to the station ID which only has to be unique on ODETTEID your computer the ODETTE ID is a worldwide unequivocal identification of the partner or your own station if ODETTE File Transfer Protocol is used The ODETTE ID consists of 25 characters including the letter O the 18 character o
116. 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 Supported platforms The following versions of portable rvs 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 UX 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 Linux zSeries using ISDN and TCP IP from rvsX 2 06 onwards rvsX for Solaris using ISDN and TCP IP are currently available rvsXP User Manual Rev 2004 05 28 5 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual Platforms continued Reliable transmission cross platform rvs400 for IBM OS 400 systems using LU 6 2 X 25 ISDN and TCP IP rvsNT for MS Windows NT 2000 using LU 6 2 X 25 ISDN and TCP IP rvsXP for MS Windows 2000 XP and WS 2003 using X 25 ISDN and TCP IP 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 application to application on a data record level You cannot use rvs to directly execute transfers in your own application You rather can place send orders from within you application to rvs which will be handled asynchronousl
117. n in four different display modes Display modes Send Reception Completely sent Completely received 66 How to work interactively with rvsXP Window areas Depending the rvsXP 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 dialing attempts only for sending 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 rvsXP Log Book C rvs db rlog log file The Date Time area indicates the transmission times and attempts logged by rvsXP Monitor Status display The Status field displays the progress of the send order selected or that of the order arriving Sending In the Send or Completely sent display modes the status field shows three events SE SK QE Receiving Inthe Receive or Completely received display modes the status field shows three events IZ QS Sample send order Status qq SE q SK q QE Abbr Event status Possible values status chain Send orders SE Send entry
118. n the station table in the rvsXP Administrator using the rvs Stations menu command The window Station table for managing the partner stations opens The table contains four sample stations after rvsXP has been installed ij rvsxP Administrator Stationtable loj xl 9 File Edit View Monitor Database Window 18 x allelei Station comment Odette Phone State LOC Local station 00013003036GEDASRYSCC ENABLED Remote stati ODETTEID ISDN PARTNER ENABLED Remote stati ODETTEID TCP PARTNER ENABLED Remote stati ODETTEID X25 PARTNER ENABLED 49 Database 8 Settings iz A Start Program Press F1 to get help F5 for refresh LOC is the local station If you have selected your own station ID for your local station during user defined installation of rvsXP then the station ID which you have selected will appear here 30 Configuration of rvsXP Updating a station Adding a station Note During default installation rvsXP sets up the following sample stations for the communication modes in the station table RSI is a partner station for communication with ISDN RST is a partner station for communication with TCP IP and RSX is a partner station for communication with X 25 Use the examples in order to set up your stations To update station parameters double click the station entry or execute the menu command Edit Updat
119. n 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 rvsXP database This may make sense in some cases in order to improve management of transmission activities Note The rvsXP Monitor constantly purges the rvsXP 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 database To remove a send order from the database Double click the send order 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 Chapter Selecting display criteria on page 77 Click the Delete button or execute menu command Edit gt Delete 76 How to work interactively with rvsXP Releasing or deleting an acknowledgement You must manually release automatically created acknowledgements if you have specified the HOLD or HOLDDIMMED parameters for processing EERP OUT acknowledgements for a partner station Received files are considered as having been completely received only after you have released or deleted the acknowledgement Releasing EERP release an acknowledgement for a received file choose the received file and execute the menu command Edit Release EERP Deleting EERP To
120. nd decryption Symmetric encryption is stronger from a security standpoint and the public private key encryption and decryption are more expensive than the corresponding operations in symmetric systems The primary problem with symmetric encryption is not their security but with key exchange and the number of the keys With a private and public key pair it is possible to distribute the public key by using insecure communication channels and use one key with different partner stations New key for each rvs performs symmetric encryption on the files to be sent The actual file session being sent is then encrypted using the session key and sent to the recipient The sender sends this session key secured by public private encryption to the receiver prior to file transmission It is possible to create and use private and public keys with a size ranging from 768 to 2048 bit Digital signature Furthermore rvs provides a digital document signature protecting the transmitted file against changes and verifying the ownership of the transmitted data The implementation of this feature uses a hash function SHA1 A hash function is a many to one function that maps its input to a value in a finite set This value is encrypted with the private key of the sender to guarantee the identity of the file owner Offline compression features Algorithm Compression is performed using the GNU zip algorithms rvs applies a GNU zip compression compatible with g
121. nd is to wait for incoming calls the parameter TCPIPRCV must be set to a value larger than 0 For further details read the Chapter The rvs parameters Partner stations The TCP IP address has to be unique for a send transmission to a partner station Thus you may only indicate one Internet address of simultaneously running receiving processes on this channel Default 1 Parameters Meaning of the line properties Database TCP IP parameter Receiver number Applicable and selectable at the local station only Number N for differentiating the various receiving channels through which the local station can be reached Each number has a tab with a set of TCP IP parameters rvsXP automatically assigns and manages this number Default 0 IP address Internet addresses have the form 255 255 255 255 INADDR If you have not specified a value for the local station you permit automatic definition of the Internet address If your own station has only one Internet address this field should be left empty Default Port Port address PORT Default 3305 Maximum sessions May only be selected at the local station Maximum number IN 46 Configuration of rvsXP 4 1 6 Setting up the ISDN parameters Connection ISDN Advanced ISDN ISDN Number 1234567890 Link 2 Karte 0 Advanced Protocol 1 If you have selected the ISDN connection in the Connecti
122. ne value at a time i Matches any number of arbitrary characters Matches exactly one arbitrary character Wildcards must be enclosed in single or double quotation marks For example to list the execution priorities of all commands enter listparm prio and rvsXP Monitor will list the values of BBPRIO IEPRIO IZPRIO etc When you specify the command as listparm q prio you are returned the values QEPRIO and QZPRIO Appendix 1 The rvs parameters Tip Tracing in the Monitor log 1 3 Command descriptions You can type commands in rvsXP Administrator and watch their execution in the Monitor log To do so choose Edit gt OperatorCommand Square brackets in the command descriptions indicate optional parameters Curled brackets and pipes list alternatives Activate SID sid Ac is an alias of act ivate Activates a partner station An rvsXP communication program starts and establishes the connection Queued data sets will be transmitted Cleanup DAYS n SS YES Physically delete all commands from the database that have been executed or logically deleted at least n days ago exactly n x 24 hours cleanup DAYS 0 deletes all executed and deleted commands If SS YES is specified all old SendStatistics records are deleted Delcmd CN cn Delete command with command number cn logically from database Delst SID sid Delete station ID s id
123. network connection on the X 25 tab You may be ready to receive for a partner station via several X 25 numbers at the same time You must specify the parameters shown in this tab to make the X 25 connection work Local station Selftest via x25 m Advanced Xe 25 Address 1234567890 Start Link EICON gt Cad fo Advanced Pork o Remove Insert TCPAP ISDN x25 Cancel rvsXP supports multiple X 25 reception through various receiving channels phone numbers at the same time You can add additional X 25 parameter sets on your local station LOC using the X 25 button below the X 25 tab rvsXP User Manual Rev 2004 05 28 51 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual 1 set of parameters only Press the Remove button to delete the currently displayed set rvsXP will automatically assign an internal consecutive number for the recipient when you add a new record Note Enable the Start checkbox to activate the receiver If the configured recipient is to be automatically active after rvsXP Monitor has been started and should wait for incoming calls the parameter MAXX25RCV must be set For further details read Chapter ISDN X 25 reception Partner stations The call number has to be unique for a send transmission to a partner station Thus you may only indicate one set of parameters Click the Advanced button to the right of the parameter
124. next connection HOLDIMMED Prepare acknowledgement after successful file reception However do not send acknowledgement but wait for operator release After the release Establish connection if there is no connection to the partner and send EERP to the partner Default IMMEDIATE Recommended NORMAL Release acknowledgement again See Handling files to be sent and received on page 75 EERP OUT Allowed characters Stipulates which characters are permitted for Odette FTP ALL no limitations OFTPUNIX all capital letters digits and special characters UNIX all letters and figures and the special characters _ deg ODETTE all capital letters figures and special characters amp and blanks CHECK RE as with ALL in addition a resident receive entry RE must be present Default ODETTE VDSNCHAR Compression Type of compression during the transfer NONE the ODETTE blocks are not compressed ODETTE the ODETTE blocks are compressed following the ODETTE standard RVS no longer up to date has no effects Default ODETTE FLAGCOMP 38 Configuration of rvsXP Parameters Meaning of advanced Odette parameters Database parameter Encryption Defines whether or not encryption is to be used during file transmission Make this setting either for all stations in rdmini dat or for each single station in the ODETTE parameter configuration The monitor parameter is applied to t
125. nitor parameters can be found in the Appendix The rvs parameters Savethe file and close the text editor Display the Monitor Log window in the Log gt Monitor ofthe rvs tree in the xvsXP Administrator Stop and start the rvsXP Monitor Read the action messages They begin with A Each setparm command in the initialization file triggers a parameter modification when the rvsXP Monitor is restarted Note Statically modify only those parameters which are to permanently differ from the rvsXP standard setting You want to monitor a transmission line temporarily in order to trace errors In order to do so modify the LITRACELEVL parameter to 3 using the Settings Parameter command and reset it again using this command after you are done with monitoring Please refer to the Appendix The rvs parameters for more detailed information in particular on additional operator commands and optimizing rvsXP 64 How to work interactively with rvsXP 6 How to work interactively with rvsXP Function overview The following functions are available for the interactive usage of rvsXP Create send entries for the transmission to one or more recipient at a definite time display the status of your transmissions Delete send entries as long as rvsXP did not begin to process them Create resident receive entries in order to define how to save or handle arriving files Create send job entries in order
126. nslation Exchange Buffer Input fasci Size o Output fasci Credit o EERP Transmit Blocks In NORMAL Send Out HOLDIMMED Receive 0 Security Allowed Chars ODETTE PKI ves Routing IN ad Cancel 36 Configuration of rvsXP Parameters Meaning of advanced Odette parameters Database parameter Exchange buffer size Maximum transmission buffer size Default 0 i e OEXBUF from parameter table applies OEXBUF Exchange buffer credit Maximum number of blocks sent without acknowledgement expected Default 0 i e OCREVAL from parameter table applies OCREVAL Code translation input Input format of the file which is to be sent prior to conversion for the partner station Values ASCII The files which are to be sent are in ASCII format EBCDIC The files which are to be sent are in EBCDIC format Default ASCII CODEIN Code translation output Target format of the files for send transmission Values ASCII During transmission rvsXP converts the files which are to be sent from input code format into ASCII format EBCDIC During transmission rvsXP converts the files which are to be sent from input code format into EBCDIC format Default ASCII CODEOUT Receive Number of blocks sent between two restarting positions for error correction Default 0 i e RECVBLOCKS from the parameter table applies
127. nsmission End of Transmission Send Attempt at 2003 04 28 23 28 41 dataset wont be deleted after successful transmission New Send Entry Delete Hold Release Press F1 for help F5 for refresh Select Refresh 23 28 rvsXP Monitor reads the send order at the next read cycle and executes it In the example rvsXP Monitor recognizes through the LOC station ID that the own station is the target and copies the file to the c rvs usrdat folder Note You can view the activities of rvsXP Monitor in the rvsXP Administrator inthe Monitor LOG window v rvsXP Administrator Monitor Log O1 xi Fie Edit View Monitor Database Window 2 1 81 121210 SP START gt Service Provider started Compression yes Security B el m XTCPIP READY gt 1696 TCP IP Receiver ready to accept incoming calls Port lt g Stations lt LGU gt XMT COMPROC FINI 11 communication processes are finished NEU CMD CREATED gt 5 43 created by SE 42 6 Users NEW CMD CREATED gt IE 44 created by SK 43 Shy Jobs NEW CMD CREATED gt IZ 45 created by IE 44 B E Logs IZ DELIVERED IZ 45 Delivery of NOTES DOC 2003 04 28 23 28 12 received Monitor Stored in cr rvs usrdat NOTES DOC Statistics CMD TERMINATED gt IZ 45 terminated status e NEW CMD CREATED gt Q5 46 created by 44 E Active Panel CMD TERMINAT
128. nversion 9 Code conversion ASCII and EBCDIC 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 EBDIC Extended Binary Coded Decimal Interchange Code ASCII is the standard code for UNIX and DOS Windows Systems EBCDIC for OS 400 and OS 390 operating systems While the assignment of digits and letters of the Latin alphabet is standardized within each of these two code families special characters like square brackets or national language characters like accented letters or umlauts may be assigned to different codes in different code pages within a family The Odette FTP standard and so rvs distinguish between text files format T and non text files F V and U formats Text files are always transmitted in ASCII stipulated by the ODETTE protocol and automatically delivered in the local system specific code of the target system where required Non text files are transmitted as is without conversion unless you specifically request code conversion on the sender and or recipient side Example 1 Text files are coded in ASCII on a Windows XP computer and in EBCDIC text file an OS 390 system Direction rvsXP 2 rvsMVS A rvsXP station is to send a text file to a rvsMVS station To be recognized as a text file this file must be sent in the text format right mouse button rvsTrayIcon gt rvs
129. o use another user account for the rvsXP service The installation program creates the rvs folder inthe All Programs start menu folder along with the required links icons to rvsXP applications Tip Read the Readme txt file before you start the rvsXP Administrator Start the rvsXP Administrator After your acknowledgement the rvsXP Administrator generates the rvs database This database is required to operate rvsXP The program Init Database initializes this database and saves it in the database folder rvs db Specifying rvsXP Monitor startup mode The rvs Monitor service provides the applications with information on the current data exchange processes Note The term Service means a program that can be started from the operating system and works in the background Depending on your choice during the rvsXP installation the startup type for this service is Automatic or Manual The user must manually start the service if the Manual startup type was chosen The rvsXP Monitor is at first set to stop in this case If you want to start rvsXP Monitor every time the system starts you can set the startup type to Automatic by choosing Automatic from the combo box in the Startup type area e Choose Start gt right mouse My Computer gt Change a setting Launchthe Start gt Control Panel gt Administrative Tools Services program Search the list of services for rvs Monitor and select the servic
130. of the LITRACELVL and ODTRACELVL parameters are larger than 0 Tracing can dramatically reduce performance because a lot of data has to be analyzed formatted and written into the trace file For normal operations tracing should be disabled i e both parameters should be set to 0 CNSMSGS controls which LOG messages are echoed to the operator console All messages whose code letter is included in the character string value of CNSMSGS are written to the console all messages are always logged independent of the value of CNSMSGS The additional message types O ODETTE L line driver and for long messages can also be used STATISTICS controls the creation of the statistic log file STATISTICS 1 creates the SRVSPATH db rlstat 1og It contains a line for each sent or received file with name date time and sender receiver ID STATISTICS 2 creates the same file but with extended information e g the file name for the transmission virtual file name the file size and command numbers for SE SK or TE LZ STATISTICS 3 is the same as STATISTICS 1 but routed file transfer will also be logged e g SID of destination station and SID of source station STATISTICS 4 is the same as STATISTICS 2 but routed file transfer will also be logged simultaneously STATISTICSz5 means a detailed output in SRVSPATHNdbNrl1stat 109g with new parameters such as file format state of transmission and number of dial in attempts STATISTICS 6 produces a
131. on type area you can edit the line parameters for the network connection on the DN tab You may be ready to receive for a partner station via several ISDN numbers at the same time You must specify the parameters shown in this tab to make the ISDN connection work Local station Selftest via ISDN Advanced ISDN ISDN ISDN Number 1234567890 Start Link CAPI2A Karte 0 Advanced Protocol Epssi Remove Insert ISDN x25 Cancel rvsXP supports multiple ISDN reception through various receiving channels phone numbers at the same time You can add additional XP parameter sets for ISDN on your local station LOC using the ISDN button below the ISDN tab rvsXP User Manual Rev 2004 05 28 47 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual 1 set of parameters only Press the Remove button to delete the currently displayed set If you add a new record then rvsXP will automatically assign a number for the recipient Note Enable the Start checkbox to activate the receiver If the configured recipient is to be automatically active after the rvs Monitor has been started and should wait for incoming calls the parameter MAXX25RCV must be set For further details read Chapter ISDN X 25 reception Partner stations The call number has to be unique for a send transmission to a partner station Thus you may only indicate one s
132. ons can be restricted by the NUMRLOGS monitor parameter The rlstat 1log statistics file For each sent rvsXP writes statistics information to the C rvs db rlstat log received file file This file contains a line for each sent or received file with name send receive date and time and sender receiver station ID Other information such as transmission file name file size and command number can be logged for archiving purposes The rvsXP STATISTICS parameter rvsXP Administrator gt Settings gt Parameter gt STATISTICS with values ranging from 1 to 7 controls the degree of detail in the statistics file Choose Settings gt Statistics to view the file contents Its maximum size is restricted by the RLSTATMAXSI parameter The file is renamed by assigning a consecutive number as extension and creating a C rvs db rlstat 1log file when this size is reached You can restrict the maximum number of files generated with the NUMRLSTATS parameter rvsXP User Manual Rev 2004 05 28 A2 1 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual Log file for troubleshooting 2 2 Troubleshooting The rvssp program being a new addition to the rvs set of programs provides the compression and encryption features This program saves protocol files in the SSPOUTDIR folder and deletes them after successful job completion In case of an error the program will not delete the protocol file which i
133. or with the rvsTraylcon command right mouse button rvsTrayIcon gt rvs Administrator choose Start All Programs gt rvs gt rvs Administrator inthe rvsXP folder The rvsXP Administrator then opens with the Monitor Log window displaying the current rvsXP Monitor activities ziBixi m Fie Edi View Monitor Database Window 2 8 x amp o v Bj xj lt COPYRIGHT gt rvsXP3 01 00 gedas 2004 All rights reserved BH INIT gt rpm Reading initial commands g Stations lt 0K_READ gt RVSCNS cleanup days 3 ss yes Users CLNUP DEL 55 gt Cleanup of RYS data base purge all SendStatistics with DTEND CLNUP START gt Cleanup of RVS data base purge all commands with DTDONE lt 2C CLNUP NONE gt Cleanup of data base ended there are no commands to be XMT START gt MasterTransmitter started SP START gt Service Provider started Compression yes Security no E Statistics TCPIP READY gt 1696 TCP IP Receiver ready to accept incoming calls Port 33C Active Panel lt LGW gt XMT COMPROC FINI 11 communication processes are finished 8 8 Database B Settings ic Start Program Press F1 to get help F5 for refresh 4 1 Setting up rvsXP stations Before you can communicate with a partner station you have to set up the partner station and your local station The same also applies to your partner e Ope
134. our computer and attach it to the X 25 network connection according to the installation instructions that came with the X 25 card Make sure that the X 25 connection works properly To do so use the X 25 diagnostic or operating software provided by the card manufacturer Note gedas deutschland GmbH has successfully tested the following X 25 cards for use with rvsXP EiconCard EICON Technology Corporation cards manufactured by TECCOM Ltda Rua da Assembleia 10Gr Centro Rio de Janeiro RJ Brasil Connectionto The TCP IP protocol is required for exchanging data using rvsXP and also for internal rvs communication For the data exchange you have to do the following Install the network hardware with which you want to connect your computer to the network For more detailed information consult the documentation provided by your hardware supplier Installation of rvsXP Display Network Connections Start gt Control Panel gt Network Connections The right window section displays existing dial in and network connections Click the right mouse button on the desired connection and choose Properties Choose the Network tab when you have chosen a dial in connection Windows XP automatically installs the TCP IP protocol If the TCP IP protocol is not contained in the list shown Click the Install button Highlight the TCP IP protocol in the window displayed and confirm your selection with OK Highlight the TCP
135. period 34 month v C 10244 bit Key Info Owner not specified Creator not specified Generate After setting all parameters click the Generate button to generate a new key Note An explanation of the parameters has been given in the previous chapter Creating private and public keys 8 4 Importing Keys rvskeyimp The rvskeyimp tool imports a key into the rvsXP database To import a key it is necessary to provide the name of the file containing the key with full path and the ID of the station SID for which the key shall be used The tool rvskeyimp reads the file containing the key copies it into the directory containing all imported keys see rvsenv dat parameter and writes all necessary information into the rvsXP database Table SV S Keys V Administration You can launch the rvskeyimp program via the command prompt or the graphic interface rvsXP User Manual Rev 12 03 2004 105 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual Launching via the command prompt Syntax rvskeyimp i FILE s lt SID gt Options i FILE Import the key from file FILE where FILE must be specified with its full path s lt SID gt The station ID for which the key will be imported Example rvskeyimp i C rvs usrdat A15A13 pri s LOC rvskeyimp i C rvs usrdat A15A13 pub s RSL Graphic interface To impo
136. q f p SK Send command ces q i QE Acknowledgement receipt sent by recipient Reception arrival IE Information entry about incoming information g f p e IZ Information delivery to the recipient q f QS Acknowledgement transmission back to uy Oe y va sender ip pDr rvsXP User Manual Rev 2004 05 28 67 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual It is always possible to exit Note 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 The meaning of the values no event q queued not yet processed by Monitor forwardable waiting for transmission process 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 Exiting rvsXP You can exit rvsXP 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 rvsXP Monitor continues to process your send orders and places arriving files into your user directory The next time you start rvsXP you can display the progress of your send orders and any files which may have arrived To
137. quipment in order to operate rvsXP SOI Are cc PC i386 platform 300 MHz clock rate at least 128 MB RAM and 1 5 GB of free hard disk space Microsoft Windows 2000 WS 2003 XP Professional or later Communication line based on ISDN TCP IP X 25 Hard disk storage for data transmission Recommended value at least twice the size of the files to be transmitted Internal communication is based on TCP IP For this purpose the TCP IP protocol must be installed Instead of a network adapter the MS Loopback Adapter can be used 2 2 Connection type installation ISDN connection If you want to use rvsXP to exchange data via the ISDN network you need the following equipment ISDN type telephone connection with s bus having at least two data channels B channel and one control channel D channel SDN adapter CAPI 2 0 driver software for operation of the ISDN card under Windows XP This is how you install the ISDN interface Install the ISDN card into your computer and attach the ISDN card to the ISDN connection Make sure that the ISDN card works properly Note Many card manufacturers supply suitable software for a self test such as a call from one data channel to another Restart your computer after installation and the test in order to make the CAPI 2 0 driver available for other applications External If you use an external ISDN router e g BinTec Brick you do not need ISDN router an intern
138. r Senders A1 14 X 25 or ISDN receivers 41 15 NUMRLOGS Monitor parameter 42 7 NUMRLOGS parameter A1 7 NUMRLSTAT parameter 7 7 NUMRLSTATS Monitor parameter A2 1 OCREVAL parameter 37 A1 7 A1 13 ODETTE Explanation of terms A4 2 Odette A4 2 File Transfer Protocol 35 A4 3 Identification 35 ODETTE Id parameter 35 ODETTE parameters 35 ODETTE parameters table 33 ODETTEID parameter 35 ODTRACELVL parameter 41 8 A1 9 A1 16 OEXBUF parameter 37 39 A1 8 A1 13 Offline compression 8 111 Configuration 777 Features 9 OFTP A4 3 OKPRIO parameter A7 8 Online compression 7 Opcmd command 7 4 Open System Interconnection 44 3 Index Oracle link 127 Orders See also Command ORETRY parameter 41 8 OSI 44 3 OTIMEOUT parameter 7 8 OUT parameter 38 Output code parameter 37 P Parallel sessions parameter 42 50 53 Parameters ACTPCOUNT 7 5 AECCHECK A1 5 A1 15 Allowed characters 38 AUTODIAL 42 BACKUP A7 5 BBCREATE A1 5 A1 15 BBPRIO 41 2 Block size 37 39 BRICKOFTPTI 41 5 CDWAIT 42 A1 5 Closed User Group 50 54 CMDDELETE 95 A1 5 A1 14 CMDTRACE A7 5 CNSMSGS 41 5 A1 16 Code translation 37 CODEIN 37 A1 5 CODEOUT 37 A1 5 Compression 38 Connection 47 Connection type 40 CUG 50 54 Delay 42 DTCONNnn 41 6 DTCONNxx A1 14 Editing A7 7 EERP IN 37 A1 6 EERP OUT 38 A1 6 Establishment of an active connection 42 FACILITIES 49 53 FORCEDEND 41 6 A1 9 genKey 102 IEPRIO A1 2
139. r enter the password twice and acknowledge with OK The service will now be assigned to this user and has the same rights Starting rvsXP Monitor for the first time Double click on the xvs Monitor service Click on the Start button Windows XP will now try to start the service If the attempt is successful the rvsXP Monitor status will change to Started The entry is IESUS Started Automatic Installation of rvsXP After installation 2 4 The rvsXP program environment The rvsXP installation program creates a folder with all links required for the rvsXP program environment The following table shows the program functions and the link instruction with the respective parameters You can start the program by invoking the associated link at the command prompt Start gt All Programs gt Accessories gt Command Prompt or by using the command Start gt Run Program Function information Link command prompt command or Start Run Init Database Initializes the rvsXP database LOC is the standard station ID for your own local workstation C rvs system rvsiniNT exe LOC Get Machine ID Reads a three or four character machine identification number and displays it on the screen C rvs system rvsgmid exe rvsXP administrator Graphical configuration administration and operating program for the rvsXP administrator C rvs system rvsmgr exe anticipated data arrive rv
140. r table and the tables for follow on processing Method 2 covers backing up the entire rvsXP database settings after configuration station table Chapter 7 1 1 and user table and follow on processing Chapter 7 1 2 Restore Recommendation benefits disadvantages Backing up Backing up the Perform back up immediately after database creation and setting up of stations users and follow on processing Repeat back up each time changes are made to the station table the user table and the follow on processing Database cleanup Recommended procedure T Important Verify whether or not current back ups of station table user table and follow on processing are available Step 1 Delete and reinitialize rvsXP database Chapter 7 3 Step 2 Restore the station table Chapter 7 4 1 Step 3 Restore the user table and the follow on processing Chapter 7 4 2 Benefit Database cleanup Disadvantage Transmission data is deleted from the database Recommendation To restore to specific start conditions and for regular database maintenance Note This method does not preserve the parameters Restart TCPIPRCV or MAXX25RCV rvsXP User Manual Rev 2004 05 28 gedas deutschland GmbH Fachbereich rvs Systems 89 rvsXP User Manual To Back up Restore Recommendation benefits disadvantages Back up al
141. rator using the Stat ions command Double click the station entry or choose the station to be edited and execute the menu command Edit Update The dialog window Properties for Station opens It comprises three sections with station parameters You may now edit all the station parameters with the exception of the station ID Please refer to Chapter 4 1 1 Setting up station parameters for further information Edit the station properties and confirm your entries with OK Renaming a station Renaming rename a station In order to do so open the station table in the rvsXP Administrator using the Stations command Choose the station to be renamed and execute the menu command Edit Rename or Click the station to be renamed with the right mouse button and choose Rename The Rename station dialog opens Type a new name and confirm your entries with OK rvsXP User Manual Rev 2004 05 28 55 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual Setting the status Activate Default setting set working Stopping Saving settings Setting the status You may activate stoporset a station working To change the status of a partner station Select the station to be changed in the window station table Activate In order to activate the station execute the menu command Edit Activate Note The station must already be Enabled before you can activate it
142. rd n Number of the X 25 card installed in the computer beginning with 0 Example CAPI200 Diehl Eicon card number Default CAPI200 LINK Protocol Specifies the ISDN standard used 1TR6 German national standard E DSS1 EURO ISDN Standard E DSS1 ISDN_PROT Packet size Size of date packets during data transmission L2PACKETSZ Alias Alias name to be used in rvsXP Monitor and in the LOG files ALIAS or RECV ALIAS Timeout Cancellation time in seconds after which the communication program aborts the connection if the partner station or CAPI does not reply Default 30 TIMEOUT X 25 Facilities Special information or facilities for an X 25 transmission see the information of the X 25 service in use FACILITIES X 25 UserData User data for an X 25 transmission see the information of the X 25 service in use USERDATA rvsXP User Manual Rev 2004 05 28 gedas deutschland GmbH Fachbereich rvs Systems 49 rvsXP User Manual Parameters Meaning of parameters ISDN Database parameter Terminal identifier Only required for X 31 Terminal End Identification Default 0 no TEI assigned ISDN TEI ISDN Facilities Special information or facilities of the ISDN transmission ISDN FAC ISDN UserData User data for the ISDN transmission ISDN USRDT Closed User Group ISDN and X 25 allow for the forma
143. re without having to start at the beginning of the file all over again the Receiver periodically closes the incoming data set Both Sender and Receiver store the number of transmitted bytes or records in the database The frequency of these actions is determined by parameters SENDBLOCKS and RECVBLOCKS Reopening and positioning a large data set involves quite a number of disk access operations and therefore is very time consuming So if most of your communication lines are very stable you may want to set these parameters to very large values effectively disabling the restart feature of rvsXP SENDBLOCKS If on the other hands most of your lines tend to break down every few minutes you will want to make sure that whatever has been transmitted once will not have to be transmitted again Note that a large value of SENDBLOCKS may also increase the time before senders terminate after Monitor has been stopped Defaults have been chosen so that rvsXP will work securely and with most options enabled 1 6 Safety resource consumption and performance RECVBLOCKS Besides RECVBLOCKS und SENDBLOCKS which have been discussed above there are several other parameters that influence the balance between safety resource consumption and performance OCREVAL OCREVAL recommended window size 99 and OEXBUF recommended size 4096 bytes influence the overhead incurred by the ODETTE protocol The higher these values the less overhead They will however
144. reich rvs Systems rvsXP User Manual Properties for Station LOC Local Station Station Station ID JLOC Comment localstaion Phone Odette Selftest via Advanced ISDN x25 IP Address 192 193 0 1 Start Port 3305 Max Sessions 5 Remove Insert TCPAP ISDN x25 Cancel Click the tab at the bottom for the connection you wish to perform a line test with Note Partner stations have only one tab here Specify all line data Heed the following for TCP IP the IP address set for your network interface card for ISDN the correct phone number for X 25 the correct X 25 address Check the Start box Confirm your entries with OK Stop and restart rvsXP Monitor 26 Function Tests Check the output in Monitor Log A message must indicate the chosen connection is ready to receive v rvsXP Administrator Monitor Log E ini xi Fie Edit View Monitor Database Window 2 18 S m lt COPYRIGHT gt rvsXP3 01 00 gedas 2004 11 rights reserved 21 19 ws INIT CMD gt rpm Reading initial commands g Stations lt 0K_READ gt RVSCNS cleanup days 3 ss yes nm Users CLNUP DEL 55 gt Cleanup of RVS data base purge all SendStatistics with DTEND lt 2003 B By Jobs lt CLNUP_START gt Cleanup of RYS data base purge all commands with DTDONE lt 2003
145. rganization ID and the 6 character computer address within the respective organization The computer address may be freely determined by the organization and must be unique Send Send password rvsXP sends this password to the partner PSWTO station as access authorization Receive Receive password rvsXP permits the partner station to PSWFROM have access with this password The local station does not display the password fields as no access authorization is required for communication with one self For a partner station you must agree on send and receive passwords with your partner The partner must interchange the passwords during sending and receiving see the illustration below Communication aborts when transmission is attempted if the passwords do not match and you receive an error message rvsXP User Manual Rev 2004 05 28 35 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual Station 1 Station 2 Password Password Send Send Receive Receive Note You receive your personal ODETTE organization ID upon request from Verband der Automobilindustrie Abteilung Logistik VDA phone 49 69 97507 283 Fax 4969 97507 300 rvsXP executes transfer with default values for the ODETTE file transfer protocol OF TP To view the default values or to change them click the Advanced button The Odette Parameter window will open with advanced configuration options Odette Parameters x Code Tra
146. rt the keys into the rvsXP database choose the Import symbol in the rvsKey dialog to launch the rvskeyimp tool 30 rysKey O File Tools Help Import Delete Generate 2 stations Info BP Loc cm B as ey 8 ast 51 Filename no file entry in the database Creator Owner Creation Time Version Serial Number Mode Version i Type B private m Run of Validity Begin End m import a new key entry Select the station for which the import should take place and than click the Import symbol 106 Encryption configuration Key administration The Select File dialog appears Select File Directory system am lecale30 pri locale30 pub File Name Rsx30 pub File Filter rvs Keyfiles pub pri Cancel Select the file containing the key or write the file name in the File Name field of the Select File dialog Click the OK button to import the key 8 5 Distribution of keys rvskeydst To enable the communication partner to receive and decrypt data intended for him the data must have been encrypted with his public key This why the sender needs the recipient s public key Exchange of public keys can be done by e mail mail fax disk or as well with rvs The rvskeydst tool sends a key file to a communication partner You must specify the name and the full path
147. rvs documentation consists of the following manuals The User Manual contains all important steps about installing and configuring rvs It shows you how to transfer files and handle the rvs database and describes integrated features such as rvs encryption off line compression and code conversion For this purpose the rvs administrator has unrestricted access to all functions The rvs user has access to all functions dealing with the transmission and reception of files The Reference Manual is the common manual for rvs portable rvsX rvsNT rvsXP rvs400 It contains descriptions of the C Cal interface rvscal the rvs batch interface rvsbat and of the rvs utilities mostly for rvsX rvsNT and rvsXP Furthermore this manual contains information on the technical background of rvs This manual describes all messages and error codes which could be displayed on the rvs Monitor and in the log file The User Manual and the Reference Manual are available as printed and as electronic documents PDF The Messages and Return Codes Manual is only available as electronic document Introduction 1 6 Representation means This chapter contains the description of the typographic conventions which are used in this manual and the explanation of the expressions which are marked Typographic conventions Instructions begin with a bullet Other lists begin with the en dash Character styles Courier Commands menu
148. ryption data such that user information is still contained but no longer readily readable This method is called encryption There are two types of encryption methods Symmetrical Symmetrical procedures apply the same key for data encryption and method decryption Owners of the respective key can encrypt data and decrypt them at any time This method ensures fast encryption but a low degree of security as the partners must agree on the key to be used for decryption and exchange it in an insecure environment Asymmetrical Asymmetrical methods use a complementary key pair One key is used methods for encryption while the other is used for decrypting the data You cannot use the key used for encryption for decryption These methods are very safe but require a high degree of computing power during encryption and decryption and may increase the data volume by up to 10096 The nondisclosure of the key required for decryption is a security advantage of the asymmetrical method Only the recipient is in possession of the key 8 1 1 Encrypted transmission with rvsXP rvsXP combines both benefits The high speed of the symmetrical method and the security level offered by the asymmetrical method rvsXP uses the following methods 3DES as symmetrical method length 3x56 bit 168 bit RSA as asymmetrical method length 768 to 2048 bit Electronic signature To enhance the degree of security rvsXP uses an electronic signature The signature ensur
149. s MasterTransmitter rvsxmt how many Senders may run concurrently When this number has been reached it waits until a Sender terminates before starting the next one No Sender will be started at all if MAXSENDERS is set to 0 This is useful if only the partner station is to establish the connection and fetch the queued data sets Use the activate command to send data to a specific station even if MAXSENDERS is set to 0 For more detailed information on the RVSPATH parameter see Chapter 1 6 Representation means A1 14 Appendix 1 The rvs parameters 1 6 2 Limiting the number of concurrent X 25 or ISDN receivers You must specify the number of concurrently active X 25 and ISDN receivers A small number is adequate for low traffic a higher number is required if you must be able to receive data on several connections in parallel However there cannot be more X 25 receivers than virtual channels are available on your X 25 multichannel In the case of ISDN there cannot be more receivers than B channels are available Because senders also occupy virtual channels or B channels in ISDN respectively the number of concurrent receivers should be limited to half the total number of channels MAXX25RCV MasterTransmitter rvsxmt uses the MAXX25RCV parameter to determine how many receivers must run concurrently It prestarts as many X 25 ISDN receivers as specified by the parameter If a receiver terminates MasterTransmitter will start a
150. s a private key named TC2private and a public key named TC2public The length of the keys will be 1024 bit and they will be valid three months beginning with the actual day genKey c Fischer f 01 06 2001 t 01 12 2001 s 2048 WOl pri WOl pub Generates a key pair with the creator Fischer and with a size of 2048 bit The valid period starts on June 1 2001 and ends on December 1 2001 rvsXP User Manual Rev 12 03 2004 gedas deutschland GmbH Fachbereich rvs Systems 103 rvsXP User Manual Graphic interface Start rvsKey with e Start gt Run and type rvskey or Start the program rvsKey inthe rvs folder Start gt Programs gt rvs gt Encryption Key Administration or Start the program in the rvsXP Administrator with Start Program gt Key Admin In the rvsKey dialog you can call the genKey program by choosing the Generate symbol to generate a new key pair rvsKey The Generate New Keypair dialog opens 104 Encryption configuration Key administration Generate New Keypair Filenames Private Key File c irysisystem locale30 pri Public Kev File c rvsisystemilocale30 pub iml m Begin of Validity Key Size start today 00 00 00 LITC C 768 bit C start now 1024 bit C begn 2124 Feb v 2004 C 1280 bit C 1536 bit m End of Validity C 1792 bit C end 212 Feb gt 20055 C 2048 bit
151. s then available for troubleshooting The rvsenv dat file defines the SSPOUTDIR environment variable You can also use the rvsXP Administrator to set the value for this environment variable by choosing Settings Environment For further information please refer to Environment variables A2 2 Appendix 3 Environment variables Appendix 3 Environment variables You can adapt the rvs environment to meet your requirements e g modification of the folder in which the Monitor stores the received files To modify the rvsXP system environment Choose Edit gt Environment The rvs Environment dialog opens and displays the current environment settings rvs Environment c rvs samples eo rys keydir c rys temp out butech xpide cirvsNarcdir DBNAME Confirm your changes entries by pressing OK Note Any changes will only take effect after rvsXP Monitor is restarted rvsXP User Manual Rev 2004 05 28 A3 1 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual Meaning of the environment variables Designation Meaning of the environment variable Default value PATH Main rvsXP folder and location of rvsenv dat C rvs environment file SYSTEM System folder with all program C rvs help batch files and libraries system DB Folder of the rvsXP database C rvs db USRDAT Folder for
152. sXP Graphical user interface for the rvsXP C rvs system rvsdiant exe user The tool for daily data exchange Batch Program for processing batch jobs when C rvs system rvsbat exe Delete Database Deletes the rvsXP database C rvs system rvsdbdNT exe Monitor parameters Opens the file with initialization commands notepad exe C rvs init rdmini dat Readme file Opens the readme file with the latest information that is not included in this manual notepad exe C rvs system README TXT Stop rvs Monitor Stops the rvsXP Monitor C rvs system rvsstop exe rvs Console Command prompt window for displaying messages and entering operator commands Has been replaced by the Monitor Log in the rvsXP Administrator MDI window C rvs system rvscns exe Dialog rvsXP DOS prompt for creating and receiving send orders Has been replaced by rvsXP C rvs system rvsdia exe rvsXP User Manual Rev 2004 05 28 gedas deutschland GmbH Fachbereich rvs Systems 19 rvsXP User Manual Contact 2 5 Howto obtain a license During installation a license key file rdkey dat is copied to the SRVSPATH init folder After initial installation rvsXP can be operated for test purposes without a license for a limited period of time If you are satisfied with rvsXP and would like to continue working with it contact your sales representative or the rvs support phone 49 30
153. same label in the correct sequence rvsXP will not start a serialized transfer until it has received the acknowledgement EERP for the previous transmission This will ensure transfer in the specified order 6 3 3 Displaying send requests and received files Displaying send orders Two display choices You can choose between two lists to display the send orders 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 Choose View gt Send to display the send orders which have not yet been completed The list of completed send orders displays those files which have been successfully transmitted and acknowledged by the recipients Note You can however view completely sent files only if the rvsXP CMDDELETE parameter has the value 0 CMDDELETE 0 means that old successful transfers remain in the rvsXP database and can also be viewed If this parameter in rvsXP has the value 1 only uncompleted transfers are displayed All successful transfers are deleted from the rvsXP database in order not to overload the database unnecessarily The CLEANUP parameter finally determines how long such finished jobs are to be retained in the database if CMDDELETE 0 This does however place a burden on the rvsXP database and we therefore recommend that by default you set the CMDDELETE parameter to 1 rvsXP User Manua
154. se maintenance Delete rvs Database x Save Entries Jelete v Stations Close User n Jobstart Help Parameter m Messages Dumping Stations done 0 Dumping Parameter done 0 Dumping User Dumping Resident Receive Entries RE s Dumping Jobstart Entries J5 s Dumping Jobstart Entries an Users done 0 Delete rvs data base in c rvs db System command del c db DB ended with rc 0 System command del c srvessdb s ID 2 ended with re 0 Backing up selected Prior to the delete operation you can save selected entries entries prior to Click the entries to be backed up in the field Save entries In this deleting case you will be asked under what name the entries are to be saved Depending on the type of entries two different file types are created When backing up User and Program start the specified file name is given the extension _ job The entries can be read in again with the menu command Database gt Import and or Database Import of Jobstart Entries and User after the rvsXP database has been created again Deletion has been successfully completed if the message ended with RC 0 appears Reinitializing Initialize the rvsXP database To do so start the Init Database the database program in the rvs program folder rvsXP will then generate a completely new rvsXP database After ini
155. ser Manual Example Example Example 9 3 2 2 Using resident receive entries created with rvsbat Creating a resident receive entry with ASCII to EBCDIC code conversion Create a job file that creates a resident receive entry Create a job file e g job containing resentr cdsn lt received ASC file gt codetrans e sid lt Sender gt Start the job with rvsbat ijoborrvsbat Result An ASCII file received via the defined resident receive entry will be saved as an EBCDIC codet rans e file Create a resident receive entry with EBCDIC to ASCII code conversion Create a job file that creates a resident receive entry Create a job file e g job containing resentr c dsn received EBCDIC file gt codetrans a sid Sender Start the job with rvsbat ijoborrvsbat Result An EBCDIC file received via the defined resident receive entry will be saved as an ASCII codet rans a file Creating a resident receive entry with user specific code conversion table Create a job file that creates a resident receive entry Create a job file e g job containing resentr c dsn received EBCDIC file gt codetrans t codetable lt user code table e g SRVSPATH NarcdirNrtcusrdat sid Sender Start the job with rvsbat ijoborrvsbat Result A file received via the defined resident receive entry will be converted
156. systems is referred to as routing If you would like to send a file via several systems then the send order only has to be directed to the recipient rvsXP then sends the file to the next OFTP system the neighboring node which in turn then forwards the file All stations must defined in the station administrations of all stations involved Data flow with and or without routing is depicted in the following illustrations Local station station Neighbour 42 Configuration of rvsXP With routing Local Neighbour Target station station station Acknowledgement When the file has arrived at the end system it sends an EERP acknowledgement End to End Response back to the original sender The send order is only completed as soon as the sender has received this acknowledgement Prerequisites You have to define 2 stations inthe station table for routing the neighbor station neighbor node through which the end recipient is reached It must have been set up prior to the target station and the target station for the end recipient Select Rout ing as the connection type on the Connection type tab for this station and the station ID for the neighbor station on the Route tab This is how you set the stations for routing Choose the station from the station table as usual and double click the entry in the list or execute the menu command Edit Update e Choose Routing as connection type t
157. t after successful file reception However do not send acknowledgement but wait for operator release Send EERP after release only if a connection to the partner still exists otherwise at next connection HOLDIMMED Prepare acknowledgement after successful file reception However do not send acknowledgement but wait for operator release After the release Establish connection if there is no connection to the partner and send EERP to the partner SYNC Maintains the connection until the EERP has been generated after successful delivery Default NORMAL Halts rvsXP Monitor Immediate cancellation even if the transmitter and receiver are active Note The Monitor will immediately stop if the parameter is set to 1 Default 0 Priority of commands Default 50 A1 6 Appendix 1 The rvs parameters INITCMDS Executes initialization commands Default 1 turned on IZPRIO Priority of IZ commands Default 40 KEEPDAYS Number of days after which deleted and ended commands and their related information may be discarded during database cleanup Default 7 LDSNPRIO Send priority for long data sets Default 50 LID Local station ID Default LOC supplied during rvsXP database initialization LITRACELVL Request line tracing between OFTP and network 0 No tracing 1 Minimum tracing line driver events etc for station specified in parameter SIDTRACE 2 Detailed tracing incl hex dump of data for station specified in p
158. t the line start Start rvskeydel at the command prompt and the l parameter to pipe the output into a file Example C rvs system rvskeydel ex 1 DelFile txt Remove the comment indicator REM from those keys you wish to delete Assign the file executable rights e Start the file from the command prompt You can launch the rvskeydel tool via the command prompt or the graphic interface Launching via the command prompt Syntax rvskeydel ldur Options 1 Generate a list of all key entries d KEYID Delete key with the ID KEYID m Remove the public key F Remove the private key 108 Encryption configuration Key administration Example of a generated key list REM SID LOC DATEBEGI DATEEND 2001 04 25 02 00 00 N 2001 01 25 00 00 00 REM rvskeydel d 1074002581 REM SID LOC DATEBEGI DATEEND 2001 04 25 02 00 00 ms N 2001 01 25 00 00 00 REM rvskeydel d 1074002581 Example rvskeydel 1 Lists all key entries rvskeydel d 103456734 u Removes the public key with the ID 103456734 Graphic interface To delete the keys from the rvsXP database choose the u symbol in the rvsKey dialog to launch the rvskeydel tool Delete rvsKey inl File Tools Help 5 Import Delete Generate 2 Boc Info LOC di Key ID 948 6222 UR FDAF49CF SID
159. ta SIDTRACE must be set equal to the local station ID LID The delay in seconds rvsXP Monitor waits during idling until it searches the database for new commands to be executed again Default 30 rvsXP User Manual Rev 2004 05 28 A1 9 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual SNARCV SSCREATE STATISTICS SYNCDL SYNCTO TCPIPRCV TIMESTAMP TMAXCON TSTODPRCT Enables start of SNA Transaction Program automatically on incoming calls 0 No transaction program will start 1 The transaction program starts Default 0 Creates a send statistics record for each transfer attempt Default 0 disabled Creates a send statistics record in the statistics log file r Lstat log for UNIX and Windows XP No statistics log file Short form Detailed form of statistics Short form of statistics inclusive routed transfers Detailed form of statistics inclusive routed transfers New parameters such as file format state of transmission number of dial in attempts 6 Statistics about deleted entries also by the user 7 Statistics about deleted entries and routed transmissions Default 2 detailed statistics enabled akhoOnNnD Oo When EERP_OUT SYNC Delay in ms until rvsXP checks whether EERP is available for dispatch Default 500 When EERP_OUT SYNC Number of wait procedures Example SYNCDL 400 SYNCTO 5 rvsXP waits for a maximum of 5 times 400 ms until the connection is c
160. ta set SRVSPATH db rlog Log to be able to look at these messages because the dialog interface will be unable to display any information about completed transfers Consider using this option for continuous unattended operations The rvsXP Monitor reaction time to new events is determined by SLEEP This may influence for example how long it takes before the Monitor starts acting on an operator command SLEEP is the period of time in seconds that rvsXP Monitor is suspended when there is nothing to do for it The longer you choose this period the less it will interfere with your other applications but the longer you may have to wait before rvsXP Monitor starts processing your requests The shorter you choose this period the higher is the unproductive overhead produced by scanning the rvsXP database when there is nothing to do The time until rvsXP Monitor restarts an unsuccessful or aborted transmission is determined by the DTCONNxx parameters The smaller these values the sooner the transmission will start after the line is up again However the more computer time may have been wasted on unsuccessful attempts until the line is restored 1 6 1 Limiting the number of concurrent senders You may want to limit the number of senders that rvsXP is allowed to execute at the same time if your system is very busy or when you know that one or more of your neighbors cannot accept more than a few incoming calls at the same time MAXSENDERS tell
161. table is the number 0 defines the input code and the number located on this position is the output code for the same character The following example will illustrate this Example understand it you need an ASCII code table an EBCDIC code table and the rvs conversion tables rtcae dat rtcea dat We assume you wish to perform an ASCII gt EBCDIC code conversion for the small letter r This character is assigned the decimal value 114 in the ASCII code table The number 114 defines the position of the decimal value for the small letter r in the rt cae dat code conversion table in the EBCDIC table So you can find at the 114th position number 0 is Oth position inthe rtcae dat file the number 153 representing the value for the small letter r in the EBCDIC table One more example A On the 65th position in the SRVSPATH system rtcae dat file is the number 193 being the EBCDIC decimal value for the capital letter A In the opposite direction you can find ASCII code 65 for A on the 193th position in the SRVSPATH system rtcea dat file rvsXP User Manual Rev 2004 05 28 115 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual Sending files with code conversion via rvsXP 9 3 How to perform a code conversion The following examples show how to perform a code conversion when receiving and sending files 9 3 1 Code conversion when sending files This chapter describes how to send files v
162. terminate rvsXP choose File gt Exit 68 How to work interactively with rvsXP 6 3 How to send and receive files with rvsXP Overview This chapter describes how to interactively send and receive files with rvsXP First it will be explained how you can create send requests The next chapter describes how you can display sent and received transmissions The last chapter shows how to edit send and receive data sets 6 3 1 Creating send orders To send a file to a business partner e Choose Edit gt New Send Entry from the menu You can also execute this command by using F2 or by clicking New Send Entry The Choose file to be sent dialog box opens Choose file to be send Look in B docs ce E File name notes txt Files of type All Files Cancel Select the file which you would like to send to your partner and confirm your selection with Open Example C docs notes txt The New Send Entry dialog opens and displays the file name selected in the File field Manually enter the station code for the receiving station in the Station ID field Or e Choose Select to open the Select Station dialog and select the ID rvsXP User Manual Rev 2004 05 28 69 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual Example LOC To send the file to your partner under a different name enter the new file name into the New Name field It is the fil
163. th user code tables The rvsXP user can use his own code tables instead of using the system code tables for code conversion The input code CODEIN output code CODEOUT parameters as well as the code table CODETABLE are of importance for code conversion Start gt Programs gt rvs gt rvsXP gt Edit gt New Send Entry gt Options The Input Code parameter defines the code of the file before conversion and the Output Code parameter is the code after the conversion The code table parameter allows you to use your own table for code conversion To use the user specific code tables you have two possibilities 1 You define all three parameters input code output code and code table See Chapter 9 3 How to perform a code conversion for more detailed explanations on code conversion during receiving and sending 2 You define Input Code and Output Code only and copy your own conversion table to the SRVSPATH init folder You own conversion table must be named rt cae dat or rtcea dat rvsXP will only recognize files named according to this convention as conversion tables 9 2 1 Structure of the code conversion tables If you intend to create your own code conversion tables these should have the same structure as rvs system code conversion tables SRVSPATH system rtcae dat and SRVSPATH system rtcea dat These code conversion tables have 256 decimal numbers 8 bit The position in the table Oth position in the
164. tialization all tables contain the default rvsXP settings Restore the tables desired from the backup files which you made earlier For appropriate instructions please read Chapter 7 4 Start rvsXP Monitor rvsXP User Manual Rev 2004 05 28 93 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual 7 4 Restoring rvsXP data from a back up When you have performed a back up with one of the back up procedures you can restore the station table the user table together with the tables for follow on processing or the entire rvsXP database See rvsXP database maintenance on page 89 7 4 4 Restoring the station table To restore the station table Start rvsXP Monitor Execute the menu command Database gt Import gt Stations Select file with station definitions dialog opens and displays the files with the dat extension in the rvsXP system folder Select the file which contains the station table which is to be restored Confirm your selection by clicking Open Restoration of the data has been successfully completed if the Monitor LOG window contains the message ok cmd done RVSCNS modst terminated 7 4 2 Restoring the user table and the follow on processing Carry out the following steps if you want restore data for the user table and follow on processing StoprvsXP Monitor Execute the menu command Database gt Import gt Jobstarts amp Users
165. tion of a closed user group All members of such a group can communicate with each other via the public telecommunication network Connection requests to group members received from participants not being a member of the closed user group will be rejected by the switching exchange The same applies to connection requests from group members to participants not being a member of the closed user group This service attribute is called Closed User Group CUG CUG Rev Timeout Only valid for the local station Cancellation time in seconds after which the receiver interrupts the waiting for incoming calls and reconnects to the card driver RCVTIMEOUT Parall sessions Maximum number of parallel active connections The following applies for reception As soon as a call has been accepted the master transmitter starts a new receiver until the maximum number is reached SESSIONS Receiver number Applies to the remote station only Number of the receiver accepting the call from the remote station Each number of the local station has a tab with a set of XP parameters Default 1 50 Configuration of rvsXP 4 1 7 Setting up X 25 parameters Connection 3 25 m Advanced 25 X25 Address 234567890 Link cad fo Advanced 0 If you have selected the 25 connection the Connection type area you can edit the line parameters for the
166. to trigger actions if files are successfully sent or could not be sent Delete or modify resident receive and job send entries 6 1 Starting rvsXP Administrator rvsmgr exe Logging onas rvsXP Administrator is used for configuring managing and administrator operating rvsXP It comprises several detail windows The configuration system and rvsXP requires administrator user rights at system level and in the rvsXP environment Start the 5 Administrator program by launching itin the rvs folder or with the rvsTraylcon or useStart gt All Programs gt rvs gt rvsXP Administrator The rvsXP Administrator opens with the Monitor Log window displaying the current rvsXP Monitor activities Ie rvsXP Administrator Monitor Log ini xi BH File Edit View Monitor Database Window 2 la x a lez CCC lt COPYRIGHT gt rvsXP3 01 00 gedas 2004 11 rights reserved H vs INIT CMD gt rpm Reading initial commands g Stations lt 0 gt RVSCNS cleanup days 3 ss yes n Users CLNUP DEL 55 Cleanup of RVS data base purge all SendStatistics with DTEI B fi Jobs CLNUP START gt Cleanup of RVS data base purge all commands with DTDONE lt E Receive CLNUP NONE gt Cleanup of RVS data base ended there no commands to be 1 XMT START gt MasterTransmitter started Send SP START gt Service Provider started Compression yes Security EB g
167. tor la xl File Edit view Monitor Database Window 7 815 station Virtual Dataset Name Program Comment lastused 8 Stations Users Ey Jobs E Receive oem B g Logs H Database E Settings amp Start Program Press F1 to get help F5 for refresh Creating a job start entry If you want to start a program after an attempt to send a file do the following e Choose Edit gt Add The Jobstart after Send Attempt dialog window then opens Jobstart after Send Attempt x Station Virtual data set name r Jobstart after c pct ENCE Send attempts af Success 2 c rvs spstem sendjob bat Program Comment Starts batch job sendjob bat after send attempt OK Enter the station you want to send the file to 84 How to work interactively with rvsXP Enter the file or the file specification for which the JS is to apply in the Virtual Data Set Name field Virtual Data Set Name is the file name that is used for the ODETTE transfer and has to be agreed upon by both sides The name length must not exceed 26 characters Use Search to select the batch program that should start after the attempt to send the file f you want the program to start in the event for example five unsuccessful attempts select Error and specify the number of unsuccessful attempts after which the program it to start under Send Attempts
168. ue into the input field and click Apply Use Close to exit the parameter list A complete list and description of all the monitor parameters can be found in the Appendix The rvs parameters Example MAXSENDERS 2 rvsXP User Manual Rev 2004 05 28 63 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual Changes with restarting Example With this example you indicate that a maximum of 2 senders transmit data at the same time Confirm your entry with Apply Use Close to exit the parameter list This operation transfers the command into the rvsXP database When restarted rvsXP Monitor will read this command and use the modified parameter Stop and start rvsXP Monitor to activate the parameter right away Static modification You can also customize the monitor parameters by making entries in the rdmini dat file It is read every time rvsXP Monitor restarts and the orders and commands it contains are executed Carry out the following steps if you want to permanently modify one or more monitor parameters e Openthe C rvs init rdmini dat file To do so click the Monitor Parameters icon the rvs folder The file contains predefined operator commands rvsXP Monitor executes each time it starts Commands for modifying the monitor parameters begin with set parm comment lines with Editthe file in accordance with your requirements A complete list and description of all the mo
169. ure of the rvs manuals and defines the target group It explains the typographic conventions used in the present manual 1 4 Short description of the system What is rvs rvs Rechner The abbreviation rvs stands for the German word Rechner Verbund Verbund System System The rvs computer communication system is a well established base service for electronic data interchange EDI rvs serves to ensure transmission of electronic data between heterogeneous computer platforms using different network protocols To do so rvs implements a universal network model which you can configure in each network node rvs provides an efficient and reliable transport service for both standardized EDI message types and files of any format or contents You can receive ony such files that are explicitly destined for rvs This means that rvs does not allow any unauthorized access to remote or to own data files 1 2 History The system was originally developed by Volkswagen AG and has been used in the German and European automobile industries for a number of years but also by banks insurances and industry worldwide rvs uses the OFTP protocol An extension to the OFTP standard was developed for Volkswagen AG It has been enhanced by a line driver for SNA LU 6 2 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
170. us NEW CMD CREATED gt Q5 16 created by 14 CMD TERMINATED gt IE 14 terminated status e NEW CMD CREATED gt QE 17 created by QS 16 CMD TERMINATED gt 05 16 terminated status e CMD TERMINATED gt QE 17 terminated status e CMD TERMINATED gt SK 13 terminated status SE SENT gt SE 12 successfully sent C rvs system readme txt for Ke CMD TERMINATED gt SE 12 terminated status gm Start Program X Press F1 to get help F5 for refresh NM Check the output in Monitor Log for error messages Eliminate any errors that occur in accordance with the advices in the Messages and Return Codes manual Note Error messages start with E and are written in red 3 2 Testing the connection with the local and the partner stations To ensure proper functioning of the network link you can use a self test to check the local station s connections Perform the following steps first for the local station When the self test was successful you can perform a connection text with a particular partner station Preparing the local Open the station table with the Stations menu command stator The window Station table for managing the partner stations opens Select the local station Double click the station entry or choose Edit gt Update to edit the station rvsXP User Manual Rev 2004 05 28 25 gedas deutschland GmbH Fachbe
171. user files received C rvs usrdat TEMP Temporary folder for the log book C rvs temp INIT Folder for the initialization files e g rdmini dat for CONTES rvsXP monitor parameters init SAMPLES Folder for files for the programming interface with examples C rvs samples KEYDIR Folder containing the private and public key files of local C rvs and partner stations keydir SPINDIR Internal Service Provider SP working folder containing the C rvs job files to be processed compression encryption and temp in code conversion SPOUTDIR Internal Service Provider SP working folder containing the C rvs job processing result files log files You can use the log temp out files for troubleshooting see also Log files Chapter Troubleshooting SPFILESDIR Internal Service Provider SP working folder containing the C Nx xv s job files used during job processing temp SERVER URL or name of local server IP address of the local PC PORT Server port number for line status messages 2956 ARCDIR Folder for back up files C rvs arcdir AP_DISPLAY Interval in milliseconds in which the display for active lines 1000 _INTERVAL is updated A3 2 Appendix 3 Environment variables Designation Meaning of the environment variable Default value DBLOG Writes entries to the rvsXP database Yes No No rvsXP logs all database operation in the C NrvsNdbNrlstat log file when you enable this che
172. ute the menu command Database gt Export gt Jobstarts amp Users The Select Backup File dialog opens and displays the files in the rvsXP system folder with the LOG extension Enter the file name under which you want to save the tables Confirm the entry by clicking Open rvsXP saves the tables and displays any errors in the rvs Dump Jobstart Entries and User dialog Backing up has been successfully completed if the message END appears Start rvsXP Monitor 7 2 Backing up Backing up the rvsXP database This method backs up the entire rvsXP database and all rvsXP parameters The backup contains the complete current rvsXP environment state i e the station table the user table and the follow on processing as well as logs of all transmissions including aborted and not completed processes You can revert to this back up if you wish to restore the previous system state after a re initialization of the rvsXP database In most cases this will rvsXP User Manual Rev 2004 05 28 91 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual Backing up the complete database Delete rvs database not be a clean initial state but rather an unmaintained state of the user environment which is disadvantageous and not desired in practice To back up the entire rvsXP database Stop rvsXP Monitor Execute the menu command Database gt Export The Select Backup File dialog op
173. vsXP user rights Logging onas ThervsXP Administrator is used to configure and manage rvsXP administrator and also for working with rvsXP To be able to perform these tasks the rvsXP Administrator features appropriate detail windows The rvsXP configuration requires that you have Administrator privileges at system level as well as in the rvsXP environment Program start with rvsTraylcon Tip Using The installer sets up the rvsTraylcon that facilitates launching the most rvsTraylcon frequently used rvsXP functions After a Windows reboot you find this icon in the system tray 11 39 To display the rvsTraylcon right after installation e choose Start gt All Programs gt rvs gt rvs rvsTrayIcon Use the rvsTraylcon to start the rvsXP Monitor stop the rvsXP Monitor start the rvsXP Administrator and open the rvsXP dialog where you can view and edit the rvsXP data transmission Start rvs Monitor Skop rvs Monitor rvs Administrator rvs Close rvsTrayIcon To start the rvsXP programs with the rvsTraylcon click the rvsTraylcon with the right mouse button and choose the desired menu item by clicking it with the left mouse button rvsXP User Manual Rev 2004 05 28 29 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual Monitor log window Configuration example Starting the rvsXP Administrator configuration program Start rvsxXP Administrat
174. with the user defined code table 10 For more detailed information on the RVSPATH parameter see Chapter 1 6 Representation means 120 rvsXP HighPerformance 10 rvsXP HighPerformance SQL server and In order to efficiently master the continuously growing flow of data and to Oracle link increase the performance level of rvs the internal rvs C ISAM database can be replaced with a high performance database On Windows NT 2000 WS 2003 XP AIX and LINUX systems of version 2 05 and later there is the option to link to an Oracle database Windows NT 2000 WS 2003 XP systems of version 2 11 and later can be linked to a Microsoft SQL Server rvsXP license License key rvsXP license key file SRVSPATH init rdkey dat must include the letter O in the Included Components line to start rvsXP with Oracle link To start the SQL Server link you must specify Q 10 1 Configuration of ORACLE Requirements To install rvsXP High Performance you must have a fully functioning Oracle database at least version 8 1 7 To run the Oracle database on a UNIX system your configuration file e g profile has to be expanded with Oracle compatible definitions of environment variables Configuration file are two examples of the configuration file for LINUX and AIX Example LINUX systems with Oracle environment variables LINUX ORACLE OWNER oracle export ORACLE OWNER ORACLE HOME opt oracle product 8 1 7 export
175. x25 ISDN 2 IP Address 1001 00 0 90 Port 2305 Max Sessions 5 Remove Insert ISDN x25 Cancel 40 Configuration of rvsXP Parameters Connection parameter meaning Database parameter Connection this The connection type with which the station is to be reached PROTOCOL parameter is visible only Values Values if the partner station is TCP IP The partner station is reached via a network with T TCP IP configured the TCP IP protocol X X 25 ISDN ISDN The partner station is reached via an ISDN line Routing X 25 The partner station is reached via X 25 line Routing The partner station uses a different partner station as a routing station Enter the routing station ID in the RT Routing tab The connection type and parameters of the routing station then apply to the connection itself For further information please refer to Chapter Setting up the routing connection Default none Self test via May only be selected at the local station Line by which PROTOCOL transmission is to be made if the self test is performed when your own station is activated Receiver May only be selected at the local station Receivers which No parameter have been configured and or are still to be configured Use the Advanced button to the right of where you choose the connection to open the Connection Properties dialog providing more parameters Connection Prop
176. y rvs is not a job scheduling system rvs does not care about the contents of the files it is transporting It only acts as a transparent transport medium and performs no semantic interpretation of the data it carries rvs is not an EDI converter You can however purchase additional components for converting between s Specie message formats e g VDA ODETTE EDIFACT XML using rvs as transport service via gedas deutschland GmbH rvs is not a network control or monitoring tool Basic rvs functions The main function of rvs is the reliable transfer of files rvs is suitable for transferring both large files and many small files rvs supports communication between different networks with many stations based on different platforms In other word rvs supports various data formats The key features of rvs are The Monitor the central rvs component controls all work to be done rvs works asynchronously You place a send order with rvs rvs executes this send order as fast as possible Benefit You or your application need not wait for the transmission to terminate The connection to the communication partner is automatically established when necessary The automatic submission of jobs after reception of a file is controlled by means of resident receive entries follow on processing Usage of file name user IDs and station IDs is supported The file transfer is possible for
177. your entries with OK rvsXP Administrator writes the new entry to the rvsXP database and displays it in the list of resident entries i rvsXP Administrator File Edit View Monitor Database Window 5 ne 1 x ax PGi 510 sy Virtual Dataset Name Comment TXT n resentr bat ont Arv stemiresentr bat Starts batch progran a ws 8 Stations Users E58 Jobs _ Receive C Send m f Loss mij Database m f Settings iG Start Program Press F1 to get help F5 for refresh Editing resident receive entries To edit a resident receive entry Select the entry to be modified in the Resident Receive Entries window Execute the menu command Edit Update TheResident Receive Entries dialog opens and displays the properties of the entry Editthe entry properties and confirm your entries with OK 82 How to work interactively with rvsXP Removing a resident receive entry To remove a resident receive entry Select the entry to be deleted in the Resident Receiv Entries window Execute the menu command Edit Delete rvsXP will ask you to confirm your delete command rvsXP Administrator Do you really want to delete resident receive entry For station RST and virtual dataset name TXT Yes No If you are sure you want to delete the entry confirm the command with Yes With No you cancel the operation without de
178. zip rfc 1952 The compression method reduces the data size in the best case down to a level of 30 and essentially never expands the data Only very small files grow in size due to the process information added The compression is independent of the CPU type operating system and character set and performs an integrity check of the decompressed data 1 4 Target group For rvsXP users This manual is meant for regular users of rvsXP as well as and administrators administrators It provides an overview of the basic rvsXP functions and also background information on rvs9 The rvsXP concept generally does not require an administrator There are however tasks that cannot do without manual intervention There is for example the very important task of maintaining the database This requires regular cleanups and backups 1995 1998 Jean Loup Gailly and Mark Adler for more information see Glossary rvsXP User Manual Rev 2004 05 28 9 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual User Manual Reference Manual Messages and Return Codes Manual Media To use rvsXP the following skills are required good knowledge of the current operating system knowledge of the communications techniques in use X 25 native communications and or ISDN native communications TCP IP Before starting to work with rvsXP it is advisable to have read this book 1 5 Structure of the rvs documentation The

- ServiceNet

Contents

Download Pdf Manuals

Related Search

Related Contents