Home
rvsXP Benutzerhandbuch - ServiceNet - T
Contents
1. AP I Eile Edit Wiew Monitor Database Window 8 x elek h lt SP_START gt Service Provider started Com ion g pression yes Security no g m Ivs lt TCPIP_READY gt 1696 TCP IP Receiver ready to accept incoming calls Port g Stations lt LGW gt lt XMT_COMPROC_FINI gt All communication processes are finished lt NEU_CMD_CREATED gt SK 43 created by 5E 42 fP Users lt NEW_CMD_CREATED gt IE 44 created by SK 43 oy Jobs lt NEW_CMD CREATED gt 12 45 created by IE 44 g Logs lt IZ DELIVERED gt IZ 45 Delivery of NOTES DOC 2003 04 28 23 28 12 received 8 Monitor Stored in c rvs usrdat NOTES DOC Bl Statistics lt CMD_TERMINATED gt 12 45 terminated status e b lt NEW_CMD_CREATED gt 03 46 created by IE 44 J Active Panel lt CMD_TERMINATED gt IE 44 terminated status e ol 8 Database El u Settings Ei Start Program lt NEW_CMD_CREATED gt QE 47 created by 0 46 lt CMD_TERMINATED gt 03 46 terminated status e lt CMD_TERMINATED gt QE 47 terminated status e lt CMD_TERMINATED gt SK 43 terminated status e lt SE_SENT gt SE 42 successfully sent C docs notes doc for Konrad at lt CMD_TERMINATED gt SE 42 terminated status e lt NEW_CMD_CREATED gt SK 49 created by SE 48 iz lt NEW CMD CREATED gt IE 501 created by SKi49i Ra Press F1 to get help F5 for refresh 6 3 2 Serializatio
2. Change History The following changes of User Manual were made in the previous releases including the current release Version 5 07 New command check_conn minor changes Version 5 06 rvs supports operating systems Windows Vista Windows 7 and WS 2008 minor changes Version 5 05 new chapter about uninstall rvsXP and minor Updates Version 5 0 Alternative Networks A neighbour station can be reached via different networks See chapter 4 1 9 Alternative Networks Online Decryption Type of decription wenn receiving a file is as a new ODETTE parameter implemented See chapter 4 1 2 Setting up ODETTE parameters new ODETTE parameter Crypt version CRYPFLAGS See chapter 4 1 2 Setting up ODETTE parameters rvs parameters are now described in the Reference Manual because they are common for all rvs portable platforms Version 4 05 XOT connection in the chapter 4 1 8 Setting up XOT parameters Version 4 0 size limit of files to be transferred is now 10 GB new parameters in the OP table OFTP Version and User Separation See chapter 4 1 2 Setting up ODETTE parameters new supported platform HP Itanium See chapter 1 2 History new feature Backup and Recovery See chapter 10 Backing Up and Recovering rvsXP Data rvsXP User Manual Rev 14 3 12 7 T Systems GmbH rvs Systems rvsXP User Manual rvs Rechner Verbund
3. Enter the station ID for the station s to be selected or e 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 90 How to work interactively with rvsXP Note You can use the wildcard characters and or acombination 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 no event queued not yet processed by rvsXP Monitor forwardable waiting for transmission process p pending waiting for completion y ended a active i in transit transmitter currently processing order deleted h held by the system or operator e If you want to repeatedly use this setting then enable the Save Setting as Standard check box e Confirm the entry by pressing OK rvsXP User Manual Rev 14 3 12 91 T Systems GmbH rvs Systems rvsXP User Manual Action during reception Example Example Troubleshooting tip 6 4 Administration with rvsXP This chapter describes how to administrate resident receive entries jobs inrvsXP Administrator after send attempts and according to user lists 6 4 1 Resident receive entries When a file is received the rvsXP Monitor stores it in the
4. Maximum sessions May only be selected at the local station Maximum number of simultaneously running receiving processes on this channel Default 1 MAX_IN rvsXP User Manual Rev 14 3 12 T Systems GmbH rvs Systems 51 rvsXP User Manual 4 1 6 Setting up the ISDN parameters Connection ISDN 0 Advanced ISDN 0 ISDN Number 56008794 Card Number fo Advanced Protocol eoss 7 Link CAPIZ40 Remove Insert TCPAP ISDN x 25 OT Cancel If you have selected the ISDN connection inthe Connection type area you can edit the line parameters for the network connection on the ISDN tab You may be ready to receive and send via several ISDN numbers or several different networks alternative networks at the same time You must specify the parameters shown in this tab to make the ISDN connection work Local station Selftest via TCPAP 1 Advanced TCPAP N TCPAP 3 TCP IP 4 TCPAP 5 ISDN 1 ISDN Number 34528976 V Start Card Number fo Advanced Protocol JEDSS1 Link CAPI2Z40 Remove Insert TCPAP ISDN x 25 OT ces rvsXP supports multiple ISDN reception through various receiving channels phone numbers at the same time You can add additional XP 52 Configuration of rvsXP parameter sets for ISDN on your local station LOC using the ISDN button below the ISDN tab Press the Remove button t
5. If you want to refresh the list select Reload inthe File menu rvsXP User Manual Rev 14 3 12 125 T Systems GmbH rvs Systems rvsXP User Manual 8 8 Support for public key certification With this feature a certification request for the own public key can be generated following PKCS 10 This may be required e g ifthe certificate shall be deposited in a trust center The certification request is created using the tool rvskeyreq Usage rvskeyreq cod outfile Options Shows usage c lt CN gt Common Name mandatory Common Name is the keyword for the search of the certificate in a PKI 0 lt ORG gt Organisation mandatory this is the name of your com pany this parameter would not be used for the search in the PKI so you can write here the short name of your company d lt Dumpfile gt Auxiliary dump file includes informations about the PKCS 10 request such as Common Name Orga nisation and the own public key outfile Output file contains the same informations as the dump file but base64 encoded Example rvskeyreq c VW_OFTP 000134350TSYSTEMSRVS33 o TSYSTEMS d C rvs usrdat dump C home rvs usrdat request This example creates a dump file dump and a certification request request In the file dump are the parameters CN Common Name ORG Organisation and your public key The same parameters are in the file request but base64 encoded The file dump could look as follows
6. 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 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 rvsXP User Manual Rev 14 3 12 T Systems GmbH rvs Systems 55 rvsXP User Manual Parameters Meaning of parameters Database ISDN parameter Closed User Group ISDN and X 25 allow for the formation of a closed user CUG group Allmembers 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 Rev 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 Parall Maximum number of parallel active
7. Two display choices 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 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 e 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 e 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 th
8. rvsXP User Manual Lc Listparm Lp Listst Ls Opcmd Setparm Sp Start Stop System Is an alias of Listcmd 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 QS DD mm Qa wo W ay 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 REP
9. 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 QE commands Default 30 Priority of QS 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 parameters RLCOMAXSIZE RLDBMAXSIZE RLOGMAXSIZE ROUTING RSTATMAXSIZE SCPRIO SDSNMAX SDSNPRIO SECURITY SENDBLOCKS SEPRIO SIDTRACE SLEEP Maximum file size for console messages rlco 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 f
10. Enter the station you want to send the file to rvsXP User Manual Rev 14 3 12 97 T Systems GmbH rvs Systems rvsXP User Manual 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 e Use Search to select the batch program that should start after the attempt to send the file lf 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 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 e Confirm your entries with OK rvsXP Administrator writes the new entry to the rvsXP database and displays it in the list of resident entries Is rvsXP Administrator 5 x File Edit View Monitor Database Window allez ax REE og vs Station virtual Dataset Name Program Commet lasts g Stations ba kd C i rysisystemsendjob bat Starts batch job sendjob bat after sen lsi Users E S Jobs Receive E 5 Logs H Database
11. MAXSENDERS 2 rvsXP User Manual Rev 14 3 12 75 T Systems GmbH 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 e Confirm your entry with Apply e 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 Open the C rvs init rdmini dat file To do so click the Monitor Parameters icon in the rvs folder The file contains predefined operator commands rvsXP Monitor executes each time it starts Commands for modifying the monitor parameters begin with setparm comment lines with Edit the file in accordance with your requirements A complete list and description of all the monitor parameters can be found in the Appendix The rvs parameters e Save the file and close the text editor e Display the Monitor Log window in the Log gt Monitor ofthe rvs tree inthe rvsXP Administrator Stop and start
12. T Systems GmbH rvs Systems 113 rvsXP User Manual Your partner encrypts a file with your public key and sends it to you getiZOUA AMQ fE lt PUI a amp VZ6 amp You decrypt the file you received To 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 114 Encryption configuration Key administration 8 2 Overview ofthe rvsXP key administration In order to use encryption with rvsXP please take these steps e Check the rvsXP license key If the Encryption module was purchased the rvsXP license key SRVSPATH 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 Chapte
13. T Systems GmbH 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 Edit 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 RVSPATH system folder The meaning of the letters in those file names is r ws translate Conversion code EBCDIC ASCII var 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
14. 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 IE 12 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 STATISTICS 5 means a detailed output in SRVSPATH db rlstat 1og with new parameters such as file format state of transmission and number of dial in attempts STATISTICS 6 produces a more detailed output about deleted entries by the user with the cause of deletion if specified with delcmd 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 gt Settings gt Parameter
15. 3 Settings E u Start Program Press F1 to get help F5 for refresh um A Editing a job start entry If you want to modify a job start entry Select the entry to be modified inthe Jobstart after send attempt window Execute the menu command Edit gt Update The Jobstart after send attempt dialog opens and displays the properties of the entry Edit the entry properties and confirm your entries with OK 98 How to work interactively with rvsXP Deleting a job start entry If you want to delete a resident send entry Select the entry to be deleted inthe Jobstart after Send Attempt window e Execute the menu command Edit gt Remove rvsXP will ask you to confirm your delete command rvsXP Administrator Do you really want to delete jobstart entry 12 Yes No e If you 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 e Open the user table in the rvsXP Administrator with User The user table contains at least the table entry for your own data X rysXP Administrat
16. 8 QZPRIO parameter A 2 R RCVTIMEOUT parameter 56 59 rdkey dat file 23 rdmini dat file 74 76 110 Receive parameter 39 Received files Displaying 86 Receiver parameter 46 Receiver number parameter 5 56 59 Index Reception Resident receive entry 92 With code conversion 134 with ISDN 69 with TCP IP 67 with X 25 69 Record formats 9 Recreating rvsXP database 106 RECVBLOCKS parameter AI 8 Al 13 Refreshing Display 87 Displaying 86 Release Station 66 Releasing Send order 89 Remote parameter 38 Removing Jobstart entry 99 Resident receive entry 96 Send order 89 90 User 101 User entry 101 Renaming Station 66 Replacement markers 92 Requirements 73 Resident receive entry Creating 93 Displaying 93 Editing 95 Receiving 92 Removing 96 Restarting Send order 89 Restoring Database 109 rvsXP database 109 Station table 708 User table and follow on processing 108 Resumed transmission Automatic 0 RETRY parameter obsolete A S RLCOMAXSIZE monitor parameter A2 1 RLCOMAXSIZE parameter A 9 RLDBMAXSIZE parameter A 9 rlog log file Al 74 Al 16 A2 1 RLOGMAXSIZE Monitor parameter A2 RLOGMAXSIZE parameter A1 9 rlstat log file A 16 A2 1 Route tab 48 Routing 47 Set up 48 ROUTING parameter A 9 RSTATMAXSIZE parameter A 9 RT routing table 37 rvs batch interface 10 A5 1 rvs Monitor 9 A5 2 Specify 19 Starting 21 Startup mode 19 rvs
17. Controller 2 internal controller supported DTMF supported channel allocation supported Ifa second ISDN line is inserted in port BRI 1 of the ISDN router and you click the button Test the message New controller foundis displayed and you can add Controller 2 If port BRI 1 is not connected to an ISDN line only one controller is displayed Use the button Test to make sure that the ISDN router works properly A4 2 Appendix 4 Operation with BinTec Router 4 2 Monitoring of ISDN connection Log on to the ISDN router via Telnet e g putty exe and log in as admin to control the ISDN connection Type the command Setup inthe command line of the router and the setup main menu will open i 10 233 66 110 PuTTY i lalx R1200 Setup Tool Funkwerk Enterprise Communications GmbH aj r1200 Licenses System External Systems Physical Interfaces Auxiliary ISDN 50 0 50 1 Fast Ethernet WAN Partner Security PPTP IPSEC IP PPP X 25 FR BRRP CREDITS CAPI ATM 005 VoIP GRE L2TP Configuration Management Monitoring and Debugging Exit Press lt Ctrl n gt lt Ctrl p gt to scroll through menu items lt Return gt to enter I iz First choose the option Monitoring and Debugging and thereafter ISDN Monitor i 10 233 66 110 PuTTY lolx R1200 Setup Tool Funkwerk Enterprise Communications GmbH MONITOR Monitoring and Debugging r1200 ISDN Monitor ISDN Credits xDSL Credits X 25 Monitor In
18. Insert TCPAP ISDN x 25 OT Cancel 50 Configuration of rvsXP Note Enable the Start checkbox to activate the recipient Ifthe configured recipient is to be automatically active after the rvsXP Monitor has been started and 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 rvsXP from the version 5 0 allows you to configure several TCP IP senders or and senders of another networks Parameters Meaning of the line properties TCP IP Database parameter Receiver number Local station N Number 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 The first tab is the receiver number 1 Partner station RCV_N Number of the local receiver accepting the call from the remote station Each TCP IP receiver of the local station has a tab with a set of TC parameters Default 1 N and RCV_N IP address Internet addresses in terms of 255 255 255 255 or hostname 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 INADDR Port Port address Default 3305 PORT
19. 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 TE 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 parameter 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 presta
20. PARAMETER DESCRIPTION l Displays a list on the screen comprising all send receive orders not yet completed You can use this option with the t lt time limits f lt redo file gt and b lt basis file gt options t lt time limit gt Date and time up to which send receive orders are displayed f lt redo file gt Name of the redo file b lt basis file gt Name of the dynamic file C Generates the RVSPATH arcdir static dat file with static data station list You can use the option when you wish to save your data to another file f lt file name of static Name of the file where you wish to save your static data gt data You can use this option in conjunction with the c option only p Changes the current status to pending waiting for EERP for an already existing send order With this option the options s d v and t from the table can be used rvsXP User Manual Rev 14 3 12 139 T Systems GmbH FB rvs Systems rvsXP User Manual PARAMETER DESCRIPTION e Changes the status to ended for an already exist ing send order With this option the options s d vand t from the table can be used S Sender StationID for which the p and e option is to be used d Receiver StationID for which the p and e option is to be used V Virtual file name for which the p and e option is to be used t Date and time of s
21. To set up rvsXP to receive calls automatically via TCP IP e 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 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 rvsXP User Manual Rev 14 3 12 67 T Systems GmbH rvs Systems rvsXP User Manual Ivs Parameter x Parameter SECURITY OPT A SENDBLOCKS 1000 SEPRIO 50 SIDTRACE SLEEP 30 Close SLEEP 30 Co SSCREATE 0 Hel STATISTICS 2 __Heb SYNCDL 500 SYNCTO 120 TIMESTAMP 2 al TMAXCON 0 TSTODPRCT 390 x TCPIPRCY e Double click TCPIPRCV in the parameter list Enter the desired value 1 into the input field e Confirm your entry with Apply Use Close to exit the parameter list A message of the type I lt TCPIP READY gt TCP IP Receiver ready to accept incoming calls Port 3305 indicates your readiness to accept calls 68 Configuration of rvsXP 4 3 ISDN X 25 XOT reception Automatic reception If you want to be ready to receive via X 25 ISDN XOT rvsXP must start a of calls receiver that waits for incoming calls on the X 25 ISDN XOT line To set up rvsXP to receive calls automatically via X 25 ISDN XOT e Execute the Settings gt Parameters menu command in the rvsXP Administrator The rvsX
22. parameter Working with AI 1 rvs parameters A 3 rvsbat A5 1 rvsbat program A5 rvscom A5 2 rvscom program A5 2 rvsdia A5 1 rvsdia program A5 1 rvsdiant exe Launching 78 Starting 78 rvskeydel program 122 rvskeydst program 2 rvskeyimp program 719 rvskeylst program 124 rvsmgr exe Launching 77 Starting 77 rvsmon A5 2 rvsmon program A5 2 rvssp program A2 2 rvsTraylcon 33 rvsxmt A5 2 rvsxmt program Al 4 A5 2 rvsXP Configuration 33 Display mode 78 Exiting 80 Installation 77 Sending a file 27 Starting 78 Window areas 79 rvsXP administrator Starting 34 77 rvsXP back up 103 rvsXP database Cleaning up 109 Managing 103 rvsXP database see Database rvsXP function test 27 rvsXP HighPerformance 4 rvsXP Monitor Al 4 Changing startup type 19 Starting 71 Startup type 19 20 rvsXP User Manual Rev 14 3 12 T Systems GmbH rvs Systems rvsXP User Manual Stopping 73 rvsXP Monitor parameters 74 Adapting 75 76 rvsXP test 27 rvsXP Traylcon 34 S SAMPLES environment variable A3 2 Saving User 101 SCPRIO parameter A 9 SDSNMAX parameter A 9 SDSNPRIO parameter A 9 SECURITY parameter A 9 Selecting display criteria 90 Self test via parameter 46 Send File 27 Send parameter 39 Send order Creating 87 Displaying 85 Editing 88 Holding 88 Releasing 89 Removing 89 90 Restarting 89 Temporarily hold 88 SENDBLOCKS Monitor parameter 74 SENDBLOCKS paramet
23. 08 09 23 52 lt X25 ERROR 16 O 2009 01 08 09 23 52 lt DISCONNECT tion LOC ended O 2009 01 08 09 23 52 lt DISCONNECT ZZZ ended L 2009 01 08 09 23 53 lt ISDN_READY incoming calls No 326734482 gt gt gt gt gt Connection as IZ 7429 Delivery of TEST PDF received at 2009 01 08 09 23 50 from LOC PDF D090108 T092350 IZ 7429 terminated status QS 7430 created by IE 7407 c rvs temp d0007407 dat IE 7407 terminated status QE 7431 created by QS 7430 QS 7430 terminated status QE 7431 terminated status S_ 3420 Cause 0 Diagnostic Connection as receive to Sta send to Station ISDN Receiver ready to accept rvsXP User Manual Rev 14 3 12 T Systems GmbH rvs Systems A4 15 rvsXP User Manual A4 16 Appendix 5 Glossary Appendix 5 Glossary ASCII American Standard Code for Information Interchange Batch interface rvsbat The rvs batch interface provides functions for background processing 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 In
24. 12 Virtual parameter 38 Virtual Circuit parameter 60 Virtual station Editing 65 Interactive operation 94 Receiving at 64 Removing 65 Sending from 65 Setting up 38 64 Statistics 76 Virtual channels 5 Virtual dataset name 94 98 What is 64 W What is rvs 8 What rvs is not 9 Wildcards A 2 Window areas 79 Window size parameter 41 Working with rvs parameters AJ X X 25 tab 56 X 25 address parameter 54 58 X 25 communication 6 rvsXP User Manual Rev 14 3 12 T Systems GmbH rvs Systems rvsXP User Manual X 25 connection 16 46 X 25 Facilities parameter 55 59 X 25 or ISDN receivers Number A1 15 X 25 reception 69 X 25 UserData parameter 55 59 XADDRESS parameter 54 58 XMCREATE parameter AI 12 Al 14 Al 16 XP X 25 ISDN table 37 Z ZIP algorithm A5 2 I 10
25. 2 Backing up Backing up the rvsXP database uusersssssnnnnnnnennennnnnnnnnnnnnnnnn nn 105 7 3 Delete and reinitialize rvsXP database umsssssennennennnnnnnnnnnnnnnnn nennen 106 7 4 Restoring rvsXP data from a back up u ee 108 7 4 1 Restoring the station table ans een eiennke 108 7 4 2 Restoring the user table and the follow on processing sesccceseeesecesseeeeeeen 108 7 4 3 Restoring the rvsXP database nase ten eteatensuaeen 109 7 5 Cleaning up the rvsXP database cleanup s sssssrrsesssrerssrrrrssrrrnrerrrnnesrrns 109 Encryption configuration Key administration uzsnnnsssnnnnnnnnnnnnnnnnnnnnnnnnnnnannnnne 111 8 1 Enieryption basics rare es 111 8 1 1 Encrypted transmission with rVSXP unnnessssnnesssnnnnnnnnnnnnnnnnen nenn nnnnnnn ernennen 111 8 1 2 rvsXP encryption principle and procedure uuu22222242nnnnnnnn nenne nenne nnnnnnn nennen 112 8 2 Overview of the rvsXP key administration 24440444H nenn nnnnnnnnnnnnnnnnn nen 115 8 3 Creating private and public keys 2224444444nnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn nn 115 8 4 Importing Keys rvskeyimp uses ea 119 8 5 Distribution of keys rvskeydst a 121 8 6 Deleting imported keys rvskeydel nrsssssnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnee 122 8 8 Support for public key certification ur ee ee 126 8 9 Configuration of offline Compression s sesssseessssrrrrerrrrtertrressrrrnstrennnrrnnneesnne 127
26. 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 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 Ifyou 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 TCPIPRC
27. 27 lt REPORT gt MAXX25RCV 2 I 2009 01 08 09 22 27 lt OK_CMD DONE gt RVSCNS setparm done A 2009 01 08 09 22 27 lt OK_READ gt RVSCNS setparm TCPIPRCV 0 R 2009 01 08 09 22 27 lt REPORT gt TCPIPRCV 0 I 2009 01 08 09 22 27 lt OK_CMD_DONE gt RVSCNS setparm done A 2009 01 08 09 22 27 lt OK_READ gt RVSCNS setparm TIMESTAMP 3 R 2009 01 08 09 22 27 lt REPORT gt TIMESTAMP 3 I 2009 01 08 09 22 27 lt OK_CMD_DONE gt RVSCNS setparm done I 2009 01 08 09 22 27 lt OK_CMD DONE gt RVSCNS setparm done A 2009 01 08 09 22 27 lt SP_START gt Service Provider started Com pression yes Security yes A 2009 01 08 09 22 27 lt XMT_START gt MasterTransmitter started L 2009 01 08 09 22 27 lt ISDN_READY gt ISDN Receiver ready to accept incoming calls No 326734482 A 2009 01 08 09 22 29 lt X25_OUTGING_CALL gt Outgoing Call to ZZZ use local XP 2 remote XP 1 L 2009 01 08 09 22 31 lt ISDN_READY gt ISDN Receiver ready to accept rvsXP User Manual Rev 14 3 12 A4 13 T Systems GmbH rvs Systems rvsXP User Manual incoming calls No 326734482 O 2009 01 08 09 22 31 lt CONNECT_IND gt Responder Connection with Sta tion LOC with Credit 99 Odette Buffer 2048 OFTP compression estab lished O 2009 01 08 09 22 31 lt CONNECT gt Sender Connection with Station ZZZ with Credit 99 Odette Buffer 2048 OFTP compression established O 2009 01 08 09 22 31 lt OFTP
28. 3 Dyymmdd 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 the 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 14 3 12 A1 11 T Systems GmbH rvs Systems rvsXP User Manual VFTYP XMCREATE The way how files with a fixed or variable format will be converted prior to
29. Ble ees 15 2 2 Connection type installation aan 15 2 3 INStallING VER Eee ct aac e a E a e A Re He 17 2 4 The rvsXP program environment ee 22 2 5 Hoewito oblain alieensez s 2a ee une 23 2 6 Uninstal vsXPaan ee ae 24 3 FUN GUGM TOSUS JOBRRRRBEF EEE ERFAIRE SERIE SPRURERPE PER PRRERBEREEPEIFEREETEITELEELTLNEFERBERERFEREEFERREFRELTEREIFTRTERTETELLEITE 27 3 1 Sending a file to yourself ns een lee 27 3 2 Testing the connection with the local and the partner stations 29 4 GConflguration frvsXP 2 02 22 en 33 4 1 Setting up rvsXP stations een een 34 4 1 2 Setting up ODETTE parameters 24 us4444nnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnenn 39 4 1 3 Setting up Connection Parameters uus244444unnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn 44 4 1 4 Setting up the routing connection 2 u 444444unnnnnnnnonnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn 47 4 1 5 Setting up TCP IP communication u u el 50 4 1 6 Setting up the ISDN parameters uu44444s0unnnnnnnnnnnnnnnnnnnnennnnnnnnnnnnnnnnnnnnn 52 4 1 7 Setting up X 25 parameters un innen 56 4 1 8 Setting up XOT parameters ar ee ee 60 4 1 9 Alternative Networks ea conde er eeneds 63 4 1 10 Setting up a virtual station aan 64 4 1 11 Editing the partner station nn a Nee en adkeieree 65 4 2 TG PAP receptione renne a a A eaaa TE 67 5 FVSXP MONOT a en enge 71 5 1 Starting T VsSXP MONITOT zes 24er 71 5 3 Customizin
30. CN Common Name VW_OFTP 000134350TSYSTEMSRVS33 ORG Organisation TSYSTEMS Public Key 00 bd 79 69 5d 96 a7 16 c6 02 e1 69 d2 14 53 af 98 47 9e 26 56 e7 14 18 fd 8c 77 71 cc ef c5 6e 65 81 9a 2f 9b 2d ed c7 b9 b5 4d 24 11 09 e6 53 7e ba 4a 8a eb db 84 18 ab c2 78 2e fe de 17 c7 126 Encryption configuration Key administration 7d 65 f5 98 85 89 20 ae 83 cb 7d 68 05 86 69 90 10 50 da f5 a3 40 f3 af bd 60 ee 26 05 c5 f9 99 99 8a c0 9d f6 de 64 0d cb e5 a4 54 69 8f 91 2b ed 1a 64 42 e7 42 a4 34 92 5d fd cb 94 8f 00 4c 8f The file request could look as follows MIIBeTCBAwIBADA8MQ8wWDQOYDVOOKFIgZSV1NDOZEXKTAnBINVBAMWIFZXX09G VFAgTZAwMTMwMDMyMTBHRURBUYOtLLVJWUONDMIG MA0OGCSQqGSIbD3DQOEBAQUA A4GNADCBiQKBgQC9eW1LdlqcWxgLhadIUU6 YR54mVuf 0GP2Md3HM78VuZYGa L5st 7ce5tU0kEQnmU366Sorr24Q0Yq8J4ALv7eF8d9ZEWY5SYkgroPL fWgF5mmQ EFDa9aNA86 9YO4mBcX5mZmKwJ 3 23mQNy WkVGmPkSvtGmRC5 0KkNJJd cuU j wBMj wIDAQABMAO0GCSqGS 1b3 DOQEBBQUAA4GBAEp 4 2 YhF7 f yRNZUOPHCQ3 sx oTzjjN pPgaqgfCrVdyciKiI zwBErsb53JaLMQYXTLixdHxcnoH2xxAVYGS5 OMB23TnZrCJUAp8Xw3 Kn4i6vF4 YTUYT8 ZdHYyBEGOKc1tVt YOHOQYcUVA8h iL60onH1lbsKxuQNzJ1ZxeKiNoulJd SARAR END CERTIFICATE REQUEST 8 9 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 addit
31. COMP FLAGS CRYPFLAGS XP SID ZZZ2 N 0 LINK CAPI2A0 TIMEOUT XADDRESS SUBAD DRESS ISDNNO 326734482 VC USERDATA CUG NO FACILITIES DBIT FALSE SESSIONS 1 ISDN _FAC ISDN_USRDT ISDN PROT EDSS1 ISDN _TEI 0 RCV_N 1 RCVTIMEOUT 0 A4 12 Appendix 4 Operation with BinTec Router R1200 Setup Tool Funkwerk Enterprise Communications GmbH MONITOR ISDN CALLS ISDN Monitor Calls r1200 Dir Remote Name Number Charge Duration Stack Channel State 0 active in CAPI 192 168 0 25 785 3 3 1 B1 active out CAPI 192 168 0 253 1801 3 2 0 B2 active in CAPI 192 168 0 253 1798 3 2 1 B2 active EXIT c alls h istory djetails s tatistics r elease I 2009 01 08 09 22 26 I 2009 01 08 09 22 26 lt COPYRIGHT gt rvsXP5 02 02 c T Systems 2007 All rights reserved A 2009 01 08 09 22 27 lt INIT_CMD gt rpm Reading initial commands A 2009 01 08 09 22 27 lt OK_READ gt RVSCNS cleanup days 3 ss yes A 2009 01 08 09 22 27 lt CLNUP_DEL_SS gt Cleanup of RVS data base purge all SendStatistics with DTEND lt 2009 01 05 09 22 27 I 2009 01 08 09 22 27 lt OK_CMD DONE gt RVSCNS cleanup done A 2009 01 08 09 22 27 lt OK_READ gt RVSCNS setparm MAXSENDERS 3 R 2009 01 08 09 22 27 lt REPORT gt MAXSENDERS 3 I 2009 01 08 09 22 27 lt OK_CMD_DONE gt RVSCNS setparm done A 2009 01 08 09 22 27 lt OK_READ gt RVSCNS setparm MAXX25RCV 2 R 2009 01 08 09 22
32. Default SECURITY OPT rvsXP User Manual Rev 14 3 12 43 T Systems GmbH rvs Systems rvsXP User Manual Parameters Meaning of advanced Odette parameters Database parameter PKI 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 PKI YES PKI NO Default NO USEPKI Crypt Version The version of encryption Possible values 1 or 2 For files bigger than 2 GB is version 2 necessary Normally you can use version 1 Default 1 CRYPFLAGS OFTP version This parameter is important only if your partner has a OFTP product which does not support OFTP 1 3 Normally must one OFTP product be able to negotiate a ODETTE protocol version during a ODETTE session If your partner is not able to do so you can set the protocol version with this parameter Possible values 1 OFTP 1 2 or 2 OFTP 1 3 Default 2 OFTPLEV User Separation This parameter is important only in communication with rvsMVS It enables to send the userlD of the user who is sending a file in the ODETTE command SFID Possible values YES or NO Default NO USERSEP Online Decryption Online Decryption Type of decryption when receiving a file Possible values 0 off decryption starts after the completely received file
33. Expanding access By default the rvs Monitor service runs under the system user of the rights 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 e Double click on rvs Monitor The rvs Monitor Properties Local Computer window opens e Click the Log On tab rvs Monitor Properties Local Computer General Log On Recovery Dependencies Log on as Local System account This account Password eoecccccccccccs Confirm password eeeeeceececcce 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 user 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 e Double click onthe rvs Monitor service e 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 Klug Started Automatic rvsXP User Manual Rev 14 3 12 21 T Systems GmbH rvs Systems rvsXP User
34. GOdE Conversion en Eee 129 9 1 Automatic code conversion with integrated conversion tables 130 9 2 Code conversion with user code tables 224000m4444nsonnnnnnnnnnnnnnnnnnnn nn 131 9 2 1 Structure of the code conversion tables 2zuunm4444snnnnnnnnnnnnnnnnnannnnnnnnnn 131 9 3 How to perform a code conversion uusresennnnnnnannnnnnnnnnnnnnnnnannnnnnnnnnnnnnnnnnen 132 9 3 1 Code conversion when sending files _ 44 44444444Rn nn nnnnnnnnnnnnnnnnnnnnnnn 132 9 3 2 Code conversion when receiving files _ s04 44444444HnnHHnnnnnnnnnnnnnnnnnannnnnnnnnn 134 Backing Up and Recovering rvsXP Data uuuunsessnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn namen 137 10 1 New Parameters un ee ae 137 10 2 PrOCBA Ur ee re ernennt ai 137 193 rVsredo Oplions msamaa neern e a e aa aa E a Ei 139 FVSXP HighPerl ormance une an 141 11 1 Configuration of ORACLE sie el Bela 141 11 2 Configuration of rvsXP nk en 143 11 3 Microsoft SQL Server configuration cccceesccceeeeeeeeeeeeeneeeeeeeeeceeeeeneaeeeeeenes 144 US PData Centern ea re 147 12 1 System requirementsia e ckee ee 147 Contents Appendix Appendix 1 The rvs parameters Appendix 2 Log files Appendix 3 Environment variables Appendix 4 Operation with BinTec Router Appendix 5 Glossary Index rvsXP User Manual Rev 14 3 12 T Systems GmbH rvs Systems rvsXP User Manual
35. Manual 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 rvsXP 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 late
36. Panel lt IZ_DELIVERED gt IZ 15 Delivery of READMERECEIVED TXT 2003 04 28 16 17 10 5 8 Database Stored in c rvs usrdat READMERECEIVED TXT E u Settings lt CMD_TERMINATED gt IZ 15 terminated status e lt NEW_CMD_CREATED gt Q5 16 created by IE 14 A lt CMD_TERMINATED gt IE 14 terminated status e lt NEW_CMD_CREATED gt QE 17 created by 0 16 lt CMD_TERMINATED gt Q5 16 terminated status e lt CMD_TERMINATED gt QE 17 terminated status e lt CMD_TERMINATED gt SK 13 terminated status e lt SE_SENT gt SE 12 successfully sent C rvs system readme txt for Ke lt CMD TERMINATED gt SE 12 terminated status e ic u Start Program X Press F1 to get help F5 for refresh yum 7A 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 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 Sranan The window Station table for managin
37. Permitted is the outgoing routing e g for the partner REM2 via REM1 LOC gt REM1 gt REM2 Not permitted is the incoming file transmission from the partner e g XXX to the remote partner e g REM1 via our local station e g LOC XXX gt LOC gt REM1 BOTH IN and OUT normal OFTP routing Determines the global rvsXP routing behavior OUT Routing is allowed for send jobs only The own local station must not function as a router NEVER routing in both direction IN and OUT is forbidden Default BOTH Security Defines whether or not encryption is to be used during file SECURITY transmission Make this setting either for all stations with the global rvs parameter or for each single station in the ODETTE parameter configuration The global parameter is applied to those 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
38. RCV gt Receive TEST PDF 090108 091833 from LOC Destination LOC FORMAT U RESTART 0 IE 7407 begins O 2009 01 08 09 22 31 lt OFTP_SEND gt Send SK 7405 TEST PDF 090108 091833 from LOC Destination ZZZ FORMAT U RESTART 0 A 2009 01 08 09 22 39 lt OK READ gt RVSCNS ACT SID zzz2 I 2009 01 08 09 22 39 lt OK ACTIVATE gt connect to station 2222 I 2009 01 08 09 22 39 lt OK_CMD DONE gt RVSCNS activate done A 2009 01 08 09 22 40 lt X25 OUTGING CALL gt Outgoing Call to 2222 use local XP 1 remote XP 1 I 2009 01 08 09 22 41 lt INCOMING CALL gt Incoming call received W 2009 01 08 09 22 41 lt ESID ERROR gt Odette session ended by remote node ZZZ2 Reason 4 invalid password W 2009 01 08 09 22 41 lt INV_PSW gt OFTP Invalid password received from LOC L 2009 01 08 09 22 43 lt ISDN READY gt ISDN Receiver ready to accept incoming calls No 326734482 A 2009 01 08 09 23 03 lt OK_READ gt RVSCNS ACT SID zzz2 I 2009 01 08 09 23 03 lt OK_ACTIVATE gt connect to station 2222 I 2009 01 08 09 23 03 lt OK_CMD DONE gt RVSCNS activate done A 2009 01 08 09 23 03 lt X25 OUTGING CALL gt Outgoing Call to ZZZ2 use local XP 1 remote XP 1 I 2009 01 08 09 23 04 lt INCOMING_CALL gt Incoming call received W 2009 01 08 09 23 04 lt INV_PSW gt OFTP Invalid password received from LOC W 2009 01 08 09 23 04 lt ESID ERROR gt Odette session ended by remote node ZZZ2
39. SRVSPATH usrdat folder Then it logs reception in the rvsXP Administrator and in the RVSPATH db rlog log rvsXP log book You can trigger other actions when receiving files by generating resident 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 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 temp folder copy DSN d temp 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 copy c rvs usrdat kontol txt d tempor copy 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 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
40. System Platforms continued 1 Introduction The present chapter gives a brief introduction to the rvs system describes the structure of the rvs manuals and defines the target group It explains the typographic conventions used in the present manual 1 1 Short description of the system What is rvs The abbreviation rvs stands for the German word Rechner Verbund 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
41. TCPAP 2 x 25 31 xoT 141 IP Address l IV Start Port 3306 Max Sessions fi Remove Insert TCPAP ISDN x 25 OT Cancel OK rvsXP User Manual Rev 14 3 12 45 T Systems GmbH rvs Systems rvsXP User Manual have been configured and or are still to be configured 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 XOT X 25 The partner station is reached via an X 25 line R Routing XOT The partner station is reached via an XOT 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 Use the Advanced button to the right
42. The Select file with station definitions dialog opens and displays the files with the dat extension in the rvsXP system folder e Select the file which contains the station table which is to be restored e Confirm your selection by clicking Open Restoration of the data has been successfully completed if the Monitor LOG window contains the message I lt ok cmd done gt 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 Stop rvsXP Monitor e Execute the menu command Database gt Import gt Jobstarts amp Users The Select Backup File dialog opens and displays the files with the LOG extension in the rvsXP system folder e Select the file which contains the user table and follow on processing which are to be restored e 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 108 rvsXP database maintenance 7 4 3 Restoring the rvsXP database To restore the entire rvsXP database using a com
43. 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 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 user 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 To Back up 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 current back ups of station table user table and follow on processing are available follow on made to the station table the user processing JL table and the follow on Chapter 7 1 2 processing Database cleanup Step 1 Benefit Recommended Ar Delete and Database cleanup procedur
44. User Manual Rev 14 3 12 73 T Systems GmbH 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 e Startthe rvsXP Administrator program in the rvs folder e Execute the menu command Monitor gt Stop or e Launch the das Stop rvs Monitor program inthe 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 other 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
45. Userdata Connection son 0 x Advanced rennin deparee ET ISDN 0 Parallel Sessions 1 ISDN Number 326997448 ISDN Faciities Card Number v Advanced ISDN Userdata Closed User G Protocol EDSS1 v Link CAPI241 Remove LT DBit 7 Insert TCPAP ISDN x XOT Receiver Number fi x 1 ee Cancel 4 7 Tests with different configurations of ISDN ports In the following tests ISDN connection with MSN number 326997448 is assigned to port BRI O and ISDN connection with MSN number 326734482 is assigned to port BRI 1 4 7 1 Test of BRI 1 Port If port BRI 1 is in use in XP line of local station Loc parameter LINK CAPI2A1 and command activate SID LOC is started the connection is established properly Example XP SID LOC N 1 LINK CAPI2A1 TIMEOUT XADDRESS SUBAD DRESS ISDNNO 326734482 VC USERDATA CUG NO FACILITIES DBIT FALSE SESSIONS 1 ISDN_FAC ISDN USRDT ISDN_PROT EDSS1 ISDN _TEI 0 RCV_N 0 RCVTIMEOUT 0 A 2009 01 08 08 13 35 lt OK_READ gt RVSCNS ACT SID loc A4 8 Appendix 4 Operation with BinTec Router I 2009 01 08 08 13 35 lt OK_ACTIVATE gt connect to station LOC I 2009 01 08 08 13 35 lt OK_ CMD DONE gt RVSCNS activate done A 2009 01 08 08 13 36 lt X25 OUTGING CALL gt Outgoing Call to LOC use local XP 1 remote XP 1 O 2009 01 08 08 13 37 lt CONNECT IND gt Responder Connection with Station LOC with Credit 99 Odette Buffer 204
46. 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 74 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 e 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 F MAXSENDERS 2 e Double click the parameter that you want to modify Enter the desired value parameter value into the input field and click Apply e 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
47. changes Communication module rvscom The rvs communication module connects different stations and sends or receives files MasterTransmitter rvsxmt The MasterTransmitter of the 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 A5 2 Appendix 5 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 14 3 12 A5 3 T Systems GmbH rvs Systems rvsXP User Manual A5 4 Index A Acknowledgement During reception 42 AI 6 During sending 41 AI 6 Act command A 3 Activate Local station 31 Partner station 31 Station 66 Activate command A 3 Activate program AI 14 Active conn
48. 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 rvskeylst tool via the command prompt or the graphic interface Launching via the command prompt Syntax rvskeylst 124 Encryption configuration Key administration Example of result SID WO1l BEGIN 2001 02 22 00 00 00 END 2001 05 22 01 00 00 FILE SID LOC BEGIN 2001 02 22 00 00 00 END 2001 05 22 02 00 00 FILE Launching via the graphic interface After launching rvskeylst the key entries are shown in the graphic rvsKey Start rvsKey with e Start gt Run and type rvskey or e 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 ix Eile Tools Help ow N Import Delete Generate 2 stations Info ARB Loc Key ID FDAF49CE ey 94866222 x p S FDAF49CF SID RSX 4 RSL Filename lc rvstkeydir RSX30 pub RST i E RSX Creator not specified S Owner not specified Creation Time Sat Feb 21 08 13 02 2004 Version Serial Number 001 Version 001 Mode 001 Type Cf public r Run of Validity Begin Sat Feb 21 01 00 00 2004 End Fri May 21 00 00 00 2004
49. coded in ASCII on a Windows computer and in EBCDIC on text file an OS 390 system Direction rvsXP gt 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 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 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 rvsut2 fv tool For more details on this tool and its command syntax please refer to the rvs Reference 4 The code pages vary as they depend on the respective operating system rvsXP User Manual Rev 14 3 12 129
50. functionalities for ISDN connections Several RCAPI clients can communicate via RCAPI server The RCAPI client for Windows is a part of BRICKware software which is delivered with the BinTec Router Further information you can get from http www funkwerk ec com You can use RCAPI server and RCAPI client alternative to internal ISDN cards Both support the CAPI interface capi2032 dll which is used by rvsXP 4 1 CAPI Configuration in BRICKware After installation of the BRICKware software the IP address of the ISDN router and the TCP port for communication with RCAPI server are to be set with the CAPI Configuration program Start gt Programs gt Funkwerk bintec BRICKware gt CAPI Configuration The following window opens Remote Clients Configuration x Ti CAPI Configuration Remote CAPI Advanced Device IP address or host name TCP port of Remote CAPI Server fi 92 168 0 254 2662 User Password default Use these values More Devices CAPI2032 DLL rInfo 32 bit CAPI You are using the multi device version of the CAPI2032 DLL Please press More Devices CAP12032 DLL to get more info Cancel Help Click the button More Devices CAPI2032 DLL for setting up the cards of the ISDN router controller rvsXP User Manual Rev 14 3 12 A4 1 T Systems GmbH rvs Systems rvsXP User Manual Remote Multi CAPI Client Configuration a 192 168 0 254 Port 2662 Controller 1
51. gt Services rvsXP User Manual Rev 14 3 12 71 T Systems GmbH rvs Systems rvsXP User Manual e Search the list of Services for rvs Monitor and select the service by clicking the appropriate line i Services FERN Fie Action View Help em R u i Services Local rys Monitor Name Description Status Startup Type Log On As A Sa Print Spooler Loads files Started Automatic Local System Start the service 88s Protected Storage Provides pr Started Automatic Local System 4005 RSYP Provides n Manual Local System 84 Remote Access Aut Createsa Started Manual Local System SB4Remote Access Con Createsa Started Manual Local System 4 Remote Desktop He Manages a Manual Local System SB4Remote Procedure Provides th Started Automatic Local System 4 Remote Procedure Manages t Manual Network 5 Remote Registry Enablesre Started Automatic Local Service Sa Removable Storage Manual Local System Sa Routing and Remot Offers rout Disabled Local System R Monitor Automatic Local System a Secondary Logon Enables st Started Automatic Local System Sa Security Accounts Stores sec Started Automatic Local System Pr er Extended Standard F e Double click on the rvsXP Monitor entry The rvs Monitor Properties Local Computer window opens e Click on the Start button If the attempt is successful the rvsXP Monitor status will change to Started The entr
52. 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 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 gt Release window Start Time continued Exact time If you want that the file to be sent your partner at an exact time you 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 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 characters before CR LF MS Windows systems or LF UNIX syst
53. in the Resident Receive Entries window Execute the menu command Edit gt Update The Resident Receive Entries dialog opens and displays the properties of the entry Edit the entry properties and confirm your entries with OK rvsXP User Manual Rev 14 3 12 95 T Systems GmbH rvs Systems rvsXP User Manual Removing a resident receive entry To remove a resident receive entry Select the entry to be deleted in the Resident Receive Entries window e Execute the menu command Edit gt Delete rvsXP will ask you to confirm your delete command rvsXP Administrator A 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 deleting 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 sendjob bat is to start after the third unsuccessful attempt to send a file This example is also to be found in the C rvs system folder The modified copies of the batch program are also saved in the SRVSPATH temp folder exactly as is the case with RE The copie
54. may increase the data volume by up to 100 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 ensures 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 14 3 12 111 T Systems GmbH 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 ke
55. of where you choose the connection to open the Connection Properties dialog providing more parameters Connection Properties x Delay E Parallel Sessions Fi IV No Limit Active Connection Setup V Priority 1 100 Cancel 46 Configuration of rvsXP 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 This parameter is important for the feature Alternative PRIORITY Networks If you have configurated more than one sender for a partner station the value of this parameter decides which network will be taken as first There are two different network types in rvsXP TCP IP or X 25 ISDN XOT The highest value means the lower 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 part
56. 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 e Choose the station from the station table as usual and double click the entry in the list or execute the menu command Edit gt Update e Choose Routing as connection type in the Connection type area Your partner station is not a direct neighbor station of yours Connection Routing Route Neighbour Node RSI Priority ee 1 100 Cancel OK e 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 48 Configuration of rvsXP 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 Set up station name MAR Set up ODETTE parameters of target
57. or the Edit gt Release menu command Restarting a send order Automatic repetition 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 e Click the Hold button or choose Edit gt Hold from the menu e Release the orders selected with Release or the Edit gt Release menu command Deleting a send order Removing before You can remove a send order from the database If you remove a send transmission order which has the status forwardable or held then your partner will not receive the file which was intended for him No revoking after A send order that has already been completed remains executed It is not transmission 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 e Double click the send order you want to rem
58. 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 gt 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 e Initialize the rvsXP database To do so start the Init Database program in the rvs program folder rvsXP will then generate a completely new rvsXP database Hint You need Windows administrator privileges for initializing the rvsXP database After initialization all tables contain the default rvsXP settings e Restore the tables desired from the backup files which you made earlier For appropriate instructions please read Chapter 7 4 StartrvsXP Monitor rvsXP User Manual Rev 14 3 12 107 T Systems GmbH 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 103 7 4 1 Restoring the station table To restore the station table StartrvsXP Monitor e Execute the menu command Database gt Import gt Stations
59. 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 XOT reception Partner stations After editing the basic parameters click the Advanced button to the right of the parameter input boxes to open the XOT Advanced dialog where you can edit these and other parameters rvsXP User Manual Rev 14 3 12 61 T Systems GmbH rvs Systems rvsXP User Manual Fort U Ej X25 Addes Router Address Link xor x 25 Facilities Po x 25 Userdata Timeout ET Receiver Number fi v Cancel e 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 XOT Database parameter Local IP address Local station only optional own IP address IP RCV_ALIAS addresses have the form 255 255 255 255 If you have not specified a value for the local station you permit automatic definition of the IP address If your own station has only one IP address this field should be left empty Link Possible values XOTI XOTX LINK e XOTI w
60. station 0001300 e Set up connection type Routing Select neighbor station RST Properties for Station Remote Station xi r Station Station ID MAR Virtual I Comment JExample Station Odette Phone m Odette Odette ID 00013003210COMP AIL3UZ Advanced Send password Receive password Connection Routing x Advanced Route Neighbour Node RST x Priority tite ee ee 1 100 Cancel rvsXP User Manual Rev 14 3 12 49 T Systems GmbH rvs Systems rvsXP User Manual 4 1 5 Setting up TCP IP communication Connection TCP IP 0 Advanced TCP IP 0 IP Address fi 23 1 234 8 Port 3305 Receiver Number Remove Insert TCPAP ISDN x 25 OT 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 iz TCPAP 1 TCPAP 3 ISDN 5 IP Address IV Start Port 3305 Max Sessions 5 Remove Selftest via Advanced
61. 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 14 3 12 33 T Systems GmbH rvs Systems rvsXP User Manual Monitor log window Configuration example Starting the rvsXP Administrator configuration program e Start rvsXP Administrator with the rvsTraylcon command right mouse button rvsTrayIcon gt rvs Administrator or e choose Start gt All Programs gt rvs gt rvs Administrator in the rvsXP folder The rvsXP Administrator then opens with the Monitor Log window displaying the current rvsXP Monitor activities ixi E Fie Edit View Monitor Database Window laj xj al l x lt COPYRIGHT gt rvsXP3 01 00 c gedas 2004 All rights reserved 8 tvs lt INIT_CHD gt rpm Reading initial commands 4 Stations lt OK_READ gt RYSCNS cleanup days 3 ss yes Users lt CLNUP_DEL_35 p Cleanup of RYS data base purge all SendStatistics with DTEND lt CLNUP_START gt Cleanup of RYS data base purge all commands with DTDONE lt 2C lt CLNUP_NONE gt Cleanup of RYS data base ended there are no commands to be pu lt XMT_START gt MasterTransmitter started 2 lt SP_START gt Service Provider started Compression yes Security no A Statistics lt TCPIP_READY gt 1696 TCP IP Receiver ready to accept incoming calls Port 33C Active Panel lt LGW gt lt XM
62. the rvsXP Monitor e 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 gt 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 76 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 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 confi
63. to complement the classical rvs product line which is based on MVS and VSE mainframes for use on midrange mini systems and personal computing Though the design and make of this product line differs considerably from the mainframe versions the functional spectrum is almost exactly the same as that of rvs MVS Supported platforms The following versions of portable rvs rvsX for AIX using X 25 XOT ISDN and TCP IP rvsX for HP UX using X 25 ISDN and TCP IP rvsX for Linux using ISDN XOT and TCP IP rvsX Linux zSeries using ISDN and TCP IP from rvsX 2 06 onwards rvsX for Solaris using ISDN and TCP IP rvs400 for IBM OS 400 systems using X 25 ISDN and TCP IP rvsNT for MS Windows NT 2000 using X 25 ISDN and TCP IP are currently available Introduction rvsXP for MS Windows 2000 XP Vista 7 and WS 2003 2008 2008 R2 using X 25 XOT 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 from 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 asynchronously 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
64. 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 station LID In this case the file is delivered locally and EERP is created and a post processing script starts if necessary Setup your virtual station as a routing station for sending files locally to a local virtual station 64 Configuration of rvsXP 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 Sending from The send job is given the SIDORIGIN parameter for sending from virtual
65. 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 In the station configuration on the partner side the virtual stations should be configurates as routed stations Setup your own virtual station as a routing station for receiving files locally from a local virtual station 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 11 Editing the partner station Note The feature Virtual Stations must be on in the licence key for the ISAM database internal rvsXP database For rvsXP with the external database such as ORACLE for example it is inklusive 4 1 11 Editing the partner station Editing properties To edit the parameters of an existing station In order to do so open the station table in the rvsXP Administrator using the Stations command e Double click the station entry or e choose the station to be edited and execute the menu command Edit gt Update The dialog window Properties for Station opens It comprises three sections with station param
66. 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 DTCONNO1 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 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 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
67. 024 2048 owner creator from to help size private_key public_key The private_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 creator Creator of the files unknown string Example c gha creater gha In the dialog Creator 0 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 Attention with different time zones the time difference is not considered 116 Encryption configuration Key administration Parameters Description Default value t to string Last day of validity period TT MM JJJJ YYYY MM DD In the dialog end Attention with different time zo
68. 1 on received records will be decrypted immediately after reception it will not be waited until the complete file was received Default 0 Note Odette Acknowledgment that a file was completely received EFPA is faster with Online Decryption FLAGCRYP 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 4 1 3 Setting up Connection Parameters The Connection tab contains information about the path via the partner station is to be reached For the local station the name of this tab 44 Configuration of rvsXP is Self Test Self Test defines via which network the local station should perform the local network test Connection x25 Advanced x 25 x 25 Address Link NETX25 Card fo Advanced Port fo 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 Just as your local station can feature reception devices you can set up several connection types rvsXP supports multiple reception for TCP IP ISDN XOT and X 25 Selftest via TCPAP 1 Advanced TCPAP 1
69. 2 1 Brief description of LOG files The Monitor Log file rlco log System start In the Monitor Log view theC rvs temp rlco log 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 1log 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 log file is generated and updated The maximum number of generations 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 statisti
70. 39 lt OK_READ gt RVSCNS ACTIVATE SID Z22Z I 2009 01 08 08 27 39 lt OK ACTIVATE gt connect to station ZZZ I 2009 01 08 08 27 39 lt OK_CMD DONE gt RVSCNS activate done A 2009 01 08 08 27 39 lt X25_OUTGING_CALL gt Outgoing Call to ZZZ use local XP 1 remote XP 1 E 2009 01 08 08 27 40 lt CAPI20 CON gt Error occurred during set up the ISDN connection 0x3304 Another application got the call O 2009 01 08 08 27 41 lt CONNECT IND gt Responder Connection with Station LOC with Credit 99 Odette Buffer 2048 OFTP compression established O 2009 01 08 08 27 41 lt CONNECT gt Sender Connection with Station ZZZ with Credit 99 Odette Buffer 2048 OFTP compression established O 2009 01 08 08 27 43 lt DISCONNECT gt Connection as receive to Station LOC ended O 2009 01 08 08 27 44 lt DISCONNECT gt Connection as send to A4 10 Appendix 4 Operation with BinTec Router Station ZZZ ended L 2009 01 08 08 27 44 lt ISDN_READY gt ISDN Receiver ready to accept incoming calls No 326734482 4 7 4 Test with occupation of the four B channels of the Routers In the following example the local station LOC is defined with two ISDN receivers and two neighbour stations ZZZ and ZZZ2 The Odette ID of station LOC and station ZZZ is identical so the trans mission via ISDN will work The example with four busy B channels shows the situation if the command activate SID ZZZ2 is started wh
71. 739 STATISTICS parameter A 0 AI 16 Index STATNAME parameter 38 Status display 79 Stop rvsXP processes AI 4 Stop command A 4 Stopping Monitor 73 Station 67 SYNCDL parameter A 0 SYNCTO parameter A 0 System command A 4 SYSTEM environment variable A3 2 System requirements 15 T Tab ISDN 52 Route 48 TCP IP 50 X 25 56 Table NK line type 37 ODETTE parameters OP 37 Routing table RT 37 ST station 37 TC TCP IP 37 XP X 25 ISDN 37 TCP IP tab 50 TCP IP connection 77 TCP IP reception 67 TCPIPRCV parameter 51 67 Al 10 AI 15 TC TCP IP table 37 TEI parameter 55 TEMP environment variable A3 2 Test rvsXP 27 TIMEOUT parameter 55 59 TIMESTAMP parameter AI 10 TMAXCON parameter A 0 Transmission buffer 47 Transmission time 0 Transmissions Displaying 85 Traylcon see rvsTraylcon Troubleshooting A2 2 TSTODPRCT parameter AI 10 Typographic conventions 4 U USEPKI parameter A1 11 User Backing up 105 Editing 701 Removing 101 Saving 101 User entry Creating 100 Displaying 99 Editing 99 Listing 99 Removing 101 Sorting 99 User interface 0 User rights 21 User table Backing up 05 Restoring 08 USERDATA parameter 55 59 USERFIELD parameter reserved A USRDAT environment variable A3 2 V VC parameter 60 VDA see Verband der Deutschen Automobilin dustrie VDSNCHAR parameter 42 A1 11 Verband der Automobilindustrie 40 VFTYP parameter AI
72. 8 OFTP com pression established O 2009 01 08 08 13 37 lt CONNECT gt Sender Connection with Station LOC with Credit 99 Odette Buffer 2048 OFTP compression established O 2009 01 08 08 13 39 lt DISCONNECT gt Connection as receive to Station LOC ended O 2009 01 08 08 13 39 lt DISCONNECT gt Connection as send to Station LOC ended L 2009 01 08 08 13 39 lt ISDN_READY gt ISDN Receiver ready to accept incoming calls No 326734482 R1200 Setup Tool Funkwerk Enterprise Communications GmbH MONITOR ISDN CALLS ISDN Monitor Calls r1200 Dir Remote Name Number Charge Duration Stack Channel State out CAPI 192 168 0 253 1666 3 E i Bl active in CAPI 192 168 0 253 1664 3 0 1 B2 active 4 7 2 Test with incorrect ISDN number at local station If port BRI O is in use in XP line of local station LOC parameter LINK CAPI2A0 and command activate SID LOC is started ISDN no 326734482 is activated the error message No user responding appears because in port BRI O the ISDN connection was set up with MSN number 326997448 Example XP SID LOC N 1 LINK CAPI2A0 TIMEOUT XADDRESS SUBAD DRESS ISDNNO 326734482 VC USERDATA CUG NO FACILITIES DBIT FALSE SESSIONS 1 ISDN _FAC ISDN USRDT ISDN PROT EDSS1 ISDN_TEI 0 RCV_N 0 RCVTIMEOUT 0 A 2009 01 08 08 01 51 lt OK_READ gt RVSCNS ACT SID loc I 2009 01 08 08 01 51 lt OK ACTIVATE gt connect to station LOC I 2009 01 08 0
73. 8 01 51 lt OK_CMD DONE gt RVSCNS activate done A 2009 01 08 08 01 51 lt X25 OUTGING CALL gt Outgoing Call to LOC use local XP 1 remote XP 1 E 2009 01 08 08 02 00 lt CAPI20 CON gt Error occurred during set up the ISDN connection 0x3492 No user responding E 2009 01 08 08 02 00 lt ISDN_ERROR gt 50 common CAPI or ISDN error see message log rvsXP User Manual Rev 14 3 12 A4 9 T Systems GmbH rvs Systems rvsXP User Manual E 2009 01 08 08 02 00 lt CONNECT FAILED RC gt OFTP Unable to connect to LOC errorcode 2101150 4 7 3 Message Another application got the call If in rvsXP the ISDN parameters of local station were set up with several ISDN receivers you get this message for information only In the following example two receivers were set up parameter MAXX25RCV 2 XP SID LOC N 2 LINK CAPI2A1 TIMEOUT XADDRESS SUBADDRESS ISDNNO 326734482 VC USERDATA CUG NO FACILITIES DBIT FALSE SESSIONS 1 ISDN_FAC ISDN _USRDT ISDN PROT EDSS1 ISDN_TEI 0 RCV_N 0 RCVTIMEOUT 0 XP SID LOC N 1 LINK CAPI2A1 TIMEOUT XADDRESS SUBADDRESS ISDNNO 326734482 VC USERDATA CUG NO FACILITIES DBIT FALSE SESSIONS 1 ISDN_FAC ISDN_USRDT ISDN_PROT EDSS1 ISDN_TEI 0 RCV_N 0 RCVTIMEOUT 0 With incoming calls the message Another application got the call is displayed in rlog 1log file rvsXP log book A 2009 01 08 08 27
74. AI 9 AI 13 SEPRIO AI 9 SESSIONS 56 59 SID 38 SIDNEIGHB 49 SIDTRACE AI 7 Al 9 SIDTYP 38 SLEEP AI 9 AI 14 SNARCV AI 10 Station 38 Station ID 38 Station name 38 STATISTICS AI 10 AI 16 STATNAME 38 SYNCDL A 10 SYNCTO AI 10 TCPIPRCV 51 67 AI 10 AI 15 TEI 55 TIMEOUT 55 59 Timeout 55 59 TIMESTAMP AI 10 TMAXCON AI I10 TSTODPRCT AI I0 USEPKI AI 11 USERDATA 55 59 VC 60 VDSNCHAR 42 A1 11 VFTYP Al 12 Virtual 38 Virtual circuit 60 Window size 4 X 25 address 54 58 X 25 Facilities 55 X 25 facilities 59 X 25 UserData 55 X 25 UserData rvsNT 59 XADDRESS 54 58 XMCREATE AI 12 Al 14 AI 16 Parameters obsolete RETRY AI 8 Parameters reserved USERFIELD AJ Partner station Activate 31 Managing 34 Setting up 34 Password administration 40 PATH environment variable A3 2 PDF A5 3 Performing Code conversion 32 134 PHONE parameter 38 Phone parameter 38 PKI parameter 44 AI 11 Platforms 8 PORT parameter 57 Portable Document Format A5 3 PRIORITY parameter 47 49 Priority parameter 47 49 Program Activate AI 14 Key 116 rvsbat A5 1 rvscom A5 2 rvsdia AS5 1 rvskeydel 22 rvskeydst 121 rvskeylst 124 rvsmon A5 2 rvssp A2 2 rvsxmt Al 14 A5 2 Properties Station 35 38 65 Protocol A5 3 PROTOCOL parameter 46 Protocol files 0 PSESSIONS parameter 47 PSWFROM parameter 39 PSWTO parameter 39 Q QEPRIO parameter A 2 AI 8 QSPRIO parameter A
75. ATH rvsenv dat The following variable definitions will be added DBNAME Host in GUI lt Name or an IP Address of the ORACLE Server gt DBUSER User in GUI lt ORACLE User Oracle NetworkServiceName gt DBPSW Password in GUI lt ORACLE user s password gt These variable values have been defined when installing and configuring Oracle Example excerpt from RVSPATH rvsenv dat rvsXP environment file rvsenv dat DBNAME rvsaix3 DBUSER skk RVSORA TSYSTEMS DE DBPSW skk 11 3 Microsoft SQL Server configuration The SQL Server database version 8 0 and later must have been set up prior to the installation of rvsXP SQL Enterprise Manager 11 For more detailed information on the RVSPATH parameter see Chapter 1 6 Representation means 144 rvsXP HighPerformance 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 Before 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 Important hint This user can be an domain user he must have administrator rights but it is not allowed to take an domain administrator for this purpose Make sure to set ANSI NULL default in the database properties The SQL server m
76. Cleanup of RV5 data base purge all SendStatistics with DTEND lt 2003 1 E y Jobs 3 lt CLNUP_START gt Cleanup of RVS data base purge all commands with DTDONE lt 2003 04 25 5 L lt CLNUP_NONE gt Cleanup of RY5 data base ended there are no commands to be purged a 29 lt XMT_START gt MasterTransmitter started Bp Monitor lt SP_START gt Service Provider started Compression yes Security no HA Statistics lt TCPIP READY gt 548 TCP IP Receiver ready to accept incoming calls Port 3305 g Active Panel 8 Database ie u Settings ic u Start Program Press F1 to get help F5 for refresh e Open the station table with the Stations menu command Link test between To test the link between local and remote station proceed as follows Start local and remote with the local station first unless you are sure it functions correctly stanon 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 rvsXP Administrator Monitor Log lol x MM Fie Edit View Monitor Database Window 2 18 x all x axi lt CONNECT Sender Connection with Station LOC with Credit 99 Odette Buff
77. Command Square brackets in the command descriptions indicate optional parameters Curled brackets and pipes list alternatives SID sid is an alias of activate Activates a partner station An rvsXP communication program starts and establishes the connection Queued data sets will be transmitted is an alias for testing the connection to a partner station without receiving files from your partner which wait for transmission process After receiving IOFTP_READY the connection is released Example check conn SID sid Hint This connection can also be executed via shell gt rvscom c sid xxx 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 CN cn Delete command with command number cn logically from database SID sid Delete station ID sid from all station table related database tables CN cn SID sid Free command with command number cn from hold status or release all suspended transfers to neighbor station sid CN cn SID sid Put command with command number cn in hold status or suspend all transfers to neighbor station sid List version and creation date of the rvsXP database CN n STATUS x rvsXP User Manual Rev 14 3 12 A1 3 T Systems GmbH rvs Systems
78. DDRESS 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 58 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 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 NetOpen cards Values for m 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 with 0 Example NETX2500 Card number 0 with port number 0 Default NETX2500 Card Type EICON or NetOpen Card Number Number of the X 25 card installed in the computer beginning with 0 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 progr
79. DETTEID 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 organization 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 14 3 12 39 T Systems GmbH 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 f
80. EAT 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 1 4 rvs parameter overview Please use the actual description of all rvs parameters in the Reference Manual because this chapter is deprecated The interval after which the statistical information about the active lines will 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
81. Export amp 8 Import Settings Parameters E Options E Environment u Start Program Dia SB Key Admin FR Tray Icon Press F1 to get help F5 for refresh rvsXP User Manual Rev 14 3 12 77 T Systems GmbH 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 e inthe rvs folder e inthe rvsXP Administrator using Program gt Diaor e with the rvsTraylcon The rvsXP window opens with display of not transmitted datasets y rysDia display of completely transmitted datasets ol x Eile Edit View Help iel xol S Entry No New File Name Disposition Time r Details File Name Local Name Receiver State Additional Information 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 information in four different display modes Display modes Send Reception Completely sent Completely received 78 How to work interactively with rvsXP Window areas Depending on the rvsXP display mode the entry list will display the list of files which have been sent or receive
82. 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 SsonVDOr mMoO gt D 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 14 3 12 A1 5 T Systems GmbH 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 that is found will be used Format MW 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 DTCONNO3 00 00 00 00 03 00 DTCONNOS5 00 00 00 00 05 00 DTCONNO7 00 00 00
83. P Parameters dialog window for editing the parameters will open In order for X 25 ISDN XOT reception to start automatically when the rvsXP Monitor starts you have to set the value of the rvsXP MAXX25RCV parameter to 1 ST 2x Parameter LOC LITRACELVL NUMRLOGS NOLIMIT NUMRLSTATS NOLIMIT OCREVAL 99 ODTRACELVL D DEXBUF 2048 OKPRIO 10 MAXX25RCV fi Apply e Double click MAXX25RCV in the parameter list Enter the desired value 1 into the input field e Confirm your entry with Apply e Use Close to exit the parameter list A message of the type I lt ISDN READY gt ISDN Receiver ready to accept incoming calls No 005361186751 indicates your readiness to accept calls rvsXP User Manual Rev 14 3 12 69 T Systems GmbH rvs Systems rvsXP User Manual 70 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 rvsXP Monitor as Usually the rvsXP Monitor works as a system service In order to install Windows service thervsXP Monitor as a system service it is necessary that you belong to the Windows 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 Servic
84. Reason 4 invalid password L 2009 01 08 09 23 06 lt ISDN READY gt ISDN Receiver ready to accept incoming calls No 326734482 A 2009 01 08 09 23 40 lt OK_READ gt RVSCNS ACT SID zzz2 I 2009 01 08 09 23 40 lt OK_ACTIVATE gt connect to station 2222 I 2009 01 08 09 23 40 lt OK_CMD DONE gt RVSCNS activate done L 2009 01 08 09 23 44 lt ISDN_READY gt ISDN Receiver ready to accept incoming calls No 326734482 O 2009 01 08 09 23 50 lt OFTP_RCV_END gt Receive TEST PDF 090108 091833 from LOC Destination LOC IE 7407 ends A 2009 01 08 09 23 50 lt NEW_CMD_CREATED gt 12 7429 created by IE 7407 O 2009 01 08 09 23 50 lt OFTP_END gt end SK 7405 status 0 TEST PDF 090108 091833 from LOC Destination ZZZ R 2009 01 08 09 23 50 lt SK_SENT gt SK 7405 sent C A Install ITIL TEST pdf to Z222 destination Z22Z as TEST PDF 2009 01 08 09 18 33 sent by kohoutd at LOC A4 14 Appendix 4 Operation with BinTec Router R 2009 01 08 09 23 50 lt IZ_DELIVERED 2009 01 08 09 18 33 Stored in c rvs usrdat TEST A 2009 01 08 09 23 50 lt CMD_TERMINATED e A 2009 01 08 09 23 50 lt NEW_CMD_CREATED A 2009 01 08 09 23 50 lt DSN_DELETED deleted termination of IE 7407 A 2009 01 08 09 23 50 lt CMD_TERMINATED e A 2009 01 08 09 23 50 lt NEW_CMD_CREATED A 2009 01 08 09 23 50 lt CMD_TERMINATED e A 2009 01 08 09 23 50 lt CMD_TERMINATED e E 2009 01
85. SID ZZZ NETID 222 STATNAME Testovaci stanice PHONE SIDTYP R rvsXP User Manual Rev 14 3 12 A4 11 T Systems GmbH rvs Systems rvsXP User Manual RT SIDDEST 22Z SIDNEIGHB ZZZ PRIORITY 1 NK SID 22Z FTP O PROTOCOL X AUTODIAL Y PRIORITY 10 FLGSUSPND FALSE PSESSIONS 1 DELAY 0 OP SID ZZZ ODETTEID 0094218623646 048 AA2 PSWFROM ZZZ PSWTO 222 SENDBLOCKS 0 RECVBLOCKS 0 OCREVAL 99 OEXBUF 2048 CODEIN A CODEOUT A USERFIELD RETRY EERP_IN NORMAL EERP_OUT SYNC VDSNCHAR ODETTE FLAGCOMP 0 FLAGCRYP 0 ROUTING B SECURITY OPT USEPKI NO USEULS OFTPLEV 2 USERSEP N DIRECTION COMP FLAGS CRYPFLAGS 1 XP SID ZZZ N 0 LINK CAPI2A0 TIMEOUT XADDRESS SUBAD DRESS ISDNNO 326734482 VC USERDATA CUG NO FACILITIES DBIT FALSE SESSIONS 1 ISDN_FAC ISDN_USRDT ISDN_PROT EDSS1 ISDN_TEI 0 RCV_N 2 RCVTIMEOUT 0 Station ZZZ2 ST SID 2222 NETID 2222 STATNAME Test 2 PHONE SIDTYP R RT SIDDEST 2222 SIDNEIGHB Z2Z2Z2 PRIORITY 1 NK SID 2222 FTP O PROTOCOL X AUTODIAL Y PRIORITY 10 FLGSUSPND FALSE PSESSIONS 1 DELAY 0 OP SID 2222 ODETTEID TEST PSWFROM PSWTO SENDBLOCKS 0 RECVBLOCKS 0 OCREVAL 99 OEXBUF 2048 CODEIN CODEOUT USERFIELD RETRY EERP_IN NORMAL EERP_OUT IMMEDIATE VDSNCHAR FLAG COMP 0 FLAGCRYP 0 ROUTING SECURITY USEPKI USEULS OFTPLEV USERSEP DIRECTION
86. Station dialog and select the ID 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 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 e Confirm your entries with OK The file size limit is at the moment 10 GB x Station ID LOC Station ID of receiver Select File C docs notes doc Search New File Name answer virtual file name r Options Disposition 7 delete after transmission Change Options Start Time J YY MM DD HH MM H hold at first Label 7 Serialization Format Unstructured C Text Fired Variable Settings for fixed and variable format Record Size fo Record Format Internal Test Native Test Native Binary Input Code code of the local file A 4SCIl E EBCDIC Output Code code on receivers side A 4SCIl E EBCDIC Codetable J Search Encryption mi Compression m I 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 82 How to work interactively with rvsXP Options Transmission settings and actions Disposition Clickthe delete after transmission checkbox to
87. T Systems rvsXP Version 5 07 User Manual rvsXP User Manual The products listed in this manual are protected by copyright rvsXP Version 5 07 User Manual 2012 by T Systems International GmbH Holzhauser Stra e 4 8 13509 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 T Systems 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 T Systems is not liable for technical or printing errors or defects in this manual Moreover T Systems shall not be liable for damage which is directly or indirectly caused by delivery performance and use of this material Contents Contents 1 Introduction 6 foes sind eaeeeeekaefen 8 1 1 Short description of the system u 8 1 2 History nassen kamen aE E A S aa paaa nie 8 1 3 Encryption and offline compression an een 10 1 4 TargetoroU Paea ee ee aaa aa a a E lem dices aa A Aaaa aa Aaa TEENAA 12 1 5 Structure of the rvs documentation ueanaeaseannnennnnnnnennnennnnennnnennnnnnnnnnennnenanann 13 1 6 Representation means zes 22 40 Harilen ee 14 2 Installation of FV SAP a ai 15 2 1 System requirements A an Le
88. T_COMPROC_FINI gt All communication processes are finished ic 3 Database amp u Settings ies u Start Program v P Press F1 to get help F5 for refresh num 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 Open the station table in the rvsXP Administrator using the rvs gt Stations menu command The window Station table for managing the partner stations opens The table contains four sample stations after rvsXP has been installed X rysXP Administrator Stationtable Oj x E File Edit View Monitor Database Window 2 l x 2 eI nxi Station Comment Odette 1D 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 H E Database E Settings E 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 34 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 t
89. 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 This manual is meant for regular users of rvsXP as well as administrators It provides an overview of the basic rvsXP functions and also background information on rvs 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 1 4995 1998 Jean Loup Gailly and Mark Adler for more information see Glossary Introduction 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 ISDN XOT and or TCP IP Before starting to work with rvsXP it is advisable to have read this book 1 5 Structure of the rvs documentation The rvs documentation consists of the following manuals User Manual 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 f
90. V 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 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 14 3 12 A1 15 T Systems GmbH 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 SSCREATE 1 These records contain the sta
91. XP User Manual Rev 14 3 12 T Systems GmbH rvs Systems rvsXP User Manual L Language environment variable A3 3 Launching rvsdiant exe 78 rvsmgr exe 77 Lc command A 4 LDSNPRIO parameter AI 7 License key NT 23 LID parameter A 7 Line driver AI 5 Line type neighboring station 45 LINK parameter 55 59 Link test 29 Listemd command A 3 Listdbv command A 3 Listing Key 124 User entry 99 listparm command A 2 AI 4 listst command Al 4 LITRACELEVL parameter 76 LITRACELVL parameter A1 7 AI 9 Al 16 LMPRIO parameter AI 7 LOC see Local station Local station 34 Activate 31 Managing 34 Setting up 34 Log file for troubleshooting A2 2 Log files 10 A2 1 Brief description A2 1 rlco log A2 1 rlog log A2 1 rlstat log A2 1 Troubleshooting A2 2 Lp command A 4 Ls command A 4 M Managing Local Station 34 Partner station 34 MasterTransmitter A5 2 MAX_IN parameter 51 MAXCMD parameter AI 7 Maximum sessions parameter 5 MAXRECL parameter A1 7 Al 12 MAXSENDERS parameter AI 7 Al 14 MAXX25RCV parameter 53 57 69 Al 7 AI 15 Monitor 2 A5 2 Starting 71 Stopping 73 Monitor parameters 74 Adapting 75 76 CNSMSGS A2 1 NUMRLOGS A2 1 NUMRLSTATS A2 1 RLCOMAXSIZE A2 1 RLOGMAXSIZE A2 1 RLSTATMAXSI A2 1 MSGPRIO parameter A 7 Multiple languages 0 N N parameter 5 56 59 NAME parameter AI 2 Neighboring nodes parameter 49 Network link test 29 New user 00 NK
92. a 7 WS 2003 WS 2008 or WS 2008 R2 Communication line based on ISDN TCP IP X 25 or XOT 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 sg bus having at least two data channels B channel and one control channel D channel ISDN adapter CAPI 2 0 driver software for operation of the ISDN card under your Windows system This is how you install the ISDN interface e Install the ISDN card into your computer and attach the ISDN card to the ISDN connection e 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 an ISDN router internal ISDN card In this configuration several applications can share the same Brick router The Brick router supports the Remote CAPI interface This m
93. 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 via rvsXP and rvsbat with code conversion Automatic ASCII to EBCDIC code conversion e Start the rvsXP program using right mouse button rvsTraylcon 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 e Select the desired file and confirm your selection with Open e Specify other send parameters Station ID andNew Name Specify the format of the file to be sent in the Options 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 rvsut2 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 e Start the rvsXP program using right mouse button rvsTraylcon 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 e Select the desired file and confirm your selection with Open 132 Code conversi
94. able 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 e double click the station entry or e execute the menu command Edit gt Update To set up a new station e click the right mouse button on the free area below the station list and choose Add or e 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 x r Station Station ID F ST Virtual T Comment Remote station via TCP IP Phone m Odette Odette ID 00023003036GEDASAYSCC Advanced Send password xx Receive password x Connection TCPAP x Advanced TCPAP IP Address fi 23 1 234 8 Port 3385 Cancel rvsXP User Manual Rev 14 3 12 35 T Systems GmbH rvs Systems rvsXP User Manual Simultaneous reception and sending via several lines The dialog shows depending on the feasibility of pertaining parameters diffe
95. 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 14 3 12 105 T Systems GmbH rvs Systems rvsXP User Manual Backing up the complete database Delete rvs database not be a clean initial state but rather an unmaintained state ofthe 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 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 rvsXP database e 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 ifthe message End appears StartrvsXP Monitor 7 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 e Make sure that all send and receive entries have been com
96. ailable 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 66 Configuration of rvsXP Stopping working Stopping 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 in the queue until you set the station working again The status is Disabled Saving Saving settings When you set up or change a station save the changed parameters by pressing OK When Windows 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 information please see the Chapter entitled 7 1 1 Backing up the station table 4 2 TCP IP reception Automatic 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
97. alog If you want to remove a user e Execute the menu command Edit gt 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 e Select the user to be edited in the User window e Execute the menu command Edit gt Update The User dialog opens You can now edit all ofthe 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 Administrator e 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 7 1 2 Saving the user table and follow on processing rvsXP User Manual Rev 14 3 12 101 T Systems GmbH rvs Systems rvsXP User Manual 102 rvsXP database maintenance 2 ways to back up and restore 7 rvsXP database maintenance
98. am 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 14 3 12 T Systems GmbH rvs Systems 59 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 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 oft
99. ameters icon in 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 110 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 To make unauthorized reading of information impossible you modify the encryption 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
100. and received transmissions The last chapter shows how to edit send and receive data sets Hint If files bigger than 2 GB are transmitted with AS 400 machine the transmission fails with an error message Set the WIndows Environment Variable RVSNOSIZECHECKSSID stationID of neighbour station to prevent this 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 CQ docs ex Fae File name notes txt Files of type All Files v Cancel e Select the file which you would like to send to your partner and confirm your selection with Open Example C docs notes txt Note When sending a file from a mapped network drive use UNC Universal Naming Convention names not drive letters UNC for Windows ServerName ShareName FileName Please check the user rights of the rvsXP Monitor if the file is not found see Assigning rvs Monitor special user rights on page 21 rvsXP User Manual Rev 14 3 12 81 T Systems GmbH rvs Systems rvsXP User Manual Example TheNew Send Entry dialog opens and displays the file name selected in the File field e Manually enter the station code for the receiving station in the Station ID field or e Choose Select to open the Select
101. as a call has been accepted the master transmitter starts a new receiver until the maximum number is reached Remote station only Number for differentiating the RCV_N various receivers through which the local station can be reached Note Each receiver should be defined in one XOT tab of the local station rvsXP automatically assigns and manages this number The first tab of the local receiver has the number 1 Default 1 4 1 9 Alternative Networks The functionality Alternative Networks offers you the possibility to reach the same partner station via several networks These could be different types of networks as e g TCP IP and ISDN or as well several sender of the same type of network This functionality is useful for line problems The parameter PRIORITY Partner Station gt Connection gt Advanced decides in which order rvsXP tries to establish the connection See chapter 4 1 3 Setting up Connection Parameters for the explanation of the parameter PRIORITY Please take notice of the following details if you are going to configure alternative networks If you want to configure a TCP IP network and an X 25 XOT ISDN network for a partner station at the same time you have to define two times the parameter PRIORITY in the configuration of your partner station As shown before the parameter PRIORITY decides which network is taken first for establishing the connection Notice The parameter PRIORITY may not have t
102. atically 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 akhoOnND o 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 and SYNCTO 5 rvsXP waits for a maximum of 5 times 400 ms until the connection is closed An EERP available for dispatch during this time will be sent and the connection closed thereafter Default 120 Maximum number of concurrently prestarted 1istening 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
103. ccording to the conditions of this database environment For further information please refer to Chapter 11 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 the follow on processing In order to back up the station table with all the parameters for partner stations e Start rvsXP Monitor e Openthe Station Table window with the Stations menu command e Execute the menu command Edit gt 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 104 rvsXP database maintenance e 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 r
104. 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 Receiver number Applies to the remote station only Number of the N 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 4 1 7 Setting up X 25 parameters Connection x25 0 Advanced x 25 0 x 25 Address Card Type NetOpen Port fo Advanced Card Number fo Link NETx2500 Remove Insert TCPAP ISDN x 25 OT Cancel OK If you have selected the X 25 connection inthe Connection type area you can edit the line parameters for the 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 56 Configuration of rvsXP You must specify the parameters shown in this tab to make the X 25 connection work Local station Selftest via x25 2 Advanced TCPAP 1 TCP IP 3 TCPAP 4 2512 x 25 Address 34672930 IV Start Card Type NetOpen Port fo Advanced Card Number fo Link NETX2500 Remove Insert TCPAP ISDN x 25 OT omes C 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 you
105. cs 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 new C rvs db rlstat log file when this size is reached You can restrict the maximum number of files generated with the NUMRLSTATS parameter rvsXP User Manual Rev 14 3 12 A2 1 T Systems GmbH 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 SPOUTDIR folder and deletes them after successful job completion In case of an error the program will not delete the protocol file which is then available for troubleshooting The rvsenv dat file defines the SPOUTDIR environment variable You can also use the rvsXP Administrator to set the value for this environment variable by choosing Settings gt 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 e Choose Edit gt Environment The rvs Environment dialog opens and displays the c
106. ctively 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 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 1 Transmission time for a 4 5 MB data set between two OS 2 node
107. d 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 1log 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 IE IZ QS Sample send order Status qq SE q SK q QE Abbr Event status Possible values status chain Send orders SE Send entry q p e SK Send command cd a i p e QE Acknowledgement receipt sent by recipient e Reception arrival IE Information entry about incoming information q f p e IZ Information delivery to the recipient q p e QS Acknowledgement transmission back
108. d 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 6 3 4 Handling files to be sent and received EERP_OUT VDSN 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 _ 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 42 Configuration of rvsXP Parameters Meaning of advanced Odette parameters Database parameter Routing Sometimes it is advantageous not to allow OFTP routing ROUTING This is possible by setting the rvs parameter ROUTING for single stations in the OP table Using the same parameter as a global rvs parameter you can suppress allow it or for all partner stations Possible values are IN the incoming file transmission from the partner e g XXX to the remote partner e g REM1 via our local station e g LOC is permitted XXX gt LOC gt REMI not permitted is the outcoming routing e g for the partner REM2 via REM1 LOC gt REM1 gt REM2 OUT partner stations can t use your local station as a router
109. d information on the RVSPATH parameter see Chapter 1 6 Representation means rvsXP User Manual Rev 14 3 12 133 T Systems GmbH 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 Start the rvsXP Administrator with right mouse button rvsTraylcon gt rvs Administrator or Start gt Programs gt rvs gt rvs Administrator Choose Job gt Receive The Resident Receive Entries window appears Choose Edit gt Add to add a new resident receive entry Enter your resident receive entry parameters Inthe 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 RVSPATH init rtcae dat or 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 Start the rvsXP Administrator with right mouse button rvsTraylcon gt rvs Administrator or Start gt Programs gt rvs gt rvs Administrator Choose Job gt R
110. e reinitialize rvsXP Disadvantage database Transmission data is deleted from Important Verify Chapter 7 3 the database whether or not Step 2 Recommendation Restore the station table Chapter 7 4 1 Step 3 Restore the user table and the follow on processing Chapter 7 4 2 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 14 3 12 T Systems GmbH rvs Systems 103 rvsXP User Manual To Back up Restore Recommendation benefits disadvantages Back up all 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 a
111. e Follow the installer instructions You can confirm the C rvs target folder or select another Please note that file and path names are not allowed to 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 Heed the appropriate dialog during installation if you wish to use another user account for the rvsXP service The installation program creates the rvs folder in the All Programs start menu folder along with the required links icons to rvsXP applications Hint for using rvsXP on Windows Vista Windows 7 and WS 2008 Systems If this applications should be executed by all users you have to set up the properties of the icons rvsXP Administrator rvsTraylcon and rvs Monitor with administrator privileges 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 C rvs db rvsXP runs normally with a intern C ISAM database If you would like to install rvsXP with an extern database e g Oracle or Micros
112. e as follows Install the interface card in your 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 T Systems GmbH has successfully tested the following X 25 cards for use with rvsXP EiconCard EICON Technology Corporation http Installation of rvsXP www eicon de Eicon C 90 91 PCI cards manufactured by Net Open Rua da Assembleia 10 sl 1201 Centro Rio de Janeiro Ru Brasil Connectionto http www net open com br TCP IP connection 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 e Display Network Connections Start gt Control Panel gt Network Connections The right window section displays existing dial in and network connections e Click the right mouse button on the desired connection and choose Properties e Choose the Network tab when you have chosen a dial in connection Windows automatically installs the TCP IP protocol If the TCP IP protocol is not contained in the list sho
113. e means a program that can be started from the operating system and works in the background 5 1 Starting rvsXP Monitor 3 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 Hint for Windows Vista or Windows 7 Systems Depending on your Windows User Account Control you will be prompted to confirm the operation before the rvsXP Monitor will be started 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 e Highlight the rvs Monitor line e 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 e Click the Startup type button and choose Automatic Starting Carry out the following steps if you want to start rvsXP Monitor at the at system level system level XP classic Windows style e Choose Start gt Settings gt Control Panel Windows Vista 7 Start gt Control Panel gt System and Maintenance e Start Administrative Tools
114. e 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 2 For more detailed information on the RVSPATH parameter see Chapter 1 6 Representation means 86 How to work interactively with rvsXP 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 rvsXP User Manual Rev 14 3 12 87 T Systems GmbH rvs Systems rvsXP User Manual rvsXP and interactive operation 6 3 4 Handling files to be sent and received This chapter describes how you can handle files with rvsXP if you are 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
115. e rvskey or Start the program rvsKey in the 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 rysKey The Generate New Keypair dialog opens 118 Encryption configuration Key administration Generate New Keypair m Filenames Private Key File c irysisystem locale30 pri Public Key File c rvsisystem locale30 pub Al m Begin of Validity Key Size start today 00 00 00 UTC 768 bit start now 1024 bit C begin 214 Feb 200044 C 1280 bit 1536 bit m End of Yalidity C 1792 bit C end 21 Feb 20054 C 2048 bit period 34 month C 1024 bit m Key Info Owner not specified Creator not specified Generate Cancel 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 rvskeyi
116. e 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 tells 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 ii 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 2 For more detailed information on the RVSPATH parameter see Chapter 1 6 Representation means A1 14 Appendix 1 The rvs parameters 1 6
117. eans 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 14 3 12 15 T Systems GmbH rvs Systems rvsXP User Manual X 25 connection Note T Systems 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 Longshine LCS 8051A Longshine http www longshine de BIANCA BRICK XS XL2 XM X4100 X4300 R1200 R4100 and R4300 Funkwerk EC http www funkwerk ec com XOT compatible Rou X 25 Uber TCP IP ter z B CISCO 801 CISCO 2600 CISCO 2800 BINTEC X4300 R1200 R4100 oder R4300 Cisco http www cisco com BinTec http bintec de rvs Support will provide you with the current list of tested devices phone from Germany 0800 664 77 45 phone from other countries 49 375 606 19 902 telefax 49 30 3497 4139 email rvs service t systems com If you want to use rvsXP to exchange data via an X 25 type network you need the following equipment X 25 network connection Interface hardware for interfacing the X 25 network in your computer Driver software for operation of the X 25 card under your Windows system If you already have this equipment then you install the X 25 interfac
118. eatures 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 Reference Manual 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 Messages and This manual describes all messages and error codes which could be Return Codes displayed on the rvs Monitor and in the log file Manual Media 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 rvsXP User Manual Rev 14 3 12 13 T Systems GmbH rvs Systems rvsXP User Manual Character styles Program names Directories 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 Courier Commands menu commands file names path names programs examples scrip
119. ecause the configured number is not existing Example of Incoming Call Answering rvsXP User Manual Rev 14 3 12 A4 5 T Systems GmbH rvs Systems rvsXP User Manual BIANCA BRICK XS Setup Tool BinTec Communications AG WAN WAN Interface brick Result of autoconfiguration Euro ISDN point to multipoint ISDN Switch Type autodetect on bootup D Channel dialup B Channel 1 dialup B Channel 2 dialup Incoming Call Answering gt Advanced Settings gt SAVE CANCEL Use lt Space gt to select BIANCA BRICK XS Setup Tool BinTec Communications AG WAN INCOMING Incoming Call Answering brick Item Number Mode Username PPP routing right to left ADD DELETE EXIT Press lt Ctrl n gt lt Ctrl p gt to scroll lt Space gt tag untag DELETE lt Return gt to edit 4 5 Settings of multiple ISDN controllers e g BRI O and BRI 1 Using of multiple ISDN lines is to set up in the station table SRVSPATH init rdstat dat via parameter LINK CAPI2AO for BRI O or LINK CAPI2A1 for BRI 1 A4 6 Appendix 4 Operation with BinTec Router The local station is to configure for incoming calls and the partner station is to configure for outgoing calls In rvsXP administrator the parameter LINK is configured by parameter Card Number It starts with figure 0 instead of rvsX which starts with figure 1 Properties for Station LOC Local Station x Station Station ID LOC Co
120. eceive The Resident Receive Entries window appears Choose Edit gt Add to add a new resident receive entry For more detailed information on the RVSPATH parameter see Chapter 1 6 Representation means 134 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 e StartthervsXP Administrator with right mouse button rvsTraylcon gt rvs Administrator or Start gt Programs gt rvs gt rvs Administrator e Choose Job gt Receive The Resident Receive Entries window appears e Choose Edit gt Add to add anew resident receive entry Enter your resident receive entry parameter Specify path and name of the user defined conversion table e g SRVSPATH arcdir rtcusr dat in Code Table Press the lt Enter gt 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 8 For more detailed information on the RVSPATH parameter see Chapter 1 6 Representa
121. ecommend 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 gt All Programs gt rvs gt rvs Administrator e Execute 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 e Confirm the entry by clicking Open rvsXP saves the tables and displays any errors inthe 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
122. ecovery You need an existing back up to restore data To recover data perform the following steps Stop rvs Delete and Reinitialize the database See chapter 7 3 Delete and reinitialize rvsXP database Restore static data To do so use the rvswdb and rvsbat program Syntax rvswdb i lt path of the input file gt Syntax rvsbat i lt SRVSPATH arcdir rlrudump log gt Example rvswdb iC rvs arcdir static dat Example rvsbat iC rvs arcdir rlrudump log Resore dynamic data Generate the list of send receive entries not yet fully processed using the rvsredo 1 command to pipe it into a file e g restore bat rvsredo 1 bC rvs arcdir dynamic log gt job bat At the command prompt launch the batch file e g restore bat generated with the rvsredo 1 command This will complete any 138 Backing Up and Recovering rvsXP Data rvs commands not yet processed files will be sent EERP will be sent or received Alternatively you can generate the list of send receive entries already completed and not yet fully completed using the rvsredo a command to pipe it into a file e g restore bat rvsredo a bC rvs arcdir dynamic log gt job bat e Call the batch file e g job bat The example batch files rvsbackup bat and rvsrecovery bat you can find in the directory SRVSPATH system 10 3 rvsredo Options The program rvsredo exe offers the following options Syntax rvsredo lacype tfbsdv
123. ection establishment parameter 47 ACTPCOUNT parameter A 5 Adapting Monitor parameters 75 76 AECCHECK parameter Al 5 Al 15 Allowed characters parameter 42 AP_DISPLAY_INTERVAL environment variable A3 2 Appendix A 5 ARCDIR environment variable A3 2 ASCII 41 A5 1 ASCII EBCDIC conversion 1 29 AUTODIAL parameter 47 B Backing up Station 67 Station table 104 User table and follow on processing 105 Back up Backing up rvsXP tables 104 Backing up the station table 104 Database complete 105 Overview 103 Recommended procedure 03 Restoring 108 Restoring the rvsXP database 109 Restoring the station table 108 Restoring user table and follow on processing 108 rvsXP 103 User table and follow on processing 05 Write to log A3 3 BACKUP parameter AI 5 Basic functions 9 BBCREATE parameter A1 5 AI 15 BBPRIO parameter A 2 AI 5 BinTec Router A4 1 Block size parameter 41 44 BRICKOFTPTI parameter AI 5 C C Cal interface 10 CDWAIT parameter 47 CDWAIT parameters A 5 Cisco A4 1 Cleaning up see Cleaning up the rvsXP database Cleanup command 709 Al 3 Al 14 Closed User Group parameter 56 60 CMDDELETE parameter 109 Al 5 Al 14 CMDTRACE parameter A 5 CNSMSGS monitor parameters A2 1 CNSMSGS parameter A 5 AI 16 Code conversion 129 During reception 134 During sending 132 Performing 132 Code translation parameter 4 CODEIN parameter 41 AI 5 CODEOUT parameter 41 AI 5 Command Cleanu
124. ecurity and authorization checking is performed Basic functions rvs automatically repeats the transmission after an unsuccessful continued connection attempt or disruption of a connection rvs only transmits rvsXP User Manual Rev 14 3 12 9 T Systems GmbH rvs Systems rvsXP User Manual Encryption even from V2 05 onwards 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 langua
125. ems Specify the maximum record size for files of the Variable format Record format Input Output Code Code Table Intern Windows 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 This feature can also be performed by rvsXP if you use the option Native Text or Native binary Text The file which should be sent in format fixed or variable must already exist in this format It means that this file contents only ASCII charachters Each line must end with CR LF Each line will be converted to one record In this case you do not need to use the utility rvsut2fv Native Text The file in format text will be converted in fixed or variable format by rvsut2fv before sending Native binary The file in format binary will be converted in fixed or variable format by rvsut2fv before sending For detailed description of these options and different file formats please the read the Chapter 9 Code conversion rvsXP User Manual Rev 14 3 12 83 T Systems GmbH rvs Systems rvsXP User Manual Options Transmission settings and actions Encryption To send a file with encryption and or compression you must enable the compression appropriate options For further information please see the Chapter entitled 8 Encryption configuration Key ad
126. en 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 4 1 8 Setting up XOT parameters If you have selected the XOT connection in the Connection type area you can edit the line parameters for the network connection on the XOT tab You may be ready to receive for a partner station via several XOT receivers at the same time From the rvsXP version 5 0 it is possible to configure several senders of the same network or and of another type of network for a partner station XOT routers are able to route X 25 packets between a TCP IP network on one side and a X 25 or ISDN network on the other side Please read the chapter XOT Router Configuration in the Reference Manual to achieve more information and hints how to configure your XOT router e You must specify the parameters shown in this tab to make the XOT connection work 60 Configuration of rvsXP Local station TOPAP 0 KOT 25 Address Router Address Link xoti 2 Remove Insert TCPAP ISDN x25 xOT Cancel OK rvsXP supports multiple XOT reception through various receiving channels atthe same time You can add additional XOT parameter sets on your local station LOC using the XOT button below the XOT tab Press the Remove button to delete the currently displayed
127. end order provision for which the p and e option is to be used Example 2005 10 26 11 20 34 140 rvsXP HighPerformance 11 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 systems of version 2 05 and later there is the option to link to an Oracle database Windows systems of version 2 11 and later can be linked to a Microsoft SQL Server rvsXP license License key The 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 11 1 Configuration of ORACLE Requirements To install rvsXP High Performance you must have a fully functioning Oracle database At the moment we support the link to the Oracle database version 10 and 11 Normally we recommand to have the same version of Oracle client and Oracle server Exception On Windows systems we recommand Oracle Client 10 with the Oracle Server 11 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 Here are two examples of the configuration file for LINUX and AIX Example LINUX syste
128. enkey 116 IEPRIO AI 2 Al 6 IN 41 INADDR 57 INITCMDS AI1 7 Input code translation 4 IP address 5 ISDN facilities 55 ISDN number 54 ISDN protocol 55 ISDN user data 55 ISDN_FAC 55 ISDN_PROT 55 ISDN_TEI 55 ISDN_USRDT 55 ISDNNO 54 IZPRIO AI 2 AI 7 KEEPDAYS A1 7 AI 14 LDSNPRIO AI 7 LID AI 7 LINK 55 59 LITRACELEVL 76 LITRACELVL AI 7 AI 9 AI 16 LMPRIO AJ 7 MAX_IN 51 MAXCMD A1 7 Maximum sessions 5 MAXRECL A1 7 AI 12 MAXSENDERS AI 7 AI 14 MAXX25RCV 53 57 69 Al 7 Al 15 MSGPRIO AI 7 N 51 56 59 NAME AI 2 Neighboring nodes 49 NUMRLOGS AI 7 NUMRLSTAT AI 7 OCREVAL 41 A1 7 Al 13 Odette 39 Odette Id 39 ODETTEID 39 ODTRACELVL AI 8 AI 9 AI 16 OEXBUF 41 44 Al 8 Al 13 OKPRIO AI 8 ORETRY AI 8 OTIMEOUT AI 8 OUT 42 Output code translation 47 Parallel sessions 47 56 59 PHONE 38 Phone 38 PKI 44 Al 11 PORT 51 Port 51 PRIORITY 47 49 Priority 47 49 PROTOCOL 46 PSESSIONS 47 PSWFROM 39 PSWTO 39 QEPRIO AI 2 AI 8 QSPRIO AI 8 QZPRIO AI 2 Rev Timeout 56 59 RCVTIMEOUT 56 59 Receive 39 Receiver 46 Receiver number 51 56 59 RECVBLOCKS AI 8 Al 13 Remote 38 RLCOMAXSIZE AI1 9 RLDBMAXSIZE AI1 9 rvsXP User Manual Rev 14 3 12 T Systems GmbH rvs Systems rvsXP User Manual RLOGMAXSIZE AI 9 ROUTING Al 9 RSTATMAXSIZE AI 9 rvskeydel 722 rvskeydst 722 rvskeyimp 120 SCPRIO 9 SDSNMAX AI 9 SDSNPRIO AI 9 SECURITY AI1 9 Self test via 46 Send 39 SENDBLOCKS
129. er A1 9 AI 13 Senders Number A 4 Sending File 81 Key file 121 With code conversion 732 Sending a file 27 81 SEPRIO parameter A 9 Serialization 10 85 SERVER environment variable A3 2 Services rvs Monitor 79 Starting 21 Startup type 20 SESSIONS parameter 56 59 setparm command 76 A 2 AI 4 Setting Environment variables A3 1 Set up Local station 34 Partner station 34 Routing 48 SID Al 4 SID parameter 38 SIDNEIGHB parameter 49 SIDTRACE parameter A1 7 AI 9 SIDTYP parameter 38 SLEEP parameter A1 9 AI 14 SNARCV parameter A 0 Sorting User entry 99 Sp command AI 4 SPFILESDIR environment variable A3 2 SPINDIR environment variable A3 2 SPOUTDIR environment variable A2 2 A3 2 SQL server link 141 Requirements 144 SSCREATE flag AI 16 SSCREATE Parameter AI 10 ST station table 37 Start rvsTraylcon 33 rvsXP administrator 34 Start command AI 4 Starting Dialog interface 77 rvsdiant exe 78 rvsmgr exe 77 rvsXP 78 rvsXP administrator 77 rvsXP Monitor 7 State of jobs 79 Station Activate 66 Backing up 67 Properties 35 65 Release 66 Renaming 66 Setting the status 66 Status change 66 Stopping 67 Station parameter 38 Station properties 38 Station ID parameter 38 Station list 82 Station name parameter 38 Station parameters Virtual 38 Station status Editing 66 Setting 66 Station table Backing up 04 Restoring 08 StationsConfigFile
130. er 20 lt TCPIP_READY lt DISCONNECT lt DISCONNECT 1300 TCP IP Receiver ready to accept incoming calls Port 3305 Connection as receive to Station LOC ended Connection as send to Station LOC ended lt COPYRIGHT gt rvsXP3 01 00 c gedas 2004 All rights reserved E ws lt INIT_CHD gt rpm Reading initial commands 3 Stations lt OK_READ gt RVSCNS cleanup days 3 ss yes m Users lt CLNUP_DEL_S5 gt Cleanup of RVS data base purge all SendStatistics with DTEND lt 2003 1 rs By Jobs lt CLNUP_START gt Cleanup of RYS data base purge all commands with DTDONE lt 2003 04 25 3 6 Loge lt CLNUP_NONE gt Cleanup of RV3 data base ended there are no commands to be purged lt XMT_START gt MasterTransmitter started 8 lt SP_START gt Service Provider started Compression yes Security no zal Statistics lt TCPIP_READY gt 548 TCP IP Receiver ready to accept incoming calls Port 3305 fE Active Panel lt 0K_READ gt RVSCNS ACTIVATE SID LOC B 8 Database lt 0K_ACTIVATE gt connect to station LOC H x lt CALL_OUT gt 1808 outgoing call to SID LOC i Settings lt INCOMING CALL gt Incoming call received LOC EB Start Program lt CONNECT IND gt Responder Connection with Station LOC with Credit 99 Odette Buffer gt gt gt gt Press F1 to get help F5 for refresh e Check the output in Monitor Log for error messages Eliminate any errors that
131. eter 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 one value at a time 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 Activate Act Check_conn Cleanup Delcmd Delst Freecmd Holdemd Listdbv Listcmd 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 Operator
132. eters rvsXP User Manual Rev 14 3 12 65 T Systems GmbH rvs Systems rvsXP User Manual Renaming Setting the status Activate Default setting set working 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 To rename a station In order to do so open the station table in the rvsXP Administrator using the Stations command e Choose the station to be renamed and execute the menu command Edit gt Rename or e Click the station to be renamed with the right mouse button and choose Rename The Rename station dialog opens Type anew name and confirm your entries with OK 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 gt Activate Note The station must already be Enabled before you can activate it 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 av
133. files to the SRVSPATH init folder SRVSPATH system rtcae dat SRVSPATH system rtcea dat 5 For more detailed information on the RVSPATH parameter see Chapter 1 6 Representation means 130 Code conversion 9 2 Code conversion with 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 rtcae dat orrtcea 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 sho
134. g interface A5 Starting 77 Directories 14 Display mode 78 Reception 79 Sending 79 Displaying Jobstart entry 97 Received files 86 Refreshing 87 Resident receive entry 93 Send order 85 Transmissions 85 User entry 99 Displays Refreshing 86 DTCONNnn parameter A 6 DTCONNxx parameter A 4 E EBCDIC 41 A5 1 EBCDIC ASCII conversion 29 EDI A5 1 EDIFACT A5 1 Editing Jobstart entry 98 Resident receive entry 95 Send order 88 User 01 User entry 99 Editing parameters A EERP A5 EERP see also End to End Response EERP_ OUT parameter 42 AI 6 EERP_IN parameter 41 A1 6 Electronic Data Interchange A5 Encryption 0 and electronic signature Asymmetrical method 771 Basics 1 11 Features 2 Key administration 715 rvsXP principle and procedure 712 Symmetrical method 711 End to End Response 41 48 A1 6 A5 1 Environment variable AP_DISPLAY_INTERVAL A3 2 ARCDIR A3 2 DB A3 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 SYSTEM A3 2 TEMP A3 2 USRDAT A3 2 Environment variables A3 2 Setting A3 1 Index SPFILESDIR A3 2 SPINDIR A3 2 SPOUTDIR A3 2 Equipment See System requirements Establishment of an active connection 47 ETSI AS5 1 Exit rvsXP 80 Explanation of special terms A5 F FACILITIES parameter 55 59 Features Encryption 2 Offline compression 12 Files rd
135. g rvsXP Monitor parameters sssssenessernserrrneeernersstressrrrnnerrnnnnennne 74 6 How to work interactively with rvsXP uunesssnnnnnnannnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnennnnnnnnnannnnen 77 6 1 Starting rvsXP Administrator rvsmgr exe uusnssnnnnnnnnennnnnnnnnnnnnennnnnnn 77 6 2 Starting rvsXP rvsdiant ere ee re 78 6 3 How to send and receive files with rvsXP c cccceeceeeeesseeeeneeeeeeeeeseeessereeeeeeees 81 6 3 1 Creating send Orders sense ee an nee dezer ae 81 632 Serialization eser ee Eines 85 6 3 3 Displaying send requests and received files _ nnssssnenennnennne nennen 85 6 3 4 Handling files to be sent and received uusnssssssnnnannnnnnnnnnnnnannnnnnnnnn nn 88 6 3 5 Selecting display criteria zert sase ae re 90 rvsXP User Manual Rev 14 3 12 3 T Systems GmbH rvs Systems rvsXP User Manual 10 11 12 6 4 Administration wiih usXP ae 92 6 4 1 Resident receive entries ses ek 92 6 4 2 Job start after send attempt nee 96 64 3 User administration ut erteilen 99 rvsXP database maintenance uuuuunnsssnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnennnnnnnnnannnnen 103 7 1 Back up backing up rvsXP tables uunzeesnnsnnannnnnnnnnnnnnnnnnannnnnnnnnnnnnnnnnnnee 104 7 1 1 Backing up the station table anna be Meee eds 104 7 1 2 Saving the user table and follow on processing uuusssnnnneennnnnnenennnnnnnenn 105 7
136. g the partner stations opens e Select the local station e Double click the station entry or choose Edit gt Update to edit the station rvsXP User Manual Rev 14 3 12 29 T Systems GmbH rvs Systems rvsXP User Manual Properties for Station LOC Local Station Station Station ID LOC Comment Local station Phone o Odette Selftest via TCPAP Advanced TCPAP son x25 IP Address 192 193 0 1 v Stark Port 3305 Max Sessions 5 Remove Insert TCPAIP ISDN x 25 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 30 Function Tests e Check the output in Monitor Log A message must indicate the chosen connection is ready to receive S rysXP Administrator Monitor Log lolx MM Fie Edit View Monitor Database Window 2 lej x a lo lt COPYRIGHT gt rvsXP3 01 00 c gedas 2004 All rights reserved I ns lt INIT_CMD gt rpm Reading initial commands 3 Stations lt 0K_READ x RVSCN5 cleanup days 3 ss yes m Users lt CLNUP_DEL_33 gt
137. ges 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 1 3 Encryption and offline compression rvs provides powerful customizable functions that add useful features to the rvs data transmission solution Introduction rvs is able to encrypt and decrypt files in order to ensure privacy of the data when being transmitted 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 netw
138. guring 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 rvsXP Administrator program e by launching itin the rvs folder or e with the rvsTraylcon or e use Start gt All Programs gt rvs gt rvsXP Administrator The rvsXP Administrator opens with the Monitor Log window displaying the current rvsXP Monitor activities X rvsXP Administrator Monitor Log 5 xj I File Edit View Monitor Database Window 2 z gj x BI D 2 W 9 af lt COPYRIGHT gt rvsXP3 01 00 c gedas 2004 All rights reserved a vs lt INIT_CHD gt rpm Reading initial commands 3 Stations lt OK_READ gt RVSCNS cleanup days 3 ss yes si Users lt CLNUP_DEL_55 gt Cleanup of RVS data base purge all SendStatistics with DTEI Sy Jobs lt CLNUP_START gt Cleanup of RYS data base purge all commands with DTDONE lt T Recei lt CLNUP_NONE gt Cleanup of RVS data base ended there are no commands to be oor lt XMT_START gt MasterTransmitter started Send z lt SP_START gt Service Provider started Compression yes Security no 8 g Logs lt TCPIP_READY gt 1696 TCP IP Receiver ready to accept incoming calls Port lt s Monitor lt LGU gt lt XMT_COMPROC_FINI gt All communication processes are finished A Statistics Active Panel a Database 8
139. he same value for different networks rvsXP User Manual Rev 14 3 12 63 T Systems GmbH rvs Systems rvsXP User Manual What are virtual stations Receiving at virtual stations Example TCP IP as PRIORITY 4 X 25 ISDN XOT PRIORITY 8 In this example the TCP IP network is taken at first because the value of PRIORITY is lower PRIORITY 4 lower value means higher priority in this line e For the parameter PRIORITY there are only two types of the network TCP IP on one side and X 25 ISDN XOT on the other side e For different types of networks senders it is necessary to configure different register cards with connection parameters Possible is to define several senders for one type of network e g several TCP IP register cards or and several different networks e g one TCP IP and one X 25 register card Example partner station NML with three TCP IP and two ISDN senders PRIORITY for TCP IP 10 PRIORITY for X 25 ISDN TXOT 20 In this example three TCP IP senders and two ISDN senders were configured Because the value of the priority parameter of the TCP IP network is lower as for the ISDN network all TCP IP senders Sequential at first line with TCP IP 1 then TCP IP 2 and at the end the line TCP IP 3 will be tried at first If there is no success with the TCP IP network two ISDN senders are the next for establishing the connection 4 1 10 Setting up a virtual station Virtual stations are used
140. ile a transmission from local station to station ZZZ is active The local station is configured with two ISDN receivers on port BRI 1 ISDN number is 326734482 parameter LINK CAPI2A1 Parameter MAXX25RCV 2 is set up in file rvs init rdmini dat Station ZZZ uses Port BRI O parameter LINK CAPI2A0 and calls number 326734482 i e the local station Station LOC ST SID LOC NETID LOC STATNAME local station PHONE SID TYP R RT SIDDEST LOC SIDNEIGHB LOC PRIORITY 10 NK SID LOC FTP O PROTOCOL X AUTODIAL Y PRIORITY 10 FLGSUSPND FALSE PSESSIONS 1 DELAY 0 OP SID LOC ODETTEID 0094218623646 048 AA2 PSWFROM ZZZ PSWTO ZZZ SENDBLOCKS 0 RECVBLOCKS 0 OCREVAL 0 OEXBUF 0 CODEIN CODEOUT USERFIELD RETRY EERP_IN NORMAL EERP OUT NORMAL VDSNCHAR FLAG COMP 0 FLAGCRYP 0 ROUTING SECURITY USEPKI USEULS OFTPLEV USERSEP DIRECTION COMP FLAGS CRYPFLAGS XP SID LOC N 2 LINK CAPI2A1 TIMEOUT XADDRESS SUBAD DRESS ISDNNO 326734482 VC USERDATA CUG NO FACILITIES DBIT FALSE SESSIONS 1 ISDN _FAC ISDN USRDT ISDN PROT EDSS1 ISDN _TEI 0 RCV_N 0 RCVTIMEOUT 0 XP SID LOC N 1 LINK CAPI2A1 TIMEOUT XADDRESS SUBAD DRESS ISDNNO 326734482 VC USERDATA CUG NO FACILITIES DBIT FALSE SESSIONS 1 ISDN_FAC ISDN USRDT ISDN PROT EDSS1 ISDN _TEI 0 RCV_N 0 RCVTIMEOUT 0 Station ZZZ ST
141. ile transfer protocol OFTP 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 Translation Exchange Buffer Input fascn Size jo Output ASCII Credit jo EERP Limitation In NORMAL VDSN Chars ODETTE Out IMMEDIATE x Routing BOTH Security ort OFTP Yersion 1 3 se PKI no x User Separation ND v Crypt Version fi Online Decryption NO Cancel 40 Configuration of rvsXP Parameters Meaning of advanced Odette parameters Database parameter Exchange buffer Maximum transmission buffer size OEXBUF size Default 0 i e OEXBUF from parameter table applies Exchange buffer Maximum number of blocks sent without acknowledgement OCREVAL credit expected Default 0 i e OCREVAL from parameter table applies Code translation Input format of the file which is to be sent prior to CODEIN input 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 Code translation Target format of the files for send transmission Values CODEOUT output ASCII During transmission rvsXP converts the files which are to be sent from input code format into ASCII format EBCDIC During transmission rvsXP co
142. indow size 7 recommended for ISDN XOTX window size 2 recommended for X 25 native Note Window size in X 25 ISDN communication is the number of packets that can be outstanding without acknowledgment The window size will be negotiated during connection setup but we recommend you to use the correct window size depending on the partner network X 25 Address Local station optional own X 25 address This XADDRESS parameter should be configured only if your partner expects it Remote station mandatory remote X 25 address 62 Configuration of rvsXP Parameters Meaning of parameters XOT Database parameter Router Address IP address of an XOT router This parameter is ALIAS optional for the local station and mandatory for the partner station X 25 Facilities Special information or facilities for an X 25 FACILITIES transmission For further information see X 25 protocol description X 25 Userdata Only for partner station User data for an X 25 USERDATA transmission For further information see X 25 protocol description Time out Only for partner station Cancellation time in TIMEOUT seconds after which the communication program aborts the connection if the partner station or CAPI does not reply Default 30 Parallel sessions Receiver Number Only for local station Maximum number of parallel SESSIONS active receivers The following applies for reception As soon
143. information See Setting up a virtual station on page 64 Possible values 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 This feature must be on in the licence key for an internal database ISAM For an external database it is inklusive and must not be regulated by the licence key 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 38 Configuration of rvsXP For routing no passwords 4 1 2 Setting up ODETTE parameters Odette Odette ID 00023003036GEDASRYSCC Advanced Send password pox Receive password xx 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 O
144. ional 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 14 3 12 127 T Systems GmbH rvs Systems rvsXP User Manual 128 Code conversion 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
145. key dat 23 rdmini dat 74 76 110 rlco log A2 1 rlog log Al 14 Al 16 A2 1 rlstat log AI 16 A2 1 Flag SSCREATE A1 16 Follow on processing Backing up 05 Restoring 108 FORCEDEND parameter AI 6 Al 9 Forwarding see Routing Forwarding Support Service A5 Freecmd command A 3 FSS A5 1 Function test rvsXP 27 G genkey program 1716 Glossary A5 1 GNU A5 2 GNU zip algorithm 12 A5 2 H Holdcmd command A 3 Holding Send order 88 Holding temporarily Send order 88 IEPRIO parameter AI 2 Al 6 Importing Key 119 IN parameter 41 INADDR parameter 57 INIT environment variable A3 2 INITCMDS parameter AI 7 Initializing rvsXP database 06 Input code parameter 41 Installation rvsXP 17 Interface C Cal 10 Command prompt 10 User 10 IP address parameter 51 ISDN tab 52 ISDN connection 15 46 ISDN Facilities parameter 55 ISDN number parameter 54 ISDN protocol parameter 55 ISDN reception 69 ISDN UserData parameter 55 ISDN_FAC parameter 55 ISDN_PROT parameter 55 ISDN_TEI parameter 55 ISDN_USRDT parameter 55 ISDNNO parameter 54 IZPRIO parameter AI 2 AI 7 J Job rvskeyimp 719 Jobstart entry Creating 97 Displaying 97 Editing 98 Removing 99 K KEEPDAYS parameter AI 7 AI 14 Key Creating 116 Deleting 22 Importing 719 Listing 724 Key administration 715 Configuration 111 Key features 9 Key file Sending 121 KEYDIR environment variable A3 2 rvs
146. l Station RST x Name of sending station Virtual data set name iat New data set name Search Replace F Disposition Record handling C Replace data set Keep Standard 7 New data set Delete Ignore data set Timestamp TI Code conversion _ none 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 Enter the file or the file specification for which 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 e If you want to change the file name after it has arrived enter the new file name inthe New data set name field Disposition determines whether the received file is deleted or kept after reception and execution of the RE Important Hint If you use option delete the received file will be deleted and can not be used for further actions It is only used as Trigger for the resident receive entry e When you decide upon Disposition keep and the C rvs usrdat folder contains a file with the same name you can enable the Replace
147. line type table 37 Number Senders Al 4 X 25 or ISDN receivers AI 15 NUMRLOGS Monitor parameter A2 1 NUMRLOGS parameter A 7 NUMRLSTAT parameter AI 7 NUMRLSTATS Monitor parameter A2 1 O OCREVAL parameter 41 Al 7 Al 13 ODETTE Explanation of terms A5 2 Odette A5 2 File Transfer Protocol 39 A5 3 Identification 39 ODETTE ld parameter 39 ODETTE parameters 39 ODETTE parameters table 37 ODETTEID parameter 39 ODTRACELVL parameter A 8 Al 9 Al 16 OEXBUF parameter 41 44 Al 8 Al 13 Offline compression 10 127 Configuration 127 Features 2 OFTP A5 3 OKPRIO parameter A 8 Online compression 70 Opcmd command A 4 Open System Interconnection A5 3 Oracle link 141 Orders See also Command ORETRY parameter A 8 OSI A5 3 OTIMEOUT parameter A 8 Index OUT parameter 42 Output code parameter 41 P Parallel sessions parameter 47 56 59 Parameters ACTPCOUNT AI 5 AECCHECK AI 5 Al 15 Allowed characters 42 AUTODIAL 47 BACKUP AI 5 BBCREATE A1 5 AI 15 BBPRIO AI 2 Block size 41 44 BRICKOFTPTI AI 5 CDWAIT 47 AI 5 Closed User Group 56 60 CMDDELETE 109 Al 5 Al 14 CMDTRACE AI 5 CNSMSGS AI 5 AI 16 Code translation 41 CODEIN 41 AI 5 CODEOUT 41 AI 5 Compression 43 Connection 46 Connection type 45 CUG 56 60 Delay 47 DTCONNnn 41 6 DTCONNxx AI 14 Editing AI 1 EERP_IN 41 AI 6 EERP_OUT 42 AI 6 Establishment of an active connection 47 FACILITIES 55 59 FORCEDEND AI 6 Al 9 g
148. ll be sent repeatable 1 lt FILE gt The file containing a list of station IDs Example rvskeydst f C rvs keycreate C45PUB pub s riil s a34 s tsystems rvskeydst f C rvs keycreate C45PUB pub 1 C rvs list sendlistl lst 8 6 Deleting imported keys rvskeydel The rvskeydel 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 at 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 exe 1 DelFile txt Remove the comment indicator REM from those keys you wish to delete e 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 122 Encryption configuration Key administration d KEYID Delete key with the ID KEYID u Remove the public key r Remove the private key Exam
149. mber and the rvs version and he will send you a license key by email e Make a backup copy of the old C rvs init rdkey dat file in order to be able to restore the original file status e You should save the received license key as rdkey dat file in the Init folder The license key has now been adapted rvsXP User Manual Rev 14 3 12 23 T Systems GmbH rvs Systems rvsXP User Manual rdkey dat file Expiration date Structure of the license key data 0000000000 XP 5 00 5LTX TESTINSTALLATION TESTVERSION 94211 CA580BE5 20189735 162D0D7F 18FAB129 KREKEKKKKKKKKKKKKKKKK C Customer Product Release Included Customer one Customer two reserved reserved reserved reserved reserved Computer PHYSICAL Number Components Name Part Name Part Model CPU IDENTIFICATION Expiration Date 612035F9 77AD6591 53B14EA4 79390F44 T Systems 2007 make a success of rvs kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkxk 00000010 00000020 00000030 00000040 00000050 00000060 00000070 00000080 00000090 00000100 00000110 00000120 00000130 00000140 00000150 00000160 00000170 00000180 00000190 Included Components may contain two or more feature codes rvs rvs Encryption TN lt WMX lt _ oO Offline Compression Number of partner stations TCP IP communications X 25 native ISDN communications Engdat with Engpart Client Server Not all features a
150. ministration For more information on compression please refer to Chapter 8 9 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 y rysDia display of not transmitted datasets u ol x File Edit View Help Dis xislo S x Entry No New File Name m Details Disposition Time 2003 04 28 23 28 41 File Name NOTES DOC Receiver Loc r Additional Information Transmitted 0 Block Size 0 Format u Local Name State Command Numbers SE 48 SK 0 C klocsinotes doc aq Date Time Disposition 2003 04 28 23 28 41 Start of Transmission Send Attempts 0 Encryption NO Compression NO End of Transmission Send Attempt at 2003 04 28 23 28 41 dataset won t be deleted after successful transmission New Send Entry Delete Hold Select Refresh Press F1 for help F5 for refresh 23 28 4 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 84 How to work interactively with rvsXP
151. mment flocal station Phone Odette Odette ID 0094218623646 048 442 Area Selftest via sont Advanced TCPAP 1 ISDN 1 ISDN Number 326734482 M Start Card Number fo x Advanced Protocol Link CAPI2A0 Remove Insert TCPAP d 4 6 Parameter RCV_N with neighbourstations Use the RCV_N parameter of neighbour station to define number of the receiver of local station whose parameters are used to define the calling party number own local ISDN number and local x 25 address This parameter is used to setup a connection to the neighbour station Example XP SID ZZZ N 0 LINK CAPI2A0 TIMEOUT XADDRESS SUBADDRESS ISDNNO 326734482 VC USERDATA CUG NO FACILITIES DBIT FALSE SESSIONS 1 ISDN_FAC ISDN_USRDT ISDN PROT EDSS1 ISDN_TEI 0 RCV N 2 RCVTIMEOUT 0 rvsXP User Manual Rev 14 3 12 A4 7 T Systems GmbH rvs Systems rvsXP User Manual In rvsXP administrator gt button Advanced in ISDN 0 card RCV_2 parameter can be set up Properties for Station 222 Remote Station MER f x l ISDN Advanced BE x r Station 2 R ISDN Number 326997448 Station ID Zz Virtual I alae 25 Address Comment Testovaci stanice Phone ir E Card Number fi x Protocol eoss1 gt m Odette Packetsize 128 x Odette ID 0094218623646 048 442 A asf Send password ZZ Timeout Receive password ZZ X25 Facilities 25
152. mp 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 14 3 12 119 T Systems GmbH rvs Systems rvsXP User Manual Launching via the command prompt Syntax rvskeyimp i lt FILE gt s lt SID gt x Options i lt FILE gt 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 X The key that is being imported is an X 509 certificate Example rvskeyimp i C rvs usrdat Al5Al3 pri s LOC rvskeyimp i C rvs usrdat A15A13 pub s RSL Graphic interface To import the keys into the rvsXP database choose the Import symbol in the rvsKey dialog to launch the rvskeyimp tool rysKey File o x File Tools Help Gi N Import Delete Generate El 2 stations Info i a Key ID BP ast SID a ARSK Filename no file entry in the database Creator E Owner Creation Time m Version Serial Number Version Mode Type private m Run of Validity Begin End import a new key entry WZ 120 Encryption configuration Key administration e Select the
153. ms with Oracle environment variables LINUX ORACLE OWNER oracle export ORACLE OWNER ORACLE HOME opt oracle product 10 export ORACLE HOME ORACLE SID rvslnx4 export ORACLE SID export DBID ORA PATH PATH ORACLE HOME bin export PATH 10 For more detailed information on the RVSPATH parameter see Chapter 1 6 Representation means rvsXP User Manual Rev 14 3 12 141 T Systems GmbH rvs Systems rvsXP User Manual Configuration file Example AIX LD LIBRARY PATH LD LIBRARY PATH home bwa rvs system home bwa rvs lib opt oracle product 10 lib export LD LIBRARY PATH AIX ORACLE SID rvsora export ORACLE SID export DBID ORA PATH PATH 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 Note If Oracle is running on an external computer this computer must be defined in the file SORACLEHOME network admin tnsname
154. n 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 e use the same label and enable the Serialization checkbox for all subsequent files create all send entries linked by the 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 rvsXP User Manual Rev 14 3 12 85 T Systems GmbH rvs Systems rvsXP User Manual
155. ner 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 OF TP 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 Neighbour station station rvsXP User Manual Rev 14 3 12 47 T Systems GmbH rvs Systems rvsXP User Manual With routing Local i Target 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 in the station table for routing e 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
156. nes the time difference is not considered p per string Validity period d D t T day m M month j J y Y year h H hours illI minutes 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 768 Creates a key pair with 768 bits In the dialog 768 bit 1024 2048 Creates a key pair with 1024 bits In the dialog 1024 bit 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 Generates 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 14 3 12 T Systems GmbH rvs Systems 117 rvsXP User Manual Graphic interface Start rvsKey with Start gt Run and typ
157. nverts the files which are to be sent from input code format into EBCDIC format Default ASCII EERP Send transmission EERP End to End Response EERP_IN IN 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 rvsXP User Manual Rev 14 3 12 41 T Systems GmbH rvs Systems 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 next connection HOLDIMMED Prepare acknowledgement after successful file reception However do not sen
158. o 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 XOT reception Partner stations serveral sets of From the rvsXP version 5 0 it is possible to configure several senders for parameters a partner station After editing the basic parameters click the Advanced button to the right of the parameter input boxes to open the ISDN Advanced dialog where you can edit these and other parameters rvsXP User Manual Rev 14 3 12 53 T Systems GmbH rvs Systems rvsXP User Manual ISDN Advanced x ISDN Number x 25 Address Card Number Protocol JEDSSI pal Packetsize 128 bt Alias Timeout 25 Facilities 25 Userdata Terminal Identifier Parallel Sessions ISDN Facilities ISDN Userdata Closed User Group DBit ll Receiver Number Cancel e 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 This number is optional It is however advisable for an ISDN connection to enter the ISDN number here as s
159. occur in accordance with the advices in the Messages and Return Codes manual rvsXP User Manual Rev 14 3 12 31 T Systems GmbH rvs Systems rvsXP User Manual 32 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 rvsXP user rights Logging onas The rvsXP 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 4 11 39 AM To display the rvsTraylcon right after installation e choose Start gt All Programs gt rvs gt rvs rvsTraylcon 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 Stop rvs Monitor rvs Administrator rvs Clase rysTrayicon To start the rvsXP programs with the rvsTraylcon e click
160. oft SQL please read the chapter 11 rvsXP HighPerformance for more information Installation of rvsXP Automatic or manual service start 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 ifthe 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 Change startup type Choose Start gt right mouse My Computer gt Change a setting e Launchthe Start gt Control Panel gt Administrative Tools gt Services program Windows Vista 7 Start gt Control Panel gt System and Maintenace gt Administrative Tools gt Services e Search the list of services for rvs Monitor and select the service by clicking the appropriate line gt Services File Action View Help R gt Services Local Name Description Status Startup Type Log On As s Sa Print Spooler Loads files Started Automatic Local System Start the service Sa Protected Sto
161. ome partners expect an X 25 address Parameters Meaning of parameters Database ISDN parameter ISDN number An ISDN number under which the partner station may be ISDNNO reached For the 1TR6 ISDN standard the single digit EndSelectionNumber ESN is assigned to the local station Default X 25 address 15 digit X 25 DTE address of the partner station XADDRESS 54 Configuration of rvsXP Parameters Meaning of parameters ISDN Database parameter 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 form and n m A no Diehl Eicon card 0 Diehl Eicon card n Number of the X 25 card installed in the computer beginning with 0 Example CAPI200 Diehl Eicon card number 0 Default CAPI200 LINK Card Number Number of the X 25 card installed in the computer beginning with 0 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
162. on e Specify other send parameters Station ID andNew Name e Specify the other send parameters Station ID andNew Name e Under Options specify the format of the file to be sent see Chapter 6 3 1 Creating send orders e Click the Search button in the Codetable area to specify the path to your own conversion table e g SRVSPATH arcdir rtcusr 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 a 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 e Start the job with rvsbat ijoborrvsbat ijob Result The ASCII file lt file to send gt will be sent as an EBCDIC file Code conversion with user specific code conversion tables e 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 gt format U sid lt recipient gt codetrans t codetable lt path and name of user code table gt e Start the job with rvsbat ijoborrvsbat ijob Result A file lt file to be sent gt 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 6 For more detaile
163. option to choose whether to replace the existing file create a new file with a unique name default or ignore the file being received 94 How to work interactively with rvsXP e 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 e 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 gt ASCIl e Use Search to select the batch program that should start when the file arrives e Confirm your entries with OK rvsXP Administrator writes the new entry to the rvsXP database and displays it in the list of resident entries Is r sXP Administrator Eile Edit View Monitor Database Window 51 x gx ca Resident Receive Entries SID DSN Virtual Dataset Name Program Comment 3 Stations TXT Cirvsis miresentr bat _ Starts batch program resentr bat ER Users E S Jobs _ Receive Send a f Logs a Database BR Settings D Start Program Press F1 to get help F5 for refresh NM z Editing resident receive entries To edit a resident receive entry Select the entry to be modified
164. or 0 x File Edit View Monitor Database Window 3 Stations English Administrator CE By Jobs el Receive E Send t _ Logs J Database E u Settings E u 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 rvsXP User Manual Rev 14 3 12 99 T Systems GmbH rvs Systems rvsXP User Manual New user User dialog To set up a new user Choose Edit gt Add The User dialog opens and displays the User Table parameters User ID SM Full Name Steve Miller Language Engish Privileges use o Cancel Enter the user identification UID Note Heed upper and lowercase spelling The spelling of your rvsXP user ID must match that of the Windows user name To ensure this copy the exact spelling of your Windows user name from the Windows User Administration Enter the complete user name character and numeric character Select the language for screen dialog e Use the mouse to click on the user access authorization e 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 100 How to work interactively with rvsXP Removing a user User di
165. or 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 3 blanks If you need to trace incoming data 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 14 3 12 A1 9 T Systems GmbH rvs Systems rvsXP User Manual SNARCV SSCREATE STATISTICS SYNCDL SYNCTO TCPIPRCV TIMESTAMP TMAXCON TSTODPRCT Enables start of SNA Transaction Program autom
166. ork 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 Sender and receiver Compression and encryption are available if both partner stations sender use rvs 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 Product Com Secure is an independent product for offline encryption and independent compression developed by rvs that also runs with other OFTP products of rvs other than rvs rvsXP User Manual Rev 14 3 12 11 T Systems GmbH rvs Systems rvsXP User Manual Symmetric and asymmetric encryption New key for each session Digital signature Algorithm GNU zip For rvsXP users and administrators Encryption features The security of rvs uses both symmetric 3DES and public private key encryption RSA Symmetric encryption uses the same key for both encryption and decryption The public private key manner use
167. orresponds to the connection with remote stations Path used to reach the local station during a self test X 25 ISDN TCP IP XOT Details 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 Stationtable Odette parameter line type NachbarKnoten neighbor node Routingtable X 25 ISDN XOT parameters and TCP IP networks Enter the remaining parameters for the new station e Confirm your entries with OK rvsXP User Manual Rev 14 3 12 T Systems GmbH rvs Systems 37 rvsXP User Manual 4 1 1 Setting up station parameters Properties for Station RST Remote Station x M Station Station ID RST ituak T 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
168. ou do not yet need a functional network link because rvsXP Monitor simply copies the data sets internally when you send to yourself 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 inthe 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 in the New Name text box This virtual file name VDSN may be lang only 26 characters rvsXP User Manual Rev 14 3 12 T Systems GmbH rvs Systems 27 rvsXP User Manual New Send Entry C rvs system readme txt 7 delete after transmission F Serialization fe Unstructured Text Fired Variable fe In
169. outer Bintec router with old firmware were able to use the CAPI service EAZO Mapping in setup application for defined call numbers Thus the client could assign its own number to the CAPI service and incoming calls were routed to the CAPI Server For Bintec router with new firmware this settings are done via SNMP Manager part of Brickware Software SNMP Manager Window1 0 x Browse View Network SNMP Monitor Window Help salsl Sl Hawea S Bein a H ipsec Index stkNumber Item LocalNumber LocalSubaddress Bearer Slot_ Unit Direction Mode UserName aA i o Jo data 0 both right to left data 0 both right to left isdn EEE isdnCallHistoryTable f isdnCallTable isdnCreditsTable isdnDChanx31Table EE isdnDisableTable E isdnDispatchTable E isdnChTable EE isdnIfTable f isdnlogin llowTable isdnStkTable H media H E modem For Help press F1 KERI 4 x isdnD spStkNumber isdnDspltem Cancel isdnDspLocalNumber Loo O O isdnDspLocalSubaddress isdnD spBearer isdnD spSlot iT ss Km isdnD spDirection bath v isdnD spMode fiightiolet isdnDspUserName I 7 The procedure with new Firmware is as follows If there is no configured phone number the ISDN login is used For rout ing incoming to the CAPI Server you should configure a not existing num ber e g 999 as PPP channel Consequently all incoming calls were routed to the CAPI server b
170. ove 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 90 e Click the Delete button or execute menu command Edit gt Delete rvsXP User Manual Rev 14 3 12 89 T Systems GmbH rvs Systems rvsXP User Manual Releasing EERP Deleting EERP 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 To release an acknowledgement for a received file e choose the received file and execute the menu command Edit gt Release EERP To delete an acknowledgement for a received file e 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 gt Select The Set selection criteria dialog opens Set selection criterias x Station ID FAR Select File Name i State Code fi save settings as default Cancel Help
171. p AI 3 Listparm AI 2 AI 4 Command descriptions AI 3 Commands Act Al 3 Activate A 3 Cleanup 109 AI 14 Delcmd A 3 Delst A 3 Freecmd A 3 Holdemd A 3 Lc Al 4 Listemd A 3 Listdbv A 3 Listparm AI 2 Listst AI 4 Lp AI 4 Ls AI 4 opcmd A 4 Setparm 76 AI 2 Al 4 Sp AI 4 Start AI 4 Stop A 4 System A 4 Communication module A5 2 Configuration Key administration 777 Configuration of rvsXP 33 Connection parameter 46 Connection establishment 9 Active 47 Connection type 46 ISDN 15 TCP IP 17 rvsXP User Manual Rev 14 3 12 T Systems GmbH rvs Systems rvsXP User Manual X 25 16 Creating genkey 116 Jobstart entry 97 Resident receive entry 93 rvsXP database 06 Send order 87 User entry 100 CUG parameter 56 60 D Data administration see Managing the rvsXP data base Data conversion 0 Database Backing up the complete database 06 Cleaning up 109 Reinitializing 106 Removing 106 Retention time of completed jobs 709 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 48 Delay parameter 47 Delcmd command A 3 Deleting Key 122 Delst command A 7 3 Dialog Choosing a file to be sent 87 Display of not transmitted datasets 78 Program start after send attempt 97 Resident receive entries 93 rvsXP administrator 77 User 100 101 Dialo
172. ple of a generated key list REM SID LOC DATEBEGIN 2001 01 25 00 00 00 DATEEND 2001 04 25 02 00 00 REM rvskeydel d 1074002581 r REM SID LOC DATEBEGIN 2001 01 25 00 00 00 DATEEND 2001 04 25 02 00 00 REM rvskeydel d 1074002581 u 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 Delete symbol in the rvsKey dialog to launch the rvskeydel tool rvsXP User Manual Rev 14 3 12 123 T Systems GmbH rvs Systems rvsXP User Manual 210 File Tools Help 1m 7 Import Delete Generate EI stations TE x Key ID 94866222 GR FDAF49CF S FDAF49CF SID Rsx E RSL Filename lc rvstkeydir RSX30 pub BP rst ann mes SP rsx reator not specified AD Ea 2 Owner not specified Creation Time 5at Feb 21 08 13 02 2004 m Version Serial Number 001 Version 001 Mode 001 Type Cf public m Run of Validity Begin Sat Feb 21 01 00 00 2004 End Fri May 21 00 00 00 2004 delete the current key entry L e Choose the private or public key highlighted in the rvsKey dialog above in the rvsKey dialog e Click the Delete button e 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
173. plete back up Stop rvsXP Monitor e 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 e 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 ifthe message 0 error s occurred appears e StartrvsXP Monitor 7 5 Cleaning up the rvsXP database cleanup Purpose of The larger the rvsXP database the more time is required by rvsXP this 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 gt Settings gt Parameter gt 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 overvie
174. pleted Pay attention to the send orders and receive entries which make use of the serialization function Back up the tables which you would like to restore after initialization of the rvsXP database is complete Further instructions are contained in the Chapter 7 1 e 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 106 rvsXP database maintenance Backing up selected entries prior to deleting Reinitializing the database Delete rvs Database x Save Entries Delete vr en gd Close IV Jobstart Hep IV Parameter Messages Dumping Stations done re 0 Dumping Parameter done rc 0 Dumping User Dumping Resident Receive Entries RE s Dumping Jobstart Entries JS s Dumping Jobstart Entries an Users done rc 0 P Delete rvs data base in c rvs db System command del c rvs db DB ended with re 0 System command del c rys4db4 IDX ended with re 0 END Prior to the delete operation you can save selected entries Click the entries to be backed up in the field Save entries In this case you will be asked under what name the entries are to be
175. r Distribution of keys rvskeydst e 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 rvskeylst rvsXP tool see Chapter Listing of imported keys rvskeylst Encryption may be enabled for each send job separately rvsXP automatically decrypts the files received This function is controlled over the parameter AUTODECRYP values Y automatically decryption default N non automatically decryption please see the Reference Manual chapter about parameters 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 3 For more detailed information on the RVSPATH parameter see Chapter 1 6 Representation means rvsXP User Manual Rev 14 3 12 115 T Systems GmbH rvs Systems rvsXP User Manual 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 Launching via the command prompt Syntax genKey chefmopstv 768 1
176. r local station LOC using the X 25 button below the X 25 tab 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 XOT reception Partner stations sets of From the rvsXP version 5 0 it is possible to configure several senders for parameters a partner station After editing the basic parameters click the Advanced button to the right of the parameter input boxes to open the X 25 Advanced dialog where you can edit these and other parameters rvsXP User Manual Rev 14 3 12 57 T Systems GmbH rvs Systems rvsXP User Manual 25 Advanced x 25 Address RET AIH Card Type NetOpen Y Card Number Pott Facilities Userdata Timeout Parallel Sessions Closed User Group vl pe Virtual Circuit Cancel e 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 Database X 25 parameter X 25 address 15 digit X 25 DTE address of the partner station XA
177. rage Provides pr Started Automatic Local System 4005 RSVP Provides n Manual Local System Sy Remote Access Aut Createsa Started Manual Local System Remote Access Con Createsa Started Manual Local System a Remote Desktop He Manages a Manual Local System 4Remote Procedure Provides th Started Automatic Local System Sy Remote Procedure Manages t Manual Network 5 Remote Registry Enables re Started Automatic Local Service a Removable Storage Manual Local System Offers rout Disabled Local System Automatic Local System Sy Secondary Logon Enables st Started Automatic Local System By Security Accounts Stores sec Started Automatic Local System Extended e Double click on rvs Monitor Thervs Monitor Properties Local Computer window opens rvsXP User Manual Rev 14 3 12 19 T Systems GmbH rvs Systems rvsXP User Manual rvs Monitor Properties Local Computer General Log On Recovery Dependencies Service name tyvsMonitor Display name Description Path to executable c rvs spstem rvsmon exe Startup type Automatic Service status Stopped You can specify the start parameters that apply when you start the service from here Start parameters e Choose Automatic inthe Startup type field and confirm with OK The rvsXP Monitor startup type changes to Automatic 20 Installation of rvsXP Assigning rvs Monitor special user rights
178. re available on all platforms at this time 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 T Systems GmbH 2 6 Uninstall rvsXP In order to uninstall rvsXP please follow the following procedure given below stop all running rvs applications Administrator rvsTray Icon etc 24 Installation of rvsXP we would recommend you to back up the station table the database and the licensekey start the Windows uninstall routine and the first window will open Answer the question whether you would like to delete rvsXP include all components with Yes In the following dialog you can decide whether you would also like to delete the backup files and the user files We do not recommend this since you would thus delete the directories arcdir init and usrdat In the next window it is displayed which components have been deleted Click on OK in order to end the uninstall program rvsXP User Manual Rev 14 3 12 T Systems GmbH rvs Systems 25 rvsXP User Manual 26 Function Tests 3 Function Tests Test without network The present chapter describes two types of function tests For one of the tests you send a file from your working environment to yourself thus ensuring rvsXP correctly accepts and processes the jobs For this test y
179. rent 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 stations only The sending and receiption is possible via different data lines and line protocols How to configure this feature read in the appropriate network section in this chapter Setting up TCP IP X 25 XOT ISDN communication Properties for Station LOC Local Station x Station Station ID LOL Comment Local station Phone Odette Odette ID 0001300321GEDAS XPSKK Selftest via TCPAP m Advanced TCPAP 1 TCPAP 2 ISDN m x 25 121 IP Address IV Start Port 3205 Max Sessions 5 Remove Insert TCPAP ISDN x OT Cancel OK 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 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 36 Configuration of rvsXP Connection For remote stations only Connection type by which the station is reachable Self test via C
180. rted listening receiver processes for X 25 communication Default 0 MSGPRIO Send priority for operator to operator messages Default 60 NUMRLOGS Number of rlog 1log_ files that can be generated Default NOLIMIT NUMRLSTAT Number of rlstat 1log_ 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 14 3 12 A1 7 T Systems GmbH 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 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
181. s are stored under the name j sXXXXXX bat where XXXXXX stands for a consecutive number You can examine these files for correctly executed commands for troubleshooting purposes Note If you want rvsXP not to save copies of the batch programs j SXXXXXX bat file in the rvsXP temp folder you should add the following command to your batch file DELETE DSNTEMP 96 How to work interactively with rvsXP Displaying job start after send attempt e Choose Job gt 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 vrvsXP Administrator lol x Eile Edit View Monitor Database Window aix EEE TE station Virtual Dataset Name Program Comment lastused g Stations g Users By Jobs E Receive em 5 Logs El 3 Database E Settings u 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 Choose Edit gt Add The Jobstart after Send Attempt dialog window then opens x Station f Yirtual data set name i mJobstart after Error IZ Send attempts f E C Success Pi p c rvs system sendjob bat Program Comment Starts batch job sendjob bat after send attempt OK Cancel Help
182. s ora 142 rvsXP HighPerformance Example tnsnames ora TNSNAMES ORA Network Configuration File opt oracle product 10 network admin tnsnames ora Generated by Oracle configuration tools RVSORA TSYSTEMS DE DESCRIPTION ADDRESS LIST ADDRESS PROTOCOL TCP HOST rvsaix3 PORT 1521 CONNECT DATA SERVICE NAME rvsora In this example RVSORA TSYSTEMS DE is an ORACLE network service name and rvsora a service name A network service name is needed to identify an ORACLE database in a network This name should not be mixed up with the global database name although it has a similar syntax The service name identifies a database instance because several instances can run on the same computer 11 2 Configuration of rvsXP Test if the Oracle configuration for rvsXP works fine if a user exists anda database is available with a following command sqlplus Oracle user Oracle NetworkServiceName password Example sqlplus skk RVSORA TSYSTEMS DE skk If this test is successful you can start with the installation of rvsX During the installation of rvsXP you will be asked to enter your Oracle user data rvsXP User Manual Rev 14 3 12 143 T Systems GmbH rvs Systems rvsXP User Manual Requirements Userdata for Oracle x Please enter your userdata for your Oracle database User Password ca This data will be added to the rvs environment file SRVSP
183. s two different keys each for encryption and 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 rvs performs symmetric encryption on the files to be sent The actual file 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 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 Compression is performed using the GNU zip algorithms rvs applies a compression compatible with gzip rfc 1952
184. s 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 14 3 12 A1 13 T Systems GmbH 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 data set SRVSPATH db rlog 1log 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 interfer
185. should read in the last generated copy of the batch program reXXXXXX bat file just which commands have been executed Note If you want rvsXP not to save copies of the batch programs reXXXXXxX bat file in the C rvs temp folder you should add the following command to your batch file DELETE DSNTEMP 92 How to work interactively with rvsXP 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 gt Receive inthe rvsxXP Administrator to display resident receive entries The Resident Receive Entries dialog opens It displays a list of the previously created resident receive entries The list is initially empty rvsXP Administrator E lalx Eile Edit View Monitor Database Window Slet gx ey Resident Receive Entries SID DSN Virtual Dataset Name Program Comment ___ lastused B ey ms 3 Stations 6 Users E 3 Database re u Settings u 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 rvsXP User Manual Rev 14 3 12 93 T Systems GmbH rvs Systems rvsXP User Manual Resident Receive Entry x
186. st 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 22 Installation of rvsXP 2 5 How to obtain a license You need a license key to work with rvsXP Contact Please contact rvs after sales service to receive a license key phone from Germany 0800 664 77 45 phone from other countries 49 375 606 19 902 email rvs service t systems com Receipt of a temporary key After initial installation you can receive a key for test purposes for a limited period of time for free e Inform your rvs after sales service of your rvsXP version e g rvsXP Version 5 4 and he will send you a license key by email rename the received license key to rdkey dat and copy rdkey dat to the Init folder License key for a full rvsXP version License key update e Startthe Machine ID application in the rvs folder The program now displays a three or four character machine identification number on the screen Inform your rvs after sales service of the machine identification nu
187. stalled in order to be able to recover data when a hard disk failure has occurred You must restart rvs to have these parameters take effect Any dynamic data will be written saved to the Redolog file from this moment onwards 10 2 Procedure The present chapter describes the general procedure during rvs data back up and recovery The new rvs program for backing up and recovering data is called rvsredo exe and is located in the RVSPATH system directory Syntax rvsredo lacype tfbsdv More about the rvsredo options please read in chapter 10 3 rvsredo Options rvsXP User Manual Rev 14 3 12 137 T Systems GmbH FB rvs Systems rvsXP User Manual Back up The following steps are necessary Set the BACKUP parameter in the SRVSPATH rvsenv dat file to ON As an option you can also set the REDOLOGFILE parameter Stop and restart rvs so that the parameter configuration change can take effect Any dynamic rvs data will be logged from this moment onwards Execute the rvsredo c command This will back up the static rvs data stations and parame ters to the SRVSPATH arcdir static dat file Backup of the static data users REs and JSs with the command rvsdru This program generates the text file rlrudump log to the SRVSPATH arcdir directory Backup of the dynamic data with a command rvsredo y This command stores all dynamic data in the file SRVSPATH arcdir dynamic dat Data r
188. station for which the import should take place and than click the Import symbol The Select File dialog appears O locale30 pri _ locale30 pub File Name R5x30 pub File Filter v Cancel rvs Keyfiles pub pri e Select the file containing the key or write the file name in the File Name field of the Select File dialog e 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 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 lt FILE gt s lt SID gt l lt FILE gt rvsXP User Manual Rev 14 3 12 121 T Systems GmbH rvs Systems rvsXP User Manual Options f lt FILE gt The file containing the key where the full path must be specified with FILE s lt SID gt The ID of the station to which the key wi
189. stitute FSS Forwarding Support Service rvsXP User Manual Rev 14 3 12 A5 1 T Systems GmbH rvs Systems rvsXP User Manual GNU zip algorithm This software is provided 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
190. t A file received via the defined resident receive entry will be converted with the user defined code table 9 For more detailed information on the RVSPATH parameter see Chapter 1 6 Representation means 136 Backing Up and Recovering rvsXP Data 10 Backing Up and Recovering rvsXP Data rvsXP lets you back up all relevant dynamic and static data and recover them if necessary This is particularly important when an error has occurred in rvsXP and the user wishes to revert to the old status prior to the error For backing up a distinction is made between dynamic and static data Static data are station data jobstarts REs and JSs users and rvs parameters Dynamic data refers to information on send and receive jobs During back up this data is written to a Redolog file to be able to recover incom plete transmission jobs at a later time Completed jobs are logged but are not relevant for recovery see 10 2 Procedure 10 1 New parameters To write the data to a Redolog file the BACKUP parameter in the SRVSPATH rvsenv dat environment file must be set to ON rvsXP Administrator gt Edit gt Environment Example BACKUP ON As an option you can also use the REDOLOGFILE parameter to specify the path to the Redolog file The default is SRVS_HOME arcdir redo log Example REDOLOGFILE D rvsrecover redo log Note Make sure to save the back up data on a disk where rvs is not in
191. terfaces BRRP Messages Email Alert TCP IP IP 005 IPSec SSHD OSPF EXIT rvsXP User Manual Rev 14 3 12 A4 3 T Systems GmbH rvs Systems rvsXP User Manual i 10 233 66 110 PuTTY R ioj xj R1200 Setup Tool Funkwerk Enterprise Communications GmbH aj MONITOR ISDN CALLS ISDN Monitor Calls r1200 Dir Remote Name Number Charge Duration Stack Channel State c alls h istory djetails s tatistics r elease bi Hint Double click the esc key to reach the next higher layer of the router settings Use the arrow keys for choosing an option You can end the Setup program with Exit 4 3 Setting up of passwords For setting up the passwords open the setup main menu choose the option System and after this the option Password settings The following mask opens and you can set up the passwords if 10 233 66 110 PuTTY 0 x R1200 Setup Tool Funkwerk Enterprise Communications GmbH SYSTEM PASSWORDS Change System Passwords r1200 admin Login Password SNMP Community read Login Password SNMP Community write Login Password SNMP Community HTTP Server Password ete Activity Monitor Password aeEEE SAVE CANCEL Use lt backspace gt to clear change password max length 16 chars 4 4 Setting up of incoming calls If the process of incoming calls fails and RCAPI cannot be started the router must be configured again A4 4 Appendix 4 Operation with BinTec R
192. ternal Text 7 Native Next Native Binary Confirm your entries with OK This will save the send entry for transmission of the file in the rvsXP database 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 28 Function Tests X rysXP Administrator Monitor Log 5 x Mi File Edit View Monitor Database Window 2 l8 x Sl alele n i lt INIT_CHD rpm Reading initial commands gt B C Ivs lt OK_READ gt R SCNS cleanup days 3 ss yes E Stations lt CLNUP_DEL 35 gt Cleanup of RYS data base purge all SendStatistics with DTE lt CLNUP_START gt Cleanup of RVS data base purge all commands with DTDONE lt ER Users lt CLNUP_NONE gt Cleanup of RVS data base ended there are no commands to be amp a Jobs lt XMT_START gt MasterTransmitter started gt lt SP_START Service Provider started Compression yes Security no lt NEW_CMD_CREATED gt SK 13 created by SE 12 a Statistics lt NEW_CMD_CREATED gt IE 14 created by K 13 lt NEW_CMD_CREATED gt IZ 15 created by IE 14 Active
193. tion means rvsXP User Manual Rev 14 3 12 135 T Systems GmbH rvs Systems rvsXP User 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 e Create a job file that creates a resident receive entry Create a job file e g job containing resentr cdsn lt received ASCII file gt codetrans e sid lt Sender gt Start the job with rvsbat ijoborrvsbat ijob Result An ASCII file received via the defined resident receive entry will be saved as an EBCDIC codetrans e file Create a resident receive entry with EBCDIC to ASCII code conversion e Create a job file that creates a resident receive entry Create a job file e g job containing resentr c dsn lt received EBCDIC file gt codetrans a sid lt Sender gt Start the job with rvsbat ijoborrvsbat ijob Result An EBCDIC file received via the defined resident receive entry will be saved as an ASCII codetrans a file Creating a resident receive entry with user specific code conversion table e Create a job file that creates a resident receive entry Create a job file e g job containing resentr c dsn lt received EBCDIC file gt codetrans t codetable lt user code table e g SRVSPATH arcdir rtcusrdat gt sid lt Sender gt Start the job with rvsbat ijoborrvsbat ijob Resul
194. tion 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 1log 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 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
195. to 1G E a sender i p e rvsXP User Manual Rev 14 3 12 79 T Systems GmbH 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 f forwardable waiting for transmission process p pending waiting for completion e ended a active i in transit transmitter currently processing order In addition every event may also have these statuses h held by the system or operator s traffic with the destination suspended at present 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 e To terminate rvsXP choose File gt Exit 80 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
196. 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 90 e Click the Hold button or choose Edit gt Hold from the menu Modifying a send order To modify a send order e Use the mouse to click the send order that you want to modify e Execute the menu command Edit gt Update The Change Send Entry dialog opens In this dialog you can modify all the fields for the send order e Carry out the desired changes e 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 e Click Change Options in the New Send Entry dialog Enter the letter Hin the Start Time field e Confirm the entry by pressing OK 88 How to work interactively with rvsXP 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 90 Release the orders selected with Release
197. transmission V rvs internal format only useful for rvs for variable and fixed formats 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 UNIX 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
198. 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 specific message formats e g VDA ODETTE EDIFACT XML using rvs as transport service viaT Systems GmbH rvs is not a network control or monitoring tool Basic rvs functions Reliable The main function of rvs is the reliable transfer of files rvs is suitable transmission for transferring both large files and many small files rvs supports cross platform 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 the following record formats U unstructured T text F fixed record length V variable record length Extensive s
199. ts 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 rvsXP is the synonym of rvs for Windows XP 2000 Vista 7 and WS 2008 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 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 rvs for Windows XP 2000 Vista 7 WS 2003 and WS 2008 home rvs for AIX Solaris Linux and SCO users rvs for HP UX Substitute the variable with your correct path Installation of rvsXP 2 Installation of rvsXP This chapter describes the system requirements installation of ISDN X 25 and TCP IP protocols and of rvsXP 2 1 System requirements Hardware and You need the following equipment in order to operate rvsXP BOW AIS oe PC i386 platform 300 MHz clock rate at least 128 MB RAM and 1 5 GB of free hard disk space Microsoft Windows XP 2000 Vist
200. ubleshooting see also Log files Chapter Troubleshooting SPFILESDIR Internal Service Provider SP working folder containing the C rvs 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 rvs db rlstat log file when you enable this checkmark 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 14 3 12 T Systems GmbH rvs Systems A3 3 rvsXP User Manual A3 4 Appendix 4 Operation with BinTec Router Appendix 4 Operation with BinTec Router The BinTec ISDN router includes an RCAPI Remote CAPI server that offers API
201. uld 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 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 To 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 rtcae 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 14 3 12 131 T Systems GmbH rvs Systems rvsXP User Manual Sending files with code conversion via rvsXP 9 3 How to perform
202. urrent environment settings r s Environment cvs c rvs db c rvs temp c rvs samples DEN AME Confirm your changes entries by pressing OK Note Any changes will only take effect after rvsXP Monitor is restarted rvsXP User Manual Rev 14 3 12 A3 1 T Systems GmbH 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 ofthe rvsXP database C rvs db USRDAT Folder for 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 C rvs 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 tro
203. ust allow SQL server authentication rvsXP User Manual Rev 14 3 12 145 T Systems GmbH rvs Systems rvsXP User Manual 146 rvs Data Center 12 rvs Data Center rvs Data Center is a server farm featuring a very high fail safety and transfer capacity To ensure a very high system availability a server farm comprises an array of several computers rvs servers in case of the rvs Data Center To ensure trouble free server farm operation another server can assume the tasks of a failed server 12 1 System requirements Oracle or MS SQL Server is used as rvs database To ensure access to the Oracle database Oracle client software must be installed on each rvs server node The NFS Network File System protocol version 3 is required to access the shared directories of the rvs Data Center over the network Hint For more information please see the Reference Manual chapter rvs Data Center or rvsX User Manual chapter rvs Data Center rvsXP User Manual Rev 14 3 12 147 T Systems GmbH rvs Systems rvsXP User Manual 148 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 r
204. vices BEE Fie Action View Help e gt m u Services Local rvs Monitor Name Description Status Startup Type Log On As La a Print Spooler Loads files Started Automatic Local System Stop the service 84 Protected Storage Provides pr Started Automatic Local System Restart the service 005 RSVP Provides n Manual Local System By Remote Access Aut Createsa Started Manual Local System BsRemote Access Con Createsa Started Manual Local System 4 Remote Desktop He Manages a Manual Local System Ss Remote Procedure Provides th Started Automatic Local System gs Remote Procedure Manages t Manual Network 5 Ss Remote Registry Enablesre Started Automatic Local Service a Removable Storage Manual Local System SBsRouting and Remot Offers rout Disabled Local System Servs Monitor Started Automatic Sa Secondary Logon Enables st Started Automatic Local System Sa Security Accounts Stores sec Started Automatic Local System Extended A Standard i i i Click the Stop button Windows 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 e Right click the rvsTraylcon e 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
205. vsXP Administrator gt Settings gt Parameter 1 1 How to use rvs parameters You can use a magnitude of parameters to customize rvs processes Chapter rvs 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 e Execute the Settings gt 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 OPT a SENDBLOCKS 1000 50 SNARCV SSCREATE 0 Hel STATISTICS 2 Help SYNCDL 500 SYNETO 120 TIMESTAMP 2 il TMAXCON 0 TSTODPRCT 390 TCPIPRCY e Double click the parameter in the parameter list Enter the desired value into the input field Confirm your entry with Apply e Use Close to exit the parameter list Activate the parameter by stopping and starting the rvsXP Monitor rvsXP User Manual Rev 14 3 12 T Systems GmbH 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 param
206. w 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 14 3 12 109 T Systems GmbH 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 74 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 Par
207. 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 rvs 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 failure without having to start atthe 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 effe
208. wn e Click the Install button Highlight the TCP IP protocol in the window displayed and confirm your selection with OK e Highlight the TCP 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 e Confirm the entries by pressing the OK button and close the Network connections window 2 3 Installing rvsXP If an installation is an update please make a backup of your old rvsXP data Make a copy of your licence key file rdkey dat of your stations users and Jobstarts See chapter 7 rvsXP database maintenance Hint for installation on Windows Vista Windows 7 and WS 2008 Systems Depending on configuration of Windows User Management you will be asked for the Windows administrator account and password before or during installation Start installation Start Windows and log in as an user with administrator rights rvsXP User Manual Rev 14 3 12 17 T Systems GmbH rvs Systems rvsXP User Manual extern database Insert the data medium labeled rvsXP in a drive e Skip the next three instructions if the rvsXP Installer starts automatically e Choose Start gt Run e Enter D setup exe to run the installation program if your CD ROM drive is drive D e Confirm the entry by pressing OK The rvsXP installer now starts and guides you through the installation
209. y 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 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 PR1 PU1 PU2 Keep the private key for yourself Send your public key to your partner and he will send you his public key 112 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 PR1 Import of PU2 PR2 Import of PU1 rvsXP User Manual Rev 14 3 12
210. y is rys Monitor Started Automatic Local System Starting with Carry out the following steps if you want to stop rvsXP Monitor with the rvsTraylcon rvsTraylcon e Right click the rvsTraylcon e 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 Starting from the Carry out the following steps if you want to start rvsXP Monitor from rvsXP environment within the rvsXP program environment while it is in operation e Startthe rvsXP Administrator program in the rvs folder e 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 72 rvsXP Monitor 3 ways to stop Stopping at system 5 2 Stopping rvsXP Monitor 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 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 Windows Vista 7 Start gt Control Panel gt System and Maintenance e Start Administrative Tools gt Services e Search the list of Services for rvs Monitor and select the service by clicking the appropriate line u Ser
Download Pdf Manuals
Related Search
Related Contents
Cisco WS-C3560CG-8TC-S network switch Model 570 Spectroscopy Amplifier Operating and Service Manual edital completo Canton Pro L Sony SLT-A99V User's Manual Copyright © All rights reserved.
Failed to retrieve file