VS TCP/IP Services Release 1.85.00 Inbound TELNET Services Component Customer Software Release Notice Copyright, Wang Laboratories, Inc., 1998 Disclaimer of Warranties and Limitation of Liabilities ______________________________________________________ The staff of Wang Laboratories, Inc., has taken due care in preparing this document. However, nothing contained herein modifies or alters in any way the standard terms and conditions of the Wang purchase, lease, or license agreement by which the product was acquired, nor increases in any way Wang's liability to the customer. In no event shall Wang or its subsidiaries be liable for incidental or consequential damages in connection with or arising from the use of the product, the accompanying document, or any related materials. Software Notice _______________ All Wang Program Products (software) are licensed to customers in accordance with the terms and conditions of the Wang Standard Software License. No title or ownership of Wang software is transferred, and any use of the software beyond the aforesaid license, without the written authorization of Wang, is prohibited. CONTENTS PREFACE CHAPTER 1 INTRODUCTION Hardware and Software Prerequisites ........................ 1-1 CHAPTER 2 ENHANCEMENTS AND SPECIAL CONSIDERATIONS Enhancements ............................................... 2-1 Considerations and Restrictions ............................ 2-2 CHAPTER 3 PROBLEMS CORRECTED CHAPTER 4 MEDIA CONTENTS CHAPTER 5 SOFTWARE INSTALLATION AND OPERATION Software Installation ...................................... 5-1 Software Operation ......................................... 5-3 APPENDIX A CONNECTING TO A REMOTE VS Starting the Inbound TELNET Server at the Remote VS ........ A-2 Logging on to the ITS from your Local Non-Wang System ...... A-2 VT100 Keyboard Mapping/Coding for Local Non-Wang Terminals . A-4 Mapping VS Functions to Your Local Wang Terminal ........ A-5 Exiting a TELNET Service ................................ A-6 TABLES Table 4-1 Media Contents ............................................. 4-2 Table A-1 VS Functions, VT100 Keypad Keys, and Codes ................. A-4 Table A-2 VS Control Keys and VT100 Sequences ........................ A-5 iii PREFACE This Customer Software Release Notice (CSRN) provides information specific to Release 1.85.00 of VS TCP/IP Inbound TELNET Services Component. This notice is intended for system and networking administrators who will install and maintain the Release 1.85.00 VS TCP/IP Inbound TELNET software. It gives an overview of the product, discusses its hardware and software requirements, explains enhancements since the previous release, discusses special considerations for its use, and lists the product's media contents. Finally, there is a chapter about software operation. The following publications are referenced within this CSRN or are suggested as prerequisite reading. - VS TCP/IP Stack, Release 1.8 Customer Software Release Notice - VS TCP/IP 1.8 Enhancements (715-5292) - VS TCP/IP Configuration Guide, Release 1.8 (715-0900C) Other product names mentioned in this CSRN may be trademarks or registered trademarks of their respective companies. iv CHAPTER 1 INTRODUCTION The VS TCP/IP Inbound TELNET Services (ITS) Component is part of the VS TCP/IP Services, Release 1.85 product. Inbound TELNET Services allows remote TCP/IP end users the ability to TELNET into a VS system and access the VS resident Data Processing applications. The remote user must use the VT100 emulation over the TELNET session. VS TCP/IP Inbound TELNET Services is year 2000 compliant. HARDWARE AND SOFTWARE PREREQUISITES The VS TCP/IP Inbound TELNET Services software is customer installable. Before the software can operate, however, the components listed in this section must be installed. This version of the Inbound TELNET Services component requires that VS TCP/IP Stack, Release 1.85 or later be installed first on the host system. For hardware and software requirements, refer to the VS TCP/IP Stack, Release 1.85.00 CSRN. 1-1 CHAPTER 2 ENHANCEMENTS AND SPECIAL CONSIDERATIONS This chapter lists enhancements made to this version of the VS TCP/IP Inbound TELNET Release 1.85 software and discusses special considerations that apply to the configuration, operation, and administration of systems running the VS TCP/IP Inbound TELNET Services. The enhancements are the major improvements that have been made to the product since the previous release, the special considerations are notes of special interest, and the restrictions are descriptions of either hardware or software limitations. ENHANCEMENTS The following section lists the enhancements made to Release 1.85.00 of VS TCP/IP ITS software. VS TCP/IP Inbound TELNET has been compiled and linked using year 2000 compliant compilers and linkers. The following section lists the enhancements made to Release 1.80.00 of VS TCP/IP ITS software. 1. International character support via the file INTRITS. See VS TCP/IP 1.8 Enhancements for more details on how to implement this feature. 2. VS TCP/IP 1.8 allows the installation to increase the number of 802.3 devices from the default of two. This provides the ability to spread the Inbound TELNET workload over multiple ILC devices. See the VS TCP/IP 1.8 Configuration Guide for additional information. 3. VS TCP/IP 1.8 allows the installation to run multiple instances of the Inbound TELNET task concurrently. Up to 6 instances of the Inbound TELNET task are supported concurrently. 4. The recommended number of Inbound TELNET sessions supported is increased from 6-10 to 16-32. This support assumes that the installation is running with multiple devices configured and multiple tasks. 2-1 CONSIDERATIONS AND RESTRICTIONS This section lists restrictions and special considerations that apply to the configuration, operation, and administration of the VS TCP/IP Inbound TELNET software, Release 1.85.00. The considerations are notes of special interest. The restrictions are descriptions of either hardware or software limitations. 1. Though a single instance of the background ITS task may support up to 32 sessions, the reliability and performance is unpredictable beyond 6 - 10 sessions. 2. User sessions are placed in SUSPENDED state on abnormal termination of either the TCP/IP stack or the ITS background tasks. 3. The cursor is left in various positions on the screen when the keyboard is locked. 4. The VS Inbound TELNET Service is CPU intensive. Please monitor when running with other CPU intensive applications. 5. Keep in mind that when you are logged on to a remote VS system from a non-Wang VT100 terminal, it is important that you send the correct VT100 codes and sequences for particular VS functions. If you are running a VT100 emulator, you should map the codes and sequences to the appropriate VS keys. Refer to the section entitled VT100 Keyboard Mapping/Coding for Local Non-Wang Terminals for information on the VS functions and their equivalent VT100 keys, as well as the code/sequence that must be generated for each VS function. 6. With this release of Inbound TELNET Services you may have multiple Inbound TELNET tasks running. Adequate initiators need to be created for this. 2-2 CHAPTER 3 PROBLEMS CORRECTED The following problems are corrected in Release 1.85.00 of VS Inbound TELNET service. None The following problems are corrected in Release 1.80.00 of VS Inbound TELNET service. TELNET service. Internal TCP APIs, which correct a buffer management problem when data is transferred, have been linked into this release. Internal When 10 inbound sessions are active memory corruption does not take place. Internal A new version of the Connection Layer Interface (CLIF - 3.00.31) was linked into @ITS@. 3-1 CHAPTER 4 MEDIA CONTENTS This chapter provides a list of the files contained in Release 1.80.00 of the Inbound TELNET Services Component. The software is available on the following media types: Designation Media Type (-7) 9-track tape (-G) Streamer cartridge (-Q) 4 mm dat Table 4-1 lists the media contents. The release tape contains the library @ITSINST, which contains the all of the software files. In the table, Protection Class represents the value of the file on the tape. Changes to the protection classes of these files may affect the operational characteristics of the Inbound TELNET Services Component. To verify the version numbers, run DISPLAY and specify the appropriate file, library, and volume. The version number and date will be visible in the first or second records displayed. 4-1 Table 4-1. Media Contents File Version Description --------------------------------------------------------------------------- Library = @ITSINST $ITS$ 01.85.00 Run Procedure @ITS@ 01.85.00 Inbound TELNET Services (ITS) executable task INSTALL 01.85.00 ITS INSTALL Procedure INTRITS None ITS International file INTRITSS None ITS International file source ITSCNTL 01.85.00 ITS Diagnostic Utility ITSSTART 01.85.00 ITS Startup Procedure ITSSTOP 01.85.00 ITS Shutdown Procedure MESSAGE 06.40.09 Inter Task Messaging Module Library = CSRNLIB ITS 01.85.00 VS TCP/IP Inbound TELNET Services CSRN --------------------------------------------------------------------------- 4-2 CHAPTER 5 SOFTWARE INSTALLATION AND OPERATION SOFTWARE INSTALLATION The VS TCP/IP Inbound TELNET Services, Release 1.80 software is customer installable. Follow these steps to install the software: NOTE: You must have VS security administrator rights on the system you are installing to. TCP/IP and Inbound TELNET Services should not be running. 1. VS TCP/IP Stack, Release 1.85.00 must already be installed on the target system. 2. Log on the system as a VS Security Administrator. 3. Mount the release tape and set the following values based on whether you received the VS TCP/IP 1.85 Upgrade or the VS TCP/IP Services package (check the tape label): Set Volume = UPGRD or SRVCE Label = NL (for TAPE) or SL (for DISK) Mode = EX 4. Run BACKUP with Function = RESTORE for the library @ITSINST on the release tape to library @ITSINST on the TCP/IP (output) volume. If you are upgrading, you may wish to backup the existing @ITSINST library. The output volume must be mounted on the system from which the BACKUP function is run. 5. When the procedure completes, dismount the input volume. 5-1 6. Run INSTALL in @ITSINST on the TCP/IP (output) volume. The following screen appears: **************************************************************** VS TCP/IP Inbound TELNET Installation Version 01.85.00 (c) Copyright, Wang Laboratories, Inc., 1998 ITS installation will proceed on volume VOLNAM when ENTER is pressed or press PF16 to exit without installing ITS **************************************************************** where, VOLNAM is the TCP/IP (output) volume name where the media files were restored. 7. If the TCP/IP (output) volume does not have enough space, cancel out of the installation process and reorganize the output volume before retrying the installation. 8. A non-adjacent system named "TERMINAL" must be configured and Logon Services must be activated through WSNEDIT. CNXMGR must also be running for ITS to work. 9. The desired number of Remote workstations must have been configured through the GENEDIT utility. (This number is in addition to the number of remote WSN workstations). 10. Create enough class Y initiators (2048 MDA size) for the Inbound TELNET Services tasks to run. 11. If you wish to increase the number of 802.3 devices reserved by TCP from the default of two, edit the $TCPIP$ procedure in library @TCPIP@ and change the first ARGV parameter (default is 2). This provides the ability to spread the Inbound TELNET workload over multiple ILC devices. See the VS TCP/IP 1.8 Configuration Guide for additional information. 12. VS TCP/IP 1.8 allows the installation to run multiple instances of the Inbound TELNET task concurrently. TCPSTART starts a single task. THE ITSSTART procedure should be used to start additional tasks. 5-2 SOFTWARE OPERATION 1. Once the prerequisite GENEDIT and WSNEDIT changes have been made, Inbound TELNET Services may be started using the ITSSTART or TCPSTART Procedure. 2. The ITSSTOP or TCPSTOP procedures may be used to terminate the background ITS tasks. Any user sessions which are still active will enter the SUSPENDED state. These user sessions must be manually logged off from the OPERATOR's screen. 3. TCPSTART starts a single instance of the ITS task. Use ITSSTART to start multiple instance of Inbound TELNET Services. ITSSTART can be modified to bring up a constant number of ITS tasks by setting parameter &NBRITS in procedure ITSSTART in library @ITSINST. 5-3 APPENDIX A CONNECTING TO A REMOTE VS This chapter provides detailed information for TCP/IP users who want to use TELNET to access applications and services at a remote VS system. When you log on to the remote VS system, your screen displays the services available. These services can include the Wang Inbound TELNET Server (ITS). After you log on to a remote Wang VS system in a TCP/IP network, you can initiate an inbound TELNET session. An inbound TELNET connection means that you are using the TELNET protocol to access VS data processing applications at a remote VS host. This remote VS host service, called the VS Inbound TELNET Services (ITS), accepts the full screen VT100 (or VT100 emulation) capabilities from a variety of workstations (e.g., Wang, DEC, SUN, etc.), enabling TCP/IP users full access to VS data processing applications and services from the VS Command Processor screen. Note: The TELNET remote logon should not be confused with VS remote logon using VS Terminal Emulation (VSTE or RLOGON), a Wang Open Systems Networking (OSN) service. RLOGON allows you to log on remotely from one VS system to another VS and perform data processing functions. A-1 STARTING THE INBOUND TELNET SERVER AT THE REMOTE VS Before you can log on to the ITS task from your local workstation, the ITS background task must be running. VS system administrators who are controlling and monitoring network activity at the ITS can run three utilities, as follows: ITSSTART This procedure will submit the ITS task to a background initiator. ITSSTOP Enables you to stop the ITS background task. ITSCNTL Enables you to send instructions to the ITS background task. The ITS records all network activity in a log file. The log file is named ILOGXXXX, where XXXX can be any number in the range 1 to 9999. For example, ITS names the first log file ILOG0001 (if a file of this name does not currently exist). When you run the I option (Reset log file), ITS first closes the current log file, then attempts to create a new log file by incrementing the log file name counter by 1 (i.e., ILOG0001 closes, ILOG0002 opens). ITS log files reside in the library INTELLOG on the SYSTEM volume. If you want to disable all network logging for the ITS background task, select the B option. The remaining options (C,D,E,F,G,H) allow you to display or shut off selected message types (e.g., NAI messages, screen messages, etc.). Messages that appear on your screen are automatically logged to the active ITS log file. NOTE: By default, task start-up turns off all logging. LOGGING ON TO THE ITS FROM YOUR LOCAL NON-WANG SYSTEM When you establish a TELNET connection to remote ITS from a non-Wang system, you can log on to the remote VS host to use the available TELNET services. Once you make the connection, your screen displays Wang VS TELNET Service (Host: VSXXX) Userid: A-2 Respond to the Userid prompt by typing your user ID and pressing RETURN. Then, type your password and press RETURN. The TELNET Services screen appears. The TELNET Services screen lists the available services with a number assigned to each service. These numbers are not always consecutive. You may also find the number assigned to a service does not always remain the same. Note: If you are logging on from a VS workstation (outbound TELNET to the ITS), be sure to press PF32 (Shift/PF16) to start the VT100 emulation program before entering the service number. Select a service from the TELNET Services screen by typing the number that corresponds with the service and pressing RETURN. The remote system verifies your user ID and password and begins running the selected service. Notes: If the remote system encounters an incorrect user ID or password, and error message appears and the remote system disconnects your local system. "R" or "r" maybe entered to attempt a resumption of a previously suspended session. The user ID and password are also verified during a resume attempt. If you enter a number that is not displayed, or if the TELNET service you selected is currently not available, the following message appears on your screen: "The selected service is not available." From the TELNET Services screen, type 1 at the Enter Selection Number prompt to log on the Wang Inbound TELNET Server. Your screen then displays the message CONNECTING TO WANG INBOUND TELNET SERVER - PLEASE HOLD. When the connection is established, you can access VS data processing applications and programs from the VS Command Processor. Keep in mind that when you are logged on to a remote VS system from a non-Wang VT100 terminal, it is important that you send the correct VT100 codes and sequences for particular VS functions. If you are running a VT100 emulator, you can modify and map the codes and sequences to the appropriate VS keys. Refer to the section entitled VT100 Keyboard Mapping/Coding for Local Non-Wang Terminals for information on the VS functions and their equivalent VT100 keys, as well as the code/sequence that must be generated for each VS function. A-3 VT100 KEYBOARD MAPPING/CODING FOR LOCAL NON-WANG TERMINALS When you log on to the ITS and display the VS Command Processor screen at your non-Wang VT100 terminal, you must map the VS functions to specific keys at your terminal keyboard. If you are using a real or emulated VT100 terminal, it is important that you send the correct VT100 codes and sequences for particular VS functions. If you have difficulty getting a VS function to work, (the ITS is not responding to your key presses) contact your system administrator. You may need to modify your VT100 terminal or VT100 emulation keyboard mapping. Table A-1 lists the VS functions and the equivalent VT100 keypad keys. Table A-2 lists the VS control keys and the equivalent VT100 key sequences. Table A-1. VS Functions, VT100 Keypad Keys, and Codes ------------------------------------------------------------------------ VS Function VT100 Keypad Key Generated Code ------------------------------------------------------------------------ NEWLINE ENTER ESC O 'M' HELP KP0 ESC O 'p' PF1 F1 ESC O 'P' PF2 F2 ESC O 'Q' PF3 F3 ESC O 'R' PF4 F4 ESC O 'S' PF5 7 ESC O 'w' PF6 8 ESC O 'x' PF7 9 ESC O 'y' PF8 - ESC O 'm' PF9 4 ESC O 't' PF10 5 ESC O 'u' PF11 6 ESC O 'v' PF12 , ESC O 'l' PF13 1 ESC O 'q' PF14 2 ESC O 'r' PF15 3 ESC O 's' PF16 . ESC O 'n' ------------------------------------------------------------------------ For the VS function PF17 to PF32 and Shift-HELP/EXECUTE, precede the corresponding unshifted keys with the ESC character. If an ESC key is not available, use the Control [ sequence; either sequence generates the required ESC code (X'1B'). For example, to send a PF17 to the remote VS from your VT100, press the ESC key followed by F1. ------------------------------------------------------------------------ A-4 Table A-2. VS Control Keys and VT100 Sequences ------------------------------------------------------------------------ VS Control Key VT100 Sequence ------------------------------------------------------------------------ CANCEL Control X SHIFT CANCEL Control C TAB TAB GLOSSARY ESC Left RETURN Return INSERT ESC Right DELETE Delete NEXT ESC Down PREVIOUS ESC Up UP Up DOWN Down RIGHT Right LEFT Left BACKSPACE Backspace HOME ESC [ 'H' ERASE ESC [ 'K' BACKTAB ESC [ 'Z' REFRESH Control L ------------------------------------------------------------------------ If an ESC key is not available, use the Control [ sequence to generate the required ESC code (X'1B'). ------------------------------------------------------------------------ Mapping VS Functions to Your Local Wang Terminal If your local workstation is a Wang terminal running the VS VT100 emulation software provided with TELNET, and if you are logged on the ITS, you must map VS functions to the VT100 emulation keys on your Wang keyboard. In most cases, it is preferrable to use a Wang Open Systems Networking service called RLOGON to establish a VS-to-VS connection. Once you establish this connection, VT100 emulation is not necessary, and you are not required to map VS functions to your specific keyboard. However, if you want to establish a VS-to-VS connection over TELNET to use VS applications and services through the ITS, you must map the VS functions to your Wang keyboard. A-5 Exiting a TELNET Service You should always exit a TELNET service before disconnecting the TELNET session. For example, when you are logged on the ITS you should exit the service by pressing PF16 (LOGOFF) from the VS Command Processor to return to the TELNET Services screen. A-6