September 1994 Microsoft(R) SNA Server version 2.1 Client software for MS-DOS(R) 3270 Applet for MS-DOS +++++++++++++++++++++++++++++++++++++++++++++++++++++++++ This file tells how to use the following: * The SNA Server 3270 Applet for MS-DOS * The SNA Server Router * The new IBM(R) Client Access/400 software (in beta as of August 1994) with SNA Server software The information is organized as follows: SECTION I A. Configuring the MS-DOS-based Applet B. Using the 3270 Applet for MS-DOS C. Transferring Files with the 3270 Applet for MS-DOS SECTION II D. Overview of the SNA Server Router E. Installing Router F. Starting Router G. Modifying the Router Configuration File H. Using Default LUs Specified in the PC Support Configuration I. Removing Router SECTION III J. Working with Client Access/400 SECTION I --------- A. Configuring the MS-DOS-based Applet ----------------------------------------- The MS-DOS-based applet is provided with a default configuration that will allow it to run on most MS-DOS-based computers with VGA adapters. The default settings in the configuration are as follows: LU Name: Blank (which causes the applet to prompt for a name) Keyboard: CUSTOM KEYBOARD (that is, keyboard mapping like the 3270 Applet for Windows) Display: VGA Language: English (U.S.) Host: On at Startup Background FT: Editor/Send/Recv 4K Mouse Support: No Multifreq 1: No EMS Memory: No Multifreq 2: No You can change the default settings by using the Configuration Utility. > To start the Configuration Utility ------------------------------------ * At the MS-DOS prompt in the directory where you copied the files, type the following and then press ENTER: 3270cfg The Configuration Utility menu is displayed on the screen. You use the Configuration Utility to configure the applet to run on your system and to customize your sessions to your preferences. A.1. How to Get Around in the Configuration Utility --------------------------------------------------- You can use either a mouse or a keyboard to make selections and work within the Configuration Utility. The following table explains how to use a mouse or a keyboard. To With the mouse With the keyboard ------------------------------------------------------------ Select a field Point to the field Use arrow keys or and double-click the TAB key to move to left button (this a field and also opens the highlight it. field's menu). Change a field Select the field; Select the field; then open its menu then open its and make the menu. Or, press changes. the SPACEBAR to cycle through the possible choices. Go to (open) Select the field. Select the field; the menu for a then press ENTER. particular field Exit a menu Click the right Press ESC. (return to the button. previous menu) ------------------------------------------------------------ A.1.1. The Environment Section ------------------------------ This is the top section of the menu, containing the basic information the MS-DOS-based applet needs to connect to and communicate with the mainframe and display data on your computer screen. Startup Name The Startup Name field displays the filename used to define a particular configuration: 3270. Type this filename at the MS-DOS prompt to start the applet. Connection This field displays the type of connection the MS-DOS-based applet is using to communicate with the mainframe. The applet is using a connection to the Microsoft SNA Server. LU Name LU names identify LUs, the basic unit through which the MS-DOS-based applet establishes a session with a mainframe. Because LU names are defined at the gateway server, you must provide a name that exactly matches one defined at the gateway. Your system administrator can supply you with the appropriate LU name. It can be up to 10 characters long. --------------------------------------------------------- NOTE If you have been assigned more than thirty 3270 LUs or LU pools at the gateway (the SNA server), only the first thirty will be accessible through the MS-DOS-based applet. --------------------------------------------------------- Keyboard The MS-DOS-based applet supports several keyboard maps, as you'll see when you open the menu of available keyboards. The keyboard you choose depends on your keyboard's model (standard, enhanced, or 122-key) and the mapping you want to use. When you select a keyboard, you tell the MS-DOS-based applet which keyboard map to use. The keyboard map assigns the locations that 3270 keys will have on your keyboard. Each 3270 key is assigned, or mapped, to a key on your keyboard. With this feature, you can use a keyboard you're familiar with rather than learning new keystrokes for your workstation. Display Your display adapter determines the graphics capabilities of your PC and mainframe sessions. For information about your display type and its adapter, talk to your system administrator or check your display adapter manual. Language The default national language is English (U.S.). In addition, each language has a default MS-DOS code page and CECP mode options of Yes or No. A.1.2. The Session Section -------------------------- The Session section of the Main menu includes two kinds of sessions: PC and Host. A PC session interacts with PC applications. A Host session is a series of conversations and interactions that takes place between the mainframe and the display terminal. The sessions contain features and options that you can select and customize so that the MS-DOS-based applet meets your needs. Status: PC Session The Status feature can be set to one of three options: Concurrent, Non Concurrent, and Not Installed. Your selection here is determined by whether you want to allow PC applications to run while you're in a Host or a Notepad session, or whether you want PC applications to pause at such times. * Concurrent is the default. It allows a PC application to continue running while you're working in a Terminal or a Notepad session, or while the PC session is not in full-screen mode. * Non Concurrent suspends any PC activity while you're using a Terminal or a Notepad session. It also suspends PC activities while your computer is in windowed mode. * Not Installed means that the PC session isn't available. Status: Host Session * On at Startup is the default; selecting it automatically turns the session on when you load the MS-DOS-based applet. * Off at Startup prevents the session from automatically starting when you load the applet. Name (not modifiable) You'll see both a short name and a long name that identify each session. Type (Host only) The only available type of host session with this applet is a Terminal session. A Terminal session allows you to work in mainframe applications. Size (Host only) The MS-DOS-based applet supports several terminal model sizes. Terminal model sizes describe the ranges of horizontal rows by vertical columns displayed on your screen. Model 2 is the default with 24 rows x 80 columns; Model 3 is 32 x 80; Model 4 is 43 x 80; and Model 5 is 27 x 132. A.1.3. The Startup Section -------------------------- The Startup section contains the features you can select to be present at startup, such as which session is active and information pertinent to file transfers. Background FT This feature controls the background file transfer available to you when you run the applet. Background file transfers have the advantage of letting you work in a PC session during file transfers. You can select a buffer size of 2K, 4K, or 8K for the transfer. Multifreq 1 Selecting Yes turns on full-screen Model 5 (27 x 132) support using a multifrequency type 1 monitor and an IBM VGA adapter. Type 1 includes the NEC (R) Multisync II and 3D monitor. Note that the MS-DOS-based applet automatically supports full-screen Model 5 monitors; you don't necessarily have to turn on this option for this support. ---------------------------------------------------------- WARNING Make sure you know the type of monitor you're using before you set Multifreq 1 or Multifreq 2 to Yes. An incorrect setting may damage your monitor. ---------------------------------------------------------- Multifreq 2 Selecting Yes turns on full-screen Model 5 (27 x 132) support using a multifrequency type 2 monitor and an IBM VGA adapter. Type 2 includes the Mitsubishi(R) 1381A Diamond Scan monitor. Note that the MS-DOS-based applet automatically supports full-screen Model 5 monitors; you don't necessarily have to turn on this option for this support. Mouse Support Selecting Yes enables mouse support in the MS-DOS-based applet. This setting takes effect after you save your configuration and restart the applet. The default is No. EMS Memory Selecting Yes causes the MS-DOS-based applet to be loaded in expanded memory. This setting takes effect after you save your configuration and restart the applet. The default is No. A.2. Saving the Configuration ----------------------------- After you have performed the basic configuration procedure, you need to save the configuration. > To save the configuration --------------------------- 1. Press F10. This brings up the Save menu with the Save & Exit field highlighted. 2. Press ENTER to save your configuration. B. Using the 3270 Applet for MS-DOS ----------------------------------- The following procedures tell how to start the 3270 applet, display a session, turn host sessions off and on, and quit the applet. > To start the 3270 Applet for MS-DOS ------------------------------------- 1. Change to the directory where the MS-DOS-based applet files are stored. 2. At the MS-DOS prompt, type the following command, and then press ENTER: 3270 Now that the MS-DOS-based applet is running, you're ready to use it. Although the prompt looks like a regular MS-DOS prompt, you are now running a PC session inside the applet. The following procedures tell the key combinations used for performing basic actions in the 3270 Applet for MS-DOS. > To display a 3270 session --------------------------- * Press CTRL+ALT+SPACEBAR. If you're working in a busy mainframe environment, you might want to turn a session off to save system resources. Turning a session off allows you to end a mainframe session without unloading the MS-DOS-based applet. If the applet was configured with the host session set to Off at Startup on your computer, you will need to turn a session on. (The default setting is On at Startup.) > To turn a session on or off ----------------------------- * Press CTRL+ALT+O. If you turn a session off, "Terminal Off" appears at the bottom of that session's screen. If you turn a session on, you can specify a different LU name for the session. When you're ready to quit using the applet, you can exit and return to the MS-DOS prompt. > To quit the MS-DOS-based applet --------------------------------- 1. Press CTRL+ALT+K. A prompt appears at the bottom of your screen, saying Quit Terminal Emulation (Y/N)?. 2. Type y. You should now be at your computer's MS-DOS prompt, in the directory containing the applet files. C. Transferring Files with the 3270 Applet for MS-DOS ----------------------------------------------------- Before starting a background file transfer, it is recommended that you use commands on the host to prevent host broadcast messages from being received by your emulator. This keeps the messages from interrupting the file transfer. After finishing the file transfer, use commands on the host to once again allow broadcast messages to reach your emulator. File transfer involves two basic steps: using the File transfer menu to set parameters for the transfer, and starting the transfer by pressing CTRL+ENTER. C.1. The File Transfer Menu --------------------------- To bring up the File Transfer menu, press CTRL+ALT+F, T. The top line of the menu contains status information. The central portion consists of five fields that you set to define a transfer. The lower portion gives information for the currently selected field. You can correct or update a particular field by pressing TAB or ENTER to advance to that field and then retyping the information. > To send a file using background transfer ------------------------------------------ 1. Bring up the File Transfer menu by pressing CTRL+ALT+F, T. If your machine beeps, you have not loaded background file transfer. Unload the MS-DOS-based applet and configure for background file transfer, as described in "The Startup Section." 2. In the Command field, type the appropriate Send command for your system, and press ENTER. 3. In the PC file field, type the name of the existing PC file that you want to send to the mainframe, and then press ENTER. You can provide the full name of the file, including path and extension. For example: c:\mydir\myfile.txt 4. In the Host File field, type the name that you want to give the file on the mainframe, and then press ENTER. 5. Type the transfer options you need in the Options field, and then press ENTER. Available options are listed under TRANSFER OPTIONS. --------------------------------------------------------- NOTE The total number of characters used to complete the menu, including options, cannot exceed 128. --------------------------------------------------------- 6. Once you have completed the menu, start the transfer by pressing CTRL+ENTER. > To receive a file from the mainframe using background transfer ---------------------------------------------------------------- 1. Bring up the File Transfer menu by pressing CTRL+ALT+F, T. 2. In the Command field, type the appropriate Receive command for your system, and then press ENTER. 3. In the PC file field, type the name that you want given to the file when it is copied to your computer, and then press ENTER. You can provide the full name of the file, including path and extension. For example: c:\mydir\myfile.txt 4. In the Host File field, type the name of the file you want to transfer to your computer, and then press ENTER. 5. Type the transfer options you need in the Options field, and then press ENTER. Available options are listed under TRANSFER OPTIONS. --------------------------------------------------------- NOTE The total number of characters used to complete the menu, including options, cannot exceed 128. --------------------------------------------------------- 6. Once you have completed the menu, start the transfer by pressing CTRL+ENTER. C.2. During the Transfer ------------------------ Once you have begun the transfer, you can jump to the PC session or any Terminal session other than the one performing the transfer and continue working. ------------------------------------------------------------ CAUTION Typing in the Terminal session that is performing the transfer may interfere with communications. ------------------------------------------------------------ You can check on the status of the transfer at any time. > To check on the status of a file transfer or initiate the canceling of a file transfer ------------------------------------------------------------ * Press CTRL+ALT+F, T. Pressing CTRL+ALT+F, T brings up the File Transfer menu again. The top line of the menu displays information about the number of characters transferred and the status of the transfer, as shown in the following table: Time when information Characters appears transferred Status ---------------------------------------------------------- Before the 0 IDLE transfer During the Number of IN PROGRESS transfer characters transferred so far After the Total number COMPLETE transfer of characters transferred If there's an Number of ABENDED (with error characters an error message) transferred before the error occurred -------------------------------------------------------------- When you bring up the File Transfer menu, it will ask you whether or not you want to cancel the transfer. To cancel the transfer, type y. To exit the menu without canceling, type n. After the file transfer is finished, you can transfer another file. The fields on the screen will still reflect the previous transfer, so you only need to update those fields that change. Often, you only will need to update the PC file and Host File fields. To change a field, use the TAB key to select it, type the new information, and then press ENTER. SECTION II ---------- D. Overview of the SNA Server Router ------------------------------------ This section describes the SNA Server Router (Router), a replacement for the IBM AS/400 PC Support program router component. Router provides the software interface to an APPC network used by several popular 5250 emulators, including the 5250 emulator provided with IBM PC Support/400. This reduces the configuration required at the client. It also allows the client to communicate through an SNA server instead of directly with an AS/400, so that the client can use standard transports such as IPX/SPX, NetBEUI, or any other LAN or WAN transport. Without the SNA Server Router, the client must communicate directly with an AS/400 over DLC. For information about PC Support, refer to your IBM PC Support manual(s). D.1. Advantages of Router ------------------------- Router provides the same interface as the PC Support program router component. It offers the following advantages: * Unlike the PC Support program router component, Router allows an MS-DOS-based client to use a single protocol (such as NetBEUI). With PC Support, an MS-DOS-based client must use the DLC protocol in addition to any other protocol it uses. * With Router, the DLC protocol does not need to be loaded. ------------------------------------------------------------ NOTE Many 5250 emulators do not require the IBM PC Support router (or the SNA Server Router), but instead use the Windows APPC API. Examples of 5250 emulators that do not require the PC Support router are the SNA Server 5250 Applet and other 5250 emulators listed in the "SNA Server Companion Product Catalog." ------------------------------------------------------------ E. Installing Router -------------------- Before you can use Router, you must take the following steps: 1. Install at least one SNA server. 2. Install the MS-DOS-based SNA Server client software on the client that will use Router. 3. If the PC Support utilities (file transfer, shared folders, IBM DOS 5250) are needed, install the IBM PC Support program software on the client as well. > To install Router ------------------- 1. Copy the ROUTER.EXE and INITRTR.EXE files to your PC Support directory. 2. Comment out the line that loads the COMNDIS program in your AUTOEXEC.BAT file. For example: rem c:\snaserv\rbin\comndis.com 2 --------------------------------------------------------- NOTE After the line that loads COMNDIS is commented out, you must include the IRQ numbers of your network adapter cards in the command line that starts Router. For information, see "Starting Router." --------------------------------------------------------- 3. Comment out the following lines in your CONFIG.SYS file: rem device=\DXMA0MOD.SYS rem device=\DXM0MOD.SYS where is the path of the directory where these drivers are located, and can be either c for Token Ring or e for Ethernet. Since Router only replaces the router component of the PC Support program, you must always load the EIMPCS.SYS driver in your CONFIG.SYS file, along with any other driver options you need. For example, if you want to use shared folders, you may also need to load the ECYDDX.SYS driver. The following is an example of a CONFIG.SYS file for an MS-DOS-based SNA Server client: DEVICE=C:\PCS\EIMPCS.SYS DEVICE=C:\PCS\ECYDDX.SYS DEVICE=C:\DOS\SETVER.EXE DEVICE=C:\WINDOWS\HIMEM.SYS DEVICE=C:\WINDOWS\EMM386.EXE NoEMS X=D800-DFFF DOS=HIGH,UMB FILES=3.0 SHELL=C:\DOS\COMMAND.COM C:\DOS\ /p LASTDRIVE=Z STACKS=9,256 DEVICE=C:\LANMAN.DOS\DRIVERS\PROTMAN\PROTMAN.DOS /i:C:\LANMAN.DOS DEVICE=C:\LANMAN.DOS\DRIVERS\ETHERNET\UB\UBNEI.DOS The following list describes the drivers that are loaded with PC Support and their function. Use the RMVPCS command to remove any drivers that you do not need. Driver Purpose ---------------------------------- EIMPCS.SYS Memory management ECYDDX.SYS Shared folders F. Starting Router ------------------ To start Router, you must first start the SnaBase service and then use the ROUTER command with appropriate options. This section shows the syntax to use with the ROUTER command, and then gives a detailed procedure for starting Router. The ROUTER command uses the following syntax: ROUTER [/C] [/BUFS=] [/IRQ=, OR ROUTER [/D] where /C Specifies the PC Support configuration file path. For example, to indicate that your configuration file path is C:\PCS\CONFIG.AS4, you would type: ROUTER /CC:\PCS\CONFIG.AS4 The default path is CONFIG.PCS. /BUFS= Specifies the number of communication buffers Router allocates. For , specify an integer from 24 through 64. Each buffer takes approximately 280 bytes of memory. With MS-DOS version 5.0 or later, Router allocates the memory for communication buffers from upper memory if there are enough free upper memory blocks available. Increase the number of buffers to at least 48 if you transfer or copy files (with the shared folders program). The default for is 24. /IRQ=, Specifies the IRQ numbers (in decimal) of your network adapter cards. Separate multiple IRQ numbers with commas. You must specify this option if you remove (or comment out) the COMNDIS line from your AUTOEXEC.BAT file. /D Removes the Router. Use the following procedure to start Router with the ROUTER command. > To start SNA Router --------------------- 1. On the MS-DOS-based SNA Server client, start the SnaBase by typing: SNABASE 2. Change to your PC Support directory. For example, type: CD \PCS 3. Start Router by typing: ROUTER [] where are as described in the preceding section. 4. Start the other PC Support components that you need, or start the Windows environment and use Windows-based 5250- emulation programs, such as RUMBA/400. --------------------------------------------------------- NOTE If you are running Windows version 3.x, the SnaBase and SNA Server Router should be started before Windows version 3.x is started. --------------------------------------------------------- G. Modifying the Router Configuration File ------------------------------------------ Router is configured through the PC Support configuration file. You can use the default filename for this file, CONFIG.PCS, or you can rename your configuration file and specify the new path name in the /C option of the ROUTER command, as described in the previous section. The following CONFIG.PCS identifiers are used by Router. RTLN and TRLI are required, and the rest of the identifiers are optional: INTL Specifies the interrupt number used by the PC Support program components when they communicate with Router. Specify a hexadecimal number from 60 through 68. This identifier is optional. If you do not specify this identifier, 68 is used. If you use extended memory manager, do not use interrupt 67. RTCU Specifies the ID to be used if a user ID is not specified for the system on the TRLI identifier. This identifier is optional. If you do not specify this identifier, you are prompted for the user ID and password. RTDN Provides the name of the AS/400 system used to start the conversation if a name is not specified. This system name must be one of the remote LU names in the SNA Server configuration. This identifier is optional. If you do not specify this identifier, the default is the first system specified with TRLI. RTLN Provides the name that uniquely identifies this computer in the APPN network. This identifier is required. It is a 17-character name that must be the same as the fully qualified LU name of your local LU in the SNA server configuration. For example: rtln appn.user1 The name must contain the period between the two parts of the fully qualified network name. RTYP Specifies the router type. This identifier is optional. If specified, RTYP must have a value of ITRN (local area network). The ITRN is an IBM-defined value for the RTYP. TRLI Specifies the link identification identifier. This identifier is required. More than one identifier can be specified for each AS/400 you communicate with. The following example shows the full syntax of the TRLI identifier: trli ,,DSAP, , MAXOUT, MAXIN, TIMERT1,TIMERT2,TIMERTI where is the name of the remote LU (AS/400 name) you connect to and is used to sign on to an AS/400. The is required, but this value is ignored by the SNA Server Router. The may be specified as 000000000000. The is optional. If this parameter is not specified, Router uses the common user ID or prompts for a user ID. H. Using Default LUs Specified in the PC Support Configuration -------------------------------------------------------------- On a client running MS-DOS or Windows version 3.x, if you want to use the default LUs specified in the PC Support configuration file, you must set a variable in the SNA.INI file (for MS-DOS) or the WIN.INI file (for Windows version 3.x): OverrideDefaultLU=YES When this variable is set to YES, SNA Server will use the default APPC LUs configured for PC Support; these LUs are specified on the RTLN line of the CONFIG.PCS file. Otherwise, SNA Server will use the default APPC LUs configured in SNA Server; these LUs are assigned to users or groups through SNA Server Admin or through the SNA Server command-line interface (snacfg). I. Removing Router ------------------ After you install Router, you can remove it any time; however, you must first unload other PC Support components (workstation function, shared folders, and so on) by using the RMVPCS command. To remove Router, type ROUTER /D For additional information about PC Support functions, refer to your IBM PC support manual(s). SECTION III ----------- J. Working with Client Access/400 ----------------------------------- Client Access/400 (CA/400) is a new software product (in beta as of August 1994) from IBM. CA/400 adds a Windows interface to existing PC Support functionality. CA/400 can be used with Microsoft SNA Server version 2.1, specifically, with the MS-DOS-based client software and the SNA Server Router (Router). Please note the following guidelines when using CA/400: * If you plan to use CA/400 with Router, be sure to read the information about Router in this README file or in Chapter 3 of the Microsoft SNA Server Installation Guide. * When CA/400 is used with SNA Server software, the shared folders component of CA/400 does not work. * To run CA/400, you must start the underlying software components (for example, the client SnaBase software and the Router) through MS-DOS, before starting the Windows operating system. The procedure is similar to the procedure for starting Router, as described in this README. > To start both Router and CA/400 --------------------------------- 1. On the client, make sure Windows is not started, so that only MS-DOS is running. 2. At the MS-DOS prompt, start the SnaBase by typing SNABASE 3. Change to the PC Support directory. For example, type: CD \PCS 4. Start SNA Server Router by typing ROUTER [] where are as described in this README. 5. Start the other PC Support components that you need. If you want to use the extended version of PC Support, you must first start RTRMAP.EXE, to allow communication between the extended PC Support functions and Router. RTRMAP.EXE is provided with PC Support and can be found on the I:\FL2 shared-folders directory on the AS/400. 6. Start the PCSWIN component of PC Support by typing PCSWIN 7. Start Windows. 8. Start the CA/400 emulator software by double-clicking on the appropriate icon. When the emulator software starts for the first time, it displays the Customize Communications dialog box, which is also available through the Configure command in the Communications menu. 9. In the Customize Communications dialog box, be sure that AS/400 PC Support Router is selected. 10. Proceed with using the CA/400 software as described in the product documentation.