Home

USER MANUAL - ServiceNet

1. lt CMD_TERMINATED gt IZ 17 terminated status e lt NEW CMD CREATED gt 03 18 created by IE 16 4 lt CMD TERMINATED gt IE 16 terminated status ej lt NEW CMD CREATED gt QE 19 created by Q5 18 lt CMD TERMINATED gt 05 18 terminated status e lt CMD TERMINATED gt QE 19 terminated status e lt CMD TERMINATED gt SK 15 terminated status e A lt SE SENT gt SE 14 successfully sent C KBProg rvs system readme txt for KONRAD at LOC lt CMD TERMINATED gt SE 14 terminated status e User Manual rvsNT Rev 08 01 99 83 gedas GmbH User Manual rvsNT Hold send order Since rvsNT operates asynchronously there is always a certain time span between your send order and file transmission This depends on the rvs Monitor capacity and settings During this time you can still put a hold on a send order and modify it This is how you hold one or more send orders 4 Use the mouse to click on a single send order NOTE To find out how to limit the display to the send orders placed on hold or certain file types please refer to the chapter Data exchange with rvsNT Select display criteria Click the Hold button or execute menu command Edit Hold Modifying a send This is how you modify a send order order 4 Use the mouse to click the send order that you want to modify Execute the menu command Edit Change The Change Send Entry dialog window then opens In this
2. Properties for station LOC Local Station _ST Station OP Odette P RT Routing LU SNALUB 2 xP x26 TC TORAP Odete FTP 7 e Automatic dialling Priority of the 4 x25 ISDN connection Delay when receiving file User Manual rvsNT Rev 08 01 99 29 O gedas GmbH User Manual rvsNT Meaning Database tab NK Line Type parameter File Transfer Transmission protocol for data transmission Protocol ODETTE FTP is the only protocol at present Connection The connection type with which the station is PROTOCOL Type to be reached Values LU6 2 The partner station is reached via Values SNA LU6 2 line Enter the connection parameters in tab LU L LU6 2 TCP IP The partner station is reached via a T TCP IP network with the TCP IP protocol X X 20 ISDN Enter the connection parameters in R Routing tab TC X 20 ISDN The partner station is reached via an X 25 or ISDN line Enter the connection parameters in tab XP Routing The partner station uses a different partner station as a routing station Enter the routing station ID in tab RT Routing The connection type and parameter of the routing station are then important for the connection itself Further information is contained in the chapter Routing table RT standard no default Active specifies the send behaviour for a pending AUTODIAL Connection send order Values Setup v Sender should automatically start as soon as a file is ready
3. NOTE No binary file may be specified as a batch program it should be a readable and interpretable file Ensure that your batch program is sensibly structured because it is not checked by rvs Every version of an RE leaves a copy of the batch file in which the replacement characters are replaced by your actual values in the directory c rvs temp The copies are stored under the name re999999 bat whereby 999999 stands for a consecutive number If the behaviour of a RE is incomprehensible to you you Should read in the last generated copy of the batch program file re999999 bat just which commands have been executed You can find more information in chapter 7 Appendix Extended functions The rvs batch interface gedas GmbH 9 rvsNT operation Display resident If you would like to display the RE then use the View JobStart Receive receive entry menu command in the rvsNT Administrator The Resident Receive Entries window then opens It displays a list of the previously created RE s The list is initially empty 3 rvsNT Administrator File Edit View Monitor Database Window lt LICENSE WMARN gt Es Resident Receive Entries SID DSN Virtual Dataset Name Dataset Name Program lt INCOMING CALL lt CONNECT Sender Connection with Station LOC with Credit l0 Odette Buffer 2C lt CONNECT_IND Responder Connection with Station LOC with Credit 10 Odette Buffer lt DISCONNECT Connec
4. Paper Support 1 System configuration 1 1 Workstation type 1 2 Operating system version no 2 rvSNT version Please call up the Help About rvsNT menu command 3 Questions concerning problem description 3 In which part of the program does the problem occur 3 2 With which function 33 What happens before afterwards 3 4 Does the error lead to loss of data 3 9 Does an error message appear on screen exact text Does an error message appear in the rvsNT log book c rvs temp rlco log 3 Which error number 38 Is the error persistent 3 9 Does the error occur on other workstations as well 3 10 Is it possible to create a sample file including the error 3 11 Are there discrepancies with the user manual lt User Manual rvsNT Rev 08 01 99 gedas GmbH 93 User Manual rvsNT 94 gedas GmbH 9 Appendix Monitor parameters 9 Appendix Monitor parameters ACTPCOUNT AECCHECK BACKUPINT BBCREATE BBPRIO BRICKOFTPTI CDWAIT CNSMSGS 0 40 1 yes O no ABEILORSW Meaning of the Monitor Parameter Values specifies the interval at which status information is 1 100 provided on the active lines specification is given as a percentage of the size of the file AuthorityExecuteCommandCheck 0 no 1 yes Check authorization for executing operator commands internal Reserved Create user mes
5. Cono ee If you have selected the Routing connection type onthe NK Line Type tab your partner station is not a direct neighbour node of yours you can edit the routing table The routing table contain the neighbour station information by means of which the station selected target station is to be reached Parameter Meaning Database tab RT Routing parameter Neighbour Station ID of partner station neighbour station SIDNEIGHB node which knows the path to the target station The Station ID has to be in the stationtable Priority Priority number of neighbour station It determines PRIORITY the data transmission route The integer value is between 1 and 100 The neighbour station with the lowest value is used The priority at the time when the send command is prepared is decisive The forwarding of files throughout several OFTP systems is referred to as routing If you would like to send a file via several systems then the send order only has to be directed to the recipient rvsNT then sends the file to the next OFTP system the neighbour node which in turn then forwards the file onward Information on the intermediate station connections is contained in the databases of the respective stations When the file has arrived at the end system it sends an acknowledgement EERP End to End Response back to the original sender The send order is only completed as soon as the sender has received this acknowl
6. gedas GmbH 5 rvsNT operation Ifyou have decided in favour of Maintain disposition and there is already a file with the same name in the user directory c rvs usrdat you may choose in the checkbox Replace whether you would like to replace the existing file to create a new file with a distinct name default or to ignore the incoming file Specify in the field Recordhandling whether the received file is to be Stored as a text file with a line feed after every record This specification only applies to files that are received in Fixed or Variable format Select Text here if the line feed is to be switched on Inthe field CodeConversion you may specify whether a code conversion is to take place Select a special conversion table by means of Search For standard conversion click Ascii Ebcdic orEbcdic gt Ascii Use Search to select the batch program that should start when the file arrives Confirm the entries by pressing OK The rvsNT Administrator writes the new entry to the rvs database and displays it in the list of REs x rvsNT Administrator File Edit View Monitor Database Window alele Monitor Log lt ILTCENSE IDA ed Resident Receive Entries SID DSN Station Vitual Dataset P TXT C rvs system resentr bat Starts batch file resentr bat lt lt lt lt lt lt lt lt lt lt lt A lt CONNECT IND gt Responder Connection with Station
7. gedas GmbH TCP IP interface Installing rvsNT 3 Installation of rvsNT If you want to exchange data using rvsNT and the TCP IP protocol you need 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 Start the Network program in the Windows NT control panel 4 Select the index card Protocol The index card shows the network protocols that are already installed Ifthe TCP IP protocol is not contained in the list shown then click the Add button Select the TCP IP protocol in the window displayed and confirm your Selection with OK 4 Click the Properties button and set the IP addresses for your environment NOTE The network administrator will provide you with the IP addresses 4 Confirm the entries by pressing the OK button and close the Network window by pressing OK start Windows NT and log in as a NT user with administrator rights Insert the data carrier labelled rvsNT in a drive Execute the Windows NT menu command Start Run o 4 Enter D Setup exe to run the installation program if your CD ROM drive is drive D 4 Confirm the entry by pressing the button OK The installation program now starts and guides you through the installation of rvsNT 4 Follow the installation program instructions You can confirm the installation directory c rvs or sel
8. card type and card number values and cannot be directly changed The values have different forms for ISDN and X 25 connections For ISDN connection CAPI2mn for ISDN cards Values for m and n ISDN May only be selected for ISDN cards Specifies ISDN PROT m A no Diehl Eicon card O Diehl Eicon card n Number of the ISDN X 25 card installed in the computer beginning with 0 Example CAPI200 Diehl Eicon card number 0 40 gedas GmbH 4 rvsNT configuration Parameter Meaning Database tab XP X25 parameter For X 25 connection 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 the configured X 25 port beginning with 0 Example NETX2500 card no 0 with port no 0 standard CAPI200 Further parameters Not all parameters are shown on the tab 4 Click the button Next gt gt The other parameters are now shown on the tab 4 Change the parameters accordingly and 4 Click lt lt Back if you want to change the parameters for LINK or the ISDN Standard again s User Manual rvsNT Rev 08 01 99 41 gedas GmbH User Manual rvsNT ST Station OP Odette Parameters NK Line Type RT Routing LU SNALUB 2 XP X25 TC TCPAP X 25 address LINK lt Back ISDN Number JE x 25 F
9. maintenance 70 new 74 restore 73 Save 72 rvs Monitor Start 57 stop 5 rvs network 12 rvs program 13 rvsNT 6 display modes 76 documentation 5 exit 87 install 17 Start 76 target group 5 Window areas 77 rvsNT configuration 21 rvsNT features 9 administration 9 user comfort 9 gedas GmbH S Select display criteria 84 85 86 Send order create 81 hold 84 modify 84 process 81 release 84 remove 85 restart 85 temporarily hold 84 Service for users 93 Services rvs Monitor 18 Start 19 57 Set environment variables 55 SNA interface 16 SNA LU6 2 see Parameter LU Station properties 22 set status 47 Set up 21 set working 47 Stop working 47 Stationtable Save 1 ST Station 24 Status of orders order 79 partner station 4 Status display 77 79 Support see User service system directory of rvsNT 55 system requirements 15 T Target groups 5 s User Manual rvsNT Rev 08 01 99 gedas GmbH 13 Appendix Index TCP IP communication TC 37 TCP IP interface 17 TCPIPRCV 37 Transaction program 44 Translation Input Code 27 Translation Output Code 27 Transmission protocol 9 30 Transmission speed 28 Type faces and symbols 8 U User modify 50 new 49 save 50 71 user files 55 User Call Interface 6 90 User table modify 49 restore 73 Userta
10. CIA O earner ara reer re en SD DD a Pe eT eee 70 BVA AU 6 acta RA SPORRE ed tar ated ile eset tm DR RANA AR NENE ea DO A E 11 FIOS LONE T E E E A A TEE 12 EANTA O EE 10E gt Cs EET E EE A NEE ED A EE A 14 Data exchange with IVSNT ass assess sassssnossaraas iss sendo cada uia aaa ia a an a 75 WV Fe PV SINE Od OO oranin A OA a 15 WAU el DS AT SIN Zi doit 15 ING EY OTTO QUIPEMCNS cases ta DSO A A 19 VV OTA WV ILIV IAL SING sa dad dE E a 76 STALIN OS NE eaa E AOA wor Gana oerbnccnaatteasaaa baste EA 76 ISD Ay AIMGS SO DROP RPA ERG AP UND AD E antes tamu RTP DOR MEDO A 80 DiSplaV Trecere CTS rasa a EA SS A doe nenaeunses 80 PROCESS Send ONCE loa boil dds waihshieanestlddsiinedlslutu daoiae 81 SPEC CISD AY CO A raene ee a rbd od a 86 FETE MA GIN ant aa il E EEE T EEE E EET EE O EEEE EE O E EE 87 Appendix Extended functions ccccccccceeeeeccceceeeeeccuuseeeeeceuuseeeeeneuuuennseneaas 89 PAEAS DA LG RI ORA C 0h arca q a A 89 THEAVSUSEL ge IIS e DAR PIRIPIRI SIDI RR seams RIDE ARO PR RO NR RE 90 Appendix rvSNT Troubleshooting cccceeeeeescceeeeeesauceeeeeennaueeeeesenauseeserens 91 ELOI CAUSES and TOMMC CIOS nanan a a de 91 CIVICE TONUS 3 San ec A ne a E cd 93 Appendix Monitor parameters ccccceeeeeeccceeeeeeeueeeeeeeeneuueeeeeeneauueeessaeaaas 95 Appendix INS database sra a AGIA DS DES SGD CE SP OS dE 101 Appendix rvs replacement characters ccccccceesceeeeeeeeucceeeeeneuucee
11. 0 no 1 yes receive status change only takes effect when Monitor is started Type of time stamp for differentiating between data O 000 999 1 000000 999999 2 Thhmmss time 3 Djjmmtt Thhmmss date and time records with the same name Maximum number of rvs consoles that run simultaneously 20 MSGPRIO 3 blanks 30 0 no i no 1 short entries 0 no 2 only time ia gedas GmbH 9 Appendix Monitor parameters Parameter Meaning of the Monitor Parameter Value Standard Odette transmission OFTPUNIX all capital letters figures and special characters UNIX all letters and numbers and the special characters 7 ODETTE all capital letters figures and special characters amp and blanks CHECK_RE as ALL and in addition an RE must also be to hand VFTYP Specifies how files in format F or V are saved in the T Files are saved as a V local system upon receipt text at the end of the record a new line feed is added V Files are saved without a new line feed XMCREATE Generate detailed messages for the Monitor Log 0 n0 1 yes 1 yes window after each successful transmission send and receive What was sent by whom to whom VDSNCHAR Stipulates which characters are permitted for an ALL no limitations ODETTE s User Manual rvsNT Rev 08 01 99 99 gedas GmbH User Manual rvsNT 100 gedas GmbH 10 Appendix rvs database 10
12. EBCDIC format Standard ASCII Allowed stipulates which characters are permitted for VDSNCHAR Code Target encoding of the files for send transmission CODEOUT characters Odette FTP ALL no limitations OFTPUNIX all capital letters figures and special characters UNIX all letters and figures and the special characters _ ODETTE all capital letters figures and special characters amp and blanks CHECK_RE as with ALL and in addition a RE must be included Transmit Number of blocks received between two restarting RECVBLOCKS Blocks positions for error correction Becan Standard 0 i e RECVBLOCKS from parameter table applies User Manual rvsNT Rev 08 01 99 27 gedas GmbH User Manual rvsNT Parameter Meaning Database tab OP Odette Parameters Advanced parameter Transmit Number of blocks sent between two restarting SENDBLOCKS Blocks positions for error correction standard 0 i e SENDBLOCKS from parameter send table applies EERP send transmission EERP End to End EERP_IN IN 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 Standard NORMAL EERP Receive transmission EERP acknowledgement EERP OUT OUT Values NEVER Par
13. SADO o sastteyst ca scitcee candies vo enseai sanctus achovennaentire Sb 47 User table modification ccccccccccssssccceccsseececessseeececessseeececcssseeeesecsaueesececsueeeeecessaeeeesecsaueeeeessaneeesecsieeeeeseneas 49 Customizing the monitor ParaMeters ccccccsessssccessssceeessscesesesseesessseeseseseeseuesseneeseseusesscseneesseneeseseeseneaaes 91 LOGS AOS QUO ia 54 CUSTOMIZING environment variables wistindinicsinss nun aeswnnadaecstaisdanlsianaaubssuathietsauddsnsabeashadvanaavevadush a Si 55 EIEN INE NEN POIS ATOT sta eg O E Ea NA Teei ia Ae NERI Ee 56 SN op ratiOn essas ara ssa os sc sa ads dd ap a US O 97 Starting and stopping the rvs Monitor ee eee cccceccccssececseeeecsseeeceseeecesseesesseececsueeceseesersueeecuee ceaneseenneeeenas 57 FUNCHON TES Uadeotsrnagesastarevanavatanecgaued oesvantelacersduncandtieacecurdesapnnninensucseeeabanedivetautsenanhranserasdnensnbiaentdteesaruserasanerasituent 59 Sending a Tile tO VOUS O soasesrasi ana si aaa ng e Tn ie ie statenteadserclatinads 59 Activan THC TOCA SUA NON usaina a aa EEE a A E TAE 60 s User Manual rvsNT Rev 08 01 99 e gedas GmbH User Manual rvsNT 10 11 12 13 SEUNG TONOW OM PROCESS IDO sir 62 PIS TO CODUON ieaiai ride o id uacdbadalehataderieonnlneds 62 SO O O agencias ETTE ET APEE a denne abate Cod oa Cada OA aaa 66 rvs d tabase MALI ANG ia tines a euntanitiadGarinnvitthiedbndntevcwee taaa OTE Kaaa NTa Taa Eoee RaDa aata Ea aaie 70
14. SNA LU6 2 Properties for station RSL Remote Station x parameter LU Rensesscnsscscsssssnsnsncnsscssnsscscsesesnsncnenes LU name _Wram _tvezrst Newari fas Network identification Transaction program Nome Trvsrcy Mode WGGRVID SNA session modus Securi nee no mi Ed APPC synchronization ca Conversation e Safety check a il level we o E Megped APPC conversation type Password Cancel Help lf you have selected line protocol LU6 2 onthe NK Line Type tab you can edit the parameters for the SNA LU6 2 connection on the LU SNA LU6 2 tab Parameter Meaning Database tab LU SNA LU6 2 parameter Under Windows NT it is the LU name which you have defined during configuration of the SNA LU Name LU name for the partner station LUNAME Server Started at the partner station This is the RVSRCV program on the local station Enter RVSOFTP for an rvsMVS host TP Name Name of the transaction program TP that is TPNAME and RVSRCV for rvs2 rvsX and rvs400 user ID and a password Values security Determines whether the partner station expects the SECURITY Values secuit IV partner station expects user ID and o password Security secuit Partner station does not expect user 4 ID and password Security fw Standard 2554r f partner station Standard User User ID which the transaction program uses at the USERID s User Ma
15. User Manual rvsNT Rev 08 01 99 49 gedas GmbH User Manual rvsNT User modification 50 Save NOTE A basic user may use the program rvsNT to send and receive files A user with administrator rights may in addition to this use the program rvsNT Administrator to configure the rvs system An Operator has the same rights as an User This type of user is reserved for future use If you would like to modify an existing user Select the user to be modified in the User window Execute the menu command Edit Edit The User dialog box will open You can now edit all of the user data parameters You can select German or English in the language field rvsNT will then display all the menus and messages in the selected language NOTE If you want to modify your own user data then the entries will only take effect after restarting the rvsNT Administrator Confirm the entries by pressing OK If you set up or modify a user use OK in order to save the modified parameters If you delete the rvsNT database or reinstall rvsNT you will also delete all users subsequent initializing of the database only retains the administrator who has set up rvsNT In order to avoid losing your entries you can save the users and the job start entries or even the entire rvs database and restore them later If you choose to do so you can find more information in the chapter rvsNT operation rvs database maintenance gedas GmbH 4 rvsNT confi
16. attempt to send a file This example is also to be found in the directory c rvs system You can also use rvs to switch parameters using the rvs batch interface The modified copies of the batch program also come into being here in the temp directory exactly as is the case with REs You can find more information in Appendix Extended functions The rvs batch interface gedas GmbH 9 IvSNT operation Display job start If you would like to display the JS then use the View JobStart Send menu after send attempt command in the rvsNT Administrator The Jobstart after Send Attempt window then opens It displays a list of the previously created JS s The list is initially empty s rvsNT Administrator File Edit View Monitor Database Window 2 amp DEJ ZIN Monitor Log lt LICENSE WARN gt ei Jobstart after Send Attempt SID DSN lt lt lt lt lt lt lt lt lt lt AAA T I0 Buffer 2C lt CONNECT_IND gt Responder Connection with Station LOC with Credit 10 Odette Buffer lt DISCONNECT gt Connection to Station LOC ended lt DISCONNECT gt Connection to Station LOC ended Press F1 to get help Create JS Ifyou want to start a program after an attempt to send a file do the following Execute the menu command View Add The Jobstart after Send Attempt dialog window then opens Jobstart after Send Attempt Ed Station i Virtual Data Set Name hi
17. been sent gedas GmbH 6 Data exchange with rvsNT display of not transmitted datasets File Edit View Help Dia x alo x Entry No New File Name Station Disposition Time State New send e ntry 14 SENDTEST LOC 1997 09 21 14 38 48 Details File Name SENDTEST Local Name CKBProgiyvsisystemyeadme txt Receiver LOC local station State hq Additional Information Command Numbers Date Time Transmitted 0 Bytes SE 14 Disposition 1997 09 21 14 38 48 Block Size 0 Bytes SK 0 Start of Transmission Format u End of Transmission Send Attempts 9 Send Attempt at dataset won t be deleted after successful transmission Delete Hold Release Select Refresh Press F1 for Help 15 02 4 The rvs Monitor reads the send order at the next read cycle and executes it In the example the rvs Monitor recognizes through the station code LOC that its own station is the target and copies the file into the c rvs usrdat directory NOTE You can view the activities of the rvs Monitor in the rvsNT Administrator inthe Monitor Log window Monitor Log Iof x lt NEW CMD CREATED gt SK 15 created by SE 14 lt NEW CMD CREATED gt IE 16 created by SK 15 lt NEW CMD CREATED gt IZ 17 created by IE 16 R lt IZ DELIVERED Delivery 17 SENDTEST 1997 09 21 14 38 46 received at 1997 09 21 15 02 39 from Li stored in c kbprog rvs usrdat SENDTEST
18. files The list of files which have been completely received displays those files which have been successfully transmitted to your station At this stage your station has acknowledged reception This is how you display completed send orders Execute the menu command View Completely received files lf you want to update the list display then do the following Click the update button or switch to a different display mode and then back again gedas GmbH 6 Data exchange with rvsNT Process send order Create send order This is how you send a file to a business partner Execute the menu command Edit New Send Entry You can also execute this command by using F2 or by pressing the push button New Send Entry The Choose file to be sent dialog box will open Choose file to be send Suchen ih H system Select file 13 rdbtab dat da dede hip da rhdddt hlg 9 Adkey dat amp ihdcdrec hlp amp thdddt hi a Ridmini dat amp thdedse hip amp thdddtr hip 9 idstat dat Pihdedset hip g rhddelsr hl readme Ext rhdens hlp AD rhddrnl hlp o resentr bat a rhdcrre lp at rhddanl hlg Dateiname readme txt Dateityp All Files bi Cancel 4 Select the file which you would like to send to your partner and confirm your selection with Open Example c rvs system readme txt The New Send Entry dialog window then opens and displays the file name selected in the File field New Sen
19. for dispatch A Pending send orders do not trigger Y v a send action N O Standard v Values Selftest via May only be selected at the local station Line PROTOCOL by which 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 No parameter Receivers which have been configured and or are still to be configured 30 gedas GmbH 4 rvsNT configuration Parameter Meaning Database tab NK Line Type parameter Delay Time in seconds to wait after receiving a file CDWAIT before a Change Direction CD is initiated Parallel Maximum number of active simultaneous PSESSIONS sessions connections via this line standard 1 unlimited Priority updates It is reserved for future use The priority number is planned for rvsNT PRIORITY Establishment of Itis occasionally necessary for files to only be made available and not to be sent an active immediately On the contrary the partner station is to establish the connection connection and fetch the available files as and when required In this case rvs functions like a mailbox that is emptied as and when needed The partner bears the costs for the connection Active connection setup must be switched off for this case s User Manual rvsNT Rev 08 01 99 31 gedas GmbH User Manual rvsNT Routing table RT NeighborNode ve en Soe ee 1 100 Priority
20. results whether in note form or as a screen print out or file Follow the exact directions of the rvsNT user manual Keep all documents Check whether your workstation is working properly Restart your workstation and note the on screen messages while the system is starting store the relevant data or ask your system manager to do this for you Ensure that all data and programs which you intend to work with are available for use by you Ask the system manager to check your access rights Check the rvsNT configuration Create a copy of the current rvs database Then load a back up copy of the system files which you created as a precautionary measure while the rvsNT was running properly should you be unable to remedy the problem using this method contact rvsNT support Service When doing so please use the checklist in the following chapter Service for users gedas GmbH Service for users 8 Appendix rvsNT Troubleshooting The rvsNT Support Service of gedas requires sufficient information in order to be able to locate any problems which may occur when working with rvsNT Should you be unable to remedy the problem with rvsNT please fill out the checklist below and contact us Please send the completed form to gedas rvysNT Support PascalstraBe 11 D 10587 Berlin Fax 030 39971 994 Sender No Checklist for problem description Please enclose additional information Enclosed Note Data carrier
21. rvsNT Pe Meaning of the Monitor Parameter Value ShortDataSetNumber Priority 100 Priority for sending short files Number of blocks sent between two FORCEDEND parameter status checks Priority for new send orders the value should at 11 100 SEPRIO SIDTRACE SLEEP SNARCV a STATISTICS TCPIPRCV TIMESTAMP 98 most be as great as the smallest priority value of the forwardable data MSGPRIO LDSNPRIO SDSNPRIO Station ID of the station to be monitored if LITRACELVL or ODTRACELVL have 1 or 2 as a value if you would like to monitor incoming data then set the value to your local station standard LOC Monitor idle phase in seconds If there are no orders the Monitor will check to see if there are any pending commands in accordance with this prescribed interval SNA Receive automatically start transaction program for incoming SNA calls status change only takes effect when Monitor is started Record each transmission attempt in the r no 1 yes 0 no 1 yes transmission statistics Transmission statistic form in Log Book file O no entries ristat log 1 short entries 2 detailed entries 3 like 1 for routing entries also 4 like 2 for routing entries also 5 detailed output for send attempts also 6 like 5 additionally with deleted entries 7 like 6 inclusive routing entries Activate TCP IP receiver and thus make ready to
22. rvsNT c rvs db USRDAT Directory for user files received lc rvs usrdat TEMP Temporary directory for the log book c rvs temp Directory for the initialization files e g rdmini dat for the monitor parameters s User Manual rvsNT Rev 08 01 99 55 gedas GmbH User Manual rvsNT Designation Meaning of the environment variable Standard value SAMPLES Directory for files for the programming c rvs samples interface with examples SERVER Internet address of the server for messages IP address of the of the line status local PC PORT Port number of the server for messages of 2956 the line status ARCDIR Directory for backup files c rvs arcdir AP DISPLAY Interval in milliseconds in which the display 1000 INTERVAL for active lines is updated DBLOG Write entries to the rvs database Yes No No If you activate this check box rvs will write all database operations to the c rvs db rldb log file and you are able to restore all the entries made since the last database backup CAUTION This will influence the performance of rvs extremely Disabled Disable access to the rvs database Yes No No You can use this control box to block access to the rvs database Example SNA processes Should not modify the data bank during a Exiting the rvsNT Administrator Monitor remains active 56 Configuration is finished if you have completely worked through the chapter rvsNT con
23. send orders 4 Use the mouse to click on a single send order Click the Hold button or execute menu command Edit Hold Release the orders selected with Release or the Edit Release menu command You can remove a send order from the database If you remove a send order which has the status Torwardable or held then your partner will not receive the file which was intended for him A send order that has already been completed remains executed It is not possible to revoke the order You can only remove the entry from the database This may make sense in some cases in order to improve management of transmission activities NOTE The rvs Monitor constantly purges the rvs Database of send entries which have been completed since a particular period of time KEEPDAYS parameter Thus you do not have to remove the send orders in order to clean the database This is how you remove one or more send orders from the order list Use the mouse to click on a single send order which you want to remove NOTE To find out how to limit the display to the send orders placed on hold or certain file types please refer to the chapter Data exchange with rvsNT Select display criteria 4 Click the Delete button or execute menu command Edit Delete s User Manual rvsNT Rev 08 01 99 85 gedas GmbH User Manual rvsNT Select display criteria You can select certain kinds of send orders for display in the entry list You can use the
24. station code file name and status of the orders as selection criteria This is how you set the display criteria for send orders Execute the menu command View Select The Set selection criteria dialog window then opens Set selection criteria Station code CO Sela FAR Sebo File FileName TXT OO State Code fF status code a selection box save settings as default for standard 86 Cancel Help Enter the station code for the station s to be selected Or Use Select to open the Select Station selection window and select the station code Enter the criterion for the files to be selected inthe File Name field Enter the status code to be selected inthe State Code field This entry is optional NOTE You can use the wildcard characters and or a combination of and for entering selection criteria stands for any or even empty character string stands for one character of any value Use one of the following characters as the status code no event held by the system or operator traffic with the destination suspended at present 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 d deleted h S gedas GmbH 6 Data exchange with rvsNT If you want to repeatedly use this setting then activate the Save Setting as standard select
25. which have the specification DAT inthe rvsNT arcdir directory Enter the file name under which you want to save the stationtable Confirm the entry by pressing Open rvSNT then saves the stationtable and displays any errors in the rvsNT dump Stationtable message window saving has been successfully completed if the message Done with O errors appears saving the user In order to save the user table and the follow on processing table and follow on processing stop the rvsNT Monitor Execute the Database Export of Jobstart Entries and User menu command The Select Backup File dialog window then opens and displays the files which have the specification LOG in the rvsNT arcdir directory 4 Enter the file name under which you want to save the tables Confirm the entry by pressing Open rvSNT then saves the tables and displays any errors in the rvsNT Dump Jobstart Entries and User message window Saving has been successfully completed if the message END appears Start the rvsNT Monitor s User Manual rvsNT Rev 08 01 99 71 gedas GmbH User Manual rvsNT Saving the rvs database Restore Restoring the Stationtable 12 If you want to save the entire rvs database 4 Stop the rvsNT Monitor Execute the menu command Database Export The Select Backup File dialog window then opens and displays the files which have the specification LOG in the rvsNT arcdir directory 4 Enter the file name u
26. window you can modify all the fields for the send order 4 Carry out the changes desired Confirm your entries with OK The send order has been modified rvsNT displays the modified order in the list of files which have not yet been sent Temporarily hold If you want to create a send order and then release it later you should carry out the following steps to put a temporary hold on it 4 Click Change Options inthe New Send Entry dialog window Enter the letter H inthe Start Time field 4 Confirm the entry by pressing the button OK Releasing a send If you have put a hold on a send order you can also release it for subsequent Order execution This is how you release one or more orders for execution 4 Use the mouse to click on a single send order NOTE To find out how to limit the display to the send orders placed on hold or certain file types please refer to the chapter Data exchange with rvsNT Select display criteria Release the orders selected with Release or the Edit Release menu command 84 gedas GmbH Restart send order Remove send order 6 Data exchange with rvsNT rvSNT repeats an unsuccessful transmission attempt in accordance with the time specified by means of the DTCONNnn parameter You can avoid this waiting period and immediately start a new attempt at transmission The Monitor then treats the send order as though you had created it for the first time This is how you restart one or more
27. Appendix rvs database The rvs database uses the following tables DB Current rvs and database version OK Operator commands BB User notification OP ODETTE parameters BT Locally registered users PT Parameter table CT Valid console IDs QE Acknowledgement entries EC End commands internal command type OS Acknowledgement send entries ET recipient entries RE Resident receive entries m Information entries RT Routing neighbouring stations SK Send commands LC Last command SL Serialization lists SS Send statistics LM Log book messages ST Station parameters LU LU 6 2 parameter XP X 25 ISDN native parameters AC X 28 PAD or ASCII parameters LX Extensions of the line driver parameters TC TCP IP parameters VD Send files Z Information assignments SE Send entries VM Send messages KT Command table NK Neighbour node connecting line lt User Manual rvsNT Rev 08 01 99 101 gedas GmbH User Manual rvsNT 11 Appendix rvs replacement characters Receive file Resident receiving entries work with the following replacement characters DTAVAIL FORMAT VDSN MAXRECL Name of the file received as saved in the local system Logica file name under which the file was transmitted Date and time when the file was made available for send
28. D for your local Station during user defined installation of rvsNT then the station ID which you have selected will appear here CAUTION Never delete the local station If the name of the local station is to be changed the rvs database must be deleted and set up again with the new name for the local station In the standard installation further stations have been entered as examples of the various communications modes RSL is a partner station for communication with SNA LU6 2 RST is a partner station for communication with TCP IP and RSX is a partner station for communication with X 25 ISDN Use the examples in order to set up your stations By double clicking the station or with the menu command Edit Edit or Add you can cause the dialog window Properties of station to open and the tab ST Station is shown to you to begin with Properties for station LOC Local Station ES ousosososessoscososesossososessssosoon Recsossososossososossososooseseseosseod Station ld Station Name parameters O Re 22 Cores tp You can display and edit the station properties by selecting the tabs ST Station OP Odette Parameters NK Line Type RT Routing LU SNA LU6 2 XP X 25 ISDN and TC TCP IP gedas GmbH 4 rvsNT configuration These abbreviations stand for Parameter Explanation ST Station The parameters that identify a station locally on your computer OP Odette Parameters which rvsNT needs fo
29. Jobstart after C E Error Send Attempts fo EN f Success F c We system eendiab bat Search Program Comment Starting batch process sendjob bat after Attempt Cancel Enter the station you want to send the file to 4 Inthe Virtual Data Set Name field enter the file or the file specification for which the JS is to apply s User Manual rvsNT Rev 08 01 99 67 gedas GmbH User Manual rvsNT Modify JS 68 Use Search to select the batch program that should start after the attempt to send the file If you only want the program to start in the event of an unsuccessful attempt then select Error and under Send Attempts enter the number of unsuccessful attempts after which the program should start Confirm the entries by pressing OK The rvsNT Administrator writes the new entry to the rvs database and displays it in the list of JS s Pile Ea Y rvsNT Administrator File Edit View Monitor Database Window ed Jobstart after Send Attempt SID DSN Virtual Dataset Prog Comment j C rvs system resentr bat Starts batch file sendjob bat after Attempt Press F1 to get help 4 If you want to modify a JS Select the entry to be modified in the Jobstart after Send Attempt window Execute the menu command Edit Edit The Jobstart after Send Attempt dialog window then opens and displays the properties of the entry Process the entry properties and confirm y
30. LOC with Credit l0 Odette Buffer lt DISCONNECT gt Connection to Station LOC ended lt DISCONNECT gt Connection to Station LOC ended Press F1 to get help s User Manual rvsNT Rev 08 01 99 65 gedas GmbH User Manual rvsNT Modify RE Delete RE Send file Resident job start entry JS 66 If you want to modify a RE Select the entry to be modified inthe Resident Receive Entries window Execute the menu command Edit Edit The Resident Receive Entries dialog window then opens and displays the properties of the entry Process the entry properties and confirm your entries with OK If you want to delete a RE Select the entry to be deleted inthe Resident Receive Entries window Execute the menu command Edit Remove rvSNT will then ask you to confirm your delete command rmshT Administrator ES AN Do vou really want to deete resident receive entry for station and virtual data set name 7 If you are sure that you want to delete the entry then confirm the command with Yes With No you cancel the operation without deleting You can trigger actions after rvsNT has attempted with or without success to send files by generating resident job start entries JS in the rvs database A JS tells the Monitor to start a program after an attempt to send a particular file or a selection of files Example The batch program sendjob bat should start after the third unsuccessful
31. NT The rvsNT program environment The rvsNT installation program creates a folder with all links required for the rvSNT 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 control panel after Start Input Instruction or by using the command Start Run Program Function Information Link control panel command or Start Run Init Database Initializes the rvs database LOC is the c rvs system rvsidb exe LOC Standard station ID for your own local workstation ID identification number and displays it on the screen rvSNT Graphical configuration administration and c rvs system rvsmogr exe Administrator operating program for the rvsNT Get Machine Reads a three or four character machine c rvs system rvsgmid exe administrator rvsNT Graphical user interface for the rvsNT user c rvs system rvsdiant exe The tool for daily data exchange Batch Program for processing batch jobs when c rvs system rvsbat exe anticipated data arrive Delete Deletes the rvs database Database Monitor Opens the file with initialization commands notepad exe c rvs init rdmini dat Parameters Readme File Opens the readme file with the newest notepad exe information that is not included in this c rvs system README TXT manual rvs Console MS DOS window for dis
32. Troubleshooting aids you in eliminating errors Using the checklist makes it easier for you and for us to localize problems when working with rvsNT In Appendix Monitor parameters you will find a table of all of the parameters required to control the rvs Monitor You will find selected concepts explained in Appendix Glossary The Appendix Index helps you to find a specific passage in the manual if you only know a key word rvSNT Use our rvsNT Support service if you have questions or experience difficulty in support working with rvsNT You can reach rvsNT Support under the telephone number 030 399 71 777 Please have the following information ready when you call atelephone number where you can be reached the most detailed description of the problem possible This best thing would be to send us the completed checklist per fax see chapter Service for users for more information gedas information You may obtain further information on rvsNT under FAX 030 399 71 994 E Mail rvs service gedas de s User Manual rvsNT Rev 08 01 99 7 gedas GmbH User Manual rvsNT Type faces and symbols This manual makes use of the following typefaces Typewriter Italics Bold This type face represents text which appears on the screen Text and data which you are required to enter are also thus displayed ltalics are used to identify menu commands Boldface is used to identify push buttons NOTE and CAUTION ar
33. YYY YYY Fress F1 to get help Check the outputin Monitor Log for error messages Eliminate any errors that occur in accordance with the advices in the chapter entitled 8 Appendix rvsNT Troubleshooting NOTE With the menu command Edit Activate you can also test the connection with other stations User Manual rvsNT Rev 08 01 99 61 gedas GmbH User Manual rvsNT Setting follow on processing File reception Resident receive entry RE 62 When a file is received the rvs Monitor stores it in the directory c rvs usrdat Then it logs reception in the rvsNT Administrator and in the rvs log book You can trigger other actions when receiving files by generating resident receive entries RE in the rvs database A RE tells the Monitor to start a program when a particular file or selection of files has arrived Example When a file with the extension TXT TXT arrives the batch program copy bat should start see the following This batch program copies the received file from the user data directory c rvs usrdat into the directory d temp copy DSN d temp DSN stands for DataSetName and states where the file was placed in the local file system are rvs replacement markers and rvs replaces the character string DSN by the local file name of the received file Example c rvs usrdat konto1 txt or c rvs usrdat konto2 txt etc Another example is to be found in the file c rvs system resentr bat
34. a sais asda T asad ates TE 15 Ame SMUT VAG id sessed E sieeve unites luninstasl eabuotinutasrnite ohDesdauuaaeen 16 COIN MINN Di SS dares cae E EE 16 DO MIM Vel ect stead ere gt ge vtec tsa te td el goa dest cod nup tp sna hans chen nachna aa iene beheld 17 STAN SADO aa O E R ERE 17 EICON SOKOV MOOICANON aeranta ET 20 A TUSNT configuration naannnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnrnnnnnrnnnnnnnnnnnrnnnnnrnnnnnrnnnnnnnne 21 Starting the SNT AQMINISUATOT sagas atrasado saidas dd a 21 SO LEITO UPS SUCOS sia dial E A ERE 21 Meaning ONT Sel QUIN OOS nani tices gst niet eE e gedit eminent ested ede ta teeta 24 ONAE Ss E EEE E E at 24 ODETTE parametr OP af a ig 25 INC IMO OU E MOOG SER RD NR RR E A EE E E AEEA RS 29 RONLNO TADIG R catdcvecdevaaaneveoidusteancdetinswahdexndasaunteviraidenpourantundvetddsbdecdautedsebsecsauenetinuraiderbiuranmtodwsbiuseausintneys 32 SNA LUG 2 parameter LU ooo ccc ccccsecccssseeecesseeeeesseeeserseeesecsauessessueesesueesecsueesseseessersueesersuneseesanes 35 TCP IP communication TG TGP IP sivarsissecdinsiatesrascdccvaiannnannsvanndsstiavnesctctnedsnavanuensdiausttatanvaonrdedacdinabanieaes 3 Rc OOO CORITIBA TE sca econ atasnnastacasnaicusmuiaiast E AE EAR 39 FOG PVN Ey GUN a ta alyhata nda tse OA O EEA EAEG 44 NA EUC SOCO DO pistas pagaria atiactapieale visit masaiaciialaneapitieisiaes 44 TOPP FOCO DON ss io cerg daa a yet enne dager E ei aa E aia eiae 45 ISDN X 25 TECE NUON jar ncia fa id id 46 Changing a partner
35. ace The rvs user call interface rvSNT provides an interface for the programming language C The header file rvscal h and all the associated libraries can be found in the c rvs samples directory The command scope and syntax are the same as for the rvs batch interface For further information please refer to the manual entitled portable rvs User Manual rvs User Call Interface 90 gedas GmbH 8 Appendix rvsNT Troubleshooting 8 Appendix rvsNT Troubleshooting Error causes and remedies Feedback values in DOS mode Input error Configuration error If you execute a rvSNT program at the DOS level you will receive the following feedback values at the end of each command step O Normal end of the program no error 4 Program was cancelled by the operator 5 Error the rvs database is not active 6 Error another Monitor is already active for the rvs database 99 Serious internal error Example The successful execution of a command ends with the message ended with RC 0 If you make incorrect entries in rvsNT you will receive a Windows error message which will present you with an OK button to press in acknowledgement of the error Example While creating a send job you specify an incorrect Station ID which is not included in the stationtable You will receive the error message Station XXX is unknown If this is the case correct your entry and then proceed lf the error continues to occur this may
36. acilities EO X 25 Facilities TEI Nin fera xe FT X 25 Call User Data O eem ISDN Facilities Do o Cancellation time for a ISDN Facilities a Timeout 30 ISDN UserData ea recipients ISDN User Data simultaneous connections EEE dependend Recv hoo H Det m Data confirmation bit OK Cancel Help Parameter Meaning Database tab XP parameter X 25 15 digit X 25 DTE address of the partner station XADDRESS Address 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 ISDN An ISDN number under which the partner station ISDNNO number may be reached Not specified for an X 25 End connection For the ISDN standard 1TR6 the selection single digit end selection number is ESN Number allocated for the local station standard TEI Only required for X 31 Terminal End ISDN_TEI Identification Standard O no TEI is allocated TimeOut Cancellation time in seconds after which the TIMEOUT communication program aborts the connection if the partner station or CAPI does not reply Standard 30 Only valid for the local station Cancellation time in Timeout seconds after which the receiver interrupts the Rev waiting for incoming calls and reconnects to the card driver 42 gedas GmbH 4 rvsNT configuration Parameter Menaing Database tab XP parameter Parallel Max
37. amic With the rvsNT Administrator you can dynamically modify the parameters during modification Monitor operation In order to do so you have to enter individual operator commands Carry out the following steps if you want to modify a parameter for rvs Monitor operation Execute the View Parameters menu command in the rvsNT Administrator The rvsNT Parameter dialog window for editing the parameters will open s User Manual rvsNT Rev 08 01 99 51 gedas GmbH User Manual rvsNT Parameter list Input field Static modification Monitor Parameter 52 rrsNT Parameter Parameter IEFRIO 50 INITCMDS 1 I2PRIO 40 MAX SENDERS 2 Double click the parameter that you want to modify Enter the desired value parameter value into the input field A complete list and description of all of the monitor parameters can be found in Appendix Monitor parameters Example Parameter MAXSENDERS 2 With this example you indicate that a maximum of 2 senders transmit data at the same time Confirm your entry with Apply Use Close to exit the parameter list This operation transfers the command into the rvs database The Monitor will then read this command the next time it is started and then use the modified parameter You can also customize the monitor parameters by making entries into the file rdmini dat It is read every time the rvs Monitor is restarted and the rvs orders and commands it c
38. ams in the rvs system environment It serves as the communications medium between the various programs It manages the static information when it comes to configuration of the system users transmission partners the system operating mode and communications parameters and at the same time the dynamic information required in the individual transmission processes Internal Each rvs program reads information from the rvs database and writes communication information for the other programs to the rvs database 10 gedas GmbH 2 What is rvsNT Information flow rvsNT carries out asynchronous processing of a data transmission Placing a task and execution of a transmission order always take place at different times The user as the originator of the job writes his order into the rvs database via the rvSNT graphical interface the programming or the batch interface The rvs Monitor inspects the database If it recognizes an order then it initiates the required measures Example It starts a send process if it has received a send order The master transmitter controls the transmission processes Several transmission processes can be run at the same time rvs Monitor The rvs Monitor represents the very heart of data transmission with rvsNT It is tasks installed as a Windows NT service and can be run automatically by starting Windows NT The rvs Monitor is provided by the rvs database with all of the information required for the tasks to be execu
39. arameters for your local station LOC the TC TCP IP tab will also display the push buttons Add and Remove with which you may either add other data records to the TC parameters or delete the currently displayed record If you add a new record then rvsNT will automatically assign a number for the receiving channel NOTE If the configured recipient is to be automatically active after the rvs Monitor has been started and is to wait for incoming calls the parameter TCPIPRCV must be set For further details read the chapter entitled Reception type setup Partner stations The TCP IP address has to be unique for a send transmission to a partner Station Thus you may only indicate one Internet address The Recipient number is 0 and may not be changed s User Manual rvsNT Rev 08 01 99 37 gedas GmbH User Manual rvsNT Parameter Meaning Database tab TC TCP IP parameter Number May only be selected at the local station N Number for differentiating the various receiving channels through which the local station can be reached Each number has one set of TC parameters otandard O IP address Internet addresses have the form INADDR 259 295 295 255 lf 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 standard Port Port address PORT Standard 3305 Maximum May only be sele
40. ata via an X 25 type network you need the following equipment X 25 network connection 4 Interface hardware for interfacing the X 25 network in your computer 4 Driver software for operation of the X 25 card under Windows NT lf you already have this equipment then you install the X 25 interface as follows Install the X 25 card in your computer and attach it to the X 25 network connection Make sure that the X 25 connection works properly To do so use the X 25 network testing or operating software provided by the card manufacturer NOTE gedas has successfully tested the following X 25 cards for use with rvsNT EiconCard EICON Technology Corporation cards manufactured by TECCOM Ltda Rua da Assembleia 10Gr Centro Rio de Janeiro Ru Brasil Connectionto rvs Support will provide you with the current list of tested cards Tel 0049 30 399 71 777 FAX 0049 30 399 71 994 E Mail rvs service gedas de If you want to use rvsNT to exchange data via an SNA LU6 2 network you need 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 Install the MS SNA server software on your Windows NT Server and configure the server for LU6 2 communication Install the MS SNA Client Software for connection with the SNA server on each of the client computers on which you want to use rvsNT
41. ation files created in this way can be restricted by the parameter NUMRLSTATS 54 gedas GmbH 4 rvsNT configuration Customizing environment variables You can adapt the rvs environment to meet your requirements e g modification of the directory in which the Monitor stores the received files Carry out the following steps if you would like to modify the rvs system environment Execute the menu command Edit Environment The rvsNT Environment dialog window then opens and displays the current environment settings Main directory of wsN EMA Tr Avs rvs system T aee emitem OOO Cancel Database Jo o User data T seoa esus Temporary directory T Jemp evstemp O Initialization Tope fesi Programming interface sampes Jeimsisamples 0 Server for line messages SERVER emo O Port for Log Messages PSE OOO a Directory for backup files saor eserdir OO E Refresh interval ap pispLasenma ooo O Language User language ne English 4 Confirm your changes entries by pressing OK NOTE Any changes will only take effect after the rvs Monitor is restarted Meaning of the Designation Meaning of the environment variable Standard value ion PATH Main directory of rvsNT and location of c rvs variables environment file rvsenv dat SYSTEM system directory rvsNT with allprograms c rvs system Help files batch files and libraries DB rvs database directory
42. be due to a configuration error If a configuration error occurs you will generally not receive a Windows error message but will almost always receive an error message in the rvs administrator in the Monitor Log window and in the log book Example You try to activate a TCP IP receiver by setting the TCPIPRCV parameter to 1 although you have not yet set up the TCP IP protocol under Windows NT You can access additional information on a malfunction by proceeding as follows Start the rvs administrator or open the rvsNT log book file c rvs temp rlco log Search for error messages for the malfunctions which have occurred NOTE Error messages begin with E and are highlighted in red Please read further information on the individual error messages in the manual entitled portable rvs Messages and Codes Eliminate the error Example Reset the incorrectly set parameters to the initial values User Manual rvsNT Rev 08 01 99 91 gedas GmbH User Manual rvsNT Description of problem Protocol of events 92 system check Data storage Access rights Configuration lf the Monitor Log window and the log book fail to display an error message when an error occurs we recommend that you employ the following systematic method of procedure Describe the problem error as precisely and extensively as possible Keep a record of all error descriptions Take note of all subsequent events and keep a record of the
43. ble Save 71 V VDA 26 104 Virtual Data Set Name 64 67 Virtual File Name 64 W Working with rvsNT 76 X X 25 communication 16 X 25 interface 16 X 25 ISDN communication XP 39 107
44. cted at the local station MAX IN sessions Maximum number of simultaneously running receiving processes on this channel standard 1 38 gedas GmbH 4 rvsNT configuration X 25 ISDN Properties for station LOC Local Station i i ST Station OP Odette Parameters NK Line Type RT Routing mmunication arena do Bae co u cat T LU SNA LUB 2 TC TCPAP Link name Deeeeeeeneeeneeeneneneneneneeseeeeenenenenenenensenenneeneneneenenenaneeennee Receiver Number 1 7 LINK Link Card Type Card Type DN Adapter nd Card Number Card Number emee fo x ISDN Standard Jr ISDN Standard recs I Remove Add Cancel Help lf you have selected line protocol X 25 ISDN onthe NK Line Type tab you can edit the parameters for X 25 ISDN connection on the XP X25 ISDN tab You may be ready to receive for a partner station via several ISDN numbers or X 25 address at the same time To begin with you must stipulate the parameters with which the connection to ISDN and or the X 25 card is made This information is passed on by the parameter LINK Local station rvsNT supports multiple X 25 ISDN reception through various receiving channels call numbers at the same time When you edit the XP parameters for your local Station LOC the tab will also display the push buttons Add and Remove with which you may either add other data records to the XP parameters or delete the cu
45. d Automatic Remote Procedure Call RPC Locator Manual Remote Procedure Call RPC Service Started Automatic Manual Manual Started Automatic Started Automatic Start Press the Start button Windows NT will now try to start the service If the attempt is successful the rvs Monitor status will change to started The entry IS res Monitor Started Automatic stop 4 Press the button End Windows NT will now try to end the service If the attempt is successful the rvs Monitor status will change to not started s User Manual rvsNT Rev 08 01 99 57 gedas GmbH User Manual rvsNT start stop from rvSNT environment ie maT Administrator Start Stop res Monitor 08 Carry out the following steps if you want to start or stop the rvs Monitor from within the rvsNT program environment while it is in operation 4 Startthe rvsNT Administrator program inthe rvs file Execute the menu command Monitor Start The rvs Monitor then starts The rvs Monitor has been started if the stop symbol Silis active on the tool bar Execute the menu command Monitor Stop or 4 Startthe Stop rvs Monitor program inthe rvs file The rvs Monitor then stops It has been stopped if the stop symbol Hi active on the tool bar gedas GmbH 5 rvsNT operation Function test The function test is used to make sure that rvsNT accepts and processes orders without error To this end you should send a file to yo
46. d Entry EI station code Station ID LOC Select Station ID of receiver Fi le File Cinvstsystemireadme d Search New File Name fest virtual file name File name for recipient Options Disposition delete after transmission Change Options Format C Tex C Fixed C Varable C Unstructured Recordsize E record size in case of fixed or variable Format Input Code code ofthe local file A ASCIL E EBCDIC Output Code code on receivers side A ASCII E EBCDIC Start Time YYIMM DD HH MM H hold at first Timestamp add Label for serialisation only save settings Cancel Help Manually enter the station code for the receiving station in the Station ID field or User Manual rvsNT Rev 08 01 99 91 gedas GmbH 82 User Manual rvsNT Use Select to open the Select Station selection window and select the station code Select Station Ba ID Description RSL remote station via SNA remote station via TCPIP RSX remote station via X 25 ISDN Test for ISDN communication Example LOC LOC is the standard setting 4 If you want to send the file to your partner under a different name then enter the new file name into the New File Name field Confirm the entries by pressing OK rvSNT then writes the send entry for transmission of the file to the rvs database The send order has been completed rvsNT displays the order in the list of files which have not yet
47. d the following equipment ISDN type telephone connection with s connection having at least two data channels B channel and one control channel D channel ISDN adapter 4 CAPI 2 0 driver software for operation of the ISDN card under Windows NT This is how you install the ISDN interface 4 Install the ISDN card into your computer and attach the ISDN card to the ISDN connection Make sure that the ISDN card works properly NOTE Many card manufacturers supply suitable software for a self test such as a call from one data channel to another Restart your computer after installation and the test in order to make the CAPI 2 0 driver available for other applications If you use an external ISDN router e g BinTec Brick you do not need an internal ISDN card In this connection 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 s User Manual rvsNT Rev 08 01 99 15 gedas GmbH User Manual rvsNT X 25 interface SNA interface 16 NOTE gedas has successfully tested the following ISDN devices for use with rvSNT AVM B1 BIANCA BRICK XS ISDN DIVA Pro and ISDN SXn rvs Support will provide you with the current list of tested devices Tel 030 399 71 777 FAX 030 399 71 994 E Mail rvs service gedas de lf you want to use rvsNT to exchange d
48. e LID LITRACELVL LMPRIO MAXSENDERS MAXX25RCV MSGPRIO NUMRLOGS pm OCREVAL ODTRACELVL Priority of information assignment command to recipient Period in days that completed and deleted commands and associated data are retained in the database before they are finally purged by database cleanup Language for operator communication and log messages LongDataSetNumberPriority Send priority for lengthy files Local station identification LineTraceLevel monitoring of the link between ODETTE FTP and the network Values 1 and 2 apply only to the stations indicated in the SIDTRACE parameter Value 3 applies to all stations Priority for external log book messages Maximum number of external commands to be read in Maximum record length for data records in F or V format Maximum number of active transmitters Maximum number of X 25 ISDN lines receiving or ready to receive the Monitor has to be restarted in order for the changes to take effect Priority for messages between operators Number of generation files for rlog log Number of generation files for ristat log ODETTE credit value window size for ODETTE FTP maximum number of blocks sent with acknowledgement expected ODETTE TraceLevel monitoring of link between transmitter and ODETTE FTP Values 1 and 2 apply only to the stations indicated in the SIDTRACE parameter Value 3 applies to all stati
49. e Access method failure in the EFNA e 12 Error code Unspecified reason in the EFNA OTIMEOUT ODETTE Timeout Cancellation time in seconds after which the transmitter aborts the connection if the partner Station does not respond QEPRIO Priority of acknowledgement receipt QSPRIO Should be between MSGPRIO and SDSNPRIO RECVBLOCKS Number of blocks received between two restart positions for error correction size of temporary data buffer Maximum size of the Monitor Log file rico log Specified in bytes Maximum size of the permanent Monitor Log file rlog log specified in bytes Maximum size of the statistics log file ristat log Specified in bytes aan ShortDataSetNumber maximum size of a short data record in units of 1024 bytes 2 File was not found or could not be opened 4 Error code File size is too big in the SFNA 8 Error code File size is too big in the EFNA Priority for sending acknowledgements The value 9 Appendix Monitor parameters 000000000000000 101110001 0000 OIL Lali eb le TU pp Wt O L1 11111 600 1 100 50 1 100 Me 5000000 1 N NOLIMIT or 0 no 200000 limitation 200 Kbyte 1 N NOLIMIT or 0 no 2000000 limitation 2 MByte 1 N NOLIMIT or 0 no 2000000 limitation 2 MByte 1 N o lt User Manual rvsNT Rev 08 01 99 gedas GmbH 97 User Manual
50. e also printed in boldface type Examples are printed with a grey background The slash separates several consecutive steps of a command which you can call up with the Menu Example The command Database Import describes the following actions 1 Open Database menu 2 Click mport command Mode of operation c rvs As a rule the manual describes operation with the help of the menu commands and pushbuttons The program may be run alternatively using normal Windows operations e g by double clicking or invoking a context menu by pressing the right mouse button For the sake of clarity these possibilities will not be treated separately Please refer also to the Function Key Overview in the Quick Reference is the standard installation directory for rvsNT If you use a different directory then the path information for files will be in accordance with your installation CAUTION warns you if a certain action might result in a loss of data NOTE Provides you with additional information on the current topic e g exceptions to a rule or detailed technical information for experienced users gedas GmbH 2 What is rvsNT 2 What is rvsNT rvSNT features gedas offers a broad range of program systems for fully automatic platform independent data exchange using the ODETTE File Transfer Protocol OFTP OFTP is the transfer protocol agreed upon by the ODETTE Association accepted worldwide The generic term i
51. e entered in the rvs Administrator lf you are absolutely sure that you want to reinstall your database carry out the following steps 4 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 4 Save the tables which you would like to restore after initialization of the rvs database is complete For precise instructions please read the chapter rvs database maintenance Backup Execute the menu command Monitor Stop Use the preferred backup method to save the stationtables users tables and the job start entries or the entire rvs database For precise instructions see chapter rvs database maintenance Backup Delete the rvs database To do so startthe Delete Database program Dedde in the rvs program file Database The DOS input request will open You have to confirm each one of the individual steps for deletion Prior to the delete operation you can save selected entries 4 Click the entries to be saved in the field Save entries In this 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 saving 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 Import and or Database Import of Jobstart Entries and User after the Database
52. earn about your workstation and the operating system Windows NT before beginning work with rvsNT Otherwise you run the risk of losing valuable information You can read the introduction to your workstation in the pertinent documentation or request training from your vendor Completely read this chapter first Then decide which chapters you want to read next based on your previous knowledge and interests This manual contains the following chapters Chapter 2 What is rvsNT provides you with the principle behind rvsNT and the most important features of the program and introduces you to the respective concepts Chapter 3 Installation of rvsNT Here is where you find out what preparations need to be made before using rvSNT and how to install the program This chapter is intended for the system administrator Chapter 4 rvsNT configuration This is where you learn how to set up rvsNT in your work and network environment This chapter is intended for the system administrator Chapter 5 rvsNT operation Here is where you find out how to monitor and control sending and receiving activities and how to manage the rvs database Chapter 6 Data exchange with rvsNT shows you how to exchange data with your business partners Appendix Extended functions shows you as an advanced user and programmer how to use the interfaces to batch processes and C programs gedas GmbH 1 About this manual User service Appendix rvsNT
53. ect another 4 You may choose between German or English as user languages We recommend LOC as the station ID for the local station However you may choose a different ID By default 2956 is set as the TCP IP port for the Active Panel The Active Panel gives information as to the status and progress of transmissions at the line level User Manual rvsNT Rev 08 01 99 17 gedas GmbH User Manual rvsNT HeadmeFile ml pps A Init Database Specify rvs Monitor Startup Mode Services 18 The installation program creates the rvs file in the Programs menu file along with the required links icons to rvsNT applications We recommend to read the file ReadMe txt before starting the rvsNT Administrator After your acknowledgement the rvsNT Administrator generates the rvs database This database is required to operate rvsNT The program Init Database initializes this database in the database directory c rvs db Important The NT user currently logged on and who initialized the database is automatically entered in the rvs database as an rvs user with the rights of an rvs administrator At the end of the installation rvsNT offers you the opportunity of immediately setting up stations Please see the chapter 4 rvsNT configuration for instructions You may however set up stations at a later time The rvs Monitor provides the applications with information on the current data exchange processes After the insta
54. edgement 32 gedas GmbH 4 rvsNT configuration Data flow with and or without routing is depicted in the following illustrations Without routing File Station 1 Station 2 EERP With routing File File Station 1 Station 2 Station 3 EERP EERP You have to define 2 stations in the stationtable for routing the neighbour station neighbour node through which the end recipient is reached and the target station for the end recipient select Rout ing as the connection type on the NK Line Type tab for this station and on the RT Rout ing tab select the station ID for the neighbour station You may define the neighbour station itself like any normal station with connection type LU6 2 TCP IP or X 25 ISDN For example Setting up of a recipient station is shown in the following screenshots The destination MAR is reached with routing via RST Station name ST Station OP Odette Parameters NK Line Type RT Routing LU SNA LU6 2 xP X25 TC TCP IP Station d Station Name recipient station via RST Phone PO Cores mp s User Manual rvsNT Rev 08 01 99 39 gedas GmbH User Manual rvsNT ODETTE ID of destination Connection type Routing station 34 Properties for station MAR Remote Station Properties for station MAR Remote Station Odete FTP Properties for station MAR Remote Station O gedas GmbH 4 rvsNT configuration
55. eeeneauueseners 102 RECO GO scan sines ani OPEN Ao RS a a E e 102 O TORTO c a Si etait 103 Appendix GIOSSANY sussa saia sais ai gas Dea oasis EE 104 Append INDO massa ass Db oI os E ris Danas LOSE dos tan DOSE E Usa dO aa Sa 105 gedas GmbH 1 About this manual 1 About this manual The present User Manual is intended to serve as a guide and provide you with the necessary explanations in order to understand rvsNT functions Target groups It is primarily intended for the system administrator who makes rvsNT available either as a Service for a group or who simply installs the program locally at his own workstation and uses it for electronic data interchange EDI lt is also aimed at users who make use of this service in order to exchange data with business partners within the scope of their business and work activities Chapter entitled Data exchange with rvsNT is intended for users A total of five manuals make up the documentation for rvsNT 2 S z a _ O ay co O O T os C E g D o5 O Z O ol nO 4 22 22 24 e o S1Oa 2 o mo aS Yio 2 z im S16 2168 25 OTT Ss Ylc ol oo gt SCO Soles kg 5260 87 a a2 Quick Relerence An overview of 4 The Quick Reference for the user is the abridged version of this users manual rvsNT documentation rvsNT This is the User Manual version of the manual This is where you will find a clear summary selection of commands a
56. ens and displays the files which have the suffix LOG in the rvsNT arcdir directory Select the file which contains the user table and resident actions which are to be restored 4 Confirm your selection by pressing Open rvSNT then opens the DOS input request rvsNT Restore Jobstart Entries and User and restores the saved entries for follow on processing in the rvs database Restoration of the data has been successfully completed if the DOS window closes without error Start the rvsNT Monitor Restoring the rvs If you want to restore the data for the entire rvs database from a backup database 4 Stop the rvsNT Monitor Execute the menu command Database Import The Select Backup File dialog window then opens and displays the files which have the suffix LOG in the rvsNT arcdir directory Select the file which contains the database which is to be restored 4 Confirm your selection by pressing Open rvSNT then restores the database and displays any errors in the rvsNT Restore Database dialog window Restoration of the data has been successfully completed if the message O error s occurred appears Start the rvsNT Monitor s User Manual rvsNT Rev 08 01 99 73 gedas GmbH User Manual rvsNT New database If you want to set up a new database you have to delete the existing one first CAUTION If you delete the database you will irrevocably loose any incomplete data transmissions and all settings which you hav
57. er SENDELOCKS 50000 Fi Parameter list Y tt Input field Double click SNARCV to select the parameter in the parameter list Enter the desired value 1 into the input field Confirm your entry with Apply Use Close to exit the parameter list e Activate the parameter by stopping and starting the Monitor TCP IP reception If you want to be ready to receive via TCP IP rvsNT must start a TCP IP receiver that waits for incoming calls This is how you set the rvsNT to receive calls automatically via TCP IP Execute the View Parameters menu command in the rvsNT Administrator The rvsNT Parameter dialog window for editing the parameters then opens In order for the TCP IP receiver to start automatically start when the Monitor starts you have to set the value of the rvs parameter TCPIPRCV to 1 4 Double click TCPIPRCV to select the parameter in the parameter list Enter the desired value 1 into the input field Confirm your entry with Apply Use Close to exit the parameter list 4 Activate the parameter by stopping and starting the Monitor A message of the type I lt TCPIP_READY gt TCP IP Receiver ready to accept incoming calls Pore 3505 indicates your readiness to accept calls User Manual rvsNT Rev 08 01 99 A5 gedas GmbH User Manual rvsNT 46 ISDN X 25 reception If you want to be ready to receive via X 25 ISDN rvsNT must start a receiver that waits f
58. eters However if you delete the rvsNT database or reinstall rvsNT 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 save the station table in a separate file and restore it later For further information please see the chapter entitled rvs database maintenance gedas GmbH 4 rvsNT configuration User table modification Only those users may work with rvsNT who are registered in the rvsNT database In order to display or modify user data Open the User Table in the rvsNT Administrator by using the View User menu command The user table contains at least the table entry for your own data y rysNT Administrator Miel ES File Edit View Monitor Database Window Press F1 to get help sort You can sort the table according to any column by using the mouse to click the column header New user If you would like to set up a new user Execute the menu command Edit Add The User dialog window then opens and displays the User Table parameters User ID User ID MNE User name User language Access authorization Privileges Administrator Cancel Enter the user identification 4 Enter the user name Select the language for screen dialog Use the mouse to click on the user access authorization Confirm the entries by pressing OK s
59. figuration up to this point The data entered will now take effect You can either allow the rvsNT Administrator to remain active for rvsNT operation or exit the program If you would like to exit the rvsNT Administrator then use the File Exit menu command The rvs Monitor operates as a Windows NT system service independently of the rvSNT Administrator Thus it remains ready to send and receive even after you exit the rvsNT Administrator Please refer to chapter 5 rvsNT operation on Starting and stopping the Monitor gedas GmbH 5 rvsNT operation o rvSNT operation Starting and stopping the rvs Monitor You can start the rvs Monitor at the level of the operating system or from the rvSNT Administrator This is the tool for operation of rvsNT Operation of rvsNT requires administrator user rights at the system level and in the rvsNT environment start stop atthe Carry out the following steps if you want to start or stop the Monitor at the system level system level Execute the Windows NT menu command Start Settings Control Panel Startthe Services program ae NOTE The term Service means a program that can be started from the operating system and works in the background Search the list of services for rvs Monitor and select the service by clicking the appropriate line Services Service Status Startup Network DDE DSDM Manual INT LM Security Support Provider Manual NVAlert Manual Plug and Play Starte
60. g rvsNT then you need to have at requirements least the following units atransmitting station and a receiving station anetwork line for bridging the transmission route a user on the transmitting and receiving end who respectively issues and or receives the send orders s User Manual rvsNT Rev 08 01 99 75 gedas GmbH User Manual rvsNT Working with rvsNT Starting rvsNT ag e mshl T Entry list Details area Additional information Command numbers Transmission time Push buttons Display modes 76 Prerequisites You should have a system which has been set up for operating rvSNT and the required access rights 4 Startthe rvsNT program in the rvs file The rvsNT window then opens with display of not transmitted datasets v r sNT display of not transmitted datasets File Edit View Help Diz xle 9 x Entry No New File Name Details File Name Receiver Additional Information Transmitted Bytes Block Size Bytes Send Attempts Local Name State Command Numbers SE SK IE New Send Entry Delete Hold Release Date Time Disposition Start of Transmission End of Transmission Send Attempt at Select Refresh 14 35 The window displays the transmission information in four different display modes Send Receive Completely sent Completely received gedas GmbH Window areas 4 6 Data exchange with r
61. gedas rvsNT VERSION 2 03 USER MANUAL User Manual rvsNT The products listed in this manual are protected by copyright rvsNT Version 2 03 User Manual 1997 1999 by gedas PascalstraBe 11 10587 Berlin This manual is protected by copyright All rights reserved No part of this book may be used or reproduced in any form or by any means including photocopies microfilm or any other means or stored in a database or retrieval system without obtaining prior permission from gedas Rights are also reserved as far as lectures radio and television is concerned We reserve the right to make changes to the content of this manual without giving prior notice gedas is not liable for technical or printing errors or defects in this manual Moreover gedas shall not be liable for damage which is directly or indirectly caused by delivery performance and use of this material 1 About this manual Contents 1 About this manual 0 cc cecee nese eee esceeeeneaceeeensaceeeensaceeeensaceeeengaueeeesaaneegs 5 DTS VSN a ree E E 9 PUC WOU GS no 9 LNG TECNICA COMICS DE soa 10 TIO AS VG IO nt ES and A EAE pea aletd ea tan ee eid aed 12 TE PSOE PROGRAMS E sino fg a a indiniegena viv eel aaee aneaniolenees 13 3 Installation Of rVSNT cccce cc cceee eee eee eee eesceeeensaceeenaaaceeenaaaceeeeaaaceeeenaaaneeenegas 15 System Me AUNT CN IVES ria saat bere NEEE iEn eE EI Rie 15 Connection type installation ce 15 DRICA CO ee
62. gnment of the QS has been completed it is given the status ended s User Manual rvsNT Rev 08 01 99 79 gedas GmbH User Manual rvsNT Display files sent Not yet completed Completed Update display Display received files File being received File completely received Update display 80 This is how you switch rvsNT modes 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 Execute the menu command View Send files in order 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 Execute the menu command View Completely sent files in order to display the list of send orders which have been completed lf you want to update the list display do the following Click the update button or Switch to a different display mode and then back again 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 This is how you display the files announced Execute the menu command View Receive
63. guration Customizing the monitor parameters The monitor parameters determine the operational mode of the rvs Monitor the heart of the rvsNT system By customizing the monitor parameters you can modify the rvs 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 Appendix Monitor parameters control the Monitor Log Book display make optimal use of data line quality monitor communication processes with other stations administer the size and number of the log files The rvs database which works as a central information source provides the rvs Monitor with allf the information required for the tasks to be executed When the rvs database is initialized the initialization program first creates a parameter table for the monitor parameters with standard values which determine the standard behaviour of the rvs Monitor You can modify these values by editing the file c rvs init rdmini dat which is the source for modification of the parameter table in the rvs Monitor start phase If you modify the file while the rvs Monitor is in operation the changes will only take effect when the Monitor is started again Dynamic modification of the monitor parameters cannot be achieved in this way Dyn
64. has been created again 4 Deletion has been successfully completed if the message ended with RC O appears Initialize the rvs database To do so start the Init Database program in E the rvs program file rvysNT will then generate a completely new database Init Database After initialization all tables contain the standard rvs settings Restore the tables desired from the backup files which you made earlier For precise instructions please read the chapter rvs database maintenance Restore Start the rvs Monitor Configure your system as described in chapter entitled rvsNT configuration 14 gedas GmbH 6 Data exchange with rvsNT 6 Data exchange with rvsNT What rvsNT can do What is rvsNT rvsNT is the tool which the user employs in order to control daily data exchange with business partners To use rvsNT you do not need to have any special knowledge to administer the rvsNT environment The rvs Monitor and the rvs Database are capable of being installed on a remote computer in your network environment In this case you need to define read and write acces for the rvs Database directory With rvsNT you can for example send files to your business associates by issuing send orders hold release modify or delete send orders have send orders automatically executed at any time Example 24 Aug 1997 at 1 30 p m display the status of transmissions Network If you want to carry out data transmission usin
65. he program s flexible back up function provides you with support when Saving and restoring the entire rvs database users and stations e The Log Function with displays in log files makes it possible to trace all operations and messages e With the rvsNT Trace Function you can trace errors at both the line and the ODETTE FTP level User Manual rvsNT Rev 08 01 99 9 gedas GmbH User Manual rvsNT The technical concept rvs Programs rvsNT is a package of programs with a database which serves as the central source of information and a central controlling unit the rvs Monitor Database Area Material and Financial CAD Systems Archiving and Several Files Management Admistrating EDIFACT ODETTE VDA STEP ENGDAT S Batch and User Call User Interface Interface Batch rvsNT Administrator Interface rvsNT Administrator CAK 1 rvs rvs Monitor Database ODETTE FTP ISDN x 25 TCP IP SNA LU6 2 4 rvsNT is the tool which the user employs in order to control daily data exchange with business partners It has a comfortable user screen and requires neither special user rights nor special knowledge when it comes to administering the rvsNT environment 4 ThervsNT Administrator is the user interface for administration and operation of rvsNT 4 The rvs database is the central source of information for all progr
66. icense key is used to modify the RDKEY DAT file in the c rvs init directory Make a backup copy of the c rvs init RDKEY DAT in order to be able to restore the original file status In case you receive the license key by fax Open the c rvs init RDKEY DAT file using an ASCII text editor e g MS DOS edit command Edit the file precisely in accordance with the license key which you received from your sales representative to match your machine identification number NOTE The character entries have to be complete and absolutely identical with the license key model Save the file and close the text editor lf you have received the license key by e mail Save it as RDKEY DAT file in the init directory 4 The license key has now been adapted gedas GmbH 4 rvsNT configuration 4 rvsNT configuration Starting the rvsNT Administrator The rvsNT administrator is used for configuring administering and operating rvsNT In order to carry out these activities the rvsNT Administrator is equipped with several detail windows The configuration assumes administrator user rights at the system level and in the rvsNT environment ike Start the program rvsNT Administrator by invocation inthe rvs a file or by means of Start Programs rvs rvs Administrator Administrator The rvsNT Administrator then opens with the Monitor Log window which displays the current rvs Monitor activities Y rysNT Administrator File Edit View M
67. imum number of parallel active connections SESSIONS sessions The following applies for reception As soon as a call has been accepted the master transmitter Starts a new receiver until the maximum number is reached X 25 User data for an X 25 transmission see the USERDATA UserData information of the X 25 service in use X 20 special information or facilities for an X 25 FACILITIES Facilities transmission see the information of the X 25 service in use ISDN special information or facilities of the ISDN ISDN_FAC Facilities transmission ISDN User data for an ISDN transmission ISDN USRDT UserData dependend Only applies to partner station entries Specifies ROV N Recv from which configured receiver the parameters for your own station e g own ISDN number or X 25 address are taken Dbit specifies whether every X 25 data packet is to be DBIT confirmed Values Yes No standard No do not confirm every data packet User Manual rvsNT Rev 08 01 99 43 gedas GmbH User Manual rvsNT Reception type setup SNA LU6 2 reception Communications program registration Communications When using SNA LU6 2 communications technology with rvsNT the calling Station initiates a communications program at the receiving station In order for the rvs communications program to start automatically when a partner station connects to your computer the SNA LU6 2 has to recognize the communications program as a transaction pr
68. ing Record format of the file received e F Fixed e Variable e T Text e U Unstructured The meaning of this field depends on the record format e Fformat Length of every record e V format Maximum length of a record e and U format always O Number of bytes transmitted Number of records transmitted with F or V format Date and time the file was received Locai user ID is not yet supported User ID of the sender is not yet supported Station ID of the sender Name of the temporary batch file 102 gedas GmbH 11 Appendix rvs replacement characters Send file Job start entries after a send attempt work with the following replacement characters DSN Name of the file sent as it is known in the local system With an EERP no local file name is to hand in this case QS SIDORIG SIDDEST Is issued with the following meaning e SIDORIG Station ID of the sender e SIDDEST Station ID of the destination station VDSN Logica file name under which the file was transmitted DTAVAIL Date and time when the file was made available for sending FORMAT Record format of the file sent e F Fixed e V Variable e T Text e U Unstructured BYTES Number of bytes transmitted RECORDS Number of records transmitted with F or V format DTRCV Date and time the file was received LABEL Label for serialization SECN Number of the send entry SKCN Number of the send command pulp User ID of
69. ion box 4 Confirm the entry by pressing the button OK ExitrvsNT You can exit rvsNT at any time even if all of the send orders have not been completed or you have not yet saved several of the files which have been received The rvs Monitor continues to process your send orders and places arriving files into your user directory The next time you start rvsNT you can display the advance status of your send orders and any files which may have arrived Ifyou would like to exit rvsNT then use the File Exit menu command s User Manual rvsNT Rev 08 01 99 87 gedas GmbH User Manual rvsNT 88 gedas GmbH 7 Appendix Extended functions 7 Appendix Extended functions The rvs batch interface The batch interface of rvsNT allows you to access the rvs environment as follows onan interactive basis at the input request level and using batch jobs You open the batch interface via the command rvsbat The format is rvsbat c e lt envfile gt i lt file gt l lt language gt q continue Continues to execute the command if an error has occurred during execution The standard setting is off e envfile l Uses by default its own file rvsenv for the rvs parameter DSN in the current environment of the invocation Example c rvs system rvsenv dat rvsbat commands You can use the characters and In the file Fa LLE input file Reads the batch file fi 1e and interprets the contents as Commen
70. ion of the file is thus entered into the rvs database The order to send the readme txt file to your station has been made rvsNT displays the order in the list of files which have not yet been sent Go to the rvsNT Administrator The Monitor Log window displays the rvs Monitor activities The Monitor reads the send order and executes it Through the station code LOC the rvs Monitor recognizes its own station as the target and copies the file into the c rvs usrdat directory Monitor Log olx 4 lt NEW CMD CREATED gt eK 15 created by SE l4 A lt NEW CMD CREATED gt IE 16 created by SK 15 4 lt NEW CMD CREATED gt IZ 17 created by IE 16 R lt IZ DELIVERED gt Delivery 17 SENDTEST 1997 09 21 14 36 46 received at 1997 09 21 15 02 39 from Lf stored in c kbprog rvs usrdat SENDTEST 4 lt CMD TERMINATED gt IZ 17 terminated status e Lk lt NEW CMD CREATED Q5 18 created by IE 16 4 lt NEW CMD CREATED gt QE 19 created by Q5 18 4 lt CMD TERMINATED gt Q5 18 terminated status ej 4 lt CMD TERMINATED gt QE 19 terminated status ej 4 lt CMD TERMINATED gt SK 15 terminated status ej A lt SE_SENT gt SE 14 successfully sent C KBProg rvs system readme txt for KONRAD at LOC 4 lt CMD TERMINATED gt SE 14 terminated status e ma F Check the output in Monitor Log for error messages Follow the instructions in Appendix rvsNT Troubleshooting in order to eliminate an
71. lick the button Advanced The Odette Parameter Advanced window will open with advanced configuration options Odette Parameter Advanced ES Transmission buffer a Exchange Buffer Credit p CodeTranslation EERP Input format aco fso i Receive acknowledgement Send acknowledgement Target format Opat Asc OUT IMMEDIATE Transmit Blocks Sendi block l allowed characters ending blocks ssa po Receiving blocks ef l Allowed characters for file names 26 gedas GmbH 4 rvsNT configuration Parameter Meaning Database tab OP Odette Parameters Advanced parameter Exchange Maximum transmission buffer size OEXBUF Buffer Size Standard 0 i e OEXBUF from parameter table applies Exchange Maximum number of blocks sent without OCREVAL Buffer acknowledgement expected Credit standard 0 i e OCREVAL from parameter table applies Code Input encoding of the file which is to be sent prior CODEIN Translation to conversion for the partner station Values Input Code ASCII The files which are to be sent are in ASCII format EBCDIC The files which are to be sent are in EBCDIC format standard ASCII Translation ASCII During transmission rvsNT converts the Output files which are to be sent from input code code format into ASCII format EBCDIC During transmission rvsNT converts the files which are to be sent from input code format into
72. llation completed the rvs Monitor s Startup mode is Manual This means that you have to start the service anew after each start of the system To automatically start the rvs Monitor whenever the system is started Press the Startup button The Services dialog box will open select Automatic as the startup mode and confirm it with OK The rvs Monitor startup mode changes to Automatic Open the Windows NT Control Panel with the menu command Start Settings Control Panel Start the Services program Search the list of services for rvs Monitor and select the service by clicking the appropriate line gedas GmbH 3 Installation of rvsNT Services Service Status Startup Hetwork ODE DSDM Manual INT LA Security Support Provider Manual NvAlert Manual Plug and Play Started Automatic Remote Procedure Call RPC Locator Manual Remote Procedure Call RPC Service Started Automatic res Monitor Manual E Manual Server Started Automatic enti Snabase Started Automatic mu Hw Profiles j Help Equip As standard the rvs Monitor service runs under the system user of the rvs Monitor with local machine It has no authorizations to be able to access network directories special user rights If it is necessary for the rvs Monitor or the processes it controls e g a batch job from a resident receive entry to access network directories the rvs Monitor service m
73. luding 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 Password Send password rvsNT sends this password to the PSWTO send partner station as access authorization Password Receive password rvsNT permits the partner PSWFROM Receive Station to have access with this password s User Manual rvsNT Rev 08 01 99 25 gedas GmbH User Manual rvsNT The fields for the passwords have been masked out on the local station since no access authorization is required for communication with yourself For a partner station the passwords for sending and or receiving must have been agreed upon with the partner The same passwords must be entered interchanged for receive and or send Non compliance results in an error message and prevents communication see following illustration Station 1 Station 2 Password Password Send Send Receive Receive NOTE You may submit an application for your own ODETTE organization code to your national ODETTE organization In Germany this is the Association of the German Automotive Industry VDA Telephone 49 69 97507 283 Fax 49 69 9 507 300 rvsNT carries out transmission using standard values for ODETTE File Transfer Protocol OFTP 4 If you would like to view the standard values or want to change them c
74. may activate stop or set a station working This is how to change the status of a partner station Select the station to be changed in the window Station table In order to activate the station execute the menu command Edit Activate NOTE The station must already be Enabled before you can activate the Station rvSNT establishes the connection to the partner station and transmits the currently pending files Activating a station means establishing an OFTP connection to this station As soon as the connection has been established each side has the opportunity to send any files that may possibly be available If no file is ready to be sent the connection is closed In order to set the station working execute the menu command Edit Release rvsNT 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 4 In order to stop the station working execute the menu command Edit Stop rvSNT 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 User Manual rvsNT Rev 08 01 99 47 gedas GmbH User Manual rvsNT 48 Save When you set up or change a station save the changed parameters by pressing OK When Windows NT is restarted rvsNT continues to work with these param
75. nd operating situations Use the Quick Reference if you are already familiar with portable rvs Technical Concept provides you with further information on the technical aspects of the multiprocessing system rvs that goes beyond the scope of the User Manual portable rvs Messages and Codes provides a detailed description of all of the messages and error messages generated by the rvsNT Monitor for the display and log book s User Manual rvsNT Rev 08 01 99 gedas GmbH User Manual rvsNT Prerequisite for working with rvsNT Using the manual Overview Installation of rysNT 4 The rvsNT Operator Guide and Reference Manual describes how you operate rvSNT at the control panel It includes information on maintaining rvsNT and describes several utilities at the control panel level This book is intended for the system administrator The portable rvs User Manual shows the user how to use the text based Dialog interface in order to exchange data with business partners This is the preceding version of the Windows based rvsNT program as described in chapter 6 Data exchange with rvsNT This manual is especially conceived for users who are familiar with older versions of rvs or the rvs of other platforms The portable rvs User Manual also describes the rvs batch interface and the API to programming language C Please read Appendix Extended functions NOTE If you are not yet familiar with your computer workstation first l
76. nder which you want to save the database Confirm the entry by pressing Open rvSNT then saves the database and displays any errors in the rvsNT Dump database message window Saving has been successfully completed if the message End appears Start the rvsNT Monitor When you have performed a backup with one of the three backup procedures you can restore the stationtable the user table together with the tables for resident actions or the entire database This is how you restore data for a stationtable that has been saved Start the rvsNT Monitor Activate the Station Table window with the View Stations menu command Execute the menu command Edit Import StationTable The Select file with station definitions dialog window then opens and displays the files which have the suffix DAT in the rvsNT arcdir directory Select the file which contains the stationtable which is to be restored 4 Confirm your selection by pressing Open Restoration of the data has been successfully completed ifthe Monitor Log window contains the message Le xok cma done gt RVSCNS mocdst ended gedas GmbH 5 rvsNT operation Restoring the user Carry out the following steps if you want restore data for the user table and table andthe follow on processing follow on processing stop the rvsNT Monitor Execute the Database Import of Jobstart Entries and User menu command The Select Backup File dialog window then op
77. nual rvsNT Rev 08 01 99 35 gedas GmbH User Manual rvsNT Parameter Meaning Database tab LU SNA LU6 2 parameter Password Password which is required to start the TP at the partner station standard Network ID Unique identification within SNA network NETID SNA network ID Mode Name for the SNA session mode which you have MODE defined during configuration of the SNA server some implementations of LU6 2 require names having at least 8 characters Thus the mode should be at least 8 characters long Standard one blank space value required Synchro APPC synchronization level values SYNCLEVEL nization NONE Partner station does not expect confirmation CONFIRM Partner station expects confirmation standard NONE Conver APPC conversation type values TYPE sation type BASIC Basic conversation not supported at present MAPPED Mapped conversation Standard MAPPED 36 gedas GmbH 4 rvsNT configuration TC P I P Properties for station RST Remote Station communication TC TCP IP Internet address _P Adaess _ft231 2348 Bot fais Port Ceres Hels lf you have selected line protocol TCP IP onthe NK Line Type tab you can edit the line parameters for the network connection on the TC TCP IP tab with TCP IP protocol Local station rvsNT supports multiple TCP IP reception under various Internet addresses at the same time When you edit the TC p
78. ogram TP By using the RVSTPSET EXE program you can enter all of the values required into the Windows NT registration database To do so follow these steps Select the Windows NT menu command Start Execute Enterc rvs system rvstpset or use Search to find the file in the rvs system directory 4 Confirm the entry by pressing the button OK The TP Setup dialog box will open Inthe Command line field you will see the start command for the communications program which is to operate as a transaction program resNT R1 02 18 TP Setup TP Name program Command line fc Srvs system AWSCOM EXE Local LU Alias LU name Do ess Activate transaction mode 44 cos 4 Inthe Local LU Alias field enter the local LU name which you defined during configuration of the SNA server 4 Confirm the entry by pressing the button OK The RVSTPSET EXE program then registers the communications program in the Windows NT registration database Restart Windows NT in order for the new entries to take effect In order to have the program start as a transaction program you have to carry out the following steps Execute the View Parameters menu command in the rvsNT Administrator The rvsNT Parameter dialog window for editing the parameters then opens In order for the transaction to start automatically you have to set the value of the rvs parameter SNARCV to 1 gedas GmbH 4 rvsNT configuration msHT Parameter Paramet
79. on 15 Context menu 8 Customizing the rvs system environment 55 D Data exchange with rvsNT 10 75 Data maintenance see rvs database maintenance Details area Display completed 80 file being received 80 file completely received 80 files sent 80 Monitor Log Book 51 not yet completed 80 received files 80 update 80 Documentation 5 E EBCDIC 27 EERP 103 s User Manual rvsNT Rev 08 01 99 gedas GmbH 13 Appendix Index EERP IN 28 EERP OUT 28 End to End Response 28 32 104 Equipment see System requirements Export jobstart entries 71 Station 71 F Filing directory 55 Follow on processing file reception 62 file sending 66 restore 3 Save 71 FTP see ODETTE File Transfer Protocol Function key see Quick Reference Function test 59 activating the local station 60 sending a file to yourself 59 Import jobstart entries 73 Station 2 Information flow 11 Installation 15 directory 8 Interface batch 89 programming language C 90 Internal communication 10 ISDN connection 30 39 46 ISDN interface 15 J Jobstart after Send Attempt 67 JS create 67 delete 69 display 67 modify 68 L List of all Monitor parameters 95 Log book 51 55 91 Log file rlco log 54 rlog log 54 105 User Manual rvsNT ristat log 54 Log file administration 54 LU6 2 communication 9 12 15 16 35 set
80. onitor Database Window cs Monitor Log lt MO STARTED rpmoms New console RYSCNS started lt INIT CMD gt rpm Reading initial commands lt OK_READ gt R SCNS cleanup days 3 ss yes lt CLNUP_DEL 35 gt Cleanup of RVS data base purge all SendStatistics with DTEND lt 1997 09 18 12 47 lt CLNUP_START gt Cleanup of RV5 data base purge all commands with DTDONE lt 1997 09 18 12 47 22 lt CLNUP_NONE gt Cleanup of RYS data base ended there are no commands to be purged lt XMT START gt MasterTransmitter started Press F1 to get help Setting up rvs 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 In order to do so open the Stations Table in the rvsNT Administrator using the View Stations menu command The Stationtable for administering the partner stations then opens The table contains four sample stations after rvsNT has been installed Y rysNT Administrator File Edit View Monitor Database Window local station my Odette ID ENABLED remote station v SNA partners O ENABLED remote station vw tep partners Od ENABLED remote station v my partners Od ENABLED Press F1 to get help NUM 4 s User Manual rvsNT Rev 08 01 99 21 gedas GmbH User Manual rvsNT Stationtable LOC is the local station If you have selected your own station I
81. ons are ExchangeBuffer maximum size of the ODETTE transmission buffer in bytes Priority of operator commands D German E English O no monitoring 1 minimal line driver more detailed 3 more detailed for all like 3 with detailed data on line level 7 like 4 with Hex data dump 1 100 O no transmitters 0 N 0 X 25 ISDN not active 1 100 1 N NOLIMIT or O no limitation en NOLIMIT or 0 no limitation 1 N O no monitoring 1 minimal only names detailed detailed for all Gai 1 100 10 10 4096 5 0 X 25 ISDN not active 20 NOLIMIT NOLIMIT 99 96 gedas GmbH ORETRY Odette error group for which the order is retried after an abort specification is in the form of a bit field and in this connection the bit position is allocated to the error code 1 Retry is executed O Retry is suppressed The bits correspond to the following errors e 1 Transmission was interrupted 3 File could not be read with repetition allowed e 5 Error code Unspecified reason in the SFNA with repetition allowed e 6 Error code File size is too big in the SFNA with repetition not allowed e 7 Error code Unspecified reason in the SFNA with repetition not allowed 9 Error code Invalid record count in the EFNA e 10 Error code Invalid byte count in the EFNA e 11 Error cod
82. ontains are executed Carry out the following steps if you want to permanently modify one or more monitor parameters Open the file c rvs init rdmini dat Click the Monitor Parameter icon in the rvs file The file contains the predefined operator commands which the Monitor executes at each new start Commands for modifying the monitor parameters begin with setparm Comment lines begin with gedas GmbH 4 rvsNT configuration Edit the file in accordance with your requirements A complete list and description of all the monitor parameters can be found in Appendix Monitor parameters Save the file and close the text editor Display the Monitor Log window in the rvsNT Administrator by using the View Monitor Log menu command Stop and start the Monitor 4 Read the action messages They begin with A Each setparm command in the initialization file triggers a parameter modification when the Monitor is restarted NOTE Statically modify only those parameters which permanently differ from the rvSNT standard setting Example You want to monitor a transmission line temporarily in order to trace errors In order to do so modify the LITRACELEVL parameter by using the View Parameters menu command and reset it again using this command after you are done with monitoring Please refer to the rvsNT Operator Guide and Reference Manual for more detailed information in particular on additional operator commands and op
83. or incoming calls on the X 25 ISDN line This is how you set the rvsNT to receive calls automatically via X 25 ISDN Execute the View Parameters menu command in the rvsNT Administrator The rvsNT Parameter dialog window for editing the parameters then opens In order for X 25 ISDN reception to start automatically when the Monitor Starts you have to set the value of the rvs parameter MAXX25RCV to 1 Double click MAXX25RCV to select the parameter in the parameter list Enter the desired value 1 into the input field Confirm your entry with Apply Use Close to exit the parameter list Activate the parameter by stopping and starting the 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 incoming calls gedas GmbH 4 rvsNT configuration Changing a partner station Set status Activate Set working Stop working NY If you want to change an existing partner station Select the station to be changed in the window Station table Execute the menu command Edit Edit The dialog window Properties of station will open You may now edit all the station parameters with the exception of the station ID For further information read the chapter entitled Meaning of rvs parameters Confirm the entries by pressing OK NOTE In order to assign a new station ID you have to set up a new Station You
84. our entries with OK gedas GmbH 5 rvsNT operation Delete JS If you want to delete a JS Select the entry to be deleted in the Jobstart after Send Attempt window Execute the menu command Edit Remove rvSNT will then ask you to confirm your delete command rmsNT Administrator EZ AN Do vou really want to detente jobstart entry 0 7 If you are sure you want to delete the entry confirm the command with Yes With No you cancel the operation without deleting the entry s User Manual rvsNT Rev 08 01 99 69 gedas GmbH User Manual rvsNT rys database maintenance 70 Cleanup Monitor Parameter The larger the rvs database the more time Is required by the rvs Monitor and for user access In order to get the best possible performance rvsNT operates with an automatic cleanup function which removes information on completed or deleted transmissions from the database after a certain retention period Information about completed actions e g transmissions are deleted immediately from the database by default It is controlled by parameter CMDDELETE 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 You can determine the information retention time by using the operator command cleanup The general command is cleanup days n ss yes no n represents the period in units of 24 hours with yes or no you specify whethe
85. playing messages c rvs system rvscns exe and entering operator commands It is replaced by the window Monitor Log in the rVSNT administrator For users of earlier versions of rvsNT and those who use rvs on other platforms You can find more information in the rysNT Operator Guide and Reference Manual c rvs system RVSDBDNT exe lt User Manual rvsNT Rev 08 01 99 13 gedas GmbH User Manual rvsNT Program Function Information Link control panel command or Start Run Dialog rvs Dialog Control Panel for creating and c rvs system rvsdia exe receiving send orders It is replaced by rvsNT For users of earlier versions of rvsNT and those who use rvs on other platforms You can find information in the portable rvs User Manual stop rvs Stops the rvs Monitor c rvs system rvsstop exe Monitor 14 gedas GmbH 3 Installation of rvsNT 3 Installation of rvsNT System requirements You need the following equipment in order to operate rvsNT PC i386 platform at least 32 Mbytes working memory and 20 Mbytes of free memory on the hard disk Operating system Microsoft Windows NT version 4 0 4 Communications line based on ISDN TCP IP X 25 or SNA LU6 2 4 Hard disk storage for data transmission Recommended value at least 2 x size of the files to be transmitted Connection type installation ISDN interface If you want to use rvsNT to exchange data via the ISDN network you nee
86. r the Odette transfer parameters NK Line Type Path by which the station is reachable RT Routing Parameters you need if you want to send files to an indirectly reachable station via your neighbour node LU SNA LU6 2 Details for the respective connection mode selected in the XP X 25 ISDN NK Line Type tab TC TCP IP Use the key combination CTRL TAB or the mouse to click on the other tabs and enter the remaining parameters of the new stations For more information refer to the following chapter Meaning of rvs parameters Confirm the entries by pressing OK s User Manual rvsNT Rev 08 01 99 23 gedas GmbH User Manual rvsNT Meaning of rvs parameters Stationtable ST serececnenssncecencesssensessscnensees PR 1 Station ld Station name Phone Telephone number en ee of contact person Identity marker Core Hep The ST tab uses three parameters to identify a station Parameter Meaning Database tab ST Station parameter station ID 16 characters Station Station name optional Enter a descriptive name STATNAME Partner station identity marker consisting of up to SID name for the station so that the station will be easily recognized by the user Optional telephone number for the contact person PHONE at the partner station NOTE After confirmation with OK you are no longer in a position to change the station ID In order to assign a new station ID you ha
87. r you want to delete the associated entries in the transmission statistics as well You may indicate the command as a single operator command or integrate it into the c rvs init rdmini dat initialization file We recommend that you edit the initialization file As a standard the file contains the entry cleanup days 3 ss yes That means that the completed or deleted transmissions remain stored for 2 hours in the rvs database until the rvs Monitor deletes them along with the transmission statistics Carry out the following steps if you want to modify the parameters Open the file c rvs init rdmini dat Click the Monitor Parameter icon in the rvs folder 4 Search for the cleanup entry and modify it to meet your requirements Save the file and close the text editor 4 Stop the rvs Monitor and then start it again in order to activate the modified settings gedas GmbH 5 rvsNT operation Backup rvsNT supports several methods of securing data With three independent backup procedures you can save the stationtable the user table together with the tables for resident actions and the entire database saving the In order to save the stationtable with all the parameters for partner stations Stationtable Start the rvsNT Monitor Open the Stationtable window with the View Stations menu command Execute the menu command Edit Export Station Table The Select Backup File dialog window then opens and displays the files
88. ransmission was not successful the monitor must arrange for a restart of SK and this is again depending on the cause of the error queued or forwardable If the transmission was successful the SK is transformed into the status pending and in this connection the SE remains in this status As soon as acknowledgement in accordance with OFTP End to End Response is received by the sender from the receiving partner station SK and SE change to the status ended Receive file The beginning of the reception of a file is noted in the database as an information entry IE with the status pending The end of the reception is noted in the database by transforming the IE into the status queued The files received are held in the buffer on a temporary basis to begin with The monitor registers the IE and initiates the data transfer by creating an information assignment IZ The IE is then given the status pending Processing the IZ consists of copying the temporary file received into the user data directory c rvs usrdat or starting a resident receive entry RE if applicable When this has been successfully performed the IZ receives the status ended Then an acknowledgement send entry QS is generated for the successful file transfer OFTP End to End Response and the IE is also transformed into the status ended Processing the QS is effected similar to the processing of a SK Once processing assi
89. rder S O SE Send entry laf p e SK Send command ata p QE Acknowledgement receipt sent by recipient EE IE Information receipt q f p e IZ Information assignment q f p e QS Acknowledgement transmission back to sender q f a i p 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 E no event q queued not yet processed by Monitor f forwardable waiting for transmission process p pending waiting for completion e ended a active 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 18 gedas GmbH 6 Data exchange with rvsNT Overview of the rvs Database send file When a send order is compiled a send entry SE is compiled in the database with the status queued The rvs monitor analyses this entry generates a send command SK also with the status queued and transforms the SE into the Status pending At the time to send usually immediately the SK is given the Status forwardable and at the same time the MasterTransmitter which coordinates the transmission is activated This starts a send process and the SK now has the status in transit If the t
90. rrently displayed record If you add a new record then rvsNT will automatically assign a number for the recipient NOTE 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 refer to the chapter entitled 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 s User Manual rvsNT Rev 08 01 99 39 gedas GmbH User Manual rvsNT Parameter Meaning Database tab XP X25 parameter Number May only be selected at the local station Number N for differentiating the various recipients through which the local station can be reached Each number has one set of XP parameters standard 0 Card type Specifies which hardware is to be used for the connection Influences the parameter LINK Port May only be selected if the card type is an X 25 card Specifies the X 25 port Influences the parameter LINK standard 1 Card Only applies for X 25 Teccom and ISDN cards number specifies the number of the card in the PC Influences the parameter LINK standard 0 standard which ISDN standard is used 1TR6 German national standard E DSS1 EURO ISDN Standard E DSS1 Link Link name determines the type of connection LINK within your computer Is determined by the port
91. s Rechner Verbund System rvs meaning Computer Network oystem The rvs program systems are used throughout European automobile industry rvsNT is the product for Windows NT Features 4 You can exchange data with any partner whose software supports ODETTE FTP 4 rvsNT supports a broad range of connection types via SNA LU6 2 X 25 ISDN and TCP IP 4 With the rvs C interface and batch interface you can invoke services from within application programs Performance Data compression increases the efficiency of data throughput 4 rvsNT automatically repeats the transmission after an unsuccessful connection attempt or disruption of a connection In the event of disruption rvSNT only transmits the parts of a file which have not yet been transmitted Therefore it is suited particularly to transmit large quantities of data even under difficult conditions User comfort Each user may modify his screen in accordance with the language desired English German He will also receive any messages in this language 4 Transmissions may be made at any time Thus for example you can trigger transmission at night when telephone rates are less expensive 4 The user can use the serialization function to specify the order of data transmission within a particular group Administration rvsNT automatically converts the text file code EBCDIC and ASCII in accordance with the respective receiving system You may also specify code conversion yourself 4 T
92. sages BB command 0 no 1 yes Priority of user messages BB command 1 100 Reserved is not used by rvsNT Time waited before and OFTP Change Direction 0 100 message is sent after a file has been received specification is in seconds Delete each command and its associated entries as 0 no 1 yes soon as it is executed or cancelled Console Messages A actions Displays inMonitorLog window B security and at the operator console E error information L line driver messages O Odette messages reports DTCONNnn FORCEDEND IECPRIO Critical errors W warnings continuation line Date TimetoConnect Format Time interval for a specific new attempt after unsuccessful connection nn successive number of attempts lf no data is indicated for a particular number the Monitor will use the next smallest number Example DTCONNO1 00 00 00 00 02 00 Halting of the Monitor with Monitor Stop Immediate O no 1 yes cancellation even if the transmitter and receiver are active NOTE If the parameter is set at 1 the Monitor will immediately stop Priority of information receipt commands 1 100 Execute initialization commands when rvs Monitor is 0 no 1 yes Started again file c rvs init rdmini dat Increasing time DD MM YY HH MM SS lintervals and minute shifts for long periods 0 no lt User Manual rvsNT Rev 08 01 99 gedas GmbH 95 User Manual rvsNT KEEPDAYS e
93. t lines begin with Use the at the end of a line if a command covers more than one line 1 language Uses the language specified as Language for the output of messages Values E English D German quiet mode Suppresses the echo on the console during execution of the command The rvs batch interface acknowledges each command with a message indicates success or error during execution of the command If you call up the batch interface without an input file you can cancel the execution at any time by pressing Ctrl C User Manual rvsNT Rev 08 01 99 89 gedas GmbH User Manual rvsNT Mii CAM INNTAS vstem32temd exe Microsoft lt R gt Windows NT lt TM gt Copyright 1985 1996 Microsoft Corp HEin2ryushat rusNT RZ2 03 01 0A Cc gedas 1999 All rights reserved 1999 88 65 14 15 51 I CND EXECUTED gt Command START USER successfully exe cuted SEND C DSMN c 2 temp readme txt CSID LOC DSNNEW new txt gt 1999 88 65 14 15 59 gt gt gt SEND Z C DSH c temp readme txt SID LOC DSNNEW neuw txt gt 1999 88 65 14 15 59 I lt ChD_EXECUTED gt Command SEND CREATE successfully ex ecuted 1999 88 85 14 16 27 I lt CMD_EXECUTED gt Command END successfully executed Hz gt The command scope and syntax are the same as for the C interface User Call Interface For further information please refer to the manual entitled portable rvs User Manual rvs User Call Interf
94. ted and the mode of operation The rvs Monitor performs the following tasks Execution of commands which are entered by the operator search of the database for send commands to be processed starting transmissions Repeating unsuccessful transmissions o gt 4 Issuing of messages to the rvsNT administrator display in Monitor Log window 4 Starting follow on processing for incoming files s User Manual rvsNT Rev 08 01 99 11 gedas GmbH User Manual rvsNT The rvs network Partner platforms 12 Based on the portable rvs rvsNT makes it possible to reach a number of communication partners on a variety of platforms gedas offers programs for data communication using rvs for the following platforms 0S 2 Windows NT IBM AS 400 HP 9000 SINIX LINUX IRIX Solaris MVS LU6 2 X 25 ISDN TCP IP LU6 2 X 25 ISDN LU6 2 X 25 ISDN TCP IP LU6 2 X 25 ISDN TCP IP LU6 2 X 25 ISDN TCP IP Stratus Continuum X 25 LU6 2 X 25 ISDN TCP IP ISDN TCP IP ISDN TCP IP ISDN TCP IP LU6 0 LU6 2 X 25 ISDN TCP IP rvsX LU6 2 communication is a modification by VW of the ODETTE File Transfer Protocol rvsX rvsMVS X 25 1SDN TCP IP LU6 2 Other Products with ODETTE FTP rvsNT is capable of operating on a Windows NT Workstation or a Windows NT Server gedas GmbH 2 What is rvs
95. the sender SID Station ID of the recipient DSNTEMP Name of the temporary batch file lt User Manual rvsNT Rev 08 01 99 103 gedas GmbH User Manual rvsNT 12 Appendix Glossary 104 VDSN Virtual Dataset Name ODETTE expression for the name of a file transferred with OFTP EDIFACT Electronic Data Interchange for Administration Commerce and Transport ENGDAT Engineering Data ODETTE recommendation Engineering Data Message ENGDAT message Message type designed by the ODETTE group and recognized as an European norm The ENGDAT message is used to transfer groups of CAD CAM files and binary files as well EERP End to End Response ODETTE expression for the acknowledgement at the end of an outgoing transmission ODETTE association The organization of European car manufacturers for standardization of data exchange SID rvs expression for station identification VDA Verband der Deutschen Automobilindustrie German Automobile Industry Association gedas GmbH 13 Appendix Index A Acknowledgement at reception 28 at sending 28 Activating transaction mode 44 Administrator exit 56 Start 21 ASCII 9 27 Backup 48 71 write to log 56 Batch interface 6 11 13 89 Blocks at reception 27 at sending 28 C C interface 90 Cleanup see rvs database cleanup CMDDELETE 70 CNSMSGS 54 Communications program registration 44 Connection type 30 installati
96. timizing rvsNT s User Manual rvsNT Rev 08 01 99 53 gedas GmbH User Manual rvsNT Log file administration several log files are written during rvsNT operation Their size and number can be controlled by means of monitor parameters The Monitor Log Monitor Log shows the file c rvs temp rico log It is regenerated with file rlco log every new start of the rvs monitor Its maximum size is restricted by means of the monitor parameter RLCOMAXSIZE Only those message classes Specified in the monitor parameter CNSMSGS are written to this file The permanent All rvs Log messages regardless of parameter CNSMSGS are written to the Monitor Log file file c rvs db rlog log Their existence is not restricted by a new start of the rvs rlog log Monitor Their maximum size is restricted by the parameter RLOGMAXSIZE When the file reaches this size it is renamed by replacing the file extension by an active counter Then a new file c rvs db rlog log is generated and updated The maximum number of generations can be restricted by the monitor parameter NUMRLOGS The statistics file Statistical information is written to the file c rvs db rlstat log Its contents can ristat log be shown by means of View Statistics lts maximum size is restricted by the parameter RLSTATMAXS TI When this size is reached the file is renamed by assigning an active counter as a file extension and creating a new file c rvs db rlstat log The maximum number of gener
97. tion to Station LOC ended lt DISCONNECT Connection to Station LOC ended 4 Press F1 to get help User Manual rvsNT Rev 08 01 99 63 gedas GmbH User Manual rvsNT Create RE If you want to start a program when a file arrives do the following Execute the menu command View Add The Resident Receive Entries dialog window then opens Resident RecerveEntry Station Name of sending Station virtual Datazet H ame i new Dataset N ame Search Replace Disposition Recordhandling C Replace Dataset f Keep Standard te New Dataset Delete Ignore Dataset Timestamp To CodeConyversior none Ascii gt Ebedic Ebedic gt Ascii U Table able Seach Program Search Comment TT cows to Enter the station from which you expect to receive the file The dialog field station is pre assigned with This means that the RE is valid for the reception of files from all stations Inthe virtual Dataset Name field enter the file or the file specification for which the RE is to apply Virtual Dataset Name is the file name that is used for the Odette transfer and has to be agreed upon by both sides If you want to change the file name after it has arrived enter the new file name inthe field new Dataset Name Disposition determines whether the received file is deleted or kept after reception and execution of the RE 64
98. tner does not expect EERP File reception ends with successful transmission Do not acknowledge reception IMMEDIATE Prepare acknowledgement after successful file reception Establish connection if there is no connection to the partner and send EERP to the partner NORMAL Prepare acknowledgement after Successful reception of a file send EERP only if a connection to the partner still exists otherwise at next connection Standard IMMEDIATE 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 of error select large values for reliable data lines in order to use the line quality for greater transmission speeds select small values for poor line quality in order to minimize the time required for repeated data transmission 20 gedas GmbH Neighbour node NK Transmission protocol Connection type Transmission protocol Connection type for self test Configured receiver Simultaneous connections 4 rvsNT configuration Properties for station RST Remote Station a RT Routing LU SNALUB2 xP x25 TC TCRAP Odete FTP F j Automatic dialling Connection priority The NK Line Type tab contains information about the path via which the partner station is to be reached For the local station it is possible to specify additional parameters
99. up reception type 44 Main directory of rvsNT 55 MAXX25RCV 39 Meaning of rvs parameters 24 Monitor parameters CNSMSGS 54 dynamic modification 51 NUMRLOGS 54 NUMRLSTATS 54 RLCOMAXSIZE 54 RLOGMAXSIZE 54 RLSTATMAXSIZE 54 Static modification 52 Network requirements 5 NUMRLOGS 54 NUMRLSTATS 54 0 ODETTE File Transfer Protocol 9 26 30 organization code 26 P Parameter list 52 95 Parameters dynamic modification 51 LU Parameters LU6 2 protocol 35 NK Line Type Neighbour node 29 OP ODETTE parameters 25 RT Routing parameters 32 Static modification 52 Station 21 ST Station Station parameters 24 TC TCP IP parameters 37 XP X 25 ISDN parameters 39 Partner platforms 12 Partner station activate 47 changing 47 Performance see rvsNT Features Predefined operator commands 52 Program environment 13 Properties of station 22 106 Q Quick Reference 5 R RE create 64 delete 66 display 63 modify 66 Recipient number 38 39 Recipient number 3 Resident job start entries 6 Resident receive entry 63 Restore see Stationtable Restore see Usertable Restore see Follow on processing Restore see rvs database rico log 54 RLCOMAXSIZE 54 rlog log 54 RLOGMAXSIZE 54 ristat log 54 RLSTATMAXSIZE 54 Routing 32 Routing table RT 32 rvs database cleanup 70 delete 74 directory 55 initialize 74
100. urself from your workstation environment To begin with you do not need a functioning network connection in this respect because when sending a file to yourself the rvs monitor copies the individual data records internally You can execute a line test by activating the local station Sending a file to If you want to test the function of rvsNT execute these steps yourself ike 4 Startthe rvsNT Administrator program inthe rvs file wvsNT Start the rvs Monitor if it has not already been started Administrator ge Start the rvsNT program in the rvs file 2 Es waT The rvSNT window then opens and displays the list of files which have not yet been sent 4 Create a new send entry with New Send Entry The Choose file to be sent dialog box will open Select any file and confirm your selection with Open Example c rvs system readme txt The New Send Entry dialog window then opens and displays the file name selected in the File field 4 Enter the station code for your station inthe Station ID field OF Use Select to open the Select Station window and select the Station code Example LOC LOC is the standard setting If you want to send the file under a different name then enter the new file name into the New File Name field Confirm the entries by pressing OK s User Manual rvsNT Rev 08 01 99 59 gedas GmbH User Manual rvsNT Activating the local station 60 The send entry for transmiss
101. ust work under a user authorized to do so In order to make this possible carry out the following steps 4 Click the Startup Mode button The Service dialog window opens Activate in the Log on as field the This account key and then the button to select an appropriate user After selecting a user enter the password twice and acknowledge with OK The service will now be assigned to this user Starting the rvs Press the Start button Windows NT will now try to start the service If the Monitor for the attempt is successful the rvs Monitor status will change to started first time The entry is tvs Monitor Started Automatic f s User Manual rvsNT Rev 08 01 99 19 gedas GmbH User Manual rvsNT License key modification Update license key A a AM Get Machine ID 20 After initial installation rvsNT can be operated for test purposes without a license for a limited period of time If you are satisfied with rvsNT and would like to continue working with it contact your sales representative or rvs Support Tel 030 399 71 777 FAX 030 399 71 994 E Mail rvs service gedas de There you may obtain the desired license 4 Start the Get Machine ID program inthe rvs file The program now displays a three or four character machine identification number on the screen 4 Inform your sales partner of the machine identification number and he will Send you a license key by fax or preferably by e mail The l
102. ve to set up a new station Station name and telephone number for the contact person are optional Do not enter the telephone connection for communication here but depending on connection mode in one of the tabs LU TC or XP CAUTION Never delete the local station If the name of the local station is to be changed the rvs database must be deleted and set up again with the new name for the local station 24 gedas GmbH 4 rvsNT configuration ODETTE goscccesosossceseseoocseosssossssososossosososoosesesosesessesesossososososg parameter oP Ea Odette code Odete 00013003210FIRMA AL3UK Send password Password Receive password ___ Receive KO Advanced Corcel ee The OP Odette Parameters tab contains information which is required by rvsNT for ODETTE File Transfer lf you access the partner station via a neighbouring station connection type Routing you do not have to enter the parameters for passwords This information has already been entered at the neighbouring station In this case rvSNT ignores the existing entries during the communication process Parameter Meaning Database tab OP Odette Parameters parameter Odette Id In contrast to the station ID which only has to be ODETTEID unique on your computer the ODETTE ID isa worldwide unequivocal identification of the partner or your own station if ODETTE File Transfer Protocol is used The ODETTE ID consists of 25 characters inc
103. vsNT Depending on the rvsNT display mode the entry list will display the list of files which have been sent or received The details area provides you with more detailed information on the currently selected file file name sender or recipient local name or original name and status of the file In the additional information you can see the currently transmitted data quantity block size file format and the number of dialling attempts only for 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 rvsNT Log Book file c rvs temp rlco log The rvs Monitor logs the transmission time Use the push buttons under the menu line to quickly execute the most frequently used commands The push buttons change in accordance with the display mode status display The status field displays the progress of the send order selected or that of the order arriving send Inthe send or completely sent display modes the status field shows three events SE SK QE see table below Receive Inthe receive or completely received display modes the status field shows three events IE IZ QS see table below Sample send order Status qq SEC SRS op OES s User Manual rvsNT Rev 08 01 99 77 gedas GmbH User Manual rvsNT Abbr Event status Possible values status DO Sendo
104. y errors NOTE Error messages begin with E and are written in red lf you want to test the function of the line components execute these steps To ensure the function of the network line follow the instructions in the chapters 3 Installation of rvsNT Connection type installation and 4 rvsNT configuration Reception type setup Open the station table with the menu command View Stations The Station table window to administer the partner stations opens 4 Select the local station Execute the menu command Edit Activate The monitor reads the operator command and executes it gedas GmbH 9 rvsNT operation The window Monitor Log shows the activities of the rvs monitor The message O lt CONNECT gt Sender Connection established with station LOC with credit 10 Odette buffer 2048 is shown e pesMT Administrator File Edit View Monitor Database Window 7 0K READ CALL OUT lt 0K ACTIVATE INCOMING CALL lt TCPIP READY CONNECT CONNECT IND lt DISCONHECT lt DISCONHECT R SCNS act sid umr outgoing call to SID UMPF connect to station UHR Incoming call received UMR 156 TCP IP Receiver ready to accept incoming calls Fort 4222 Sender Connection with Station UMR with Credit l10 Odette Butfer el Responder Connection with Station UME with Credit 10 Odette Buffer Connection to Station UME ended Connection to Station UME ended E HI MOMO Y

USER MANUAL - ServiceNet

Contents

Download Pdf Manuals

Related Search

Related Contents