Home

rvsXP Benutzerhandbuch

1. Insert TCPAP ISDN x 25 Cancel 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 R Routing X 25 The partner station is reached via an X 25 line Routing The partner station uses a different partner station as a routing station Enter the routing station ID in the RT Routing tab The connection type and parameters of the routing station then apply to the connection itself For further information please refer to Chapter Setting up the routing connection Default none Self test via May only be selected at the local station Line by which PROTOCOL transmission is to be made if the self test is performed when your own station is activated Receiver May only be selected at the local station Receivers which No parameter have been configured and or are still to be configured Use the Advanced bution to the right of where you choose the connection to open the Connection Properties dialog providing more parameters rvsXP User Manual Rev 2005 12 18 43 gedas deutschland GmbH FB rvs Systems rvsXP User Manual x Delay 0 Parallel Sessions fr I
2. PR1 PU1 PU2 decrypted file Invoice No 877 Customer 106 Encryption configuration Key administration 8 2 Overview of the 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 Chapter 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 l
3. 50 Configuration of rvsXP ISDN Advanced x ISDN Number 0301 234567890 25 Address Link CAPI2 amp jeoss ri f I Karte Protocol Packetsize Alias Timeout 25 Facilities x 25 Userdata Terminal Identifier Parallel Sessions ISDN Facilities ISDN Userdata Close User Group DBit N Receiver Number Coros 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 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 This number is optional It is however advisable for an ISDN connection to enter the ISDN number here as some partners expect an X 25 address rvsXP User Manual Rev 2005 12 18 gedas deutschland GmbH FB rvs Systems 51 rvsXP User Manual 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 for m and n m A no Diehl Eicon card 0 Diehl Eicon
4. 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 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 122 Code conversion e Specify other send parameters Station ID andNew Name e Specify the other send parameters Station ID and New Name e Under Options specify the format of the file to be sent see Chapter 6 3 1 Creating send orders e Click
5. Start Time 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 If you activate these two options the files would arrive at their destination in a Serialization 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 systems Specify the maximum record size for files of the Variable format Record format Input Output Code Code Table Intern Windows XP does not support the fixed and variable mainframe formats to send files in one of these formats you have to convert the files with the rvsut2fv utility before sending Please see the Reference manual Part III Utilities This feature can also be performed b
6. Stops the rvsXP Monitor C rvs system rvsstop exe rvs Console Command prompt window for displaying messages and entering operator commands Has been replaced by the Monitor Log in the rvsXP Administrator MDI window C rvs system rvscns exe Dialog rvsXP DOS prompt for creating and receiving send orders Has been replaced by rvsXP C rvs system rvsdia exe rvsXP User Manual Rev 2004 05 28 gedas deutschland GmbH Fachbereich rvs Systems 21 rvsXP User Manual Contact 2 5 How to obtain a license During installation a license key file rdkey dat is copied to the SRVSPATH init folder After initial installation rvsXP can be operated for test purposes without a license for a limited period of time If you are satisfied with rvsXP and would like to continue working with it contact your sales representative or the rvs support phone 49 30 399 71 777 telefax 49 30 399 71 994 email rvs service gedas de There you may obtain the desired license When you install a full rvsXP version you receive a license key file that does not contain an expiry date i e there is no temporal restriction License key update e Start the Machine ID application in the rvs folder The program now displays a three or four character machine identification number on the screen Inform your sales partner of the machine identification number and he will send you a license key by em
7. Window areas Depending on the rvsXP display mode the entry list will display the list of files which have been sent or received The Details area provides you with more detailed information on the currently selected file file name sender or recipient local name or original name and status of the file In the additional information you can see the currently transmitted data quantity block size file format and the number of dialing attempts only for sending The respective successive command numbers for send entries SE send command SK and information entries IE identify the individual transmission steps These numbers can also be found in the rvsXP Log Book C rvs db rlog 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 gq p e SK Send command Op By ay i p e QE Acknowledgement receipt sent by recipient e Reception arrival IE Information entry
8. 1 4 rvs parameter overview 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 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 s0ormu gt Default input code local file when creating a send job Default A Default output code file at recipient when creating a send job Default X rvsXP User Manual Rev 2004 05 28 A1 5 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual DTCONNnn EERP_IN EERP_OUT FORCEDEND IEPRIO Wait periods until an unsuccessful connection attempt is repeated nn is the number of unsuccessful attempts CNTRETRY in SK Th
9. 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 12 03 2004 gedas deutschland GmbH Fachbereich rvs Systems 109 rvsXP User Manual Graphic interface Start rvsKey with 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 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 110 Encryption configuration Key administration Generate New Keypair m Filenames Private Key File c irysisystem locale30 pri Public Key File ciirvsisystem locale30 pub m Begin of Validity Key Si
10. SORACLEHOME network admin tsnames ora 132 rvsXP HighPerformance Example tnsnames ora TNSNAMES ORA Network Configuration File opt oracle product 8 1 7 network admin tnsnames ora Generated by Oracle configuration tools RVSORA GEDAS DE DESCRIPTION ADDRESS LIST ADDRESS PROTOCOL TCP HOST rvsaix3 PORT 1521 CONNECT DATA SERVICE NAME rvsora gedas de 11 2 Configuration of rvsXP The following variable definitions will be asked during the rvsXP installation Userdata for Oracle x Please enter your userdata for your Oracle database Host ji User Password coren These variable definitions will be added to the SRVSPATH rvsenv dat rvsXP environment file by the installation script rvsXP User Manual Rev 2004 05 28 133 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual Requirements DBNAME lt ORACLE System ID gt DBUSER lt ORACLE user ORACLE database gt DBPSW lt ORACLE user password gt These variable values have been defined when installing and configuring Oracle Example excerpt from RVSPATH 2 rvsenv dat rvsXP environment file rvsenv dat DBNAME rvsora DBUSER skk RVSORA GEDAS 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 The instal
11. 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 In the Code Conversion field you can define the direction of the code conversion none ASCII gt EBCDIC or EBCDIC gt ASCII the path and name of the rvsXP system code conversion table from ASCII to EBCDIC SRVSPATH 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 rvsAdministrator Choose Job gt Receive 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 12
12. User Manual Reference Manual Messages and Return Codes Manual Media To use rvsXP the following skills are required good knowledge of the current operating system knowledge of the communications techniques in use X 25 native communications and or ISDN native communications TCP IP Before starting to work with rvsXP it is advisable to have read this book 1 5 Structure of the rvs documentation The rvs documentation consists of the following manuals The User Manual contains all important steps about installing and configuring rvs It shows you how to transfer files and handle the rvs database and describes integrated features such as rvs encryption off line compression and code conversion For this purpose the rvs administrator has unrestricted access to all functions The rvs user has access to all functions dealing with the transmission and reception of files The Reference Manual is the common manual for rvs portable rvsX rvsNT rvsXP rvs400 It contains descriptions of the C Cal interface rvscal the rvs batch interface rvsbat and of the rvs utilities mostly for rvsX rvsNT and rvsXP Furthermore this manual contains information on the technical background of rvs This manual describes all messages and error codes which could be displayed on the rvs Monitor and in the log file The User Manual and the Reference Manual are available as printed and as electronic documents
13. gt New Send Entry gt Change Options gt Format Text This file will be transmitted as an ASCII file stipulated by the ODETTE protocol and will be converted into EBCDIC by the rvsMVS station Direction rvsMVS gt rvsXP When sending a text file from an OS 390 system you must define the format of the file T format so this EBCDIC text file will be converted to ASCII code before sending Text files are transmitted only in ASCII format Odette The rvsXP system will receive the text file in ASCII Example 2 Direction rvsXP gt rvsMVS Non text file Normally an OS 390 system requires rvsMVS files in the F fixed or V variable format to be able to store and process them without problems As a Windows XP system is able to work only with files in the T Text or U unstructured binary format you have to convert them to the pseudo fixed or pseudo variable format before sending For this purpose rvsXP offers the rvsut2 fv tool For more details on this tool and its command syntax please refer to the rvs Reference 5 The code pages vary as they depend on the respective operating system rvsXP User Manual Rev 2004 05 28 119 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual manual Part Ill Utilities The rvsXP station is then to send the converted file in the F or V format and also set the parameters for the input and output code Start gt Programs gt rvs gt rvsXP gt E
14. 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 opensthe 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 e StartrvsXP Monitor 100 rvsXP database maintenance 7 4 3 Restoring the rvsXP database To restore the entire rvsXP database using a complete 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 Res
15. IE 44 created by SK 43 Sy 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 amp 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 Hf Database lt NEW_CMD CREATED gt QE 47 created by 03 46 u Settings lt CMD_TERMINATED gt Q3 46 terminated status e rs u Start Program 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 5E 48 lt NEW CMD CREATED gt TE 50 created by 5Ki49i 4 Press F1 to get help F5 for refresh 6 3 2 Serialization Purpose of serialization Sometimes it may be important that a number of files arrive in a specific 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 befo
16. Input format of the file which is to be sent prior to conversion for the partner station Values ASCII The files which are to be sent are in ASCII format EBCDIC The files which are to be sent are in EBCDIC format Default ASCII CODEIN Code translation output Target format of the files for send transmission Values ASCII During transmission rvsXP converts the files which are to be sent from input code format into ASCII format EBCDIC During transmission rvsXP converts the files which are to be sent from input code format into EBCDIC format Default ASCII CODEOUT Receive Number of blocks sent between two restarting positions for error correction Default 0 i e RECVBLOCKS from the parameter table applies RECVBLOCKS Send Number of blocks sent between two resuming positions for error correction Default 0 i e SENDBLOCKS from the parameter table applies SENDBLOCKS EERP Send transmission EERP End to End Response acknowledgement Values NEVER Partner does not send EERP file dispatch ends with successful transmission Do not wait for acknowledgement NORMAL Wait for acknowledgement by partner after successful file transmission File dispatch ends with receipt of EERP Default NORMAL EERP_IN rvsXP User Manual Rev 2005 12 18 gedas deutschland GmbH FB rvs Systems 39 rvsXP User Manual Parameters Meaning of advanced Odette param
17. Se LOC D FDarsscr Key ID 948E6222 S FDAF49CF SID Rsx E rs Filename c rvs keydirRSX30 pub Creator not specified Owner not specified Creation Time Sat Feb 21 08 13 02 2004 r Version Serial Number 001 Version 001 Mode 001 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 HL rvsXP User Manual Rev 12 03 2004 115 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual e Choose the private or public key highlighted in the rvsKey dialog above in the rvsKey dialog e Click the Delete button Answering the following query with Yes causes the key to be deleted in the rvsXP database and from the list in the rvsKey dialog The key will not be deleted if you choose No 8 7 Listing of imported keys rvskeylst The rvskeylst tool lists all keys that have been imported into the database with their complete data This command does not support any options You can launch the rvskeylst tool via the command prompt or the graphic interface Launching via the command prompt Syntax rvskeylst Example of result SID WO1 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 a
18. 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 Tv rvsXP Administrator Monitor Log lol x MM Fie Edit View Monitor Database Window 2 18 x ak eal al axi lt CONNECT lt TCPIP_READY lt DISCONNECT lt DISCONNECT Sender Connection with Station LOC with Credit 99 Odette Buffer 20 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 e 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 za Statistics lt TCPIP_READY gt 548 TCP IP Receiver ready to accept incoming calls Port 3305 fE Active Panel lt OK_READ gt RVSCNS ACTIVATE SI
19. information Specifying rvsXP Monitor startup mode The rvs Monitor service provides the applications with information on the current data exchange processes Note The term Service means a program that can be started from the operating system and works in the background Depending on your choice during the rvsXP installation the startup type for this service is Automatic or Manual The user must manually start the service if the Manual startup type was chosen The rvsXP Monitor is at first set to stop in this case If you want to start rvsXP Monitor every time the system starts you can set the startup type to Automatic by choosing Automatic from the combo box in the Startup type area e Choose Start gt right mouse My Computer gt Change a setting e Launchthe Start gt Control Panel gt Administrative Tools gt Services program e Search the list of services for rvs Monitor and select the service by clicking the appropriate line 18 Installation of rvsXP i Services File Action View Help e R rmnm 4 Services Local Name 7 Bs Print Spooler Sy Protected Storage 4005 RSVP rvs Monitor Start the service S4Remote Access Aut Remote Access Con Remote Desktop He 4 Remote Procedure 4 Remote Procedure Remote Registry Removable Storage Routing and Remot Sy Secondary Logon Sy Security Accounts iy A Standard e Double click on rvs Monitor
20. means 126 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 REDOLOGF ILE 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 installed 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
21. parameter 36 Station parameters Virtual 36 Station status Index Editing 59 Setting 59 Station table Backing up 96 Restoring 100 StationsConfigFile 129 STATISTICS parameter AT 10 A1 16 STATNAME parameter 36 Status display 77 Stop rvsXP processes A1 4 Stop command A1 4 Stopping Monitor 65 Station 59 SYNCDL parameter A1 10 SYNCTO parameter AT 10 System command A1 4 SYSTEM environment variable A3 2 System requirements 15 T Tab ISDN 49 Route 46 TCP IP 47 X 25 53 Table NK line type 35 ODETTE parameters OP 35 Routing table RT 35 ST station 35 TC TCP IP 35 XP X 25 ISDN 35 TCP IP tab 47 TCP IP connection 16 TCP IP reception 60 TCPIPRCV parameter 48 60 A1 10 A1 15 TC TCP IP table 35 TEI parameter 52 TEMP environment variable A3 2 Test rvsXP 25 TIMEOUT parameter 52 56 TIMESTAMP parameter A7 70 TMAXCON parameter AT 10 Transmission buffer 39 Transmission time 10 Transmissions Displaying 77 Traylcon see rvsTraylcon Troubleshooting A2 2 TSTODPRCT parameter A1 10 Typographic conventions 73 U USEPKI parameter AT 11 User Backing up 97 Editing 93 Removing 93 Saving 93 User entry Creating 92 Displaying 97 Editing 97 Listing 97 Removing 93 Sorting 91 User interface 9 User rights 20 User table Backing up 97 Restoring 100 USERDATA parameter 52 56 USERFIELD parameter reserved AT 11 USRDAT environment variable A3 2 V VC parame
22. transmitted data The implementation of this feature uses a hash function SHA1 A hash function is a many to one function that maps its input to a value in a finite set This value is encrypted with the private key of the sender to guarantee the identity of the file owner Offline compression features Algorithm Compression is performed using the GNU zip algorithms rvs applies a GNU zip compression compatible with gzip rfc 1952 The compression method reduces the data size in the best case down to a level of 30 and essentially never expands the data Only very small files grow in size due to the process information added The compression is independent of the CPU type operating system and character set and performs an integrity check of the decompressed data 1 4 Target group For rvsXP users This manual is meant for regular users of rvsXP as well as and administrators administrators It provides an overview of the basic rvsXP functions and also background information on 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 rvsXP User Manual Rev 2004 05 28 11 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual
23. If SS YES is specified all old SendStatistics records are deleted Delcmd CN cn Delete command with command number cn logically from database Delst SID sid Delete station ID id from all station table related database tables Freecmd CN cn SID sid Free command with command number cn from hold status or release all suspended transfers to neighbor station sid Holdcmd CN cn SID sid Put command with command number cn in hold status or suspend all transfers to neighbor station sid Listdbv List version and creation date of the rvsXP database Listcmd CN n STATUS x rvsXP User Manual Rev 2004 05 28 A1 3 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual 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
24. 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 for long messages can also be used STATISTICS controls the creation of the statistic log file STATISTICS 1 creates the RVSPATH 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 IZ 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 rlsta
25. 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 listening processes for TCP IP communication 0 No TCP IP receiver will be started 1 A TCP IP receiver will be started Default 1 Creation of a timestamp to distinguish data sets with the same data set name 0 000 999 three digit counter for MS DOS file names 1 000000 999999 counter 2 Thhmmss time 3 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 ch
26. PDF The Messages and Return Codes Manual is only available as electronic document 12 Introduction 1 6 Representation means This chapter contains the description of the typographic conventions which are used in this manual and the explanation of the expressions which are marked Typographic conventions Instructions begin with a bullet Other lists begin with the en dash Character styles Courier Commands menu commands file names path names programs examples scripts options qualifiers data sets fields modes window names dialog boxes and statuses BOLD and IN CAPITAL Parameters environment variables variables LETTERS Inverted commas Links to other manuals sections and chapters literature Bold Important terms names of operating systems proper names buttons function keys Terms and variables Program names rvsXP is the synonym of rvs for Windows XP systems rvsNT is the synonym of rvs for Windows NT systems rvsX is the synonym of rvs for UNIX systems rvs400 is the synonym of rvs for OS 400 systems Here the naming operating system is mentioned only Directories As user directories are found on different locations for the different operating systems and respective hardware software environments we use the RVSPATH variable in this manual Default values are C rvs for Windows XP 2000 WS 2003 and NT home rvs for AIX Solaris IRIX Linux and SCO users
27. 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 98 rvsXP database maintenance Delete rvs Database x gt Save Entries e JV Stations Close IV User ddi V Jobstart Help V Parameter m 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 db DB ended with re 0 System command del c rvsdb ID gt ended with re 0 Backing up selected Prior to the delete operation you can save selected entries entries prior to Click the entries to be backed up in the field Save entries In this deleting case you will be asked under what name the entries are to be saved Depending on the type of entries two different file types are created When backing up User and Program start the specified file name is given the extension Job The entries can be read in again with the menu command Database gt Import and or Database gt Import of Jobstart Entries and User after the rvsXP database has been created
28. 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 statistics file Choose Settings gt Statistics to view the file contents Its maximum size is restricted by the RLSTATMAXSI parameter The file is renamed by assigning a consecutive number as extension and creating a new C rvs db rlstat 1log file when this size is reached You can restrict the maximum number of files generated with the NUMRLSTATS parameter rvsXP User Manual Rev 2004 05 28 A2 1 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual Log file for troubleshooting 2 2 Troubleshooting The rvssp program being a new addition to the rvs set of programs provides the compression and encryption features This program saves protocol files in the SPOUTDIR folder and deletes them after succ
29. are currently available 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 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 via gedas deutschland GmbH rvs is not a network control or monitoring tool Basic rvs functions The main function of rvs is the reliable transfer of files rvs is suitable for transferring both large files and many small files rvs supports communication between different networks with many stations based on different platforms In other word rvs supports various data formats The key features of rvs are Introduction 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
30. base purge all SendStatistics with DTEND lt CLNUP_START gt Cleanup of R 5 data base purge all commands with DTDONE lt 2C lt CLNUP_NONE gt Cleanup of RVS data base ended there are no commands to be pv lt XMT_START gt MasterTransmitter started t lt SP_START gt Service Provider started Compression yes Security no fA Statistics lt TCPIP_READY gt 1696 TCP IP Receiver ready to accept incoming calls Port 33C Active Panel lt LGW gt lt XNT_COMPROC_FINI gt All communication processes are finished ic 3 Database EB u Settings Ic u Start Program Press F1 to get help F5 for refresh 4 1 Setting up rvsXP stations Before you can communicate with a partner station you have to set up the partner station and your local station The same also applies to your partner e 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 st rysXP Administrator Stationtable loj x File Edit View Monitor Database Window 8 x allelei pixj Station Comment Odette Phone State LOC Local station 00013003036GEDASRYSCC ENABLED Remote stati ODETTEID ISDN PARTNER ENABLED Remote stati ODETTEID TCP PARTNER ENABLED Remote stati ODETTEID X25 PARTNER ENABLED 49 Database u Settings El A St
31. blanks CHECK_RE as with ALL in addition a resident receive entry RE must be present Default ODETTE VDSNCHAR Compression Type of compression during the transfer NONE the ODETTE blocks are not compressed ODETTE the ODETTE blocks are compressed following the ODETTE standard RVS no longer up to date has no effects Default ODETTE FLAGCOMP 40 Configuration of rvsXP Parameters Meaning of advanced Odette parameters Database parameter Encryption Defines whether or not encryption is to be used during file SECURITY transmission Make this setting either for all stations in rdmini dat or for each single station in the ODETTE parameter configuration The monitor parameter is applied to 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 Default SECURITY OPT PKI rvsXP ca
32. can use the wildcard characters and or a combination of and for entering selection criteria stands for any or even empty character string stands for one character of any value Use one of the following characters as the status code y no event queued not yet processed by rvsXP Monitor f forwardable waiting for transmission process p pending waiting for completion y ended a active J in transit transmitter currently processing order deleted h held by the system or operator e Ifyou 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 2004 05 28 83 gedas deutschland GmbH Fachbereich 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 SRVSPATH usrdat folder Then it logs reception in the rvsXP Administrator and in the SRVSPATH 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 fi
33. 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 the received files The list of files being received displays those files which have not yet been completely transmitted Your station and the partner station are presently transmitting the files To display the files announced e Choose View gt Receive The list of files which have been completely received displays those files which have been successfully transmitted to your station At this stage your station h
34. 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 for send jobs only The own local station must not function as a router B BOTH Standard OFTP routing routing is allowed in send and receive direction Default B Maximum file size for statistical logs rlstat log Default 2000000 This parameter refers to the cooperation between rvsXP Monitor and service provider Change after consultation with rvs Support only Default 10 Maximum size for a data set to be considered short in Kbytes units of 1024 bytes Default 100 Send priority for short data sets Default 40 Use of encryption OPT Optional Use of encryption if NO No encryption FORCED Compulsory Default OPT Number of buffers or records that the Sender sends before looking at FORCEDEND again Default 1000 The priority for new SEs should be at least as high as the highest priority of valid for SE Default 50 ID of station tha
35. information required by rvsXP for ODETTE file transfer If you access the partner station via a neighboring station connection type Routing you do not have to enter the parameters for passwords This information has already been entered at the neighboring station In this case rvsXP ignores the existing entries during the communication process Parameters Meaning of Odette parameters Database parameter Odette Id In contrast to the station ID which only has to be unique on ODETTEID your computer the ODETTE ID is a worldwide unequivocal identification of the partner or your own station if ODETTE File Transfer Protocol is used The ODETTE ID consists of 25 characters including the letter O the 18 character 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
36. 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 1 3 Command descriptions You can type commands in rvsXP Administrator and watch their execution in the Monitor log To do so choose Edit gt OperatorCommand Square brackets in the command descriptions indicate optional parameters Curled brackets and pipes list alternatives Activate SID sid Act is an alias of activate Activates a partner station An rvsXP communication program starts and establishes the connection Queued data sets will be transmitted Cleanup DAYS n SS YES Physically delete all commands from the database that have been executed or logically deleted at least n days ago exactly n x 24 hours cleanup DAYS 0 deletes all executed and deleted commands
37. locally and EERP is created and a post processing script starts if necessary In a routing case the finals receiver s SID SIDDEST does not match the local station s SID In this case a send entry is created that forwards the file to the actual receiver Upon receipt of an EERP a verification as to whether the receiver Odette ID in the EERP matches that of a virtual station is performed In this case the file is delivered locally and EERP is created and a post processing script starts if necessary rvsXP User Manual Rev 2005 12 18 57 gedas deutschland GmbH FB rvs Systems rvsXP User Manual Sending from virtual stations Setting up virtual stations Updating removing virtual stations Renaming The send job is given the SIDORIGIN parameter for sending from virtual 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 The process of creating and setting up virtual stations is basically identical with that of other stations Refer to Chapter 4 1 Setting up rvsXP stations The process of editing and removing virtual stations is basically identical with that of other stations See also Chapter 4 1 9 Editing the partner station 4 1 9 Editing the partner station Editing properties To edit the parameters of an existing station In orde
38. lt XMT_COMPROC_FINI gt All communication processes are finished 2 Statistics 6 Active Panel a 8 Database E 8 Export 8 Import u Settings Parameters E Options 2 Environment u Start Program Dia Key Admin R Tray Icon Press F1 to get help F5 for refresh rvsXP User Manual Rev 2004 05 28 69 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual Requirements 6 2 Starting rvsXP rvsdiant exe You need a system which has been set up for operating rvsXP and the required access rights Start the rvsXP program e inthe rvs folder e inthe rvsXP Administrator using Program gt Dia or e with the rvsTraylcon The rvsXP window opens with display of not transmitted datasets y rysDia display of completely transmitted datasets oj xj File Edit View Help Dia xole S el 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 70 How to work interactively with rvsXP
39. member of the closed user group will be rejected by the switching exchange The same applies to connection requests from group members to participants not being a member of the closed user group This service attribute is called Closed User Group CUG CUG 52 Configuration of rvsXP 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 Parameters Meaning of parameters Database ISDN parameter 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 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 4 1 7 Setting up X 25 parameters Connection 25 Z Advanced x 25 x 25 Address fi 234567890 Link EG x coc fo zi Advanced Port fo Cancel If you have selected the X 25 connection in the 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 You must specify the parameters s
40. 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 H in the Start Time field e Confirm the entry by pressing OK 80 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 82 Release the orders selected with Release 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 o
41. 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 security 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 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 i
42. 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 XP automatically installs the TCP IP protocol If the TCP IP protocol is not contained in the list shown 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 Start installation Start Windows XP and log in as an XP user with administrator rights e 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 EnterD 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 e
43. send and receive files with rvsXP First it will be explained how you can create send requests The next chapter describes how you can display sent and received transmissions The last chapter shows how to edit send and receive data sets 6 3 1 Creating send orders To send a file to a business partner 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 docs ce E 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 The New 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 Station dialog and select the ID rvsXP User Manual Rev 2004 05 28 73 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual Example LOC To send the file to your partner under a different name enter the new file name into the New Name field It is the 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 Confirm your entries with OK The file size limit is at th
44. source provides the rvsXP Monitor with all the information required for the tasks to be executed When the rvsXP database is initialized the initialization program first creates a parameter table for the Monitor parameters with default values which determine the default behavior of rvsXP Monitor You can modify these values by editing the C rvs init rdmini dat file which is the source for modification of the parameter table in the rvsXP Monitor start phase Changes will only take effect when the Monitor is started again if you modify the file while rvsXP Monitor is in operation Dynamic modification of the monitor parameters cannot be achieved in this way 66 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 al
45. systems with Oracle environment variables LINUX ORACLE OWNER oracle export ORACLE OWNER ORACLE HOME opt oracle product 8 1 7 export ORACLE HOME ORACLE SID rvslnx4 export ORACLE SID export DBID ORA PATH PATH SORACLE HOME bin 11 For more detailed information on the RVSPATH parameter see Chapter 1 6 Representation means rvsXP User Manual Rev 2004 05 28 131 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual Configuration file Example AIX export PATH LD LIBRARY PATH LD LIBRARY PATH home bwa rvs system home bwa rvs lib opt oracle product 8 1 7 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
46. 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 a 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 REPEAT is specified the command will be executed immediately and repeated indefinitely after the given interval has expired name value Is an alias of setparm 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 Appendix 1 The rvs parameters ACTPCOUNT parameter for ActivePanel only AECCHECK BACKUPINT BBCREATE BBPRIO BRICKOFTPTI CDWAIT CMDDELETE CMDTRACE CNSMSGS CODEIN CODEOUT
47. 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 j ob containing send c dsn lt file to be sents 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 sends 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 j ob containing send c dsn lt file to be sents 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 7 For more detailed information on the RVSPATH parameter see Chapter 1 6 Representation means rvsXP User Manual Rev 2004 05 28 123 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual 9 3 2 Code conversion when receiving files
48. 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 Skop rvs Monitor rvs Administrator rvs Clase rvsTrayiIcon To start the rvsXP programs with the rvsTraylcon e click the rvsTraylcon with the right mouse button and choose the desired menu item by clicking it with the left mouse button rvsXP User Manual Rev 2005 12 18 31 gedas deutschland GmbH FB 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 11x E Fie Edit View Monitor Database Window 2 18 x al l 2 x lt COPYRIGHT gt rvsXP3 01 00 c gedas 2004 All rights reserved E res lt INIT_CMD gt rpm Reading initial commands 3 Stations lt OK_READ gt RYSCNS cleanup days 3 ss yes fi Users lt CLNUP_DEL 55 gt Cleanup of RYS data
49. under the system user of the local machine He has no access rights for network directories If it is necessary for the rvsXP Monitor or the processes it controls e g a batch job from a resident receive entry to access network directories the rvs Monitor service must work under a user authorized to do so To this end proceed as follows 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 E E O General Log n Recovery Dependencies Log on as Local System account This account Password 0 n000 Confirm password You can enable or disable this service for the hardware profiles listed below Hardware Profile Service Profile 1 Enabled e 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 Welle Started Automatic 20 Installation of rvsXP After installation 2 4 The rvsXP program environment The rvsXP installation program creates a fol
50. when transmission is attempted if the passwords do not match and you receive an error message rvsXP User Manual Rev 2005 12 18 37 gedas deutschland GmbH FB rvs Systems rvsXP User Manual Station 1 Station 2 Password Password Send Send Receive Receive Note You receive your personal ODETTE organization ID upon request from Verband der Automobilindustrie Abteilung Logistik VDA phone 49 69 97507 283 Fax 4969 97507 300 rvsXP executes transfer with default values for the ODETTE file transfer protocol OF TP To view the default values or to change them click the Advanced button The Odette Parameter window will open with advanced configuration options Odette Parameters x m Code Translation Exchange Buffer Input fasci x Size fo Output fasci x Credit fo EERP Transmit Blocks In NORMAL Send fo Out HOLDIMMED Receive jo Security ort Allowed Chars ODETTE PKI YES Routing IN nd Cancel 38 Configuration of rvsXP Parameters Meaning of advanced Odette parameters Database parameter Exchange buffer size Maximum transmission buffer size Default 0 i e OEXBUF from parameter table applies OEXBUF Exchange buffer credit Maximum number of blocks sent without acknowledgement expected Default 0 i e OCREVAL from parameter table applies OCREVAL Code translation input
51. white cross in a red circle if rvsXP Monitor is stopped rvsXP User Manual Rev 2004 05 28 65 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual Stopping from the rvsXP environment What can be customized Start settings Carry out the following steps if you want to stop rvsXP Monitor from within the rvsXP program environment while it is in operation 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
52. window 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 copies are stored under the name jsXXXXXX bat where XXXXXxX stands for a consecutive number You can examine these files for correctly executed commands for troubleshooting purposes The number of the jobs XXXXXX must not exceed 32 000 Windows XP restriction Note If you want rvsXP not to save copies of the batch programs j SXXXXXX bat file in the rvsXP temp folder you should add the following command to your batch file DELETE DSNTEMP 88 How to work interactive
53. 1 9 RT routing table 35 rvs batch interface 9 A4 1 rvs Monitor 9 A4 2 Specify 18 Starting 20 Startup mode 78 rvs parameter Working with A1 1 rvs parameters A1 13 rvsbat A4 1 rvsbat program A4 1 rvscom A4 2 rvscom program A4 2 rvsdia A4 1 rvsdia program A4 7 rvsdiant exe Launching 70 Starting 70 rvskeydel program 114 rvskeydst program 113 rvskeyimp program 111 rvskeylst program 116 rvsmgr exe Launching 69 Starting 69 rvsmon A4 2 rvsmon program A4 2 rvssp program A2 2 rvsTraylcon 31 rvsxmt A4 2 rvsxmt program AT 14 A4 2 rvsXP Configuration 37 Display mode 70 Exiting 72 Installation 17 Sending a file 25 Starting 70 Window areas 71 rvsXP administrator Starting 32 69 rvsXP back up 95 rvsXP database Cleaning up 101 Managing 95 rvsXP User Manual Rev 2004 05 28 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual rvsXP database see Database rvsXP function test 25 rvsXP HighPerformance 131 rvsXP Monitor AT 4 Changing startup type 18 Starting 63 Startup type 78 19 Stopping 65 rvsXP Monitor parameters 66 Adapting 67 68 rvsXP test 25 rvsXP Traylcon 32 S SAMPLES environment variable A3 2 Saving User 93 SCPRIO parameter AT 9 SDSNMAX parameter A1 9 SDSNPRIO parameter A1 9 SECURITY parameter A1 9 Selecting display criteria 82 Self test via parameter 43 Send File 25 Send parameter 37 39 Send order Creating 73 Displaying
54. 21 9 2 1 Structure of the code conversion tables _ 22444nssnnnnnnnnnnnnnnnnnnnennennnnnnn 121 9 3 How to perform a code conversion unneeessssnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnannennn nn 122 9 3 1 Code conversion when Sending files _ u 4444400nnnnnnnnnnnnnnnnnnnnnnennennn nen 122 9 3 2 Code conversion when receiving files_ u 4224444044nnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn 124 10 Backing Up and Recovering rvsXP Data nnsssnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnannnnne 127 10 1 NEW parameters en ee Maven ahs Helene 127 10 2 Procedure nee sie 127 10 3 WVSEEUO Options deskri enpagi eae EE an EAEE enan ENAA APAA EA E A EREA RENEE 129 11 FYSXP HighPerformance nee nenne 131 11 1 Configuration of ORACLE vr een reellen 131 112 COMMGUIATION OD IVSAP nee ee e VR 133 11 3 Microsoft SQL Server configuration sssssssssrenesesneresnrerssrrrrserrrnnrrrnnnrrnnnresene 134 Appendix Appendix 1 The rvs parameters Appendix 2 Log files Appendix 3 Environment variables Appendix 4 Glossary Contents Index rvsXP User Manual Rev 2004 05 28 5 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual Introduction Change History The following changes of User Manual were made in the previous releases including the current release Version 4 0 size limit of files to be transferred is now 10 GB new parameters in the
55. 4 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 rvsAdministrator 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 9 For more detailed information on the RVSPATH parameter see Chapter 1 6 Representation means rvsXP User Manual Rev 2004 05 28 125 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual Example Example Example 9 3 2 2 Using resident receive entries created with
56. 67890 Link Eicon gt Kate f0 7 Port Facilities Userdata Timeout Parallel Sessions Close User Group ai Virtual Circuit Cancel Edit the parameters and click the OK button to save the changes or click the Cancel button to discard the changes The table below explains the individual parameters Parameters X 25 address Meaning of parameters X 25 15 digit X 25 DTE address of the partner station 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 Database parameter XADDRESS rvsXP User Manual Rev 2005 12 18 gedas deutschland GmbH FB rvs Systems 55 rvsXP User Manual 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 TECCOM cards Values for m and n m Number of the X 25 card installed in the computer beginning with 0 n Port number of t
57. 77 Editing 80 Holding 80 Releasing 87 Removing 87 82 Restarting 87 Temporarily hold 80 SENDBLOCKS Monitor parameter 66 SENDBLOCKS parameter 39 A1 9 A1 13 Senders Number AT 14 Sending File 73 Key file 113 With code conversion 122 Sending a file 25 73 SEPRIO parameter A1 9 Serialization 10 77 SERVER environment variable A3 2 Services rvs Monitor 18 Starting 20 Startup type 19 SESSIONS parameter 53 56 setparm command 68 A1 2 A1 4 Setting Environment variables A3 7 Set up Local station 32 Partner station 32 Routing 45 SID A1 4 SID parameter 36 SIDNEIGHB parameter 46 SIDTRACE parameter A1 7 A1 9 SIDTYP parameter 36 SLEEP parameter A1 9 A1 14 SNARCV parameter AT 10 Sorting User entry 97 Sp command A1 4 SPFILESDIR environment variable A3 2 SPINDIR environment variable A3 2 SPOUTDIR environment variable A2 2 A3 2 SQL server link 137 Requirements 134 SSCREATE flag AT 16 SSCREATE Parameter A1 10 ST station table 35 Start rvsTraylcon 37 rvsXP administrator 32 Start command A1 4 Starting Dialog interface 69 rvsdiant exe 70 rvsmgr exe 69 rvsXP 70 rvsXP administrator 69 rvsXP Monitor 63 State of jobs 71 Station Activate 59 Backing up 59 Properties 33 58 Release 59 Renaming 58 Setting the status 59 Status change 59 Stopping 59 Station parameter 36 Station properties 36 Station ID parameter 36 Station list 73 Station name
58. 9 71 777 telefax 49 30 399 71 994 email rvs service gedas de If you want to use rvsXP to exchange data via an X 25 type network you need the following equipment 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 Windows XP If you already have this equipment then you install the X 25 interface 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 gedas deutschland GmbH has successfully tested the following X 25 cards for use with rvsXP EiconCard EICON Technology Corporation cards manufactured by TECCOM Ltda Rua da Assembleia 10Gr Centro Rio de Janeiro Ru Brasil Connectionto The TCP IP protocol is required for exchanging data using rvsXP and also for internal rvs communication For the data exchange you have to do the following Install the network hardware with which you want to connect your computer to the network For more detailed information consult the documentation provided by your hardware supplier 16 Installation of rvsXP e Display Network Connections Start gt Control Panel gt Network Connections The
59. D LOC B 8 Database lt 0K_ACTIVATE gt connect to station LOC H k 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 occur in accordance with the advices in the Messages and Return Codes manual rvsXP User Manual Rev 2004 05 28 29 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual 30 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 Loggingonas ThervsXP Administrator is used to configure and manage rvsXP administrator and also for working with rvsXP To be able to perform these tasks the rvsXP Administrator features appropriate detail windows The rvsXP configuration requires that you have Administrator privileges at system level as well as in the rvsXP environment Program start with rvsTraylcon Tip Using The installer sets up the rvsTraylcon that facilitates launching the most rvsTraylcon frequently used rvsXP functions After a Windows reboot you find this icon in the system tray 11 39 4M To display
60. 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 e 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 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 e Enter the status code to be selected in the State Code field This entry is optional 82 How to work interactively with rvsXP Note You
61. Follow the installer instructions You can confirm the C rvs target folder or select another Please note that file and path names must not contain any spaces e You may choose between German or English as user languages rvsXP User Manual Rev 2004 05 28 17 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual extern database Automatic or manual service start Change startup type 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 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 Microsoft SQL please read the chapter 11 rvsXP HighPerformance for more
62. 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 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 rvs Rechner The abbreviation rvs stands for the German word Rechner Verbund Verbund System System The rvs computer communication system is a well established base service for electronic data interchange EDI rvs serves to ensure transmission of electronic data between heterogeneous computer platforms using different network protocols To do so rvs implements a universal network model which you can configure in each network node rvs provides an efficient and reliable transport service for both standardized EDI message types and files of any format or contents You can receive only 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 bank
63. P Phone m Odette Odette ID O0023003036GEDASRYSCC Advanced Send password fox Receive password fox Connection TCPAP x Advanced TCPAP IP Address fi 23 1 234 8 Port 3305 Cancel rvsXP User Manual Rev 2005 12 18 33 gedas deutschland GmbH FB rvs Systems rvsXP User Manual Simultaneous reception via several lines The dialog shows depending on the feasibility of pertaining parameters different property fields for your local station and the remote stations The local station is always physically present and can never be a virtual station Neither do you need a password to communicate with your own local station This is why fields such as virtual Send password and Receive password are available for remote stations only While transfer to a remote station at a given time is possible via a particular data line only several remote stations can send the data to your station via different data lines and line protocols This is why connection parameters of the remote station always relate to one line type Depending on the station s equipment the parameters for the local station can comprise several lines and protocols Properties for Station LOC Local Station f xj r Station Station ID LOC Comment Local station Phone Poo Odette Odette ID 00013003036GEDASRVSCC PET Selftest via terap Advanced TCPAP son x25 IP Addres
64. Priority K 1 100 4 1 5 Setting up TCP IP communication Connection TCP IP Advanced TCP IP IP Address j 23 1 234 8 Port 3305 Cancel If you have selected the TCP IP connection on the Connection type tab you can edit the line parameters for the network connection on the TCP IP tab with TCP IP protocol rvsXP User Manual Rev 2005 12 18 47 gedas deutschland GmbH FB rvs Systems rvsXP User Manual 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 bution to delete the currently displayed set rvsXP will automatically assign a number for the receiving channel Port when you add a new record Selftest via TCPAP Advanced TCPAP TcPAP IP Address 192 183 010 I Start Port 3305 Max Sessions 5 Remove Insert TCPAP ISDN x 25 Note Enable the Start checkbox to activate the recipient If the configured recipient is to be automatically active after the rvsXP Monitor has been started 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 TCP IP address has to be unique for a send transmission to a partner station Thus
65. SWFROM parameter 37 PSWTO parameter 37 Q QEPRIO parameter AT 2 A1 8 QSPRIO parameter AT 8 QZPRIO parameter AT 2 R RCVTIMEOUT parameter 53 56 rdkey dat file 22 Index rdmini dat file 66 68 102 RECBLOCKS parameter 39 Receive parameter 37 39 Received files Displaying 78 Receiver parameter 43 Receiver number parameter 48 53 56 Reception Resident receive entry 84 With code conversion 124 with ISDN 67 with TCP IP 60 with X 25 67 Record formats 9 Recreating rvsXP database 98 RECVBLOCKS parameter A1 8 A1 13 Refreshing Display 79 Displaying 78 Release Station 59 Releasing Send order 87 Remote parameter 36 Removing Jobstart entry 97 Resident receive entry 88 Send order 81 82 User 93 User entry 93 Renaming Station 58 Replacement markers 84 Requirements 12 Resident receive entry Creating 85 Displaying 85 Editing 87 Receiving 84 Removing 88 Restarting Send order 81 Restoring Database 101 rvsXP database 107 Station table 100 User table and follow on processing 100 Resumed transmission Automatic 9 RETRY parameter obsolete A7 8 RLCOMAXSIZE monitor parameter A2 1 RLCOMAXSIZE parameter A7 9 RLDBMAXSIZE parameter A1 9 rlog log file A1 14 A1 16 A2 1 RLOGMAXSIZE Monitor parameter A2 1 RLOGMAXSIZE parameter A1 9 rlstat log file A1 16 A2 1 Route tab 46 Routing 45 Set up 45 ROUTING parameter AT 9 RSTATMAXSIZE parameter A
66. T 5 Adaptation License key 22 Adapting Monitor parameters 67 68 AECCHECK parameter AT 5 A1 15 Allowed characters parameter 40 AP_DISPLAY_INTERVAL environment variable A3 2 Appendix A14 135 ARCDIR environment variable A3 2 ASCII 39 A4 1 ASCII EBCDIC conversion 119 AUTODIAL parameter 44 B Backing up Station 59 Station table 96 User table and follow on processing 97 Back up Backing up rvsXP tables 96 Backing up the station table 96 Database complete 97 Overview 95 Recommended procedure 95 Restoring 100 Restoring the rvsXP database 101 Restoring the station table 100 Restoring user table and follow on processing 100 rvsXP 95 User table and follow on processing 97 Write to log A3 3 BACKUP parameter AT 5 Basic functions 8 BBCREATE parameter AT 5 A1 15 BBPRIO parameter AT 2 AT 5 Block size parameter 39 42 Blocks During reception 39 During sending 39 BRICKOFTPTI parameter AT 5 C C Cal interface 9 CDWAIT parameter 44 CDWAIT parameters A1 5 Cleaning up see Cleaning up the rvsXP database Cleanup command 101 A1 3 A1 14 Closed User Group parameter 52 57 CMDDELETE parameter 101 A1 5 A1 14 CMDTRACE parameter A1 5 CMX A4 1 CNSMSGS monitor parameters A2 1 CNSMSGS parameter A1 5 A1 16 Code conversion 119 During reception 124 During sending 122 Performing 122 Code translation parameter 39 CODEIN parameter 39 A1 5 CODEOUT parameter 39 A1 5 Command Cleanup A1 3 List
67. The rvs Monitor Properties opens rvs Monitor Properties Local Computer a General Log On Recovery Dependencies Status Started Started Description Loads files Provides pr Provides n Creates a Creates a Manages a Provides th Manages t Enables re Started Started Started Started Offers rout Enables st Started Stores sec Started Local Computer tysMonitor Service name Display name Description Path to executable c rvs system rvsmon exe Startup type Automatic Service status Stopped Pause You can specify the start parameters that apply when you start the service from here Start parameters Resume Apply Startup T Automatic Automatic Manual Manual Manual Manual Automatic Manual Automatic Manual Disabled Automatic Automatic Automatic Log On As N Local System Local System Local System Local System Local System Local System Local System Network 5 Local Service Local System Local System Local System Local System Local System window e Choose Automatic inthe Startup type field and confirm with OK The rvsXP Monitor startup type changes to Automatic rvsXP User Manual Rev 2004 05 28 gedas deutschland GmbH Fachbereich rvs Systems 19 rvsXP User Manual Expanding access rights Assigning rvs Monitor special user rights By default the rvs Monitor service runs
68. V No Limit Active Connection Setup Vv Priority 10 Cancel Priority reserved for future use Parameters Connection parameter meaning Database parameter Delay Time in seconds to wait after receiving a file before a CDWAIT Change Direction CD is initiated Parallel sessions Maximum number of active simultaneous connections via PSESSIONS this line Default 1 no restrictions Active connection Specifies the send behavior for a pending send order AUTODIAL establishment Values Values v Sender should automatically start as soon as a file is Y v ready for dispatch N O O Pending send orders do not trigger a send action Default v The priority number is planned for rvsXP updates It is PRIORITY Preparing files for fetching Establishment of an active connection It is occasionally necessary for files to be made only available and not to be sent immediately On the contrary the partner station is to establish the connection and fetch the available files as and when required The partner bears the costs for the connection Active connection establishment must be switched off for this case 44 Configuration of rvsXP What is routing Without routing With routing Acknowledgement EERP Prerequisites 4 1 4 Setting up the routing connection The forwarding of files throughout several OFTP systems is referred to as routing If you would like to send a file via sever
69. about incoming information g p e IZ Information delivery to the recipient q p e QS Acknowledgement transmission back to a E ay sender i p e rvsXP User Manual Rev 2004 05 28 71 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual It is always possible to exit Note Each event normally runs through the status chain in the order of possible values indicated Some statuses have such a short duration that they are only briefly visible The meaning of the values no event q queued not yet processed by Monitor 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 72 How to work interactively with rvsXP 6 3 How to send and receive files with rvsXP Overview This chapter describes how to interactively
70. active connection 44 FACILITIES 52 56 FORCEDEND A1 6 A1 9 genkey 108 IEPRIO AT 2 A1 6 IN 39 INADDR 48 INITCMDS AT 7 Input code translation 39 IP address 48 ISDN facilities 52 ISDN number 51 ISDN protocol 52 ISDN user data 52 ISDN_FAC 52 ISDN_PROT 52 ISDN_TEI 52 ISDN_USRDT 52 ISDNNO 51 IZPRIO AT 2 AT 7 KEEPDAYS AT 7 AT 14 LDSNPRIO A1 7 LID AT 7 LINK 52 56 LITRACELEVL 68 LITRACELVL A1 7 AT 9 A1 16 LMPRIO A1 7 MAX_IN 49 MAXCMD AT 7 Maximum sessions 49 MAXRECL A1 7 AT 12 MAXSENDERS A1 7 AT 14 MAXX25RCV 50 54 61 A1 7 A1 15 MSGPRIO A1 7 N 48 53 56 NAME AT 2 Neighboring nodes 46 NUMRLOGS A1 7 NUMRLSTAT AT 7 OCREVAL 39 A1 7 A1 13 Odette 37 Odette Id 37 ODETTEID 37 ODTRACELVL A1 8 A1 9 A1 16 OEXBUF 39 42 A1 8 A1 13 OKPRIO A1 8 ORETRY A1 8 OTIMEOUT AT 8 OUT 40 Output code translation 39 Parallel sessions 44 53 56 PHONE 36 Phone 36 PKI 41 AT 11 PORT 49 Port 49 PRIORITY 44 46 Priority 44 46 PROTOCOL 43 PSESSIONS 44 PSWFROM 37 PSWTO 37 QEPRIO AT 2 A1 8 QSPRIO A1 8 QZPRIO A1 2 Rev Timeout 53 56 RCVTIMEOUT 53 56 RECBLOCKS 39 Receive 37 39 rvsXP User Manual Rev 2004 05 28 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual Receiver 43 Receiver number 48 53 56 RECVBLOCKS A1 8 A1 13 Remote 36 RLCOMAXSIZE A1 9 RLDBMAXSIZE A1 9 RLOGMAXSIZE A1 9 ROUTING A1 9 RSTATMAXSIZE A1 9 rvskeydel 114 rvskeydst 113 rvskeyi
71. again Deletion has been successfully completed if the message ended with RC 0 appears Reinitializing Initialize the rvsXP database To do so start the Init Database the database program in the rvs program folder rvsXP will then generate a completely new rvsXP database After 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 Start rvsXP Monitor rvsXP User Manual Rev 2004 05 28 99 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual 7 4 Restoring rvsXP data from a back up When you have performed a back up with one of the back up procedures you can restore the station table the user table together with the tables for follow on processing or the entire rvsXP database See rvsXP database maintenance on page 95 7 4 1 Restoring the station table To restore the station table e StartrvsXP Monitor e Execute the menu command Database gt Import gt Stations 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
72. ail 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 2 See Chapter 1 6 Representation means for more information 22 Installation of rvsXP Structure of the license key data rdkey dat file 0000000000 Customer Number NT Product 3 00 00 Release 5LTX Included Components TESTINSTALLATION Customer Name Part one Customer Name Part two reserved reserved reserved reserved reserved Computer Model TESTVERS ION PHYSTCAL CPU IDENTIFICATION 94211 Expiration Date CA580BE5 20189735 612035F9 77AD6591 162D0D7F 18FAB129 53B14EA4 79390F44 EEE 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 C gedas GmbH 1999 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 T TCP IP communications X X 25 native ISDN communications Not all features are available on all platforms at this time Expiration date The license expiration date is designated YYTTT where YY means the year TTT the day of year of the respective year Note Do not modify any of the f
73. ail 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 1 lt FILE gt Options f lt FILE gt The file containing the key where the full path must be specified with FILE rvsXP User Manual Rev 12 03 2004 113 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual s lt SID gt The ID of the station to which the key will be sent repeatable 1 lt FILE gt The file containing a list of station IDs Example rvskeydst f C rvs keycreate C45PUB pub s riil s a34 s gedas 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 T
74. al 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 Local Neighbour Target station station station When the file has arrived at the end system it sends an 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 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 Routing as the connection type on the Connection type tab for this station and the station ID for the neighbor station on the Route tab This is how you set the stations for routing Choose the station from the station table as usual and double click the entry in the list or execute the menu command Edit gt Update e Choose Routing as connection type inthe Connection type area Your partner station is not a direct neighbor station of yours rvsXP User Manual Rev 2005 12 18 45 gedas deutschland GmbH FB rvs Systems rv
75. ange 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 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
76. aracters 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 2004 05 28 A1 11 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual VFTYP XMCREATE The way how files with a fixed or variable format will be converted prior to transmission V rvs internal format only useful for rvs for variable and fixed formats S Format of ft SINIX useful also for ft SINIX T Text format each line is terminated by carriage return and line feed Each line is converted into one output record The record length is defined in MAXRECL Files in the fixed or variable format can be stored as text files For this purpose you should use the VF TYP 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 reco
77. art 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 32 Configuration of rvsXP Updating a station Adding a station Note During default installation rvsXP sets up the following sample stations for the communication modes in the station table RSlis 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 xi r Station Station ID F ST Virtual T Comment Remote station via TCP I
78. as acknowledged reception To display completed send orders Choose View gt Completely received 3 For more detailed information on the RVSPATH parameter see Chapter 1 6 Representation means 78 How to work interactively with rvsXP 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 rvsXP User Manual Rev 2004 05 28 79 gedas deutschland GmbH Fachbereich 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 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 82 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
79. atabase maintenance Note This method does not preserve the parameters Restart TCPIPRCV or MAXX25RCV rvsXP User Manual Rev 2004 05 28 gedas deutschland GmbH Fachbereich rvs Systems 95 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 according 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 edit
80. ay the Monitor Log window in the Log gt Monitor of the rvs tree inthe rvsXP Administrator Stop and start 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 68 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 se
81. 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 Protocol Packet size Specifies the ISDN standard used 1TR6 German national standard E DSS1 EURO ISDN Standard E DSS1 Size of date packets during data transmission ISDN_PROT 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 ifthe partner station or CAPI does not reply Default 30 TIMEOUT X 25 Facilities Special information or facilities for an X 25 transmission see the information of the X 25 service in use FACILITIES X 25 UserData User data for an X 25 transmission see the information of the X 25 service in use USERDATA Terminal identifier Only required for X 31 Terminal End Identification Default 0 no TEI assigned ISDN_TEI ISDN Facilities Special information or facilities of the ISDN transmission ISDN_FAC ISDN UserData User data for the ISDN transmission ISDN_USRDT Closed User Group ISDN and X 25 allow for the formation of a closed user group All members of such a group can communicate with each other via the public telecommunication network Connection requests to group members received from participants not being a
82. ch rvs Systems rvsXP User Manual New user User dialog To set up a new user e Choose Edit gt Add The User dialog opens and displays the User Table parameters User ID Mo Full Name Steve Miller Lanquage Engish Privileges User sts 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 XP user name To ensure this copy the exact spelling of your Windows XP user name from the Windows XP User Administration Enter the complete user name Select the language for screen dialog 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 92 How to work interactively with rvsXP Removing a user User dialog 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 of the user data parameters You can se
83. cking up the station table rvsXP User Manual Rev 2005 12 18 59 gedas deutschland GmbH FB rvs Systems rvsXP User Manual Automatic reception of calls 4 2 TCP IP reception If you want to be ready to receive via TCP IP rvsXP must start a TCP IP receiver that waits for incoming calls 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 I 2x Parameter SECURITY OPT z SENDBLOCKS 1000 SEPRIO 50 SIDTRACE SLEEP 30 Close SLEEP 30 Se SSCREATE 0 Hel STATISTICS 2 __Heb SYNCDL 500 SYNCTO 120 TIMESTAMP 2 p TMAXCON 0 TSTODPRCT 90 x TCPIPRCV fl Apply e Double click TCPIPRCV 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 Activate the parameter by stopping and starting the rvsXP Monitor 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 60 Configuration of rvsXP 4 3 ISDN X 25 reception Automatic reception If you want to be ready to r
84. cribes 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 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 metho
85. d 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 12 03 2004 103 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual Creating a key pair Distributing public keys safely storing private keys Importing an external public key 8 1 2 rvsXP encryption principle and procedure Each participant in encrypted communication creates a key pair on his system consisting of the public key and the private key The recipient makes his public key available to all partners he expects to receive data transmissions from The respective sender thus can encrypt the data for precisely the partner who sent him the public key in question There is no security risk in openly transmitting the public key as it is not suited for decryption The partner does not share his private key and stores i
86. d 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 means that every computer in your LAN uses the Brick router as if it were a local ISDN card in the computer rvsXP User Manual Rev 2004 05 28 15 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual X 25 connection TCP IP connection Note gedas deutschland GmbH has successfully tested the following ISDN devices for use with rvsXP Device Manufacturer Remarks EICON DIVA Server Eicon http www eicon de BRI 2M EICON DIVA Pro 2 0 Eicon http www eicon de EICON DIVA 2 0 Eicon http www eicon de AVM B1 AVM http www avm de not suitable for X 31 AVM Fritz Card AVM hittp www avm de only Classic and PCI BIANCA BRICK XS BinTec http www bintec de with remote CAPI XL XM and X4100 rvs Support will provide you with the current list of tested devices phone 49 30 39
87. d 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 rvsXP User Manual Rev 2004 05 28 25 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual New Send Entry a C rvs system readme txt teadmeReceived txt J delete after transmission J Serialization F add Text Fired Variable e Unstructured SEAN 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 26 Function Tests X rysXP Administrator Monitor Log 5 x File Edit View Monitor Database Window 2 8 x s l r lt INIT_CID rpm Reading initial commands B C Ivs lt OK_READ R SCNS cleanup days 3 ss yes E Stations lt CLNUP_DEL_ 35 Cleanup of RVS data base purge all SendStatistics with DTE lt CLNUP_START Cleanup of RYS data base purge all commands with DTDONE lt Bi Users
88. database Delete rvs database not be a clean initial state but rather an unmaintained state of the user environment which is disadvantageous and not desired in practice To back up the entire rvsXP database Stop rvsXP Monitor Execute the menu command Database gt Export The Select Backup File dialog 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 if the message End appears e Start rvsXP 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 Make sure that all send and receive entries have been completed Pay attention to the send orders and receive entries which make use of the serialization function e 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
89. der 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 latest information that is not included in this manual notepad exe C rvs system README TXT Stop rvs Monitor
90. dit gt New Send Entry gt Options gt Format Fixed Variable gt Input Code A Output Code E The input code is A for ASCII the output code is E for EBCDIC rvsXP supports code conversion both during sending and receiving of files You can force a code conversion of received files by setting up an appropriate resident receive entry For the code conversion you can use two sorts of code conversion tables those integrated in rvsXP or your own conversion tables 9 1 Automatic code conversion with integrated conversion tables The rvsXP code conversion tables meet the following standards ASCII ISO 8859 Latin 1 and EBCDIC CECP 037 The code conversion tables are located as rtcae dat and rtcea dat files in the SRVSPATH system folder The meaning of the letters in those file names is 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 files to the SRVSPATH init folder SRVSPATH system rtcae dat SRVSPATH system rtcea dat 6 For more detailed information on the RVSPATH parameter see Chapter 1 6 Representation means 120 Code conversion 9 2 Code conversion with user code tabl
91. e SQL server and In order to efficiently master the continuously growing flow of data and to Oracle link increase the performance level of rvs the internal rvs C ISAM database can be replaced with a high performance database On Windows NT 2000 WS 2003 XP AIX and LINUX systems of version 2 05 and later there is the option to link to an Oracle database Windows NT 2000 WS 2003 XP systems of version 2 11 and later can be linked to a Microsoft SQL Server rvsXP license License key The rvsXP license key file RVSPATH 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 least version 8 1 7 At the moment we support the link to the Oracle database version 8 9 and 10 Normally we recommand to have the same version of Oracle client and Oracle server Exception On Windows systems we recommand Oracle Client 9 with the Oracle Server 8 1 7 Note For the Oracle client on Windows must Oracle version 9 with a patch 9 2 0 4 be installed 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
92. e 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 16 December 2005 129 gedas deutschland 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 v and 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 send order provision for which the p and e option is to be used Example 2005 10 26 11 20 34 130 rvsXP HighPerformance 11 rvsXP HighPerformanc
93. e moment 10 GB New Send Entry x Station ID Log Station ID of receiver Select File CAdocstnotesdoc Search New File Name ned virtual file name m Options Disposition J delete after transmission Change Options Start Time O YYAMMYDD HH MM H hold at first Label F Serialization Timestamp F add Format C Tert Fired Variable Unstructured Recordsize tS record size in case of fixed or variable Format Input Code code of the local file AsASCIl E EBCDIC Output Code SS code on receivers side A 45CIl E EBCDIC Codetable Search fal Encryption Compression 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 74 How to work interactively with rvsXP continued Options Transmission settings and actions Disposition Click the delete after transmission checkbox to have files deleted on your local computer after successful transmission Otherwise it would not be deleted Start Time rvsXP sends files immediately If this is not 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
94. e rvsXP database Yes No No rvsXP logs all database operation in the C rvs db rlstat 1log 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 2004 05 28 gedas deutschland GmbH Fachbereich rvs Systems A3 3 rvsXP User Manual A3 4 Appendix 4 Glossary Appendix 4 Glossary ASCII American Standard Code for Information Interchange Batch interface rvsbat The rvs batch interface provides functions for background processing CMX Communications Manager SINIX Dialog interface rvsdia The rvs dialog interface of provides interactive user functionality EBCDIC Extended Binary Coded Decimal Interchange Code EDI Electronic Data Interchange EDIFACT Electronic Data Interchange for Administration Commerce and Transport EERP End to End Response ODETTE term for an acknowledgement at the end of a send transmission ETSI European Telecommunications Standardization Institute FSS Forwarding Support Service rvsXP User Manual Rev 2004 05 28 A4 1 gedas deutsc
95. eceive via X 25 ISDN rvsXP must start a of calls receiver that waits for incoming calls on the X 25 ISDN line To set up rvsXP to receive calls automatically via X 25 ISDN 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 X 25 and ISDN reception to start automatically when the rvsXP Monitor starts you have to set the value of the rvsXPMAXX25RCV parameter to 1 ST x 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 Confirm your entry with Apply e Use Close to exit the parameter list Activate the parameter by stopping and starting the rvsXP Monitor 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 2005 12 18 61 gedas deutschland GmbH FB rvs Systems rvsXP User Manual 62 rvsXP Monitor 5 rvsXP Monitor This chapter describes how to start and stop rvsXP Monitor as well as how to customize the Monitor parameters for Windows XP rvsXP Monitor as Usually the rvsXP Monitor works as a system service In order to install Window
96. ecified 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 prestarted 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 2004 05 28 A1 7 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual ODTRACELVL OEXBUF OKPRIO ORETRY OTIMEOUT QEPRIO QSPRIO RECVBLOCKS RETRY Request line tracing between sender and OFTP 0 No tracing 1 Minimum tracing request names only for station specified in SIDTRACE 2 Detailed tracing parameter values etc for station specified in SIDTRACE 3 Detailed tracing for all stations Default 0 ODETTE exch
97. einitialize 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 128 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 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 fil
98. elp dl xjelo S x Entry No New File Name Disposition Time 2003 04 28 23 28 41 m Details File Name NOTES DOC Local Name C docs notes doc Receiver Loc State qq Additional Information Command Numbers Date Time Transmitted 0 SE 48 Disposition 2003 04 28 23 28 41 Block Size 0 Format u Send Attempts 0 End of Transmission Encryption NO Compression NO SK 0 Start of Transmission Send Attempt at 2003 04 28 23 28 41 dataset wont be deleted after successful transmission New Send Entry Delete Hald Select Refresh Press Fi 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 76 How to work interactively with rvsXP ojx I Eile Edit Wiew Monitor Database Window 18 x elek h lt SP_START gt Service Provider started Con 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 XMNT_COMPROC_FINI gt All communication processes are finished lt NEU_CMD_CREATED gt SK 43 created by 5E 42 Bi Users lt NEW_CMD_CREATED gt
99. ely with rvsXP 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 rvsXP Administrator lolxi Eile Edit View Monitor Database Window JE Ka gx ca Resident Receive Entries SID DSN Virtual Dataset Name Program Comment TXT sentr bat C lrvsisyst esentr bat Starts batch program re u BR Settings i Start Program Press F1 to get help F5 for refresh NM 4 Editing resident receive entries To edit a resident receive entry Select the entry to be modified in the Resident Receive Entries window e 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 2004 05 28 87 gedas deutschland GmbH Fachbereich 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
100. ennnnnennnnnnnnnnnnnnennnnnnnnn nenn 100 7 4 1 Restoring the station table aha a nie kaeebiwenbed 100 7 4 2 Restoring the user table and the follow on processing sscecseecccreeeseereee 100 7 4 3 Restoring the rvsXP database a ana ee Rr eens weds 101 75 Cleaning up the rvsXP database cleanup nnnessssennenenssnnnnnnnnnnnnnnnn 101 8 _ Encryption configuration Key administration unessennnnnnnnnnnnennnnnnnnnnnnnnnnnnnnnnnnnnn 103 8 1 Encryption Basics uses een 103 8 1 1 Encrypted transmission withirvsXP a2 ee 103 8 1 2 rvsXP encryption principle and procedure uneeessssnnnnnnnnnnnnnnnnennnnnnnnnnnnnn nenn 104 8 2 Overview of the rvsXP key administration 222444s444nnnnnnnnnnnnnnnnnnennn nenn 107 8 3 Creating private and public keys 24 4444440004nnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn ran 107 8 4 Importing Keys rvskeyimp wanna en 111 8 5 Distribution of keys rvskeydst uumeeeennnnnnnannnnnnnnnnnnnnnnnnnnnnnnnnnnnn anne 113 8 6 Deleting imported keys rvskeydel uummsssennnnnnnnnnnnnnnnnnnnnnnnnnnnnnn nen 114 8 8 Configuration of offline compression 444uu4m4nnnnnnnnnnnnnonnnnnnnnnnnnnnnnnnnn nenn 117 9 Code Conversion 22er une En esta Zs 119 9 1 Automatic code conversion with integrated conversion tables 120 9 2 Code conversion with user code tables u 222440444n44nnnnnnnnnnnnnnnnnnnnnnnn nenn 1
101. ere 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 MWDD 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 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 F
102. es The rvsXP user can use his own code tables instead of using the system code tables for code conversion The input code CODEIN output code CODEOUT parameters as well as the code table CODETABLE are of importance for code conversion Start gt Programs gt rvs gt rvsXP gt Edit gt New Send Entry gt Options The Input Code parameter defines the code of the file before conversion and the Output Code parameter is the code after the conversion The code table parameter allows you to use your own table for code conversion To use the user specific code tables you have two possibilities 1 You define all three parameters input code output code and code table See Chapter 9 3 How to perform a code conversion for more detailed explanations on code conversion during receiving and sending 2 You define Input Code and Output Code only and copy your own conversion table to the SRVSPATH init folder You own conversion table must be named rt cae dat 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 should have the same structure as rvs system code conversion tables SRVSPATH system rtcae dat and SRVSPATH system rtcea dat These code conversion tables have 256 decimal numbers 8 bit The position in the table Oth position in the table is the number 0 define
103. es Mead ots a dacuteetenehaars 70 6 3 How to send and receive files With rvsXP ueesssesssssennnnnnnnennnnnennnnnnnnnen nennen 73 6 3 1 Creating send arders a eit heat ea eda Now abd yaaa nee 73 e 2 ASSMANIZAN ON fash ae tats Seance ee einer Nee ata 77 6 3 3 Displaying send requests and received files 0 2 eeeeeeeeeceee eee eeeeeeeeeeeeeeeeeeeeees 77 6 3 4 Handling files to be sent and received uusssssesssnnnannnnnnnnnnnnnnnnnnnnnnn nenn 80 6 3 5 Selecting display criteria rn escheat ieee iat ap a eG a ae 82 6 4 Administration with rvsXP erkenne ebene 84 6 4 1 Resident receive entries u a eo 84 6 4 2 Job start after send attempt zer se eset ches sects ie 88 rvsXP User Manual Rev 2004 05 28 3 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual 6 483 USEr ACIMUIMISI AMON esse ee ee 91 7 rvsXP database maintenance n r r0000000nnnnnnnnnunnnnnnnnnnnnnnnnnnnnnnnnnnnnnerrennnnnnnannnnen 95 7 1 Back up backing up rvsXP tables assesenkennee 96 7 1 1 Backing up the station table cis u zen 96 7 1 2 Saving the user table and follow on processing s esseseeeessreessreesssrrrrserrrne 97 7 2 Backing up Backing up the rvsXP database uuueerssnssennnnnnennnnnnnnnnnnnnnnnnnn nn 97 7 3 Delete and reinitialize rvsXP database ccccccceeeeeeeeeeeeeeeeceeeeeeeeeeeeeeeeeeees 98 7 4 Restoring rvsXP data from a back up uuu22222222
104. essful 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 current environment settings r s Environment c ivs c rvs samples o rys keydir c rys tempout butech xpide c rvs aredir DENAME UBUSER DERSWE Confirm your changes entries by pressing OK Note Any changes will only take effect after rvsXP Monitor is restarted rvsXP User Manual Rev 2004 05 28 A3 1 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual Meaning of the environment variables Designation Meaning of the environment variable Default value PATH Main rvsXP folder and location of rvsenv dat C rvs environment file SYSTEM System folder with al
105. eters 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 send acknowledgement but wait for operator release After the release Establish connection if there is no connection to the partner and send EERP to the partner Default IMMEDIATE Recommended NORMAL Release acknowledgement again See Handling files to be sent and received on page 80 EERP_OUT Allowed characters Stipulates which characters are permitted for Odette FTP ALL no limitations OFTPUNIX all capital letters digits and special characters UNIX all letters and figures and the special characters _ ODETTE all capital letters figures and special characters amp and
106. ev 2004 05 28 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual Sending 113 KEYDIR environment variable A3 2 L Language environment variable A3 3 Launching rvsdiant exe 70 rvsmgr exe 69 Lc command A1 4 LDSNPRIO parameter AT 7 License key Adapting 22 NT 22 LID parameter A1 7 Line driver AT 5 Line type neighboring station 42 LINK parameter 52 56 Link test 27 Listemd command A1 3 Listdbv command A1 3 Listing Key 116 User entry 97 listparm command A1 2 A1 4 listst command A1 4 LITRACELEVL parameter 68 LITRACELVL parameter A1 7 A1 9 A1 16 LMPRIO parameter AT 7 LOC see Local station Local station 32 Activate 29 Managing 32 Setting up 32 Log file for troubleshooting A2 2 Log files 9 A2 1 Brief description A2 1 rlco log A2 1 rlog log A2 7 rlstat log A2 7 Troubleshooting A2 2 Lp command A1 4 Ls command A1 4 M Managing Local Station 32 Partner station 32 MasterTransmitter A4 2 MAX_IN parameter 49 MAXCMD parameter AT 7 Maximum sessions parameter 49 MAXRECL parameter AT 7 A1 12 MAXSENDERS parameter AT 7 A1 14 MAXX25RCV parameter 50 54 61 A1 7 A1 15 Monitor 2 A4 2 Starting 63 Stopping 65 Monitor parameters 66 Adapting 67 68 CNSMSGS A2 1 NUMRLOGS A2 1 NUMRLSTATS A2 1 RLCOMAXSIZE A2 1 RLOGMAXSIZE A2 1 RLSTATMAXSI A2 1 MSGPRIO parameter AT 7 Multiple languages 9 N N parameter 48 53 56 NAME parameter AT 2 Neighborin
107. 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 SRVSPATH system directory Syntax rvsredo lacype tfbsdv More about the rvsredo options please read in chapter 10 3 rvsredo Options rvsXP User Manual Rev 16 December 2005 127 gedas deutschland 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 recovery 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 r
108. g nodes parameter 46 Network link test 27 New user 92 NK line type table 35 Number Senders A1 14 X 25 or ISDN receivers A1 15 NUMRLOGS Monitor parameter A2 7 NUMRLOGS parameter AT 7 NUMRLSTAT parameter AT 7 NUMRLSTATS Monitor parameter A2 1 O OCREVAL parameter 39 A1 7 A1 13 ODETTE Explanation of terms A4 2 Odette A4 2 File Transfer Protocol 37 A4 3 Identification 37 ODETTE Id parameter 37 ODETTE parameters 37 ODETTE parameters table 35 ODETTEID parameter 37 ODTRACELVL parameter A1 8 A1 9 A1 16 OEXBUF parameter 39 42 A1 8 A1 13 Offline compression 10 117 Configuration 117 Features 77 OFTP A4 3 OKPRIO parameter AT 8 Online compression 9 Opcmd command A1 4 Open System Interconnection A4 3 Index Oracle link 137 Orders See also Command ORETRY parameter A1 8 OSI A4 3 OTIMEOUT parameter A1 8 OUT parameter 40 Output code parameter 39 P Parallel sessions parameter 44 53 56 Parameters ACTPCOUNT A1 5 AECCHECK A1 5 A1 15 Allowed characters 40 AUTODIAL 44 BACKUP A1 5 BBCREATE A1 5 A1 15 BBPRIO A1 2 Block size 39 42 BRICKOFTPTI A1 5 CDWAIT 44 A1 5 Closed User Group 52 57 CMDDELETE 101 A1 5 A1 14 CMDTRACE A1 5 CNSMSGS A1 5 A1 16 Code translation 39 CODEIN 39 A1 5 CODEOUT 39 A1 5 Compression 40 Connection 43 Connection type 42 CUG 52 57 Delay 44 DTCONNnn A1 6 DTCONNxx A1 14 Editing A1 1 EERP_IN 39 A1 6 EERP_OUT 40 A1 6 Establishment of an
109. gedas rvsXP Version 4 00 User Manual rvsXP User Manual The products listed in this manual are protected by copyright rvsXP Version 4 01 User Manual 2005 by gedas deutschland GmbH Pascalstra e 11 10587 Berlin This manual is protected by copyright All rights reserved No part of this book may be used or reproduced in any form or by any means including photocopies microfilm or any other means or stored in a database or retrieval system without obtaining prior permission from gedas Rights are also reserved as far as lectures radio and television is concerned We reserve the right to make changes to the content of this manual without giving prior notice gedas is not liable for technical or printing errors or defects in this manual Moreover gedas shall not be liable for damage which is directly or indirectly caused by delivery performance and use of this material Contents Contents 1 IHNTTOQLIELION aussen ae een 7 1 1 Short description of ihe system aeceee aad eae andes 7 1 2 Fisting 7 1 3 Encryption and offline compression 222224444444444440RHnHAn nennen nennen nnnnannnnnn nen 10 1 4 Targeligroup sue tens er eisen 11 1 5 Structure of the rvs documentation uanananenennennnnennnnnnnennnennnnennnennnnnnnnnnennenn 12 1 6 Representation means ainkmeeeuner 13 2 Installation OF IV SXP a nen 15 2 1 System requirements a ede aliee 15 2 2 Connection type installation ae n
110. h 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 e Start rvsXP Monitor 7 2 Backing up Backing up the rvsXP database This method backs up the entire rvsXP database and all rvsXP parameters The backup contains the complete current rvsXP environment state i e the station table the user table and the follow on processing as well as logs of all transmissions including aborted and not completed processes You can revert to this back up if you wish to restore the previous system state after a re initialization of the rvsXP database In most cases this will rvsXP User Manual Rev 2004 05 28 97 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual Backing up the complete
111. he configured X 25 port beginning with 0 Example NETX2500 Card number 0 with port number 0 Default NETX2500 Facilities Special information or facilities for an X 25 transmission FACILITIES see the information of the X 25 service in use Userdata User data for an X 25 transmission see the information of USERDATA the X 25 service in use Timeout Cancellation time in seconds after which the TIMEOUT communication program aborts the connection if the partner station or CAPI does not reply Default 30 Parallel Maximum number of parallel active connections The SESSIONS sessions following applies for reception As soon as a call has been accepted the master transmitter starts a new receiver until the maximum number is reached Timeout Only valid for the local station Cancellation time in RCVTIMEOUT seconds after which the receiver interrupts the waiting for incoming calls and reconnects to the card driver Receiver Number Applies to the remote station only Number for N 56 Configuration of rvsXP 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 c
112. he entry properties and confirm your entries with OK 90 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 in the 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 Ifyou are sure you want to delete the entry confirm the command with Yes With No you cancel the operation without deleting the entry For more information about the rvs batch interface rvsbat and how to define alternative resident job start entries using this interface please refer to the rvs Reference Manual 6 4 3 User administration Only those users may work with rvsXP who are registered in the rvsXP database In order to display or modify user data e Open the user table in the rvsXP Administrator with User The user table contains at least the table entry for your own data vrvsXP Administrator 5 x File Edit View Monitor Database Window 3 Stations Fe Ea Jobs _ Receive Send E g Logs BE 3 Database EB 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 2004 05 28 91 gedas deutschland GmbH Fachberei
113. hland GmbH Fachbereich 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 changes Communication module rvscom The rvs communication module connec
114. hown in this tab to make the X 25 connection work rvsXP User Manual Rev 2005 12 18 gedas deutschland GmbH FB rvs Systems 53 rvsXP User Manual 1 set of parameters only Local station Selftest via x25 Advanced x25 x25 25 Address 1234567890 Start Link EICON Card fo Advanced Port lo Remove Insert TCPAP ISDN x 25 Cancel rvsXP supports multiple X 25 reception through various receiving channels phone numbers at the same time You can add additional X 25 parameter sets on your local station LOC using the X 25 button below the X 25 tab Press the Remove button to delete the currently displayed set rvsXP will automatically assign an internal consecutive number for the recipient when you add a new record Note Enable the Start checkbox to activate the receiver If the configured recipient is to be automatically active after rvsXP Monitor has been started and should wait for incoming calls the parameter MAXX25RCV must be set For further details read Chapter ISDN X 25 reception Partner stations The call number has to be unique for a send transmission to a partner station Thus you may only indicate one set of parameters Click the Advanced button to the right of the parameter input boxes to open the X 25 Advanced dialog where you can edit these and other parameters 54 Configuration of rvsXP x 25 Advanced x 25 Address 12345
115. ields in the license key file unless explicitly asked to do so by gedas GmbH rvsXP User Manual Rev 2004 05 28 gedas deutschland GmbH Fachbereich rvs Systems 23 rvsXP User Manual 24 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 you 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 in the Station ID field or Choose Select to open the Select Station dialog an
116. ile 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 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 IE 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 sp
117. ing 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 Open the 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 96 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 recommend you back up the user table and follow on processing each time you make changes to them You can revert to this back up if you wish to restore the previous settings for users and follow on processing after a re initialization of the rvsXP database You thus avoid performing the set up again Such a back up is also ideal to establis
118. ing 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 To Back up Restore Recommendation benefits disadvantages Backing up Backing up the Perform back up immediately settings after station table after database creation and configuration Chapter 7 1 1 setting up of stations users and and user table and follow on processing Repeat back up each time changes are 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 ain Delete and Database cleanup procedure reinitialize rvsXP Disadvantage database Transmission data is deleted from Important Verify Chapter 7 3 the database whether or not Step 2 Recommendation current back ups of station table user table and follow on processing are available 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 d
119. key will be imported Example rvskeyimp i C rvs usrdat Al5Al3 pri s LOC rvskeyimp i C rvs usrdat Al5Al3 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 So rvsKey g x lol Eile Tools Help BG IN Import Delete Generate 2 stations Info a BP est SID u Se Filename no file entry in the database Creator u Owner Creation Time Version Serial Number Version Mode Type private m Run of Validity Begin End import a new key entry fo LH G Select the station for which the import should take place and than click the Import symbol 112 Encryption configuration Key administration The Select File dialog appears Select File Directory E system M _ locale30 pri locale30 pub Eile Name R5x30 pub File Filter rvs Keyfiles pub pri Cancel e Select the file containing the key or write the file name in the File Name fieldofthe Select File dialog Click the OK button to import the key 8 5 Distribution of keys rvskeydst To enable the communication partner to receive and decrypt data intended for him the data must have been encrypted with his public key This why the sender needs the recipient s public key Exchange of public keys can be done by e m
120. l 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 Cc rvs samples KEYDIR Folder containing the private and public key files of local C rvs and partner stations keydir SPINDIR Internal Service Provider SP working folder containing the C rvs job files to be processed compression encryption and temp in code conversion SPOUTDIR Internal Service Provider SP working folder containing the C rvs job processing result files log files You can use the log temp out files for troubleshooting see also Log files Chapter Troubleshooting SPFILESDIR Internal Service Provider SP working folder containing the C 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 th
121. l the monitor parameters can be found in the Appendix The rvs parameters Example MAXSENDERS 2 rvsXP User Manual Rev 2004 05 28 67 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual Changes with restarting Example With this example you indicate that a maximum of 2 senders transmit data at the same time e Confirm your entry with Apply Use Close to exit the parameter list This operation transfers the command into the rvsXP database When restarted rvsXP Monitor will read this command and use the modified parameter Stop and start rvsXP Monitor to activate the parameter right away Static modification You can also customize the monitor parameters by making entries in the rdmini dat file It is read every time rvsXP Monitor restarts and the orders and commands it contains are executed Carry out the following steps if you want to permanently modify one or more monitor parameters e 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 Displ
122. le 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 should read in the last generated copy of the batch program reXXXXXX bat file just which commands have been executed The number of the jobs XXXXXX must not exceed 32 000 Windows XP restriction 84 How to work interactively with rvsXP Note If you want rvsXP not to save copies of the batch programs reXXXXXxX bat file in the C r
123. lect 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 Chapter Saving the user table and follow on processing on page 97 rvsXP User Manual Rev 2004 05 28 93 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual 94 rvsXP database maintenance 2 ways to back up and restore 7 rvsXP database maintenance The rvsXP database is the memory of rvsXP both as to what happened in the past and what still has to be done If the rvsXP database is damaged or contains inconsistent entries files may be sent twice or not at all This chapter describes how to maintain the rvsXP database for Windows XP You will be given recommendations on how to apply strategies for back
124. ler 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 Make sure to set ANSI NULL default in the database properties The SQL server must allow SQL server authentication 12 For more detailed information on the RVSPATH parameter see Chapter 1 6 Representation means 134 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 rvsXP Administrator gt Settings gt Parameter 1 1 How to use rvs parameters You can use a magnitude of parameters to customize rvs processes Chapter 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 edi
125. lt CLNUP_NONE Cleanup of RVS data base ended there are no commands to be By Jobs lt XMT_START MasterTransnitter started a g Logs lt SP_START Service Provider started Compression yes Security no HE Monitor lt NEW_CMD_CREATED gt SK 13 created by SE 12 2 Statistics lt NEW_CMD CREATED gt JIE 14 created by SK 13 lt NEW_CMD_CREATED gt IZ 15 created by IE 14 Active Panel lt IZ DELIVERED gt I2 15 Delivery of READMERECEIVED TXT 2003 04 28 16 17 10 8 Database Stored in c rvs usrdat READMERECEIVED TXT EB Settings lt CMD_TERMINATED gt IZ l5 terminated status e iy Start Program lt NEW_CMD_CREATED gt QS 16 created by IE 14 lt CMD_TERMINATED gt IE 14 terminated status e lt NEW_CMD_CREATED gt QE 17 created by Q 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 l2 successfully sent C rvs system readme txt for Ke lt CMD_TERMINATED gt SE 12 terminated status e Press F1 to get help F5 for refresh e Check the output in Monitor Log for error messages Eliminate any errors that occur in accordance with the advices in the Messages and Return Codes manual 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 func
126. ly with rvsXP Displaying job start after send attempt e Choose Job gt SendinthervsXP 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 iolxi Eile Edit View Monitor Database Window alel n2 j ax PIE ag vs station Virtual Dataset Name Program Comment lastused g Stations el Users ER Jobs Receive E E g Logs El 8 Database E Settings E 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 e Choose Edit gt Add The Jobstart after Send Attempt dialog window then opens x Station f Virtual data set name i Jobstart after c ical Eror Send attempts f Success pi c rvs system sendjob bat Program Comment Starts batch job sendjob bat after send attempt OK Cancel Help Enter the station you want to send the file to rvsXP User Manual Rev 2004 05 28 89 gedas deutschland GmbH Fachbereich 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 na
127. me length must not exceed 26 characters e Use Search to select the batch program that should start after the attempt to send the file e Ifyou 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 rvsXP Administrator iolx File Edit View Monitor Database Window al l ax REE ag vs Station virtual Dataset Name Program Commet istud g Stations ba kd C i rysisystemsendjob bat Starts batch job sendjob bat after sen a Users ER Jobs Receive BE 5 Logs H Database EB Settings E u Start Program Press F1 to get help F5 for refresh um 4 Editing a job start entry If you want to modify a job start entry e Select the entry to be modified inthe Jobstart after send attempt window e Execute the menu command Edit gt Update The Jobstart after send attempt dialog opens and displays the properties of the entry Edit t
128. ministrator 69 User 92 93 Dialog interface A4 1 Starting 69 Directories 13 Display mode 70 Reception 77 Sending 71 Displaying Jobstart entry 89 Received files 78 Refreshing 79 Resident receive entry 85 Send order 77 Transmissions 77 User entry 97 Displays Refreshing 78 DTCONNnn parameter A1 6 DTCONNxx parameter AT 14 E EBCDIC 39 A4 1 EBCDIC ASCII conversion 119 EDI A4 1 EDIFACT A4 1 Editing Jobstart entry 90 Resident receive entry 87 Send order 80 User 93 User entry 91 Editing parameters AT 1 EERP A4 1 EERP see also End to End Response EERP_ OUT parameter 40 A1 6 EERP_IN parameter 39 AT 6 Electronic Data Interchange A4 1 Encryption 9 10 and electronic signature 103 Asymmetrical method 103 Basics 103 Features 77 Key administration 107 rvsXP principle and procedure 104 Symmetrical method 103 End to End Response 39 45 A1 6 A4 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 7 KEYDIR A3 2 Language A3 3 PATH A3 2 PORT A3 2 SAMPLES A3 2 SERVER A3 2 SPOUTDIR A2 2 Index SYSTEM A3 2 TEMP A3 2 USRDAT A3 2 Environment variables A3 2 Setting A3 1 SPFILESDIR A3 2 SPINDIR A3 2 SPOUTDIR A3 2 Equipment See System requirements Establishment of an active connection 44 ETSI A4 1 Exit rvsXP 72 Explanation of special terms A4 1 F FACILITIES parameter 52 56 Features Encrypti
129. mp 772 SCPRIO 9 SDSNMAX A1 9 SDSNPRIO A1 9 SECURITY A1 9 Self test via 43 Send 37 39 SENDBLOCKS 39 A1 9 A1 13 SEPRIO A1 9 SESSIONS 53 56 SID 36 SIDNEIGHB 46 SIDTRACE A1 7 A1 9 SIDTYP 36 SLEEP A1 9 A1 14 SNARCV AT 10 Station 36 Station ID 36 Station name 36 STATISTICS A1 10 A1 16 STATNAME 36 SYNCDL A1 10 SYNCTO A1 10 TCPIPRCV 48 60 A1 10 A1 15 TEI 52 TIMEOUT 52 56 Timeout 52 56 TIMESTAMP A1 10 TMAXCON A1 10 TSTODPRCT A1 10 USEPKI AT 11 USERDATA 52 56 VC 57 VDSNCHAR 40 AT 11 VFTYP AT 12 Virtual 36 Virtual circuit 57 Window size 39 X 25 address 51 55 X 25 Facilities 52 X 25 facilities 56 X 25 UserData 52 X 25 UserData rvsNT 56 XADDRESS 51 55 XMCREATE AT 12 A1 14 A1 16 Parameters obsolete RETRY A1 8 Parameters reserved USERFIELD AT 11 Partner station Activate 29 Managing 32 Setting up 32 Password administration 38 PATH environment variable A3 2 PDF A4 3 Performing Code conversion 122 124 PHONE parameter 36 Phone parameter 36 PKI parameter 41 AT 11 Platforms 8 PORT parameter 49 Portable Document Format A4 3 PRIORITY parameter 44 46 Priority parameter 44 46 Program Activate AT 14 Key 107 rvsbat A4 1 rvscom A4 2 rvsdia A4 1 rvskeydel 114 rvskeydst 773 rvskeylst 116 rvsmon A4 2 rvssp A2 2 rvsxmt A1 14 A4 2 Properties Station 33 36 58 Protocol A4 3 PROTOCOL parameter 43 Protocol files 9 PSESSIONS parameter 44 P
130. n obtain public keys from partners via LDAP USEPKI 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 Routing Determines the global rvsXP routing behavior ROUTING O OUT Routing is allowed for send jobs only The own local station must not function as a router B BOTH Standard OFTP routing routing is allowed in send and receive direction Default B OFTP version This parameter is important only if your partner has a OFTPLEV 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 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 rvsXP User Manual Rev 2005 12 18 41 gedas deutschland GmbH FB rvs Systems rvsXP User Manual Tip The greater the number the more improbable the data transmission will be interrupted for entry of the restarting positions but the greater will be the quantity of data to be transmitted again in the event
131. nd entries 6 1 Starting rvsXP Administrator rvsmgr exe Loggingonas rvsXP Administrator is used for configuring managing and administrator operating rvsXP It comprises several detail windows The configuration system and rvsXP requires administrator user rights at system level and in the rvsXP environment Start the 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 rysXP Administrator Monitor Log lolx MM File Edit View Monitor Database Window 2 la x a lez FI xI lt COPYRIGHT gt rvsXP3 01 00 c gedas 2004 All rights reserved C vs lt INIT_CMD gt rpm Reading initial commands 3 Stations lt OK_READ gt RVSCNS cleanup days 3 ss yes lsi Users lt CLNUP_DEL_55 gt Cleanup of RYS data base purge all SendStatistics with DTEI a Bp Jobs lt CLNUP_START gt Cleanup of RVS data base purge all commands with DTDONE lt E Receive lt CLNUP_NONE gt Cleanup of R S data base ended there are no commands to be lt XMT_START gt MasterTransmitter started Send lt SP_START gt Service Provider started Compression yes Security no a g Logs lt TCPIP_READY gt 1696 TCP IP Receiver ready to accept incoming calls Port lt i Monitor lt LGW gt _
132. nd type 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 116 Encryption configuration Key administration 1olx File Tools Help ow N Import Delete Generate E 2 stations Info BP Loc en amp FDAF49CF ey 948E6222 S FDAF49CF SID RSX z RSL Filename cirvs keydir RSX30 pub E RST a a RSX Creator not specified SE 2 Owner not specified Creation Time Sat Feb 21 08 13 02 2004 r 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 Ready LG e If you want to refresh the list select Reload in the File menu 8 8 Configuration of offline compression If the offline compression module was purchased it is enabled by the rvsXP license key Offline compression is enabled when the key file rdkey dat located in the rvsXP init folder contains the Z module There are none additional configuration steps required for offline compression Offline compression may be switched on for each send job separately It is handled automatically when receiving files rvsXP User Manual Rev 12 03 2004 117 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual 118 Code c
133. ndicate the chosen connection is ready to receive S rysXP Administrator Monitor Log E 5 xi File Edit View Monitor Database Window 2 x B 2 2 xl A lt COPYRIGHT gt rvsXP3 01 00 c gedas 2004 All rights reserved ws lt INIT_CHD gt rpm Reading initial commands 3 Stations lt OK_READ gt RVSCNS cleanup days 3 ss yes lt i Users lt CLNUP_DEL_ 5 gt Cleanup of RYS data base purge all SendStatistics with DTEND lt 2003 1 a By Jobs lt CLNUP_START gt Cleanup of RYS data base purge all commands with DTDONE lt 2003 04 25 lt CLNUP_NONE gt Cleanup of RVS data base ended there are no commands to be purged B lt XMT_START gt MasterTransmitter started lt SP_START gt Service Provider started Compression yes Security no Statistics lt TCPIP READY gt 548 TCP IP Receiver ready to accept incoming calls Port 3305 Active Panel Ic 3 Database 5 Settings u Start Program Press F1 to get help F5 for refresh EI NUM Bl 7 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
134. ne 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 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 remove Note To find out how to limit the display to the send orders placed on hold or certain file types please refer to Chapter Selecting display criteria on page 82 e Click the Delete button or execute menu command Edit gt Delete rvsXP User Manual Rev 2004 05 28 81 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual Releasing EERP Deleting
135. nne nne 15 2 3 DUS eA NEC OS XP aa ee ee esaa 17 2 4 The rvsXP program environment u a a 21 2 5 How to obtain a license arts ee 22 3 PUN GUN Tests naar eine 25 3 1 Sending a file to yourself u nnen nee 25 3 2 Testing the connection with the local and the partner stations 27 4 Gontlguratlon of fVSsXP une 31 4 1 Setting up rvsXP stations Han ee eu nee 32 4 1 2 Setting up ODETTE parameters anna ee 37 4 1 3 Setting up the neighboring station 4440u444444annnnnnnnnnnnnnnnnonnnnnnnnnnnnnnannn 42 4 1 4 Setting up the routing connection 22ss44nnnnnnnnnnnnnnnnnnnnnnnnnnnnnonnnnnnnnnnnnnnnnnnn 45 4 1 5 Setting up TCP IP communication ur sha Hei 47 4 1 6 Setting up the ISDN parameters 24 42444000Hnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnannen 49 4 1 7 Setting up X 25 parameters unsnuendereieeeileinn 53 4 1 8 Setting up a virtual station aan 57 4 1 9 Editing the partner station access tere 58 4 2 TCP IP reception re ee a ee 60 5 FSA MO NITOT ae ee 63 5 1 Starting VSXP M nllor see 63 5 3 Customizing rvsXP Monitor parameters cccccceeeeeeeeeeeeeeeeeeeeeeeeeeeeneneeeeeenaes 66 6 How to work interactively With rvsXP ssunsssnnnnennsenennnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn nnna 69 6 1 Starting rvsXP Administrator rvsmgr exe uuunnnnnsnnnnnnnnnennennennnnnnnnn 69 6 2 Starting rvsXP rvs diant exe dc cecciena cet nel red etennies chees
136. nterface 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 languages in messages operator console and user interfaces presently English and German The data conversion if wanted can be carried out Text files are automatically converted to the code EBCDIC or ASCII used on the target partner system rvsXP User Manual Rev 2004 05 28 9 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual Encryption even from V2 05 onwards Sender and receiver use rvs Product independent of rvs 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 ws supp
137. o 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 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 S Generate a list of all key entries d KEYID Delete key with the ID KEYID u Remove the public key r Remove the private key 114 Encryption configuration Key administration Example 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 rysKey lol x File Tools Help Caie Va Import Delete Generate 2 toc Info
138. ocal 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 8 3 Creating private and public keys To use the rvsXP encryption function you must have created the key pairs comprising the private and the public key with the genKey tool This is an easy to use program which randomly creates a new key pair at any call You can launch the genKey program in two ways via the command prompt or the graphic interface 4 For more detailed information on the RVSPATH parameter see Chapter 1 6 Representation means rvsXP User Manual Rev 12 03 2004 107 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual Launching via the command prompt Syntax genKey chefmopstv 768 1024 2048 owner creator from to help size private_key public_key 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 po
139. ode 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 If you want to change the file name after it has arrived enter the new file name in the New data set name field Disposition determines whether the received file is deleted or kept after reception and execution of the RE When you decide upon Disposition keep and the C rvs usrdat folder contains a file with the same name you can enable the Replace option to choose whether to replace the existing file create a new file with a unique name default or ignore the file being received e Specify inthe 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 86 How to work interactiv
140. of error Choose Large values for reliable data lines in order to use the line quality for greater transmission speeds Small values for poor line quality in order to minimize the time required for repeated data transmission Tip to increase transmission speed Multiple reception 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 the neighboring station The Connection type tab contains information about the path via which the partner station is to be reached Connection x25 Advanced TCP IP 25 ISDN Wiel x 25 Address Link NETX25 Card fo Advanced Pott 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 The connection type defines the reception type for the local station Just as your local station can feature reception devices you can set up several connection types rvsXP supports multiple reception for TCP IP ISDN and X 25 42 Configuration of rvsXP Selftest via TCPAIP Advanced TCPAP ISDN x25 ISDN x25 IP Address 100 100 0 90 u Start Port 3305 Max Sessions 5 Remove
141. on 77 Offline compression 11 Files rdkey dat 22 rdmini dat 66 68 102 rlco log A2 1 rlog log A1 14 A1 16 A2 1 rlstat log AT 16 A2 1 Flag SSCREATE AT 16 Follow on processing Backing up 97 Restoring 100 FORCEDEND parameter A1 6 A1 9 Forwarding see Routing Forwarding Support Service A4 1 Freecmd command AT 3 FSS A4 1 Function test rvsXP 25 G genKey program 107 Glossary A4 1 GNU A4 2 GNU zip algorithm 11 A4 2 H Holdemd command A7 3 Holding Send order 80 Holding temporarily Send order 80 IEPRIO parameter AT 2 A1 6 Importing Key 111 IN parameter 39 INADDR parameter 48 INIT environment variable A3 2 INITCMDS parameter AT 7 Initializing rvsXP database 98 Input code parameter 39 Installation rvsXP 17 Interface C Cal 9 Command prompt 9 User 9 IP address parameter 48 ISDN tab 49 ISDN connection 15 43 ISDN Facilities parameter 52 ISDN number parameter 57 ISDN protocol parameter 52 ISDN reception 67 ISDN UserData parameter 52 ISDN_FAC parameter 52 ISDN_PROT parameter 52 ISDN_TEI parameter 52 ISDN_USRDT parameter 52 ISDNNO parameter 57 IZPRIO parameter AT 2 A1 7 J Job rvskeyimp 777 Jobstart entry Creating 89 Displaying 89 Editing 90 Removing 91 K KEEPDAYS parameter AT 7 AT 14 Key Creating 107 Deleting 114 Importing 177 Listing 176 Key administration 107 Configuration 103 Key features 8 Key file rvsXP User Manual R
142. onnection 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 What are virtual stations Receiving at virtual stations X 25 are referred to as channels and are assigned a vc channel ID each virtual circuit There are SVC switched virtual circuits and PVC permanent virtual circuits for leased lines You often need to specify the number of channels when configuring an X 25 layer These are enabled by the X 25 access provider and often charged for according to their number You need at least 2 SVC for parallel receiving and sending 4 1 8 Setting up a virtual station Virtual stations are used to represent stations outside the OFTP network for the OFTP network They allow files to be sent to destination stations outside the OF TP 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
143. onversion 9 Code conversion ASCII and EBCDIC You are probably aware that text files are stored on most systems in one of two computer codes namely ASCII American National Standard Code for Information Interchange or EBDIC Extended Binary Coded Decimal Interchange Code ASCII is the standard code for UNIX and DOS Windows Systems EBCDIC for OS 400 and OS 390 operating systems While the assignment of digits and letters of the Latin alphabet is standardized within each of these two code families special characters like square brackets or national language characters like accented letters or umlauts may be assigned to different codes in different code pages within a family The Odette FTP standard and so rvs distinguish between text files format T and non text files F V and U formats Text files are always transmitted in ASCII stipulated by the ODETTE protocol and automatically delivered in the local system specific code of the target system where required Non text files are transmitted as is without conversion unless you specifically request code conversion on the sender and or recipient side Example 1 Text files are coded in ASCII on a Windows XP computer and in EBCDIC text file on 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
144. or command cleanup The general command is cleanup days n ss yes no n represents the period in units of 24 hours with yes or no you specify whether you also want to delete the associated entries in the transmission statistics rvsXP User Manual Rev 2004 05 28 101 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual Possible parameter modification Dynamic adaptation during operation of rvsXP Monitor using the rvsXP Administrator See Customizing rvsXP Monitor parameters on page 66 or Interactively issue the command as a single operator command or Static adaptation by integrating the command in the C rvs init rdmini dat initialization file By default the file contains the cleanup days 3 ss yes entry That means that completed or deleted transmissions remain stored for 72 hours in the rvsXP database until rvsXP Monitor deletes them along with the transmission statistics Carry out the following steps if you want to modify the parameters for the restart Open the C rvs init rdmini dat file To do so click the Monitor Parameters icon 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 102 Encryption configuration Key administration 8 Encryption configuration Key administration The present chapter des
145. or entry The rvs Monitor Properties Local Computer window opens Click on the Start button If the attempt is successful the rvsXP Monitor status will change to Started The entry is rys Monitor Started Automatic Local System Carry out the following steps if you want to stop rvsXP Monitor with the 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 Carry out the following steps if you want to start rvsXP Monitor from within the rvsXP program environment while it is in operation e Startthe rvsXP Administrator program in the rvs folder 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 64 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 e Start Administrative Tools gt Services e Search the list of Services for rvs Monitor and select the
146. orts 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 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 network costs are significantly reduced All formats and character sets are supported You can also configure compulsory encryption Both encryption and offline compression work automatically after having been configured once on a station by station base The described features work directly between sender and receiver Routing stations conveniently forward the encrypted and compressed files Compression and encryption are available if both partner stations sender and receiver use rvs OFTP routing is not affected i e encryption does not affect the routing stations on the way On MVS systems the encryption and compression subsystem enables extended file format information which prevents loss of file format information e g block size blocked ASA Com Secure is an independent product for offline encryp
147. parm A1 2 A1 4 Command descriptions A1 3 Commands Act A1 3 Activate A1 3 Cleanup 101 A1 14 Delcmd A1 3 Delst AT 3 Freecmd AT 3 Holdemd A1 3 Lc A1 4 Listemd AT 3 Listdbv AT 3 Listparm A1 2 Listst AT 4 Lp AT 4 Ls AT 4 opcmd AT 4 Setparm 68 AT 2 A1 4 Sp AT 4 Start AT 4 Stop A1 4 System AT 4 Communication module A4 2 Communications Manager SINIX A4 1 Configuration Key administration 103 Configuration of rvsXP 37 Connection parameter 43 rvsXP User Manual Rev 2004 05 28 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual Connection establishment 9 Active 44 Connection type 43 ISDN 15 TCP IP 16 X 25 16 Creating genKey 107 Jobstart entry 89 Resident receive entry 85 rvsXP database 98 Send order 73 User entry 92 CUG parameter 52 57 D Data administration see Managing the rvsXP data base Data conversion 9 Database Backing up the complete database 98 Cleaning up 101 Reinitializing 98 Removing 98 Retention time of completed jobs 101 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 45 Delay parameter 44 Delcmd command A7 3 Deleting Key 114 Delst command AT 3 Dialog Choosing a file to be sent 73 Display of not transmitted datasets 70 Program start after send attempt 89 Resident receive entries 85 rvsXP ad
148. r Station RST Remote Station x m Station Station ID RST Virtual 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 at the PHONE partner station Virtual Indicates whether or not the station is a virtual station SIDTYP Additional information See Setting up a virtual station on page 57 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 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 36 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
149. r to do so open the station table in the rvsXP Administrator using the Stations command e Double click the station entry or 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 parameters You may now edit all the station parameters with the exception of the station ID Please refer to Chapter 4 1 1 Setting up station parameters for further information Edit the station properties and confirm your entries with OK Renaming a station 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 58 Configuration of rvsXP Setting the status 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 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 file
150. ral ISDN numbers at the same time You must specify the parameters shown in this tab to make the ISDN connection work rvsXP User Manual Rev 2005 12 18 49 gedas deutschland GmbH FB rvs Systems rvsXP User Manual 1 set of parameters only Local station Selftest via ISDN Advanced ISDN ISDN ISDN Number 1234567890 IV Start Link cap 2a Karte fo Advanced Protocol EDSS1 Remove Insert TCPAP ISDN x 25 Cancel rvsXP supports multiple ISDN reception through various receiving channels phone numbers at the same time You can add additional XP parameter sets for ISDN on your local station LOC using the ISDN button below the ISDN tab Press the Remove button to delete the currently displayed set If you add a new record then rvsXP will automatically assign a number for the recipient Note Enable the Start checkbox to activate the receiver If the configured recipient is to be automatically active after the rvs Monitor has been started and should wait for incoming calls the parameter MAXX25RCV must be set For further details read Chapter ISDN X 25 reception Partner stations The call number has to be unique for a send transmission to a partner station Thus you may only indicate one set of 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
151. rd 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 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 transmis
152. re 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 2004 05 28 gedas deutschland GmbH Fachbereich rvs Systems 77 rvsXP User Manual 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
153. rvs for HP UX defpath rvs for SINIX Substitute the variable with your correct path rvsXP User Manual Rev 2004 05 28 13 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual 14 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 Solar Je PC i386 platform 300 MHz clock rate at least 128 MB RAM and 1 5 GB of free hard disk space Microsoft Windows 2000 WS 2003 XP Professional or later Communication line based on ISDN TCP IP X 25 Hard disk storage for data transmission Recommended value at least twice the size of the files to be transmitted Internal communication is based on TCP IP For this purpose the TCP IP protocol must be installed Instead of a network adapter the MS Loopback Adapter can be used 2 2 Connection type installation ISDN connection If you want to use rvsXP to exchange data via the ISDN network you need the following equipment ISDN type telephone connection with 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 Windows XP This is how you install the ISDN interface e Install the ISDN card into your computer an
154. 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 j ob containing resentr cdsn lt received ASCII file gt codetrans e sid lt Sender gt e 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 e 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 j ob containing resentr c dsn lt received EBCDIC file gt codetrans t codetable lt user code table e g SRVSPATH O arcdir rtcusrdat gt sid lt Sender gt e Start the job with rvsbat ijoborrvsbat ijob Result A file received via the defined resident receive entry will be converted with the user defined code table 10 For more detailed information on the RVSPATH parameter see Chapter 1 6 Representation
155. s Activating a station means establishing an OFTP connection to this station As soon as the connection has been established each side has the opportunity to send any files that may possibly be available If no file is ready to be sent the connection is closed Set working Default setting In order to set the station working execute the menu command set working Edit gt Enable rvsXP is now ready for communication with the partner station The status is Enabled This is the standard setting for a station A connection is established to this station as soon as data is available to be sent to this station Stopping working 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 XP is restarted rvsXP continues to work with these parameters However if you delete the rvsXP database or reinstall you also delete the newly set up stations Subsequent initializing of the database only provides the specified standard configuration of the station table In order to avoid losing your entries you may back up the station table in a separate file and restore it later For further information please see the Chapter entitled 7 1 1 Ba
156. s homo 00900 JV Start Port j5 Max Sessions fe Remove Insert TCPAP ISDN x 25 Cancel Use this dialog to view and edit the station properties Click the Advanced buttons in this window to open additional property dialogs for the Odette and Connection parameters areas 34 Configuration of rvsXP The abbreviations in this dialog stand for Station The parameters that identify a station locally on your computer Odette Parameters rvsXP needs for the ODETTE protocol Connection For remote stations only Connection type by which the station is reachable Self test via Corresponds to the connection with remote stations Path used to reach the local station during a self test X 25 ISDN TCP IP 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 ST OP NK RT XP TC Stationtable Odette parameter line type NachbarKnoten neighbor node Routingtable X 25 ISDN parameters and TCP IP networks Enter the remaining parameters for the new station e Confirm your entries with OK rvsXP User Manual Rev 2005 12 18 gedas deutschland GmbH FB rvs Systems 35 rvsXP User Manual 4 1 1 Setting up station parameters Properties fo
157. s 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 SNALU 6 2 This portable version of rvs has been developed in order to complement the classical rvs product line which is based on MVS and VSE mainframes for use on midrange mini systems and personal rvsXP User Manual Rev 2004 05 28 7 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual Platforms continued Reliable transmission cross platform computing Though the design and make of this product line differs considerably from the mainframe versions the functional spectrum is almost exactly the same as that of rvs MVS Supported platforms The following versions of portable rvs rvsX for SINIX using LU 6 2 X 25 ISDN and TCP IP rvsX for AIX using LU 6 2 X 25 ISDN and TCP IP rvsX for HP UX using LU 6 2 X 25 ISDN and TCP IP rvsX for HP Itanium using TCP IP ISDN and X 25 rvsX for IRIX using ISDN and TCP IP rvsX for Linux using ISDN and TCP IP rvsX Linux zSeries using ISDN and TCP IP from rvsX 2 06 onwards rvsX for Solaris using ISDN and TCP IP rvs400 for IBM OS 400 systems using LU 6 2 X 25 ISDN and TCP IP rvsNT for MS Windows NT 2000 using LU 6 2 X 25 ISDN and TCP IP rvsXP for MS Windows 2000 XP and WS 2003 using X 25 ISDN and TCP IP
158. s service the rvsXP Monitor as a system service it is necessary that you belong to the Windows XP Administrator group Windows offers various ways to open the list of Services This list provides functions for managing and controlling services Use the Services dialog to start stop pause or continue the rvsXP Monitor service Note The term Service means a program that can be started from the operating system and works in the background 5 1 Starting rvsXP Monitor 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 Startup type Manual The user must manually start the service ifthe 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 Windo
159. s 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 2004 05 28 121 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual Sending files with code conversion via rvsxP 9 3 How to perform a code conversion The following examples show how to perform a code conversion when receiving and sending files 9 3 1 Code conversion when sending files This chapter describes how to send files via rvsXP and rvsbat with code conversion
160. sXP User Manual Connection Routing Route Neighbour Node RSI Priority 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 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 e Set up station name MAR Set up ODETTE parameters of target station 0001300 e Set up connection type Routing Select neighbor station RST 46 Configuration of rvsXP Properties for Station Remote Station xj r Station Station ID MAR Virtual I Comment JExample Station Odette Phone r Odette Odette ID 00013003210COMP AIL3UZ Advanced Send password Receive password Connection Routing x Advanced Route Neighbour Node Rss O
161. service by clicking the appropriate line 3 Services BEE Fie Action View Help e m 2 u Services Local rvs Monitor Name Description Status Startup Type Log On As A Sa 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 B4Remote Access Con Createsa Started Manual Local System gs Remote Desktop He Manages a Manual Local System Ss Remote Procedure Provides th Started Automatic Local System a Remote Procedure Manages t Manual Network 5 BaRemote Registry Enables re Started Automatic Local Service 4 Removable Storage Manual Local System a Routing and Remot Offers rout Disabled Local System Servs Monitor Started Automatic Local System a Secondary Logon Enables st Started Automatic Local System Be security Accounts Stores sec Started Automatic Local System A Extended Standard Z i i i e Click the Stop button Windows XP will now try to end the service If the attempt is successful the rvsXP Monitor status will change to not started Stopping with Carry out the following steps if you want to stop rvsXP Monitor with the rvsTraylcon rvsTraylcon e Right click the rvsTraylcon e Execute the menu command Stop rvs Monitor rvsXP Monitor stops The rvsTraylcon shows a
162. sion 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 at the beginning of the file all over again the Receiver periodically closes the incoming data set Both Sender and Receiver store the number of transmitted bytes or records in the database The frequency of these actions is determined by parameters SENDBLOCKS and RECVBLOCKS Reopening and positioning a large data set involves quite a number of disk access operations and therefore is very time consuming So if most of your communication lines are very stable you may want to set these parameters to very large values effectively disabling the restart feature of rvsXP SENDBLOCKS _ If on the other hands most of your lines tend to break down every few minutes you will want to make sure that whatever has been transmitted once will not have to be transmitted again Note that a large value of SENDBLOCKS may also increase the time before senders terminate after Monitor has been stopped Defaults have been chosen so that rvsXP will work securely and with most options enabled 1 6 Safety resource consumption and performance RECVBLOCKS Besides RECVBLOCKS und SENDBLOCKS which have been discussed above there are several other parameters that influence the balance between safety resource consumption and performance OCREVAL OCREVAL recommended window size 99 and OEXBUF recommended size 4096 b
163. ssible 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 t to string Last day of validity period TT MM JJJJ YYYY MM DD In the dialog end 108 Encryption configuration Key administration Parameters Description Default value p per string Validity period d D t T day m M month j J y Y year h H hours ill 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 Creates a key pair with 1024 bits In the dialog 1024 bit 2048 Creates a key pair with 2048 bits In the dialog 2048 bit Use the exact current time normally the validity period starts at 00 00 00 UTC
164. t 1log 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 2 1 Brief description of LOG files The Monitor Log file rlco log System start Inthe Monitor Log view the C rvs temp rlco 1log file is messages displayed It is created from scratch each time rvsXP Monitor starts Its maximum size is restricted by the RLCOMAXSIZE Monitor parameter Only those message classes specified in the CNSMSGS Monitor parameter are written to this file The permanent rlog 1log Monitor log file rvsXP log AllrvsXP log messages are written to the C rvs db rlog 1log 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
165. t 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 Keep the private key for yourself Send your public key to your partner and he will send you his public key 104 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 12 03 2004 gedas deutschland GmbH Fachbereich rvs Systems 105 rvsXP User Manual Your partner encrypts a file with your public key and sends it to you qetiZOUA AMQ fE lt PU1 AEVZ6 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
166. t 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 2004 05 28 A1 9 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual SNARCV SSCREATE STATISTICS SYNCDL SYNCTO TCPIPRCV TIMESTAMP TMAXCON TSTODPRCT Enables start of SNA Transaction Program automatically on incoming calls 0 No transaction program will start 1 The transaction program starts Default 0 Creates a send statistics record for each transfer attempt Default 0 disabled Creates a send statistics record in the statistics log file rlstat log for UNIX and Windows XP No statistics log file Short form Detailed form of statistics Short form of statistics inclusive routed transfers Detailed form of statistics inclusive routed transfers New parameters such as file format state of transmission number of dial in attempts 6 Statistics about deleted entries also by the user 7 Statistics about deleted entries and routed transmissions Default 2 detailed statistics enabled akhoOnNnD o When EERP_OUT SYNC Delay in ms until rvsXP checks whether EERP is available for dispatch Default 500 When EERP_OUT SYNC
167. tarts 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 _ If you want to communicate via TCP IP rvsXP has to start a receiver and waiting for incoming calls You must set the value of the TCPIPRCV MAX_IN parameter Set TCPIPRCV to 0 if you use TCP IP only If a TCP IP receiver accepts an incoming call MasterTransmitter will start a new receiver on the same port which in turn will wait for incoming calls The number of calls you can accept on each port corresponds to the MAX_IN values defined for your local station in your station table 1 6 4 Optional features Providing these optional services takes time and uses up disk space We therefore recommend that you enable them as soon as they are no longer needed AECCHECK AECCHECK is a flag telling rvsXP Monitor to check whether the originator of the command currently being processed has the authority to issue this particular command In a future multi console environment this could be used to prevent certain consoles from s
168. ter 57 VDA see Verband der Deutschen Automobilin dustrie VDSNCHAR parameter 40 A1 11 Verband der Automobilindustrie 38 VFTYP parameter A1 12 Virtual parameter 36 Virtual Circuit parameter 57 Virtual station Editing 58 Interactive operation 86 Receiving at 57 Removing 58 Sending from 58 Setting up 36 57 Statistics 16 Virtual channels 15 Virtual dataset name 86 90 What is 57 W What is rvs 7 What rvs is not 8 Wildcards A1 2 Window areas 71 Window size parameter 39 Working with rvs parameters AT 1 rvsXP User Manual Rev 2004 05 28 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual X X 25 tab 53 X 25 address parameter 57 55 X 25 communication 16 X 25 connection 16 43 X 25 Facilities parameter 52 56 X 25 or ISDN receivers Number A1 15 X 25 reception 61 X 25 UserData parameter 52 56 XADDRESS parameter 51 55 XMCREATE parameter AT 12 A1 14 A1 16 XP X 25 ISDN table 35 Z ZIP algorithm A4 2 l 10
169. ting 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 SEPRIO 50 ee SNARCY SSCREATE Hel STATISTICS 2 Hep SYNCDL 500 SYNCTO 120 TIMESTAMP 2 il TMAXCON 0 TSTODPRCT 90 ha TCPIPRC m Apply e Double click the parameter in the parameter list Enter the desired value into the input field e 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 2004 05 28 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual Alternative Command level ATTENTION Multiple selection You can also use the rvsXP Administrator gt Edit gt OperatorCommand command to display or edit a parameter Use listparm NAME in this case to list one or several parameter values NAME can be the name of a parameter to list this one value awildcard to list all parameters whose names match this wildcard wildcards are described in the following Chapter Wildcards or ALL to list all parameters You can modify the NAME parameter using the following command setparm name value No plausibility check is made on the value you specify Thus the results are unpredictable if you specify
170. tion and compression developed by rvs that also runs with other OFTP products other than rvs 10 Introduction Encryption features Symmetric and The security of rvs uses both symmetric 3DES and public private key asymmetric encryption RSA Symmetric encryption uses the same key for both encryption encryption and decryption The public private key manner uses two different keys each for encryption 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 New key for each rvs performs symmetric encryption on the files to be sent The actual file session being sent is then encrypted using the session key and sent to the recipient The sender sends this session key secured by public private encryption to the receiver prior to file transmission It is possible to create and use private and public keys with a size ranging from 768 to 2048 bit Digital signature Furthermore rvs provides a digital document signature protecting the transmitted file against changes and verifying the ownership of the
171. tioning 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 slaton The window Station table for managing the partner stations opens Select the local station e Double click the station entry or choose Edit gt Update to edit the station rvsXP User Manual Rev 2004 05 28 27 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual Properties for Station LOC Local Station Station Station ID JLOC Comment localstaion 07 Phone en Odette Selftest via TCPAP Advanced TCPAP ISDN x25 IP Address 192 193 0 1 IV Start Port 3205 Max Sessions 5 Remove Insert TCPAP 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 28 Function Tests e Check the output in Monitor Log A message must i
172. topping 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 2004 05 28 A1 15 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual SSCREATE XMCREATE LITRACELVL and ODTRACELVL CNSMSGS STATISTICS Statistics records will be created for every attempted transfer when flag SSCREATE is enabled SSCREATE 1 These records contain the station ID of the neighboring station as well as time and completion code of the attempted or completed transfer SSCREATE 0 prevents generation of these records Currently no utility to analyze these records is provided XMCREATE create xfer message controls generation of detailed information about successful transfers in the SRVSPATH db rlog log system log file XMCREATE 1 default writes a log message in the following cases Whenever a data set is successfully sent to a neighboring station even before an acknowledgement has been received whenever a send entry completes after receiving acknowledgements from all recipients and whenever a data set has been delivered to a local user XMCREATE 0 suppresses generation of these
173. tore Database dialog Restoration of the data has been successfully completed if the message 0 error s occurred appears e Start rvsXP Monitor 7 5 Cleaning up the rvsXP database cleanup Purpose of The larger the rvsXP database the more time is required by rvsXP 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 overview of files sent and received or if you require this information for archiving purposes use the rvsXP SRVSPATH db rlstat log statistic file see Appendix Log files Retention time of The CLEANUP parameter finally determines how long such finished jobs completed jobs are to be retained in the database if CMDDELETE 0 You can determine the information retention time by using the operat
174. ts 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 A4 2 Appendix 4 Glossary OFTP ODETTE File Transfer Protocol The ODETTE File Transfer Protocol is the definition of a file transfer protocol by the ODETTE Group IV for OSI Layers 4 to 7 International Protocol used in many business fields Industry Commerce Finance OSI Open System Interconnection PDF Portable Document Format Protocol To connect two different computers they have to follow the same protocol This protocol defines actions and reactions as well as the language spoken rvsXP User Manual Rev 2004 05 28 A4 3 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual A4 4 Index A Acknowledgement During reception 40 A1 6 During sending 39 A1 6 Act command AT 3 Activate Local station 29 Partner station 29 Station 59 Activate command AT 3 Activate program A1 14 Active connection establishment parameter 44 ACTPCOUNT parameter A
175. u 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 if MAXSENDERS is set to 0 This is useful if only the partner station is to establish the connection and fetch the queued data sets Use the activate command to send data to a specific station even if MAXSENDERS is set to 0 2 For more detailed information on the RVSPATH parameter see Chapter 1 6 Representation means A1 14 Appendix 1 The rvs parameters 1 6 2 Limiting the number of concurrent X 25 or ISDN receivers You must specify the number of concurrently active X 25 and ISDN receivers A small number is adequate for low traffic a higher number is required if you must be able to receive data on several connections in parallel However there cannot be more X 25 receivers than virtual channels are available on your X 25 multichannel In the case of ISDN there cannot be more receivers than B channels are available Because senders also occupy virtual channels or B channels in ISDN respectively the number of concurrent receivers should be limited to half the total number of channels MAXX25RCV MasterTransmitter rvsxmt uses the MAXX25RCV parameter to determine how many receivers must run concurrently It pres
176. vs temp folder you should add the following command to your batch file DELETE DSNTEMP For more information about rvsXP replacement markers and how to define resident receive entries using the rvs batch interface rvsbat please refer to the rvs Reference Manual Displaying resident receive entry Choose Job gt Receive inthe rvsXP 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 X rysXP Administrator 5 x Eile Edit View Monitor Database Window ES Resident Receive Entries SID DSN Virtual Dataset Name Program Comment __ lastused 3 Stations f2 Users ic g Logs 3 Database u Settings E CA 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 2004 05 28 85 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual Resident Receive Entry xl 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 C Delete Ignore data set Timestamp TI C
177. way detailed LOG messages will be created after sending or receiving a data set All users should have access to the log data set RVSPATH 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 interfere with your other applications but the longer you may have to wait before rvsXP Monitor starts processing your requests The shorter you choose this period the higher is the unproductive overhead produced by scanning the rvsXP database when there is nothing to do The time until rvsXP Monitor restarts an unsuccessful or aborted transmission is determined by the DTCONNxx parameters The smaller these values the sooner the transmission will start after the line is up again However the more computer time may have been wasted on unsuccessful attempts until the line is restored 1 6 1 Limiting the number of concurrent senders You may want to limit the number of senders that rvsXP is allowed to execute at the same time if your system is very busy or when yo
178. ws style e Choose Start gt Settings gt Control Panel e Start Administrative Tools gt Services e Search the list of Services for rvs Monitor and select the service by clicking the appropriate line rvsXP User Manual Rev 2004 05 28 63 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual Starting with rvsTraylcon Starting from the rvsXP environment u Services BEE Fie Action View Help e gt u Services Local rvs Monitor Name Description Status Startup Type LogOnas a Print Spooler Loads files Started Automatic Local System Start the service Sy Protected Storage Provides pr Started Automatic Local System 4005 RSVP Provides n Manual Local System 84 Remote Access Aut Createsa Started Manual Local System 4 Remote Access Con Createsa Started Manual Local System Remote Desktop He Manages a Manual Local System Remote Procedure Provides th Started Automatic Local System SaRemote Procedure Manages t Manual Network 5 4 Remote Registry Enablesre Started Automatic Local Service 884 Removable Storage Manual Local System 84 Routing and Remot Offers rout Disabled Local System rys Monitor Automatic Local System a Secondary Logon Enables st Started Automatic Local System a Security Accounts Stores sec Started Automatic Local System Pr 7 A 5 A Extended A Standard F e Double click on the rvsXP Monit
179. y 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 2004 05 28 75 gedas deutschland GmbH Fachbereich 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 administration For more information on compression please refer to Chapter 8 8 Configuration of offline compression rvsXP then writes the send entry for transmission of the file to the rvsXP database The send order has been completed rvsXP lists the job in the list of files waiting to be sent y rysDia display of not transmitted datasets a Oj x File Edit View H
180. you may only indicate one Internet address Parameters Meaning of the line properties Database TCP IP parameter Receiver number Applicable and selectable at the local station only Number N for differentiating the various receiving channels through which the local station can be reached Each number has a tab with a set of TCP IP parameters rvsXP automatically assigns and manages this number Default 0 IP address Internet addresses have the form 255 255 255 255 INADDR If you have not specified a value for the local station you permit automatic definition of the Internet address If your own station has only one Internet address this field should be left empty Default 48 Configuration of rvsXP Parameters Meaning of the line properties Database TCP IP parameter Port Port address PORT Default 3305 Maximum sessions May only be selected at the local station Maximum number MAX_IN of simultaneously running receiving processes on this channel Default 1 4 1 6 Setting up the ISDN parameters Connection ISDN Advanced ISDN ISDN Number 1234567890 CAPI2A Karte fo Advanced e a Protocol 1TR6 Link Cancel If you have selected the ISDN connection in the Connection type area you can edit the line parameters for the network connection on the ISDN tab You may be ready to receive for a partner station via seve
181. ytes 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 Transmission time for a 4 5 MB data set between two OS 2 nodes was reduced by about a factor of 10 from more than an hour to a few minutes by changing the values of these parameters from 10 to 10000 rvsXP User Manual Rev 2004 05 28 A1 13 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual CMDDELETE and XMCREATE SLEEP DTCONNxx MAXSENDERS number of days you want to keep information about ended or deleted transmissions unless you use cleanup days n explicitly specifying the retention period in the command itself For CMDDELETE 1 all related entries will be removed physically from the database when a command ends or when it is logically deleted This keeps the size of the database as small as possible If you choose this option you should leave XMCREATE at its default value 1 In this
182. ze start today 00 00 00 UTC 768 bit start now 1024 bit C begin 214 Feb 20044 C 1280 bit 1536 bit m End of Validity C 1792 bit C end 21 Feb 20054 C 2048 bit period 34 month C 10244 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 rvskeyimp reads the file containing the key copies it into the directory containing all imported keys see rvsenv dat parameter and writes all necessary information into the rvsXP database Table SV S Keys V Administration You can launch the rvskeyimp program via the command prompt or the graphic interface rvsXP User Manual Rev 12 03 2004 111 gedas deutschland GmbH Fachbereich rvs Systems rvsXP User Manual Launching via the command prompt Syntax rvskeyimp i lt FILE gt s lt SID gt Options i lt FILE gt Import the key from file FILE where FILE must be specified with its full path s SID gt The station ID for which the

rvsXP Benutzerhandbuch

Contents

Download Pdf Manuals

Related Search

Related Contents