|
DataMuseum.dkPresents historical artifacts from the history of: CP/M |
This is an automatic "excavation" of a thematic subset of
See our Wiki for more about CP/M Excavated with: AutoArchaeologist - Free & Open Source Software. |
top - metrics - download
Length: 130944 (0x1ff80) Types: RcTekst Names: »99110409.WP«
└─⟦6fdfe4d4d⟧ Bits:30005866/disk5.imd Dokumenter i RcTekst format (RCSL 99-1-*) └─⟦this⟧ »99110409.WP«
╱04002d4e0a000600000000030c4731400000000000000000000000000000000000000000000000000c16202a343e48525c66707a848e98ff04╱ ════════════════════════════════════════════════════════════════════════ ↓ ┆a1┆┆b0┆┆a1┆RC3931 Communications Processor↲ ┆b0┆┆a1┆User's Guide↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ┆b0┆February 1986↲ ┆b0┆RCSL No. 991 10409↲ ┆b0┆Development Department↲ ┆b0┆RC Computer A/S↲ ════════════════════════════════════════════════════════════════════════ ↓ Copyright (C) 1985↲ A/S Regnecentralen af 1979 / RC Computer A/S↲ ┆a1┆Published by A/S Regnecentralen af 1979, Copenhagen↲ ↲ Users of this document are cautioned that the specifications ↓ contained herein are subject to change by RC at any time ↓ without prior notice. RC is not responsible for typograph┄↓ ical or arithmetic errors which may appear in this document ↓ and shall not be responsible for any damage caused by ↓ reliance on any of the material presented.↲ ════════════════════════════════════════════════════════════════════════ ↓ ┆14┆┆b3┆↲ ┆14┆┆b1┆┆b0┆ RC3931 Communications Processor┆05┆Contents ↲ ┆14┆┆b2┆┆b0┆ Contents┆05┆RC3931 Communications Processor ↲ ┆15┆┆b3┆↲ ┆15┆┆b3┆↲ ┆15┆┆b3┆↲ ┆15┆┆b1┆┆b0┆ Update 1/86┆05┆Page Contents-┆0b┆ ↲ ┆15┆┆b2┆┆b0┆ Page Contents-┆0b┆┆05┆Update 1/86 ↲ ╱04002d4e0a000600000000030c4731400000000000000000000000000000000000000000000000000c0f121416202a343e48525c66707aff04╱ ╱04002d4e0a000600000000030c4731400000000000000000000000000000000000000000000000000c16202a343e48525c66707a848e98ff04╱ ↓ ┆a1┆CONTENTS↲ ↲ A.╞ ┆a1┆Introduction┆e1┆ Page A-1↲ ↲ B.╞ ┆a1┆System Overview┆e1┆ B.1-1↲ ╞ 1.╞ ┆a1┆Basic Functions┆e1┆ B.1-1↲ ╞ ╞ LAN communication B.1-1↲ ╞ ╞ RcCircuit communication B.1-2↲ ╞ ╞ Terminal download B.1-2↲ ╞ 2. ┆a1┆IBM 3270 Emulation┆e1┆ B.2-1↲ ╞ ╞ Linking the CU to a host computer B.2-1↲ ╞ ╞ ╞ Multiple links B.2-1↲ ╞ ╞ ╞ Host link selection B.2-2↲ ╞ ╞ ╞ ╞ Skipping the host link menu B.2-2↲ ╞ ╞ ╞ Remote host links B.2-3↲ ╞ ╞ ╞ ╞ IBM-compatible links B.2-3↲ ╞ ╞ ╞ ╞ X.21-BSC B.2-3↲ ╞ ╞ ╞ ╞ Dual host configuration B.2-4↲ ╞ ╞ ╞ Local host links B.2-4↲ ╞ ╞ Emulated 3270 devices B.2-4↲ ↲ C. ┆a1┆Software Installation┆e1┆ C-1↲ ╞ ╞ After installation C-1↲ ╞ ╞ ╞ SW3882 (ANSI X3.64 terminal program) C-1↲ ╞ ╞ ╞ SW3802 (Teletex) C-2↲ SW3803 and (3270 emulation) C-2↲ ╞ ╞ SW3804 (3270 Programmer's toolkit)↲ ↲ D.╞ ┆a1┆System Customization┆e1┆ D.1-1↲ ╞ 1.╞ ┆a1┆Configuration┆e1┆ D.1-2↲ ╞ ╞ Basic functions D.1-2↲ ╞ ╞ IBM 3270 emulation D.1-3↲ ╞ ╞ ╞ Remote host links D.1-3↲ ╞ ╞ ╞ Local host links D.1-4↲ ╞ ╞ ╞ Soft devices D.1-4↲ ╞ Teletex D.1-4↲ ════════════════════════════════════════════════════════════════════════ ↓ ╞ 2.╞ ┆a1┆Customization, Parameter Files┆e1┆ Page D.2-1↲ ╞ ╞ Parameter file syntax D.2-1↲ ╞ ╞ Download menus (MENUDL.CST) D.2-2↲ ╞ ╞ ╞ Frame text: FTEXT D.2-4↲ ╞ ╞ ╞ Error text: ETEXT D.2-4↲ ╞ ╞ ╞ Terminal program: TPRG D.2-4↲ ╞ ╞ ╞ Terminal menu: TMENU D.2-4↲ ╞ ╞ ╞ Example D.2-5↲ ╞ ╞ Conversion tables (CONV.CST) D.2-6↲ ╞ ╞ ╞ Conversion to internal code: INTCODE D.2-7↲ ╞ ╞ ╞ Conversion to EBCDIC code: EBCDIC D.2-8↲ ╞ ╞ Displayable texts (TEXTS.CST) D.2-8↲ ╞ ╞ ╞ Host link menu heading: HOSTMENU D.2-8↲ ╞ ╞ ╞ BSC link name: BSCID D.2-8↲ ╞ ╞ ╞ SNA/SDLC link name: SNAID D.2-9↲ ╞ ╞ ╞ Device status message: DSTEXT D.2-9↲ ╞ ╞ ╞ Communication status message: CSTEXT D.2-10↲ ╞ ╞ Communication parameters (COMM.CST) D.2-10↲ ╞ ╞ ╞ Parameters for BSC links D.2-11↲ ╞ ╞ ╞ ╞ BSC link kind: BSCKIND D.2-11↲ ╞ ╞ ╞ ╞ EBCDIC code for BSC link: BSCCONV D.2-11↲ CU number: BSCCU D.2-12↲ ╞ ╞ ╞ ╞ DTR handling: BSCDTR D.2-12↲ ╞ ╞ ╞ ╞ Half/full duplex: BSCDUP D.2-13↲ ╞ ╞ ╞ ╞ BSC printer timeout: BSCPTIME D.2-13↲ X.21 subscriber number: BSCXNO D.2-13↲ ╞ ╞ ╞ Parameters for SNA/SDLC links D.2-13↲ ╞ ╞ ╞ ╞ SNA/SDLC link kind: SDLCKIND D.2-14↲ ╞ ╞ ╞ ╞ EBCDIC code for SNA/SDLC link D.2-14↲ SDLC address: SDLCADDR D.2-14↲ ╞ ╞ ╞ ╞ Terminal ID: TERMID D.2-15↲ ╞ ╞ ╞ ╞ NRZI encoding: SDLCNRZI D.2-15↲ ╞ ╞ ╞ ╞ Printer sharing: PSHARING D.2-15↲ ╞ ╞ ╞ ╞ DTR handling: SDLCDTR D.2-16↲ ════════════════════════════════════════════════════════════════════════ ↓ ╞ ╞ ╞ ╞ Half/full duplex: SDLCDUP D.2-16↲ ╞ ╞ ╞ ╞ Point-to-point/multipoint: MPOINT D.2-16↲ ╞ ╞ ╞ ╞ Host subscriber number: SDLCHXNO D.2-16↲ ╞ ╞ ╞ ╞ Own subscriber number: SDLCCXNO D.2-17↲ ╞ ╞ ╞ Printer authorization Page D.2-17↲ ╞ ╞ ╞ ╞ Printer mode: PMODE D.2-18↲ ╞ ╞ ╞ ╞ Printer class: PCLASS D.2-18↲ ╞ ╞ ╞ ╞ Printer source device list: PSRCLIST D.2-18↲ ╞ ╞ ╞ Cluster size D.2-19↲ ╞ ╞ ╞ ╞ Maximum device number: MAXDEVNO D.2-19↲ ╞ ╞ ╞ ╞ Number of terminals: NOTERMS D.2-19↲ ╞ ╞ Local host links D.2-19↲ ╞ ╞ ╞ ╞ Number of local host links: CULCONS D.2-20↲ ╞ ╞ ╞ ╞ ┆84┆Output message size host links: CULOSIZE D.2-20↲ Input message size host links: CULOSIZE D.2-20↲ ╞ ╞ ╞ ╞ CU port name for local host link: CULIPORT D.2-20↲ ╞ ╞ Soft devices D.2-21↲ ╞ ╞ ╞ ╞ Device numbers: SOFTDEVS D.2-21↲ ╞ ╞ ╞ ╞ Soft device timeout: SOFTMOUT D.2-21↲ ╞ ╞ ╞ Parameters for Teletex D.2-21↲ ╞ ╞ ╞ ╞ Class 0 pages: CLASS0P D.2-21↲ ╞ ╞ ╞ ╞ Number of letters: MAXL D.2-21↲ ╞ ╞ ╞ ╞ Address of Telex conversion facility: ↲ CFADDR D.2-22↲ ↲ E.╞ ┆a1┆System Management┆e1┆ E-1↲ ╞ ╞ Resetting the CP E-1↲ ╞ ╞ Files belonging to the CP E-2↲ ╞ ╞ ╞ Auxiliary files E-2↲ ╞ ╞ ╞ Selecting character conversion E-4↲ ╞ ╞ External cable connections E-4↲ ╞ ╞ Device number management (3270) E-7↲ ╞ ╞ CP log file E-7↲ ╞ ╞ Lamps on the front panel E-8↲ ↲ ════════════════════════════════════════════════════════════════════════ ↓ F. ┆a1┆Normal Use┆e1┆ F-1↲ ╞ Error messages during download F-1↲ ╞ ╞ 3270 emulator status messages F-3↲ ╞ ╞ ╞ Device status messges F-3↲ ╞ ╞ ╞ Communication status messages F-7↲ ↲ H. ┆a1┆Appendices┆e1┆ H.1-1↲ ╞ 1. ┆a1┆References┆e1┆ H.1-1↲ ╞ 2. ┆a1┆Character Sets┆e1┆ H.2-1↲ ╞ 3. ┆a1┆EBCDIC Character Codes┆e1┆ H.3-1↲ ╞ 4.╞ ┆a1┆V.24/X.21 Connectors┆e1┆ H.4-1↲ ╞ 5. ┆a1┆Host Link Information Displays┆e1┆ H.5-1↲ ╞ ╞ ╞ BSC Link Information H.5-1↲ ╞ ╞ ╞ SNA/SDLC Link Information H.5-2↲ ╞ ╞ ╞ ╞ SNA statistics H.5-2↲ ╞ ╞ ╞ ╞ SDLC statistics H.5-5↲ ╞ ╞ ╞ ╞ X.21 statistics H.5-7↲ ↲ ┆a1┆Figures↲ ↲ B-1.╞ ╞ Example: configuration of 3270 host links B.2-5↲ B-2.╞ ╞ Example: cluster of 3270 devices B.2-7↲ D-1.╞ ╞ Default terminal download menu D.2-3↲ E-1.╞ ╞ RC39 connector panel Page E-5↲ E-2.╞ ╞ RC39 front panel E-8↲ H.2-1.╞ US English character set H.2-1↲ H.2-2.╞ UK English character set H.2-2↲ H.2-3.╞ German character set H.2-3↲ H.2-4.╞ Swedish character set H.2-4↲ H.2-5.╞ Standard Danish character set H.2-5↲ H.2-6.╞ Danish OS (public sector) character set H.2-6↲ H.3-1.╞ US English EBCDIC codes H.3-1↲ H.3-2.╞ UK English EBCDIC codes H.3-2↲ H.3-3.╞ German EBCDIC codes H.3-3↲ H.3-4.╞ German alternate EBCDIC codes H.3-4↲ H.3-5.╞ Swedish EBCDIC codes H.3-5↲ ════════════════════════════════════════════════════════════════════════ ↓ H.3-6.╞ Swedish alternate EBCDIC codes H.3-6↲ H.3-7.╞ Standard Danish EBCDIC codes H.3-7↲ H.3-8.╞ Standard Danish alternate EBCDIC codes H.3-8↲ H.3-9.╞ Danish OS EBCDIC codes H.3-9↲ H.3-10.╞ Danish OS alternate EBCDIC codes H.3-10↲ H.5-1.╞ SNA statistics display for an inactive PU↲ H.5-2.╞ SNA statistics display for an active PU↲ H.5-3.╞ SDLC statistics display for an SDLC-V.24 link↲ H.5-4.╞ SDLC statistics display for an SDLC-X.21 link↲ H.5-5.╞ X.21 statistics display for an SDLC-X.21 link↲ ════════════════════════════════════════════════════════════════════════ ↓ ↲ ════════════════════════════════════════════════════════════════════════ ↓ ┆14┆┆b3┆↲ ┆14┆┆b1┆┆b0┆ RC3931 Communications Processor┆05┆Introduction A↲ ┆14┆┆b2┆┆b0┆ A Introduction┆05┆RC3931 Communications Processor ↲ ┆15┆┆b3┆↲ ┆15┆┆b1┆┆b0┆ Update 1/86┆05┆Page A-┆0b┆ A↲ ┆15┆┆b2┆┆b0┆ A Page A-┆0b┆┆05┆Update 1/86 ↲ ╱04002d4e0a000600000000030c4731400000000000000000000000000000000000000000000000000c151b284648525c66707a848effffff04╱ ╱04002d4e0a000600000000030c4731400000000000000000000000000000000000000000000000000c0f121416202a343e48525c66707aff04╱ ↓ ┆a1┆A. INTRODUCTION↲ ↲ The RC3931 Communications Processor (CP) is a subsystem for ↓ the RC39 Multi-User Computer System (MUCS).↲ The basic element of the RC39 MUCS is a processor which ↓ can execute application programs in the local environment, ↓ i.e. with locally connected terminals and data stored on the ↓ built-in disk unit. We refer to this processor as the Local ↓ Applications Processor (LAP). In its ability to execute ↓ application programs locally, the LAP is a completely ↓ independent system.↲ The CP is an additional, separate processor subsystem ↓ which can be built into an RC39 system. It may perform a ↓ number of communication functions, some of which are ↓ integrated with the functions of the LAP, while others, ↓ which do not involve the LAP, are equivalent to the ↓ functions of a stand-alone communication control unit, such ↓ as the RC890 or RC891 CU.↲ Through the CP, the LAP may interact with remote systems, ↓ e.g. with a mainframe host computer system. Utilizing this ↓ feature the RC39 MUCS may be used as an element in distri┄↓ buted application systems, where some functions and some ↓ data reside within a large central mainframe installation, ↓ while other functions as well as part of the data base ↓ reside locally in one or more RC39 systems.↲ Most users will not be aware of using the CP since it does ↓ not perform a user-visible function of its own, but trans┄↓ parently enables various components of a total system, both ↓ local and remote, to communicate and cooperate.↲ In this guide as well as in the user's guide which covers ↓ the RC39 MUCS in general (ref. 1), one user at each in┄↓ stallation site is designated the system administrator. A ↓ number of tasks concerning the CP are described as system ↓ administrator responsibilities. It is not the intention to ↓ imply that these tasks must necessarily all be carried out ↓ by the same person, although such an arrangement would be ↓ very practical. In general it can be said that most of the ↓ ┆8c┆┆83┆┆bc┆↓ information in this guide is addressed to the system ↓ administrator.↲ The CP consists of both hardware and software. The primary ↓ hardware element of the CP is a printed circuit board which ↓ holds a single board microcomputer. This board is of the ↓ same shape and size as the other boards which are used in ↓ the RC39 MUCS. The microprocessor, RAM, and many other ↓ components on the CP board are also similar to the compo┄↓ nents on the other boards in the system. However, the CP is ↓ distinguished by containing communication control components ↓ and circuitry for receiving and transmitting data on the ↓ various communication lines which are utilized to connect ↓ the RC39 MUCS to terminals and other local or remote com┄↓ puter systems.↲ Depending on the required functions, additional adapter ↓ boards are likely to be needed, so that the CP subsystem ↓ typically consists of a total of two or three boards.↲ This guide does not cover hardware details such as board ↓ installation and fault diagnostics. Nor does it discuss ↓ which adapters etc. are needed for the various functions. In ↓ other words, it is assumed that the hardware elements which ↓ are needed for the required functions have been properly ↓ installed.↲ The program to be executed by the CP is configured in a ↓ flexible fashion from a number of available software ↓ modules. Basic functions are performed by software modules ↓ which are distributed together with the XENIX Timesharing ↓ System, while additional specific functions are performed by ↓ modules distributed in separate packages. The SW packages ↓ covered by this guide are:↲ ↲ ┆a1┆package╞ ╞ ╞ contents╞ ↲ SW3910╞ ╞ Software modules for basic CP functions.↲ SW3802 ┆84┆Software modules for the CP as well as the ↓ ┆19┆┆8f┆┄┄LAP to provide the Teletex service.↲ SW3803╞ ╞ ┆84┆IBM 3270 emulation software enabling the CP ↓ ┆19┆┆8f┆┄┄to act as an IBM 3274 Control Unit.↲ ════════════════════════════════════════════════════════════════════════ ↓ ┆a1┆package╞ ╞ ╞ contents╞ ↲ SW3804 ┆84┆Software modules for the CP as well as the ↓ ┆19┆┆8f┆┄┄LAP which enables the LAP to access a host ↓ ┆19┆┆8f┆┄┄appli┄cation via the 3274 CU function of the ↓ ┆19┆┆8f┆┄┄CP.↲ ↲ ╱04002d4e0a000600000000020c4731400000000000000000000000000000000000000000000000000c16202a343e48525c66707a848e98ff04╱ ╱04002d4e0a000600000000030c4731400000000000000000000000000000000000000000000000000c151b284648525c66707a848effffff04╱ ↓ The basic functions of the CP are:↲ ↲ ╱04002d4e0a000600000000030c4731400000000000000000000000000000000000000000000000000c16202a343e48525c66707a848e98ff04╱ ╱04002d4e0a000600000000020c4731400000000000000000000000000000000000000000000000000c16202a343e48525c66707a848e98ff04╱ ↓ - ┆84┆to enable the RC39 MUCS to be attached to a local area ↓ ┆19┆┆82┆┄┄network (LAN) in order to communicate and interact with ↓ ┆19┆┆82┆┄┄other units attached to the LAN. These units may be other ↓ ┆19┆┆82┆┄┄RC39 systems, RC8000 mainframe computers, and RC750 or ↓ ╱04002d4e0a000600000000020c4731400000000000000000000000000000000000000000000000000c16202a343e48525c66707a848e98ff04╱ ╱04002d4e0a000600000000030c4731400000000000000000000000000000000000000000000000000c16202a343e48525c66707a848e98ff04╱ ↓ ┆19┆┆82┆┄┄RC45 personal computers┆81┆1┆82┆.↲ ↲ ╱04002d4e0a000600000000030c4731400000000000000000000000000000000000000000000000000c16202a343e48525c66707a848e98ff04╱ ╱04002d4e0a000600000000020c4731400000000000000000000000000000000000000000000000000c16202a343e48525c66707a848e98ff04╱ ↓ - ┆84┆to enable block-mode communication with RC45 and/or RC855 ↓ ┆19┆┆82┆┄┄terminals connected to the RC39 MUCS via RcCircuit. This ↓ ┆19┆┆82┆┄┄mode of communication is the basis for all terminal-↓ ╱04002d4e0a000600000000020c4731400000000000000000000000000000000000000000000000000c16202a343e48525c66707a848e98ff04╱ ╱04002d4e0a000600000000030c4731400000000000000000000000000000000000000000000000000c16202a343e48525c66707a848e98ff04╱ ↓ ┆19┆┆82┆┄┄oriented functions involving the CP.↲ ↲ ╱04002d4e0a000600000000030c4731400000000000000000000000000000000000000000000000000c16202a343e48525c66707a848e98ff04╱ ╱04002d4e0a000600000000020c4731400000000000000000000000000000000000000000000000000c16202a343e48525c66707a848e98ff04╱ ↓ - ┆84┆to present the terminal operator with a menu of programs ↓ ┆19┆┆82┆┄┄which can be downloaded to run on the terminal and to ↓ ┆19┆┆82┆┄┄perform the load as selected. Menus may include various ↓ ┆19┆┆82┆┄┄emulators and may be customized for the individual ↓ ┆19┆┆82┆┄┄terminal. Note that terminal programs to be downloaded are ↓ ┆19┆┆82┆┄┄distributed as separate packages (not included among the ↓ ╱04002d4e0a000600000000020c4731400000000000000000000000000000000000000000000000000c16202a343e48525c66707a848e98ff04╱ ╱04002d4e0a000600000000030c4731400000000000000000000000000000000000000000000000000c16202a343e48525c66707a848e98ff04╱ ↓ ┆19┆┆82┆┄┄packages mentioned above).↲ ↲ ╱04002d4e0a000600000000030c4731400000000000000000000000000000000000000000000000000c16202a343e48525c66707a848e98ff04╱ ╱04002d4e0a000600000000020c4731400000000000000000000000000000000000000000000000000c16202a343e48525c66707a848e98ff04╱ ↓ This guide covers the basic functions of the CP as well as ↓ those aspects of 3270 emulation and Teletex communication ↓ that pertain to the CP. Information about 3270 emulation re┄↓ levant for the terminal operator may be found in the user's ↓ guide for the terminal or PC emulator in question (refs. ↓ 2,3,4)┆81┆2┆82┆. Information about accessing the communication ↓ ╱04002d4e0a000600000000020c4731400000000000000000000000000000000000000000000000000c16202a343e48525c66707a848e98ff04╱ ╱04002d4e0a000600000000030c4731400000000000000000000000000000000000000000000000000c16202a343e48525c66707a848e98ff04╱ ↓ ______↲ ↲ 1. ┆84┆The abbreviation PC is used in this guide to refer to any ↓ ┆19┆┆83┆┄┄RC Personal Computer, i.e. either the RC750 PC or the ↓ ┆19┆┆83┆┄┄RC45 PC.↲ 2. ┆84┆The available emulator operating guide may have been ↓ ┆19┆┆83┆┄┄written before the release of the RC3931 CP with support ↓ ┆19┆┆83┆┄┄for IBM 3270 emulation. It may therefore not mention the ↓ ┆19┆┆83┆┄┄CP. However, from the point of view of a terminal ↓ ┆19┆┆83┆┄┄emulator, the CP behaves exactly like the RC890 or RC891 ↓ ┆19┆┆83┆┄┄Control Unit which the guide will refer to.↲ ════════════════════════════════════════════════════════════════════════ ↓ ╱04002d4e0a000600000000030c4731400000000000000000000000000000000000000000000000000c16202a343e48525c66707a848e98ff04╱ ╱04002d4e0a000600000000020c4731400000000000000000000000000000000000000000000000000c16202a343e48525c66707a848e98ff04╱ ↓ functions from programs running on the LAP (XENIX programs) ↓ may be found in ref. 5.↲ From the point of view of a terminal operator the terminal ↓ download and 3270 emulation functions performed by the CP ↓ are completely equivalent to those of an RC890 or RC891 ↓ control unit (CU). For the sake of consistency we shall ↓ therefore use the abbreviation CU to refer to the CP when ↓ speaking of these functions.↲ With respect to the Teletex service only the customization ↓ of the CP-part of the software is described in this guide. ↓ The user interaction with the service through the software ↓ running on the LAP is described in ref. 7.↲ Main section B contains a general description of the ↓ functions of the CP emphasizing how the CP will interact ↓ with terminals, other units attached to a LAN, a public data ↓ network, and remote host computers.↲ SW packages for the CP are distributed on diskettes. The ↓ installation of the files on these diskettes is the subject ↓ of main section C. Some hints are also given on the most ↓ important aspects of system customization to check and/or ↓ update after installation of each package.↲ By editing a number of text files containing a specifi┄↓ cation of the functional configuration and a number of ↓ operational parameters, the system administrator may tailor ↓ the CP to the needs of the particular installation. The ↓ configuration possibilities and customization parameters are ↓ explained in main section D.↲ The responsibilities of the system administrator with ↓ respect to the CP and the tools available for accomplishing ↓ these tasks are the subjects of main section E.↲ As mentioned above, the CP is almost invisible to the ↓ normal user. However, it is the source of a number of ↓ messages, i.e. brief texts, which appear in the status line ↓ of a terminal or PC display when the downloader or an ↓ emulation system is used. The meaning of these messages is ↓ discussed in main section F.↲ ════════════════════════════════════════════════════════════════════════ ↓ ┆14┆┆b3┆↲ ┆14┆┆b1┆┆b0┆ RC3931 Communications Processor┆05┆System Overview B↲ ┆14┆┆b2┆┆b0┆ B System Overview┆05┆RC3931 Communications Processor ↲ ╱04002d4e0a00060000000003014c3140000000000000000000000000000000000000000000000000050f19232d37414b555f69737d8791ff04╱ ╱04002d4e0a000600000000030c4731400000000000000000000000000000000000000000000000000c16202a343e48525c66707a848e98ff04╱ ↓ ┆15┆┆b3┆↲ ┆15┆┆b1┆┆b0┆ Update 1/86┆05┆Page B.1-┆0b┆ B↲ ┆15┆┆b2┆┆b0┆ B Page B.1-┆0b┆┆05┆Update 1/86 ↲ ╱04002d4e0a000600000000030c4731400000000000000000000000000000000000000000000000000c16202a343e48525c66707a848e98ff04╱ ╱04002d4e0a00060000000003014c3140000000000000000000000000000000000000000000000000050f19232d37414b555f69737d8791ff04╱ ↓ ┆a1┆B. SYSTEM OVERVIEW↲ ↲ The purpose of this main section is to provide a general ↓ understanding of the working of the CP subsystem and to ↓ establish a frame of reference for the specific information ↓ given in main section D on the customization of a CP. The ↓ first section deals with the basic functions: LAN communi┄↓ cation, communication with terminals via RcCircuit, and ↓ download of terminals. The second section deals with IBM ↓ 3270 emulation. When defining the functional configuration ↓ of the CP the system administrator may choose to activate or ↓ not activate each of these functions separately.↲ ↲ ┆a1┆B.1 Basic Functions↲ ↲ The software modules performing the basic functions are ↓ included among the files (SW3901) which are installed ↓ together with the RC3931 hardware.↲ ↲ ┆a1┆LAN Communication↲ ↲ When an RC39 MUCS is attached to a local area network, all ↓ messages transmitted to or received from other units on the ↓ LAN pass through the CP. The CP provides a complete ↓ transport service allowing communication for several ↓ independent purposes to take place simultaneously on the ↓ LAN.↲ The basic transport service allows programs running on ↓ separate units attached to the LAN to exchange data messages ↓ (blocks of data). LAN communication is also used in ↓ conjunction with IBM 3270 emulation when devices are ↓ emulated on PCs or when an RC8000 mainframe computer is ↓ connected to the CP using local links (see section B.2).↲ ↲ ════════════════════════════════════════════════════════════════════════ ↓ ┆a1┆RcCircuit Communication↲ ↲ The transport service mentioned under LAN communication ↓ above is extended to programs running on terminals connected ↓ to the RC39 MUCS by means of RcCircuit. This block-mode ↓ communication is different from the character-at-a-time ↓ communication which is used when terminals log in to the ↓ (XENIX) operating system or application programs running on ↓ the RC39 LAP. It utilizes a separate twisted wire pair in ↓ the RcCircuit cable.↲ The twisted pair used for block-mode communication is ↓ referred to as RcCircuit-I, while the pair used for ↓ character-mode communication is referred to as RcCircuit-II.↲ Block-mode communication on the RcCircuit-I is the basis ↓ for all terminal-oriented functions involving the CP. ↓ Specifically, it is used for downloading and for 3270 ↓ emulation.↲ ↲ ┆a1┆Terminal Download↲ ↲ RC45 and RC855 terminals may be connected to the CP and to ↓ the RC39 MUCS in general by means of the RcCircuit. These ↓ terminals are based on a soft-programmed microcomputer. In ↓ order to perform a useful function they must therefore be ↓ loaded with a program. A terminal may be configured to ↓ expect its program to be downloaded from a CU which may be ↓ an RC890 or RC891 CU, or the CP. In the latter case the ↓ program is transferred from a file on the RC39 disk to the ↓ program execution memory of the terminal by transmission on ↓ the RcCircuit-I.↲ Alternatively, terminals may be configured to load from ↓ built-in permanent memory (PROM) or from a local diskette ↓ unit (RC855 only).↲ Download is a little slower than load from a built-in ↓ PROM, but more flexible, since several different terminal ↓ programs may be downloaded to the same terminal, e.g. an IBM ↓ 3270 emulator to be used in cooperation with a CU (i.e. the ↓ ┆8c┆┆83┆┆bc┆↓ 3274 CU emulator function of the CP) and an ANSI X3.64 ↓ terminal program used when the terminal is to communicate ↓ with the RC39 LAP.↲ The selection of the program to be downloaded to a termi┄↓ nal is made by means of a menu. The default menus are very ↓ simple. However, menus may be extended by the system ↓ administrator.↲ It is possible for one emulator program to appear more ↓ than once in the same menu in different disguises. This is ↓ meaningful if different parameters are supplied for the ↓ program in each instance, causing it to behave differently. ↓ See section B.2, Host line selection, for a description of ↓ how parameters are used with the 3270 emulator programs.↲ Terminal menus may be customized for each installation, ↓ see section D.2, Download menus. It is possible to specify a ↓ different menu for each individual terminal. It is also ↓ possible, independent of the functional configuration of the ↓ CP, to install additional terminal programs and include them ↓ in the menu for any desired terminal.↲ ════════════════════════════════════════════════════════════════════════ ↓ ↲ ════════════════════════════════════════════════════════════════════════ ↓ ┆14┆┆b3┆↲ ┆14┆┆b1┆┆b0┆ RC3931 Communications Processor┆05┆System Overview B↲ ┆14┆┆b2┆┆b0┆ B System Overview┆05┆RC3931 Communications Processor ↲ ┆15┆┆b3┆↲ ┆15┆┆b1┆┆b0┆ Update 0/85┆05┆Page B.2-┆0b┆ B↲ ┆15┆┆b2┆┆b0┆ B Page B.2-┆0b┆┆05┆Update 0/85 ↲ ╱04002d4e0a000600000000030c4731400000000000000000000000000000000000000000000000000c16202a343e48525c66707a848e98ff04╱ ╱04002d4e0a000600000000030c4731400000000000000000000000000000000000000000000000000c16202a343e48525c66707a848e98ff04╱ ↓ ┆a1┆B.2 IBM 3270 Emulation↲ ↲ Together with a number of terminals and/or personal compu┄↓ ters the CP may emulate an IBM 3274 Control Unit with a ↓ cluster of attached devices. This emulation requires the ↓ 3270 emulation software modules to be installed and running ↓ on the CP, and similarly each terminal or PC which is to ↓ emulate one or more 3270 devices must run the appropriate ↓ emulator. In the context of 3270 emulation we use the ↓ abbreviation CU to refer to the CP.↲ The emulation system provides a number of functions beyond ↓ those of a traditional 3270-type device cluster. However, ↓ the central purpose remains: to allow communication to take ↓ place between a host computer-based application and a number ↓ of devices. The devices may be printers or displays with ↓ keyboards; they may also include "soft devices", i.e. ↓ software modules with no direct physical representation.↲ ↲ ┆a1┆Linking the CU to a host computer↲ ↲ A link is needed between the CU and the host computer in ↓ order to exchange data between the application program ↓ running on the host and devices attached to the CU. Such a ↓ link may be established in several different ways, and a CU ↓ may support communication on several links simultaneously.↲ The concept of a ┆a1┆host link┆e1┆ is important in order to under┄↓ stand the host link menus and link names that occur in the ↓ emulation system, particularly when the CU is configured and ↓ customized to support multiple links.↲ A host link may be ┆a1┆remote┆e1┆, utilizing telephone lines or a ↓ public data network, or ┆a1┆local┆e1┆, utilizing a LAN.↲ ↲ ┆a1┆Multiple links↲ When the CU supports multiple links simultaneously it must ↓ establish correspondences between active devices and links. ↓ We say that a device is attached to a link. In general, any ↓ device may be attached to any link, but not to more than one ↓ ┆8c┆┆83┆┆bc┆↓ link at a time. A display device is always attached to a ↓ link; an idle printer need not be.↲ When a device is attached to a given host link, the CU ↓ will report to other hosts attempting to access the device ↓ that it is unavailable, as if it were switched off.↲ In some cases the host may later be notified when the ↓ device becomes available, e.g. when a printer has completed ↓ its operation.↲ ↲ ┆a1┆Host link selection↲ Consider the situation when an emulated display device ↓ belonging to a cluster with multiple host links is activated ↓ in a terminal or PC. The CU must then attach the device to a ↓ host link. This is done by presenting a menu on the terminal ↓ display allowing the operator to select any one of the host ↓ links.↲ Host links must therefore have names which can be shown in ↓ the host link menu. The name of the host link to which the ↓ device is attached is shown in the status line of the ↓ display during normal emulator operation.↲ If there is only one host link, an activated display ↓ device is automatically attached to this link. No menu is ↓ shown, but the link name will appear in the status line.↲ For remote links, the link names may be defined as part of ↓ CU customization. For local links, the names are received ↓ from the host, and cannot be changed at the CU.↲ ↲ ┆a1┆Skipping the host link menu┆e1┆. It is possible to supply a host ↓ link name as a parameter when the 3270 emulator program for ↓ RC45 or RC855 terminal is loaded. If such a name is present ↓ the emulator will skip the menu presentation and automa┄↓ tically attach the device to the link. This feature is only ↓ relevant if multiple links exist. See the description of ↓ download menu customization (section D.2, Download menus) ↓ for information on how to pass parameters to the terminal ↓ emulators.↲ ↲ ┆8c┆┆83┆┆bc┆↓ ┆a1┆Remote host links↲ A remote host link can be established via a permanent ↓ (leased) or dial-up telephone line to the host computer. The ↓ CU must be connected to the telephone line by means of a ↓ modem according to CCITT interface standard V.24.↲ Alternatively, a remote host link can be established via a ↓ circuit-switched public data network. In this case the CU ↓ must be connected to the network by means of a DCE according ↓ to CCITT interface standard X.21.↲ The communication protocol used on the host link can be ↓ either BSC or SNA/SDLC.↲ ↲ ┆a1┆IBM-compatible links┆e1┆. Three combinations of line kind and ↓ protocol, viz. V.24-BSC, V.24-SNA/SDLC and X.21-SNA/SDLC, ↓ enable the CU to communicate with standard IBM products and ↓ compatible products from other vendors. In these cases there ↓ is a one-to-one relationship between the modem (V.24 signal ↓ cable) or DCE (X.21 signal cable) and a host link. Notice ↓ that such a host link may provide access to several appli┄↓ cations running on the same host computer, or in fact to ↓ several host computers in the case of an SNA network. ↓ However, from the point of view of the CU and the terminal ↓ emulator there is only one host link.↲ The CU communicates with each remote host as if it were an ↓ IBM 3274 control unit. When multiple host links exist the ↓ hosts need not be aware of each other.↲ ↲ ┆a1┆X.21-BSC┆e1┆. The fourth combination of line kind and protocol, ↓ X.21-BSC, is not supported by IBM or IBM-compatible vendors. ↓ This combination therefore requires a special front-end (FE) ↓ computer, the RC3803, at the host site. By utilizing the ↓ fast switching capability of the public network - assuming ↓ it is indeed fast - to hold a line only when there is actual ↓ data traffic, the CU is able to maintain communication with ↓ up to 4 FEs simultaneously per DCE, i.e. per X.21 subscriber ↓ attachment (in IBM termi┄nology this technique is referred to ↓ as "short-hold mode with multiple port sharing").↲ ┆8c┆┆83┆┆bc┆↓ As in the case of IBM-compatible links we shall refer (in ↓ main sections D and E) to the connection between the CU and ↓ the X.21 DCE as a link. However, with respect to host link ↓ selection this link has up to four ┆a1┆sublinks┆e1┆, one per RC3803 ↓ FE, each with its own link name.↲ ↲ ┆a1┆Dual host configuration┆e1┆. The CU may be configured with ↓ connections to one or two modems or X.21 DCEs. A config┄↓ uration with two such connections is referred to as "dual ↓ host". The various combinations of line kind and protocol ↓ may be freely mixed on the two connections of a dual host ↓ configured CU. It should be clear from the discussion above ↓ that if the X.21-BSC combination is used on (at least) one ↓ of the two connections the number of host links may be ↓ greater than two. The phrase "dual host" is therefore ↓ slightly misleading.↲ Figure B-1 shows an example configuration with three ↓ remote host links.↲ ↲ ┆a1┆Local host links↲ Local host links are established on a LAN. The host computer ↓ must be an RC8000 attached to the LAN by means of a so-↓ called Attached Device Processor (ADP). The number of host ↓ links is customized in the ADP. It is possible to customize ↓ so that each one of possibly several applications on the ↓ RC8000 host has its own link. Local links are logical in ↓ nature since they all share the same physical LAN.↲ ↲ ┆a1┆Emulated 3270 devices↲ ↲ 3270-type devices can be emulated on several different kinds ↓ of equipment which of course must be connected to the CU. ↓ The different emulators may be freely combined in a cluster.↲ An RC45 or RC855 terminal, which is connected to the CU ↓ via RcCircuit and runs the 3270 emulator program, supports ↓ up to two display devices and one printer device. Only one ↓ ┆8c┆┆83┆┆b0┆↓ ┆0e┆↓ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ╞ < Figure B-1 >↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ┆0f┆↓ of the display devices is visible, but the operator can ↓ switch display device at any time.↲ A PC, which is connected to the CU via a LAN and runs its ↓ version of the 3270 emulator program, supports up to four ↓ display devices and four printer devices. Normally, the ↓ operator sees only one display device at a time, but can ↓ switch among them. By means of windows, parts of two or more ↓ display devices may be visible simultaneously. It is not ↓ possible to connect four printers directly to the same PC, ↓ so some of them may be reached via re-routing through the ↓ ════════════════════════════════════════════════════════════════════════ ↓ LAN. This re-routing is handled by the emulator program ↓ running on the PC and is unknown to the CU.↲ In addition to emulated devices which are mapped to ↓ physical devices by emulator programs in terminals or PCs, ↓ the CP itself may be configured to maintain a number of ↓ "soft devices". The soft devices have no physical mani┄↓ festation, but they behave exactly like other devices toward ↓ the host. Operations on soft devices can be performed by ↓ application programs running on the RC39 LAP or possibly on ↓ another processor connected to the CP by a LAN. The soft ↓ devices allow such programs to access host computers as if ↓ they were terminal operators.↲ An example system with several different kinds of emulated ↓ devices is shown in Figure B-2. The letter D indicates a ↓ display device and the letter P a printer device.↲ The device numbers used to address the individual devices ↓ in an emulated 3270 cluster are in general ┆a1┆not┆e1┆ customized ↓ as parameters of the CU, but as parameters of the units, ↓ i.e. terminals or PCs, where the devices reside. Soft ↓ devices, however, are customized as CP parameters, since ↓ these devices do reside within the CP.↲ This customization method is intended to be flexible and ↓ easy to use: it is not necessary to change the customization ↓ of the CU because a new terminal is added to the cluster. As ↓ a consequence, the CU, when it begins operation upon load, ↓ has no knowledge of the device configuration of the cluster. ↓ If configuration errors exist, i.e. if the same device ↓ number has been used for emulated devices in two or more ↓ units or twice in the same unit, this will not be uncovered ↓ until both devices become active simultaneously. When such a ↓ situation arises, the CU will reject the second device which ↓ attempts to use the contested device number.↲ ┆8c┆┆83┆┄↓ ┆0e┆↓ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ╞ < Figure B-2 >↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ┆0f┆↓ ════════════════════════════════════════════════════════════════════════ ↓ ↓ ════════════════════════════════════════════════════════════════════════ ↓ ┆14┆┆b3┆↲ ┆14┆┆b1┆┆b0┆ RC3931 Communications Processor┆05┆Software Installation C↲ ┆14┆┆b2┆┆b0┆ C Software Installation┆05┆RC3931 Communications Processor ↲ ┆15┆┆b3┆↲ ┆15┆┆b1┆┆b0┆ Update 1/86┆05┆Page C-┆0b┆ C↲ ┆15┆┆b2┆┆b0┆ C Page C-┆0b┆┆05┆Update 1/86 ↲ ╱04002d4e0a000600000000030c4731400000000000000000000000000000000000000000000000000c16202a343e48525c66707a848e98ff04╱ ╱04002d4e0a000600000000030c4731400000000000000000000000000000000000000000000000000c16202a343e48525c66707a848e98ff04╱ ↓ ┆a1┆C. Software Installation↲ ↲ Like other SW packages for the RC39 MUCS the packages for ↓ the CP are distributed on diskettes. There is a general SW ↓ installation utility program for the RC39 MUCS which is used ↓ to move the files present on a distribution diskette to the ↓ disk of the RC39 system. This program is also used for the ↓ SW packages involving the CP, including programs to be ↓ downloaded to terminals. It helps the person installing a SW ↓ package by prompting, instructing, and displaying informa┄↓ tive messages as it goes along. A general description of the ↓ installation procedure is found in ref. 1.↲ The installation program may be entered through the system ↓ administration menu or simply by logging in to the XENIX ↓ operating system as root (super user) and typing the install ↓ command.↲ ↲ ┆a1┆After installation↲ ↲ In most situations it will be necessary to customize an ↓ installed package after the files have been read. A detailed ↓ discussion of this subject is found in main section D. Only ↓ some hints about the most important items are given here.↲ Note that after installation and customization the CP must ↓ be reset before the new functions can be used, cf. section ↓ E, Resetting the CP.↲ ↲ ┆a1┆SW3882 (ANSI X3.64 terminal ↓ ┆19┆┄┄┆84┆program)┆e1┆: Check that all terminals can be downloaded; try to ↓ load the ANSI X3.64 terminal program. If unsuccessful, check ↓ that the secondary address of the failing terminal is in the ↓ range 0..15.↲ ↲ ════════════════════════════════════════════════════════════════════════ ↓ ┆a1┆SW3802 (Teletex)┆e1┆: Make sure the signal cables are correctly ↓ mounted, connecting the CP to the X.21 DCE, cf. section E, ↓ External cable connections.↲ ↲ ┆a1┆SW3803 and SW3881 (3270 emulation)┆e1┆: Check device numbers in all ↓ terminals using the downloaded configurator (not one loaded ↓ from PROMs in the terminal), cf. section E, Device number ↓ management.↲ Update the configuration file (CONFIG.CST) to include the ↓ appropriate 3270 configuration switch(es).↲ Update the parameters for the remote host link(s) in the ↓ file COMM.CST, cf. sections D.2, Parameters for BSC links ↓ and/or Parameters for SNA/SDLC links. Unless the kind of the ↓ link(s) (V.24/X.21) is specified appropriately and the CU ↓ number (BSC) and SDLC address (SNA/SDLC) and other essential ↓ communication parameter are correctly specified, communi┄↓ cation cannot take place. The parameters which can be ↓ specified in the remaining *.CST files are less critical.↲ Make sure the signal cables are correctly mounted, ↓ connecting the CP to the V.24 modem or X.21 DCE, cf. section ↓ E, External cable connections.↲ ↲ ┆a1┆SW3804 (3270 programmer's toolkit)┆e1┆: Select and customize ↓ device numbers for soft devices, cf. section E, Device ↓ number management, and D.2, Soft devices.↲ Activate the soft device function by setting the SOFTDEV ↓ switch in the configuration file (CONFIG.CST), cf. section ↓ D.1, Soft devices.↲ ════════════════════════════════════════════════════════════════════════ ↓ ┆14┆┆b3┆↲ ┆14┆┆b1┆┆b0┆ RC3931 Communications Processor┆05┆System Customization D↲ ┆14┆┆b2┆┆b0┆ D System Customization┆05┆RC3931 Communications Processor ↲ ┆15┆┆b3┆↲ ┆15┆┆b1┆┆b0┆ Update 1/86┆05┆Page D.1-┆0b┆ D↲ ┆15┆┆b2┆┆b0┆ D Page D.1-┆0b┆┆05┆Update 1/86 ↲ ╱04002d4e0a000600000000030c4731000000000000000000000000000000000000000000000000000c16202a343e48525c66707a848e98ff04╱ ╱04002d4e0a000600000000030c4731400000000000000000000000000000000000000000000000000c16202a343e48525c66707a848e98ff04╱ ↓ ┆a1┆D. System Customization↲ ↲ The RC3931 Communications Processor can be configured and ↓ customized in a simple and flexible manner. All information ↓ concerning the configuration and customization of a CP is ↓ collected in a number of text files which are read by the CP ↓ when its software is loaded.↲ The term configuration is used to refer to the selection ↓ of functions in a given CP system. The configuration of a CP ↓ determines which software modules are loaded and activated. ↓ By customization, on the other hand, we refer to the control ↓ at a detailed level of operational parameters for the ↓ modules which have been selected for a configuration.↲ There is one file, the ┆a1┆configuration file┆e1┆, which contains ↓ a description of the CP configuration, and a number of ↓ files, the ┆a1┆parameter files┆e1┆, which contain specifications of ↓ customization parameters. This main section is concerned ↓ with the form and meaning of the contents of these files. ↓ Practical aspects, such as finding the files and editing ↓ them, are discussed in main section E.↲ Whenever the CP is reset (cf. section E, Resetting the ↓ CP), an initial program is executed which reads the con┄↓ figuration file, determines which software modules to load, ↓ and then reads the parameter files to obtain parameters for ↓ the activation of these modules. Default values for all the ↓ parameters are built into the initial program, and these ↓ values remain in effect in all cases where no modification ↓ is read from the appropriate parameter file. Consequently, ↓ the parameter files need only contain specifications of ↓ deviations from the default parameter values for those ↓ functions which are active.↲ As a general rule all the files have a name of the form ↓ *.CST, where * stands for some sequence of letters, and CST ↓ is intended as a mnemonic for "CuSTomization". Similarly the ↓ * part of the name is chosen so as to give a clue to the ↓ subject of the contents of the file.↲ ════════════════════════════════════════════════════════════════════════ ↓ Another rule is that semicolons (;) may be used in the ↓ files to introduce comments; i.e. the part of a text line ↓ which follows a semicolon is ignored, when the files are ↓ read during load of the CP, and may contain explanatory ↓ information for the system administrator who will be ↓ responsible for editing the files.↲ ↲ ┆a1┆D.1 Configuration↲ ↲ The significant part of the configuration file - excluding ↓ comments - is a list of so-called configuration switches, ↓ each of which causes a particular function or set of ↓ functions to be activated or deactivated. Syntactically, a ↓ configuration switch is just a sequence of characters. In ↓ the list, the configuration switches may be separated by ↓ commas (,) and/or newline characters.↲ Configuration switches requesting functions for which the ↓ necessary software has not been installed will, in general, ↓ not have any effect.↲ The name of the configuration file is CONFIG.CST. The ↓ distributed version of this file is empty. There is another ↓ file, DEFAULT.CFG, which contains a number of comment lines ↓ explaining how to set configuration switches. The intention ↓ is that the user (system administrator) may create the ↓ proper configuration file by editing the DEFAULT.CFG file. ↓ The remaining part of this section goes into more detail ↓ than the explanation found in the distributed file.↲ ↲ ┆a1┆Basic functions↲ ↲ The basic transport service across a LAN is activated by the ↓ configuration switch LAN.↲ The other basic functions: RcCircuit-I communication and ↓ download to terminals are activated by default, since they ↓ are normally always required to be active. It is possible to ↓ deactivate these functions by means of the configuration ↓ switches -1CIRC and -MDLL, respectively. Beware, however, ↓ ┆8c┆┆83┆┆bc┆↓ that deactivation of RcCircuit-I commu┄nication will disable ↓ any form of communication between terminals and the CP.↲ ↲ ┆a1┆IBM 3270 emulation↲ ↲ There are two aspects of 3270 emulation which are configured ↓ independently: 1) the ability to communicate with one or ↓ more host computers via one or more links, and 2) soft ↓ devices which reside within the CP and may be accessed from ↓ programs running on the RC39 LAP or other processors ↓ attached to the LAN (if there is one).↲ ↲ ┆a1┆Remote host links↲ A "dual host" configuration is one which supports two remote ↓ links (with possible sublinks in the X.21-BSC case). For ↓ each link there is a connection to a V.24 modem or an X.21 ↓ DCE. A "high performance" configur┄ation supports only one ↓ remote link, but allows a data transfer rate up to 19200 ↓ bps. The maximum data transfer rate in dual host as well as ↓ ordinary single host configur┄ations is 9600 bps.↲ Because the protocols BSC and SNA/SDLC are handled by ↓ different software modules, protocol selection is also a ↓ configuration issue, whereas line kind selection (V.24 or ↓ X.21) is handled by means of a customization parameter.↲ There are seven configuration switches which activate 3270 ↓ emulation with remote link support. At most one of these may ↓ be present in the configuration file. The switches are:↲ ↲ ┆a1┆conf.switch╞ description╞ ╞ ↲ 3270B╞ Single host BSC, ordinary↲ 3270BH╞ Single host BSC, high performance↲ 3270BD╞ Dual host, both BSC↲ 3270S╞ Single host SNA/SDLC, ordinary↲ 3270SH╞ Single host SNA/SDLC, high performance↲ 3270SD╞ Dual host, both SNA/SDLC↲ 3270BS╞ Dual host, one BSC, one SNA/SDLC↲ ↲ ┆8c┆┆83┆┆bc┆↓ In order to distinguish the links in dual host configur┄↓ ations the specifications of customization parameters (see ↓ section D.2) use the concept of a link number which can be 1 ↓ or 2. Link number 2 will apply only to dual host configur┄↓ ations where the same protocol is used for both links ↓ (3270BD or 3270SD). In single host configurations and mixed ↓ protocol dual host configurations the link/both links is/are ↓ defined to be link number 1, and the link number may be ↓ omitted from parameter specifications as it is not needed to ↓ identify the link (the BSCID and BSCXNO parameters are ↓ exceptions from this general rule).↲ ↲ ┆a1┆Local host links↲ The configuration switch CULANI (3270 ┆a1┆CU┆e1┆ emulation with ┆a1┆LAN┆e1┆ ↓ ┆a1┆I┆e1┆nterface) will activate 3270 emulation with support for ↓ local host links. This switch may be present together with ↓ any one of the switches mentioned under remote host links, ↓ or with none of them.↲ ↲ ┆a1┆Soft devices↲ The configuration switch SOFTDEV will activate one or more ↓ soft 3270 devices. The device numbers of soft devices must ↓ be specified by a customization parameter. Unless either ↓ remote or local host links are also activated, the soft ↓ devices will not be able to communicate with a host.↲ ↲ ┆a1┆Teletex↲ ↲ The Teletex service is activated by the configuration switch ↓ TTX.↲ ════════════════════════════════════════════════════════════════════════ ↓ ┆14┆┆b3┆↲ ┆14┆┆b1┆┆b0┆ RC3931 Communications Processor┆05┆System Customization D↲ ┆14┆┆b2┆┆b0┆ D System Customization┆05┆RC3931 Communications Processor ↲ ┆15┆┆b3┆↲ ┆15┆┆b1┆┆b0┆ Update 1/86┆05┆Page D.2-┆0b┆ D↲ ┆15┆┆b2┆┆b0┆ D Page D.2-┆0b┆┆05┆Update 1/86 ↲ ╱04002d4e0a000600000000030c4731400000000000000000000000000000000000000000000000000c161b202a343e48525c66707a848eff04╱ ╱04002d4e0a000600000000030c4731000000000000000000000000000000000000000000000000000c16202a343e48525c66707a848e98ff04╱ ↓ ┆a1┆D.2 Customization, Parameter Files↲ ↲ In order to simplify the task of customization by text file ↓ editing, the customization parameters have been divided into ↓ groups according to subject. A parameter file is defined for ↓ each group of parameters. A value for a given parameter must ↓ be specified in the file to which the parameter has been ↓ assigned. If a parameter specification is placed in a wrong ↓ file it will have no effect.↲ There are five parameter files. These, and the associated ↓ ╱04002d4e0a000600000000020c4731000000000000000000000000000000000000000000000000000c161b202a343e48525c66707a848eff04╱ ╱04002d4e0a000600000000030c4731400000000000000000000000000000000000000000000000000c161b202a343e48525c66707a848eff04╱ ↓ subjects are:↲ ↲ ╱04002d4e0a000600000000030c4731000000000000000000000000000000000000000000000000000c161b202a343e48525c66707a848eff04╱ ╱04002d4e0a000600000000020c4731000000000000000000000000000000000000000000000000000c161b202a343e48525c66707a848eff04╱ ↓ MENUDL.CST╞ Download menus.↲ CONV1.CST╞ ╞ Conversion between EBCDIC character code used↲ (CONV.CST)╞ for transmission on remote host links and the↲ CONV2.CST╞ ╞ ┆84┆internal character code used by the CP and ↓ ┆19┆┆8f┆┄┄emulated 3270 devices.↲ TEXTS.CST╞ ╞ Texts for status lines and host link menus.↲ COMM.CST╞ ╞ ┆84┆Communication, both local and remote, and ↓ ┆19┆┆8f┆┄┄device cluster control.↲ ↲ ┆a1┆Parameter file syntax↲ ↲ Each line in one of the parameter files contains the speci┄↓ fication of a parameter value, or just a comment if the line ↓ begins with a semicolon. A parameter specification line ↓ always begins with the name of the parameter, which is a ↓ sequence of letters (at most 8), possibly followed by some ↓ further information to identify the desired parameter, ↓ typically an index when several similar parameters are ↓ organized in a table. Then follows an equals sign and the ↓ value to be used for the parameter in question.↲ In the subsections dealing with the individual parameter ↓ files each parameter specification line is shown in a ↓ generic form which indicates the proper syntax. In these ↓ lines parentheses are used to delimit optional parts, ↓ slashes (/) to delimit alternatives, and words or phrases ↓ ════════════════════════════════════════════════════════════════════════ ↓ written in small case letters to indicate parts whose syntax ↓ is explained in subsequent paragraphs.↲ On the other hand, the parameter name which occurs at the ↓ beginning of each parameter line written in capital letters, ↓ comma (,), equals sign (=) and binary digits (0/1) shall be ↓ used literally in actual parameter lines.↲ Whenever a parameter specification includes a text ↓ (character string), each character following the preceeding ↓ delimiter (comma or equals sign) is significant, i.e. a ↓ character string may include leading blanks. On the other ↓ hand, a numeric parameter may be preceeded by blanks, which ↓ in this case have no significance.↲ In the following subsections, the generic form of each ↓ parameter specification line is shown as the part to the ↓ right of the colon in the headline introducing the de┄↓ scription of the parameter.↲ ↲ ┆a1┆Download menus (MENUDL.CST)↲ ↲ The menu-based terminal downloader identifies terminals by ↓ their addresses as secondary stations on the RcCircuit-I (SA ↓ parameter in the configuration of the terminal). The default ↓ menus are identical for all terminals. Figure D-1 shows the ↓ default menu as it appears on a terminal. Three texts frame ↓ ╱04002d4e0a000600000000020c4731000000000000000000000000000000000000000000000000000c161b202a343e48525c66707a848eff04╱ ╱04002d4e0a000600000000030c4731000000000000000000000000000000000000000000000000000c161b202a343e48525c66707a848eff04╱ ↓ the menu:↲ ↲ ╱04002d4e0a000600000000030c4731000000000000000000000000000000000000000000000000000c161b202a343e48525c66707a848eff04╱ ╱04002d4e0a000600000000020c4731000000000000000000000000000000000000000000000000000c161b202a343e48525c66707a848eff04╱ ↓ 1. TERMINAL FUNCTION MENU↲ 2. Key Description↲ ╱04002d4e0a000600000000020c4731000000000000000000000000000000000000000000000000000c161b202a343e48525c66707a848eff04╱ ╱04002d4e0a000600000000030c4731000000000000000000000000000000000000000000000000000c161b202a343e48525c66707a848eff04╱ ↓ 3. Press function key to select application↲ ↲ ╱04002d4e0a000600000000030c4731000000000000000000000000000000000000000000000000000c161b202a343e48525c66707a848eff04╱ ╱04002d4e0a000600000000020c4731000000000000000000000000000000000000000000000000000c161b202a343e48525c66707a848eff04╱ ↓ These "frame texts" appear in fixed positions on the ↓ display, but may be modified using the FTEXT parameter ↓ specification. They will appear identically on all terminals ↓ connected to the CU. The key names (PF1, PF2, PF3) cannot be ↓ modified; they correspond to engravings on the keys. Each ↓ line centered underneath the two frame lines at the top ↓ represents a terminal program which can be selected for↲ ════════════════════════════════════════════════════════════════════════ ↓ ╞ ╞ TERMINAL FUNCTION MENU↲ ↲ ╞ ╞ Key Description↲ ↲ ╞ ╞ PF1 ANSI X3.64 Terminal↲ ╞ ╞ PF2 IBM 3270 Emulator↲ ╞ ╞ PF3 Terminal Configurator↲ ↲ ↲ ↲ ↲ ↲ ↲ Press function key to select application↲ ↲ ↲ Figure D-1. Default terminal download menu.↲ ↲ download. The CU must know three things, each represented by ↓ ╱04002d4e0a000600000000020c4731000000000000000000000000000000000000000000000000000c161b202a343e48525c66707a848eff04╱ ╱04002d4e0a000600000000030c4731000000000000000000000000000000000000000000000000000c161b202a343e48525c66707a848eff04╱ ↓ a character string, about a terminal program:↲ ↲ ╱04002d4e0a000600000000030c4731000000000000000000000000000000000000000000000000000c161b202a343e48525c66707a848eff04╱ ╱04002d4e0a000600000000020c4731000000000000000000000000000000000000000000000000000c161b202a343e48525c66707a848eff04╱ ↓ 1. ┆84┆A file name whereby the file containing the program to be ↓ ┆19┆┆83┆┄┄downloaded will be retrieved. These names are automati┄↓ ┆19┆┆83┆┄┄cally extended with ".855" or ".S45" for an RC855 or RC45 ↓ ┆19┆┆83┆┄┄terminal, respectively, to obtain the actual file name. ↓ ┆19┆┆83┆┄┄For example, if the file name is specified as CONFI the ↓ ┆19┆┆83┆┄┄actual name of the program file which is downloaded to an ↓ ┆19┆┆83┆┄┄RC45 terminal is CONFI.S45. Because of the automatic ↓ ┆19┆┆83┆┄┄extension, the same terminal program specifications may ↓ ╱04002d4e0a000600000000020c4731000000000000000000000000000000000000000000000000000c161b202a343e48525c66707a848eff04╱ ╱04002d4e0a000600000000030c4731000000000000000000000000000000000000000000000000000c161b202a343e48525c66707a848eff04╱ ↓ ┆19┆┆83┆┄┄be used for both RC855 and RC45 terminals.↲ ↲ ╱04002d4e0a000600000000030c4731000000000000000000000000000000000000000000000000000c161b202a343e48525c66707a848eff04╱ ╱04002d4e0a000600000000020c4731000000000000000000000000000000000000000000000000000c161b202a343e48525c66707a848eff04╱ ↓ 2. ┆84┆A description to appear in the menu line representing the ↓ ╱04002d4e0a000600000000020c4731000000000000000000000000000000000000000000000000000c161b202a343e48525c66707a848eff04╱ ╱04002d4e0a000600000000030c4731000000000000000000000000000000000000000000000000000c161b202a343e48525c66707a848eff04╱ ↓ ┆19┆┆83┆┄┄terminal program, e.g. "IBM 3270 Emulator".↲ ↲ ╱04002d4e0a000600000000030c4731000000000000000000000000000000000000000000000000000c161b202a343e48525c66707a848eff04╱ ╱04002d4e0a000600000000020c4731000000000000000000000000000000000000000000000000000c161b202a343e48525c66707a848eff04╱ ↓ 3. ┆84┆(optional) A parameter to be supplied to the terminal ↓ ┆19┆┆83┆┄┄program subsequent to download. See section B.2, Skipping ↓ ┆19┆┆83┆┄┄the host link menu, for a description of how the 3270 ↓ ┆19┆┆83┆┄┄terminal emulators use such a parameter.↲ ↲ ════════════════════════════════════════════════════════════════════════ ↓ ┆a1┆Frame text┆e1┆: FTEXT,ftno=text↲ FTEXT specifies one of the frame texts of the download menu. ↓ Ftno is a number: 1, 2 or 3, which identifies the particular ↓ text. The numbering is as indicated above for the default ↓ texts. The text may be at most 45 characters long.↲ ↲ ┆a1┆Error text┆e1┆: ETEXT,etno=text↲ ETEXT specifies a text which may occur as an error message ↓ in the status (bottom) line of the terminal in case of an ↓ error during download. Etno must be a number in the range ↓ 1..4, and the text may be at most 25 characters long. The ↓ four default texts are shown in the example below. The error ↓ situations they refer to are described in section F, Error ↓ messages during download.↲ ↲ ┆a1┆Terminal program┆e1┆: TPRG,tpno=fname,desc(,param)↲ TPRG specifies a terminal program which may be referred to ↓ in terminal menu specifications (TMENU, see below) by its ↓ number, given as tpno, which must be in the range 0..25. ↓ Thus there can be at most 26 terminal programs. Fname is the ↓ file name, at most 8 characters; desc is the description, at ↓ most 25 characters; the optional part param is the character ↓ string which, if present, will be passed to the downloaded ↓ program, at most 89 characters.↲ If fname is specified as A: no program will be downloaded; ↓ instead the terminal, which must be an RC855 workstation, ↓ will load the CP/M operating system from the local diskette. ↓ A program to be loaded from the floppy disk may be specified ↓ in the param part using capital letters. This feature may be ↓ used to combine local programs with down┄loaded programs ↓ providing a unified method of selecting ↓ ╱04002d4e0a000600000000020c4731000000000000000000000000000000000000000000000000000c161b202a343e48525c66707a848eff04╱ ╱04002d4e0a000600000000030c4731000000000000000000000000000000000000000000000000000c161b202a343e48525c66707a848eff04╱ ↓ terminal function. Example:↲ ↲ TPRG,7=A:,RcTekst,RCTEKST↲ ↲ ╱04002d4e0a000600000000030c4731000000000000000000000000000000000000000000000000000c161b202a343e48525c66707a848eff04╱ ╱04002d4e0a000600000000020c4731000000000000000000000000000000000000000000000000000c161b202a343e48525c66707a848eff04╱ ↓ The same file name may be used in several terminal program ↓ specifications. This can be meaningful if the desc and param ↓ parts are different.↲ ↲ ┆8c┆┆83┆┆c4┆↓ ┆a1┆Terminal menu┆e1┆: TMENU,secaddr=tpnolist↲ TMENU specifies the menu for a terminal whose secondary ↓ address is given as secaddr, a number in the range 0..31. ↓ Tpnolist is a list of terminal program numbers. It must ↓ consist of numbers which have appeared in TPRG parameter ↓ specification lines prior to the TMENU line. The numbers ↓ must be separated by commas.↲ A number may be immediately preceeded by D to indi┄cate a ↓ default terminal program. If a terminal is configured for ↓ default download and its menu contains a default terminal ↓ program, then no menu is shown when the terminal is powered ↓ on or reset. Instead, the default program is loaded without ↓ requiring selection by the operator.↲ ↲ ┆a1┆Example↲ As an example, the following lines could be used to specify ↓ the default menu (also found in the distributed file ↓ DEFAULT.MDL):↲ ↲ FTEXT,1=TERMINAL FUNCTION MENU; default download menu↲ FTEXT,2=Key Description↲ FTEXT,3=Press function key to select application↲ ETEXT,1=Disk access error↲ ETEXT,2=CU disconnected↲ ETEXT,3=Checksum error↲ ETEXT,4=Program not found↲ TPRG,0=CONFI,Terminal Configurator↲ TPRG,1=3270,IBM 3270 Emulator↲ TPRG,2=ANSI,ANSI X3.64 Terminal↲ TMENU,0=D2,1,0↲ TMENU,1=D2,1,0↲ TMENU,2=D2,1,0↲ TMENU,3=D2,1,0↲ ...↲ TMENU,31=D2,1,0↲ ↲ ════════════════════════════════════════════════════════════════════════ ↓ ┆a1┆Conversion tables (CONV1.CST, CONV2.CST)↲ ↲ Two different kinds of character encoding are used by the ↓ 3270 emulation system. Externally, when characters are ↓ transmitted on remote host links in BSC or SNA/SDLC ↓ protocol, the character code is EBCDIC according to IBM ↓ convention. Displayable characters have EBCDIC codes in the ↓ range 64..255 (40┆82┆Hex┆81┆..FF┆82┆Hex┆81┆). Internally, when characters ↓ are stored and manipulated in device buffers within the CU ↓ as well as by terminal emulator programs, characters have ↓ codes in accordance with ISO standard 646 (7-bit coded ↓ character set for information processing interchange), i.e. ↓ ASCII-like. In this encoding displayable characters have ↓ codes in the range 32..126 (20┆82┆Hex┆81┆..7E┆82┆Hex┆81┆).↲ As a consequence of the two kinds of encoding the CU must ↓ perform a conversion. Characters received from a remote host ↓ are converted from EBCDIC representation to internal code ↓ using a table called the intcode-table (because its output ↓ is internal code). Conversely, before transmission to a ↓ remote host, characters are converted from the internal ↓ representation to EBCDIC using another table, the ebcdic-↓ table.↲ The internal character set, i.e. character repertoire and ↓ encoding, is implemented in terminals by means of character ↓ image generators and tables in PROMs. A number of national ↓ versions of the internal character set are supported with RC ↓ terminal products, see appendix H.2. The character set must ↓ be the same for all terminals in a cluster. Once chosen, it ↓ must be regarded as fixed for the installation.↲ Given the internal character set, the same character ↓ repertoire, or a subset thereof, must necessarily be ↓ employed in communication with remote hosts. However, by ↓ modifying the conversion tables it is possible to customize ↓ the EBCDIC encoding of the available characters.↲ In the case of multiple remote host links (dual host ↓ confi┄guration) it may not be appropriate to use the same ↓ EBCDIC code in communication with all/both hosts. The CU ↓ ┆8c┆┆83┆┆bc┆↓ therefore supports two different EBCDIC codes, called EBCDIC ↓ code 1 and EBCDIC code 2, implemented by means of two pairs ↓ of conversion tables, each pair consisting of an intcode ↓ table and an ebcdic table. The EBCDIC code to be used on a ↓ given remote host link is selected by means of the BSCCONV ↓ or SNACONV parameter specification; see the section Commu┄↓ nication parameters (COMM.CST) below.↲ The default conversion, identical for both pairs of ↓ tables, is between US English (ASCII) internal code (see ↓ appendix H.2) and US English EBCDIC code (see appendix H.3). ↓ Each displayable character entry in each of the conversion ↓ tables may be modified by means of an appropriate parameter ↓ specification line. The modifications specifying EBCDIC code ↓ 1 are defined in the file CONV1.CST (or in the absence of ↓ such a file, by the file CONV.CST), and those specifying ↓ EBCDIC code 2 in the file CONV2.CST. The same syntax applies ↓ to both of these files; see below.↲ Those modifications to the default conversion tables ↓ which are necessary in order to support a given internal ↓ character set and a corresponding EBCDIC encoding may be ↓ derived from a com┄parison of charts for the codes in ↓ question with the default code charts as shown in the ↓ appendices mentioned above. The number of changes that are ↓ necessary will depend on how different the code charts are ↓ from the default ones.↲ When the internal character sets supported with RC ↓ terminal products and the corresponding standard EBCDIC ↓ encodings are used (see appendix H.3) it is not necessary ↓ for the user to devise conversion table modifications, as ↓ all standard sets of modifications are provided in the form ↓ of files distributed in the basic SW package for the CP (cf. ↓ section E, Selecting character conversion).↲ ↲ ┆a1┆Conversion to internal code┆e1┆: INTCODE,ecode=icode↲ Each INTCODE parameter line specifies one entry in the ↓ intcode-table. Ecode is the EBCDIC code, i.e. the input to ↓ the table lookup; it must be written as a hexadecimal number ↓ ┆8c┆┆83┆┆bc┆↓ in the range 40..FF. Icode is the internal code, i.e. the ↓ output of the table lookup; it must be written as a hexa┄↓ decimal number in the range 20..7E.↲ When a particular EBCDIC code is not used it is appro┄↓ priate to specify the internal code as null (0).↲ ↲ ┆a1┆Conversion to EBCDIC code┆e1┆: EBCDIC,icode=ecode↲ Each EBCDIC parameter line specifies one entry in the ↓ ebcdic-table. Icode is the internal code, i.e. the input to ↓ the table lookup; it must be written as a hexadecimal number ↓ in the range 20..7E. Ecode is the EBCDIC code, i.e. the ↓ output of the table lookup; it must be written as a hexa┄↓ decimal number in the range 40..FF.↲ ↲ ┆a1┆Displayable texts (TEXTS.CST)↲ ↲ Messages shown to the operator of a terminal or PC which ↓ emulates a 3270 display device in the host link menu or in ↓ the status line may be customized in the file TEXTS.CST. All ↓ the parameters described in this section are specified as ↓ character strings.↲ ↲ ┆a1┆Host link menu heading┆e1┆: HOSTMENU=htext↲ HOSTMENU specifies the text to be written as a heading in ↓ the host link menu. The maximum length of htext is 32 ↓ characters.↲ The default text is: Host link menu↲ ↲ ┆a1┆BSC link name┆e1┆: BSCID(,linkno(,sublinkno))=lname↲ BSCID specifies the name of a remote BSC host link or sub┄↓ link.↲ Sublinkno must be present if the link kind is X.21 and ↓ must be left out if it is V.24. If present, it identifies ↓ the sublink and must be a number in the range 1..4.↲ Linkno may be omitted unless the configuration is dual ↓ host with two BSC links. However, in the case of an X.21 ↓ link, i.e. if sublinkno is present, linkno must not be ↓ ┆8c┆┆83┆┆bc┆↓ omitted even if there is only one BSC link. It specifies the ↓ number of the link and must be 1 or 2.↲ Lname is the link name which will be shown in the host ↓ link menu and in the status line of display devices which ↓ are attached to the link. The maximum length of lname is 12 ↓ characters.↲ The same name may not be given to two different links.↲ ↲ ┆a1┆SNA/SDLC link name┆e1┆: SNAID(,linkno)=lname↲ SNAID specifies the name of a remote SNA/SDLC host link.↲ Linkno may be omitted unless the configuration is dual ↓ host with two SNA/SDLC links. It specifies the number of the ↓ link and must be 1 or 2.↲ Lname is the link name which will be shown in the host ↓ link menu and in the status line of display devices which ↓ are attached to the link. The maximum length of lname is 12 ↓ characters.↲ The same name may not be given to two different links.↲ ↲ ┆a1┆Device status message┆e1┆: DSTEXT,dstno=dsmsg↲ DSTEXT specifies one of the messages which may be shown in ↓ the status line of an emulated 3270 display device to inform ↓ the operator of the status of the display device or of ↓ another device (printer or card reader) on which an ↓ operation was attempted.↲ Dstno is the number of the status message and must be in ↓ the range 1..12. The maximum length of dsmsg is 21 charac┄↓ ters. The default status messages and their numbers are ↓ ╱04002d4e0a000600000000020c4731000000000000000000000000000000000000000000000000000c161b202a343e48525c66707a848eff04╱ ╱04002d4e0a000600000000030c4731000000000000000000000000000000000000000000000000000c161b202a343e48525c66707a848eff04╱ ↓ shown below. Note that they all begin with a blank.↲ ↲ ╱04002d4e0a000600000000030c4731000000000000000000000000000000000000000000000000000c161b202a343e48525c66707a848eff04╱ ╱04002d4e0a000600000000020c4731000000000000000000000000000000000000000000000000000c161b202a343e48525c66707a848eff04╱ ↓ 1= Printer not ready↲ 2= Print cancelled↲ 3= Printer offline↲ 4= Printer unavailable↲ 5= Printer busy↲ 6= Protected field↲ 7= Card read error↲ 8= Card format error↲ ┆8c┆┆83┆┆c0┆↓ 9= Field size error↲ 10= Configuration error↲ 11= CU disconnected↲ ╱04002d4e0a000600000000020c4731000000000000000000000000000000000000000000000000000c161b202a343e48525c66707a848eff04╱ ╱04002d4e0a000600000000030c4731000000000000000000000000000000000000000000000000000c161b202a343e48525c66707a848eff04╱ ↓ 12= Illegal position↲ ↲ ╱04002d4e0a000600000000030c4731000000000000000000000000000000000000000000000000000c161b202a343e48525c66707a848eff04╱ ╱04002d4e0a000600000000020c4731000000000000000000000000000000000000000000000000000c161b202a343e48525c66707a848eff04╱ ↓ An explanation of the meaning of the messages is given in ↓ section F, Device status messages.↲ ↲ ┆a1┆Communication status message┆e1┆: CSTEXT,cstno=csmsg↲ CSTEXT specifies one of the messages which may be shown in ↓ the status line of an emulated 3270 display device to inform ↓ the operator of the status of the remote host link to which ↓ the device is attached.↲ Cstno is the number of status message and must be in the ↓ range 1..8.↲ The default status messages and their numbers are shown ↓ below. Shown in parentheses is the maximum number of ↓ characters to be included in a message specified as a ↓ replacement for each default message. Note that all the ↓ ╱04002d4e0a000600000000020c4731000000000000000000000000000000000000000000000000000c161b202a343e48525c66707a848eff04╱ ╱04002d4e0a000600000000030c4731000000000000000000000000000000000000000000000000000c161b202a343e48525c66707a848eff04╱ ↓ texts begin with a blank.↲ ↲ ╱04002d4e0a000600000000030c4731000000000000000000000000000000000000000000000000000c161b202a343e48525c66707a848eff04╱ ╱04002d4e0a000600000000020c4731000000000000000000000000000000000000000000000000000c161b202a343e48525c66707a848eff04╱ ↓ 1= Modem off╞ ╞ ╞ (19)↲ 2= Line not ready╞ ╞ (15)↲ 3= System not available╞ (24)↲ 4= Cabling error╞ ╞ (19)↲ 5= Device not supported╞ (24)↲ 6= Call status CP╞ ╞ (15)↲ 7= Call error╞ ╞ ╞ (15)↲ ╱04002d4e0a000600000000020c4731000000000000000000000000000000000000000000000000000c161b202a343e48525c66707a848eff04╱ ╱04002d4e0a000600000000030c4731000000000000000000000000000000000000000000000000000c161b202a343e48525c66707a848eff04╱ ↓ 8= Waiting for menu╞ (24)↲ ↲ ╱04002d4e0a000600000000030c4731000000000000000000000000000000000000000000000000000c161b202a343e48525c66707a848eff04╱ ╱04002d4e0a000600000000020c4731000000000000000000000000000000000000000000000000000c161b202a343e48525c66707a848eff04╱ ↓ An explanation of the meaning of the messages is given in ↓ section F, Communication status messages.↲ ↲ ┆a1┆Communication parameters (COMM.CST)↲ ↲ Parameters for detailed control of communication functions ↓ and the organization of device clusters may be customized in ↓ the file COMM.CST.↲ ════════════════════════════════════════════════════════════════════════ ↓ Note that for many of the parameters discussed in this ↓ section it is essential that they be specified in agreement ↓ with those specified when the (IBM or IBM compatible) host ↓ and FE systems are generated.↲ ↲ ┆a1┆Parameters for BSC links↲ The major parameter for a BSC link is BSCKIND which speci┄↓ fies the kind of the link as either V.24 or X.21. Of the ↓ remaining parameters BSCCU, BSCDTR, BSCDUP and BSCPTIME will ↓ only affect a V.24 link, and BSCXNO will only affect an X.21 ↓ link. Specifying one of these parameters for a link of the ↓ wrong kind is not treated as an error, but has no effect.↲ The four possible sublinks of an X.21-BSC link do not ↓ exist by default. Unless the subscriber number of the ↓ Front-End computer associated with each sublink is specified ↓ using the BSCXNO parameter the link is treated as non-↓ existing. There is no parameter to inform the CU of its own ↓ subscriber number; it does not need this information.↲ ↲ ┆a1┆┆a1┆BSC link kind┆e1┆: BSCKIND(,linkno)=0/1↲ BSCKIND specifies the kind of a BSC link as V.24 (0, ↓ default) or X.21 (1).↲ Linkno may be omitted unless the configuration is dual ↓ host with two BSC links. It specifies the number of the link ↓ and must be 1 or 2.↲ Note that the kind of a link should only be specified as ↓ X.21 if automatic call handling and subscriber number ↓ signalling is required. In case of an X.21 bis interface ↓ (DATEX-L) the link should be specified as V.24 and the ↓ BSCDTR parameter set to 2 (see below).↲ ↲ ┆a1┆EBCDIC code for BSC link┆e1┆: BSCCONV(,linkno(,sublinkno))=1/2↲ BSCCONV specifies whether EBCDIC code 1 or 2 (cf. the ↓ section Conversion tables above) is to be used on a remote ↓ BSC host link or sub┄link.↲ ════════════════════════════════════════════════════════════════════════ ↓ Sublinkno must be present if the link kind is X.21 and ↓ must be left out if it is V.24. If present, it identifies ↓ the sublink and must be a number in the range 1..4.↲ Linkno may be omitted unless the configuration is dual ↓ host with two BSC links. However, in the case of an X.21 ↓ link, i.e. if sublinkno is present, linkno must not be ↓ omitted even if there is only one BSC link. It specifies the ↓ number of the link and must be 1 or 2.↲ ↲ ┆a1┆CU number┆e1┆: BSCCU(,linkno)=cuno↲ BSCCU specifies the CU number of a V.24-BSC link. It is ↓ given as cuno, which must be a decimal number in the range ↓ 0..31. The CU number determines the addressing sequences ↓ (poll and select) to which the CU will respond. The default ↓ value is 0, corresponding to polling address 40┆82┆Hex┆81┆ and ↓ selection address 60┆82┆Hex┆81┆.↲ Linkno may be omitted unless the configuration is dual ↓ host with two BSC links. It specifies the number of the link ↓ and must be 1 or 2.↲ ↲ ┆a1┆DTR handling┆e1┆: BSCDTR(,linkno)=dtrspec↲ BSCDTR specifies how the DTR signal of the V.24 interface is ↓ to be handled for a V.24-BSC link. Dtrspec must be 0 (de┄↓ ╱04002d4e0a000600000000020c4731000000000000000000000000000000000000000000000000000c161b202a343e48525c66707a848eff04╱ ╱04002d4e0a000600000000030c4731000000000000000000000000000000000000000000000000000c161b202a343e48525c66707a848eff04╱ ↓ fault), 1 or 2, and is interpreted as follows:↲ ↲ 0. Nonswitched line, DTR is always set.↲ ↲ ╱04002d4e0a000600000000030c4731000000000000000000000000000000000000000000000000000c161b202a343e48525c66707a848eff04╱ ╱04002d4e0a000600000000020c4731000000000000000000000000000000000000000000000000000c161b202a343e48525c66707a848eff04╱ ↓ 1. ┆84┆Manual call. DTR is set initially, and the CU waits for ↓ ┆19┆┆83┆┄┄DSR. If DSR subsequently disappears, DTR is reset for 5 ↓ ╱04002d4e0a000600000000020c4731000000000000000000000000000000000000000000000000000c161b202a343e48525c66707a848eff04╱ ╱04002d4e0a000600000000030c4731000000000000000000000000000000000000000000000000000c161b202a343e48525c66707a848eff04╱ ↓ ┆19┆┆83┆┄┄seconds and thereafter set again.↲ ↲ ╱04002d4e0a000600000000030c4731000000000000000000000000000000000000000000000000000c161b202a343e48525c66707a848eff04╱ ╱04002d4e0a000600000000020c4731000000000000000000000000000000000000000000000000000c161b202a343e48525c66707a848eff04╱ ↓ 2. ┆84┆Automatic call (X.21 bis). DTR is set and the CU waits up ↓ ┆19┆┆83┆┄┄to 5 seconds for DSR. If DSR fails to appear or sub┄↓ ┆19┆┆83┆┄┄sequently disappears, DTR is reset for 5 seconds, where┄↓ ┆19┆┆83┆┄┄upon the procedure is repeated. After 8 unsuccessful ↓ ┆19┆┆83┆┄┄attempts there is a 30 seconds pause, in which DTR is ↓ ╱04002d4e0a000600000000020c4731000000000000000000000000000000000000000000000000000c161b202a343e48525c66707a848eff04╱ ╱04002d4e0a000600000000030c4731000000000000000000000000000000000000000000000000000c161b202a343e48525c66707a848eff04╱ ↓ ┆19┆┆83┆┄┄reset.↲ ↲ ╱04002d4e0a000600000000030c4731000000000000000000000000000000000000000000000000000c161b202a343e48525c66707a848eff04╱ ╱04002d4e0a000600000000020c4731000000000000000000000000000000000000000000000000000c161b202a343e48525c66707a848eff04╱ ↓ Linkno may be omitted unless the configuration is dual host ↓ with two BSC links. It specifies the number of the link and ↓ must be 1 or 2.↲ ↲ ┆8c┆┆83┆┆d8┆↓ ┆a1┆Half/full duplex┆e1┆: BSCDUP(,linkno)=0/1↲ BSCDUP specifies half duplex (0) or full duplex (1, default) ↓ treatment of a V.24-BSC link. The parameter affects the use ↓ of the RTS signal of the V.24 interface.↲ Linkno may be omitted unless the configuration is dual ↓ host with two BSC links. It specifies the number of the link ↓ and must be 1 or 2.↲ ↲ ┆a1┆BSC printer timeout┆e1┆: BSCPTIME(,linkno)=timeout↲ BSCPTIME specifies for a V.24-BSC link how long a printer ↓ shall be reserved for the host after completion of a ↓ printout operation initiated by the host. While the printer ↓ is reserved it cannot be used for local hard-copy. Moreover, ↓ the CU monitors that the printer is not switched offline. ↓ This mechanism is provided to avoid mixing up printed data ↓ originating from different sources.↲ Timeout specifies the reservation period in seconds and ↓ must be in the range 1..60. The default value is 15.↲ Linkno may be omitted unless the configuration is dual ↓ host with two BSC links. It specifies the number of the link ↓ and must be 1 or 2.↲ ↲ ┆a1┆X.21 subscriber number┆e1┆: BSCXNO,linkno,sublinkno=xno↲ BSCXNO specifies the subscriber number in the public data ↓ network of the FE associated with an X.21-BSC sublink.↲ Linkno specifies the number of the link and must be 1 or ↓ 2. It must be present even if there is only one BSC link. ↓ Sublinkno identifies the sublink and must be a number in the ↓ range 1..4.↲ Xno is the subscriber number. It must consist of up to 16 ↓ decimal digits, and will be extended with zeroes. Other ↓ characters appearing among the digits are ignored.↲ ↲ ┆a1┆Parameters for SNA/SDLC links↲ The major parameter for an SNA/SDLC link is SDLCKIND which ↓ specifies the kind of the link as either V.24 or X.21. Of ↓ the remaining parameters SDLCDTR, SDLCDUP and MPOINT will ↓ ┆8c┆┆83┆┆bc┆↓ only affect a V.24 link, and SDLCHXNO and SDLCCXNO will only ↓ affect an X.21 link. Specifying one of these parameters for ↓ a link of the wrong kind is not treated as an error, but has ↓ no effect.↲ In case of an X.21-SNA/SDLC link the CU must know the ↓ subscriber number of the host computer as well as its own ↓ subscriber number. These numbers are specified using the ↓ SDLCHXNO and SDLCCXNO parameters, respectively.↲ ↲ ┆a1┆SNA/SDLC link kind┆e1┆: SDLCKIND(,linkno)=0/1↲ SDLCKIND specifies the kind of a SNA/SDLC link as V.24 (0, ↓ default) or X.21 (1).↲ Linkno may be omitted unless the configuration is dual ↓ host with two SNA/SDLC links. It specifies the number of the ↓ link and must be 1 or 2.↲ Note that the kind of a link should only be specified as ↓ X.21 if automatic call handling and subscriber number ↓ signalling is required. In case of an X.21 bis interface ↓ (DATEX-L) the link should be specified as V.24 and the ↓ SDLCDTR parameter set to 2 (see below).↲ ↲ ┆a1┆EBCDIC code for SNA/SDLC link┆e1┆: SNACONV(,linkno)=1/2↲ SNACONV specifies whether EBCDIC code 1 or 2 (cf. the ↓ section Conversion tables above) is to be used on a remote ↓ SNA/SDLC host ┄link.↲ Linkno may be omitted unless the configuration is dual ↓ host with two SNA/SDLC links. It specifies the number of the ↓ link and must be 1 or 2.↲ ↲ ┆a1┆SDLC address┆e1┆: SDLCADDR(,linkno)=saddr↲ SDLCADDR specifies the SDLC address for an SNA/SDLC link ↓ (V.24 or X.21). It is given as saddr, which must be a ↓ hexadecimal number in the range 0..FF. The SDLC address ↓ identifies the frames to which the CU will respond. The ↓ default value is C1.↲ ════════════════════════════════════════════════════════════════════════ ↓ Linkno may be omitted unless the configuration is dual ↓ host with two SNA/SDLC links. It specifies the number of the ↓ link and must be 1 or 2.↲ ↲ ┆a1┆Terminal ID┆e1┆: TERMID(,linkno)=tid↲ TERMID specifies the terminal ID for an SNA/SDLC link (V.24 ↓ or X.21). It is given as tid, which must be a sequence of 5 ↓ hexadecimal digits. The terminal ID is transmitted to the ↓ host computer in response to XID. The default value is ↓ 00000.↲ Linkno may be omitted unless the configuration is dual ↓ host with two SNA/SDLC links. It specifies the number of the ↓ link and must be 1 or 2.↲ ↲ ┆a1┆NRZI encoding┆e1┆: SDLCNRZI(,linkno)=0/1↲ SDLCNRZI specifies whether NRZI encoding is to be used (1) ↓ or not used (0, default) on an SNA/SDLC link (V.24 or X.21).↲ Linkno may be omitted unless the configuration is dual ↓ host with two SNA/SDLC links. It specifies the number of the ↓ link and must be 1 or 2.↲ ↲ ┆a1┆Printer sharing┆e1┆: PSHARING(,linkno)=0/1↲ PSHARING applies to printer devices which can be activated ↓ by a host computer (not in local mode, cf. the PMODE ↓ parameter discussed in the following subsection, Printer ↓ authorization) as seen by the host computer with which the ↓ CU communicates on an SNA/SDLC link (V.24 or X.21).↲ The parameter specifies whether the printer is to be ↓ shared between this host and other sources of printout ↓ operations only between sessions (0, default) or between ↓ brackets (1).↲ Linkno may be omitted unless the configuration is dual ↓ host with two SNA/SDLC links. It specifies the number of the ↓ link and must be 1 or 2.↲ ↲ ════════════════════════════════════════════════════════════════════════ ↓ ┆a1┆DTR handling┆e1┆: SDLCDTR(,linkno)=dtrspec↲ SDLCDTR specifies how the DTR signal of the V.24 interface ↓ is to be handled for a V.24-SNA/SDLC link. Dtrspec must be 0 ↓ (de┄fault), 1 or 2. It has the same interpretation as de┄↓ scribed for the BSCDTR parameter (cf. the preceeding ↓ subsection, Parameters for BSC links).↲ ↲ ┆a1┆Half/full duplex┆e1┆: SDLCDUP(,linkno)=0/1↲ SDLCDUP specifies half duplex (0) or full duplex (1, de┄↓ fault) treatment of a V.24-SNA/SDLC link. The parameter ↓ affects the use of the RTS signal of the V.24 interface.↲ Linkno may be omitted unless the configuration is dual ↓ host with two SNA/SDLC links. It specifies the number of the ↓ link and must be 1 or 2.↲ ↲ ┆a1┆Point-to-point/multipoint┆e1┆: MPOINT(,linkno)=0/1↲ MPOINT specifies whether a V.24-SNA/SDLC link is established ↓ on a point-to-point line (0, default), or an a multipoint ↓ line (1).↲ Linkno may be omitted unless the configuration is dual ↓ host with two SNA/SDLC links. It specifies the number of the ↓ link and must be 1 or 2.↲ ↲ ┆a1┆Host subscriber number┆e1┆: SDLCHXNO(,linkno)=xno↲ SDLCHXNO specifies the subscriber number in the public data ↓ network of the host computer with which the CU communicates ↓ on an X.21-SNA/SDLC link.↲ Linkno may be omitted unless the configuration is dual ↓ host with two SNA/SDLC links. It specifies the number of the ↓ link and must be 1 or 2.↲ Xno is the subscriber number. It must consist of up to 16 ↓ decimal digits, and will be extended with zeroes. Other ↓ characters appearing among the digits are ignored.↲ ↲ ════════════════════════════════════════════════════════════════════════ ↓ ┆a1┆Own subscriber number┆e1┆: SDLCCXNO(,linkno)=xno↲ SDLCCXNO specifies the local subscriber number in the public ↓ data network, i.e. the number of the CU itself, for an X.21-↓ SNA/SDLC link.↲ Linkno may be omitted unless the configuration is dual ↓ host with two SNA/SDLC links. It specifies the number of the ↓ link and must be 1 or 2.↲ Xno is the subscriber number. It must consist of up to 16 ↓ decimal digits, and will be extended with zeroes. Other ↓ characters appearing among the digits are ignored.↲ ↲ ┆a1┆Printer authorization↲ The use of printer devices in an emulated 3270 cluster is ↓ controlled by printer authorization parameters. There are ↓ ╱04002d4e0a000600000000020c4731000000000000000000000000000000000000000000000000000c161b202a343e48525c66707a848eff04╱ ╱04002d4e0a000600000000030c4731000000000000000000000000000000000000000000000000000c161b202a343e48525c66707a848eff04╱ ↓ three aspects of printer authorization.↲ ↲ ╱04002d4e0a000600000000030c4731000000000000000000000000000000000000000000000000000c161b202a343e48525c66707a848eff04╱ ╱04002d4e0a000600000000020c4731000000000000000000000000000000000000000000000000000c161b202a343e48525c66707a848eff04╱ ↓ 1. ┆84┆For each printer a ┆a1┆mode┆e1┆ is specified which determines ↓ ┆19┆┆83┆┄┄whether the printer is to be used exclusively for local ↓ ┆19┆┆83┆┄┄hard-copy (local mode), or exclusively for printout ↓ ┆19┆┆83┆┄┄operations initiated by a host (system mode), or for both ↓ ╱04002d4e0a000600000000020c4731000000000000000000000000000000000000000000000000000c161b202a343e48525c66707a848eff04╱ ╱04002d4e0a000600000000030c4731000000000000000000000000000000000000000000000000000c161b202a343e48525c66707a848eff04╱ ↓ ┆19┆┆83┆┄┄of these types of printing (shared mode).↲ ↲ ╱04002d4e0a000600000000030c4731000000000000000000000000000000000000000000000000000c161b202a343e48525c66707a848eff04╱ ╱04002d4e0a000600000000020c4731000000000000000000000000000000000000000000000000000c161b202a343e48525c66707a848eff04╱ ↓ 2. ┆84┆Up to 16 ┆a1┆classes┆e1┆ of printers may be defined. A class is a ↓ ┆19┆┆83┆┄┄group of printers. The concept allows the hard-copy ↓ ┆19┆┆83┆┄┄printer for a terminal (configured in each terminal) to ↓ ┆19┆┆83┆┄┄be specified as a class rather than an individual ↓ ┆19┆┆83┆┄┄printer. A hard-copy printout requested for the display ↓ ┆19┆┆83┆┄┄may be performed on any printer in the class. The printer ↓ ┆19┆┆83┆┄┄classes are numbered from 0 to 15. When configuring a ↓ ┆19┆┆83┆┄┄terminal, printer class n is specified by using device ↓ ╱04002d4e0a000600000000020c4731000000000000000000000000000000000000000000000000000c161b202a343e48525c66707a848eff04╱ ╱04002d4e0a000600000000030c4731000000000000000000000000000000000000000000000000000c161b202a343e48525c66707a848eff04╱ ↓ ┆19┆┆83┆┄┄number 130+n, i.e. a number in the range 130..145.↲ ↲ ╱04002d4e0a000600000000030c4731000000000000000000000000000000000000000000000000000c161b202a343e48525c66707a848eff04╱ ╱04002d4e0a000600000000020c4731000000000000000000000000000000000000000000000000000c161b202a343e48525c66707a848eff04╱ ↓ 3. ┆84┆For each printer a ┆a1┆source device list┆e1┆ is defined. This is ↓ ┆19┆┆83┆┄┄a list of display devices for which the printer may ↓ ┆19┆┆83┆┄┄execute local hard-copy operations. If a display device ↓ ┆19┆┆83┆┄┄does not belong to the source device list of a given ↓ ┆19┆┆83┆┄┄printer, hard-copy cannot take place on that printer even ↓ ┆19┆┆83┆┄┄if it is selected as the hard-copy printer for the ↓ ╱04002d4e0a000600000000020c4731000000000000000000000000000000000000000000000000000c161b202a343e48525c66707a848eff04╱ ╱04002d4e0a000600000000030c4731000000000000000000000000000000000000000000000000000c161b202a343e48525c66707a848eff04╱ ↓ ┆19┆┆83┆┄┄device, either individually or as a member of a class.↲ ↲ ╱04002d4e0a000600000000030c4731000000000000000000000000000000000000000000000000000c161b202a343e48525c66707a848eff04╱ ╱04002d4e0a000600000000020c4731000000000000000000000000000000000000000000000000000c161b202a343e48525c66707a848eff04╱ ↓ ┆8c┆┆83┆┆c0┆↓ Notice that the parameter specifications described below ↓ include device numbers which in each case must identify ↓ either a printer or a display device. Since the CU does not ↓ know the devices in a cluster or their numbers when the ↓ parameter file is read, some of the information in these ↓ parameter specifications may turn out to be meaningless, in ↓ which case it will have no effect.↲ ↲ ┆a1┆Printer mode┆e1┆: PMODE,devno=pmo↲ PMODE specifies the mode of the printer whose device number ↓ is given as devno, which must be a number in the range ↓ ╱04002d4e0a000600000000020c4731000000000000000000000000000000000000000000000000000c161b202a343e48525c66707a848eff04╱ ╱04002d4e0a000600000000030c4731000000000000000000000000000000000000000000000000000c161b202a343e48525c66707a848eff04╱ ↓ 0..127. Pmo must be 0, 1 or 2, meaning:↲ ↲ ╱04002d4e0a000600000000030c4731000000000000000000000000000000000000000000000000000c161b202a343e48525c66707a848eff04╱ ╱04002d4e0a000600000000020c4731000000000000000000000000000000000000000000000000000c161b202a343e48525c66707a848eff04╱ ↓ 0 local mode↲ 1 system mode ↲ 2 shared mode (default)↲ ↲ ┆a1┆Printer class┆e1┆: PCLASS,clno=devno-list↲ PCLASS specifies that the listed (printer) devices belong to ↓ the printer class whose number is given as clno, which must ↓ be a number in the range 0..15. Devno-list must be a list of ↓ device numbers in the range 0..127, separated by commas or ↓ hyphens. If two device numbers in the list, the first one ↓ smaller than the second one, are separated by a hyphen, then ↓ all device numbers in the interval between them are also ↓ included. By default, all printer classes are empty.↲ As an example: PCLASS,7=2,4,8-12↲ specifies that the printers with device numbers 2, 4, 8, 9, ↓ 10, 11 and 12 belong to printer class number 7.↲ ↲ ┆a1┆Printer source device list┆e1┆: PSRCLIST,devno=devno-list↲ PSRCLIST specifies that the source device list for the ↓ printer whose device number is given as devno, which must be ↓ a number in the range 0..127, comprises precisely the listed ↓ (display) devices. Devno-list is written in the same way as ↓ for the PCLASS parameter (see above). By default, all ↓ display devices belong to the source lists of all printers.↲ ↲ ┆8c┆┆83┆┆c0┆↓ ┆a1┆Cluster size↲ There are two parameters related to the size of a cluster: ↓ the maximum 3270 device number and the number of terminals ↓ with which the CP will communicate on RcCircuit-I. 3270 ↓ devices include devices emulated in PCs connected to the CP ↓ via a LAN and soft devices resident in the CP itself as well ↓ as devices in terminals connected to the CP via RcCircuit-I.↲ ↲ ┆a1┆Maximum device number┆e1┆: MAXDEVNO=mno↲ MAXDEVNO specifies the maximum number which the CU will ↓ accept as a valid device number. Mno gives this number, ↓ which must be in the range 1..127. The default value is 63. ↓ If a device is activated with a device number greater than ↓ the one specified by MAXDEVNO it will be rejected by the CU.↲ Note that regardless of the value specified by MAXDEVNO ↓ devices with device numbers greater than 63 cannot commu┄↓ nicate with a host computer via a remote BSC link because of ↓ limitations in the BSC protocol.↲ ↲ ┆a1┆Number of terminals┆e1┆: NOTERMS=tno↲ NOTERMS specifies the number of terminals with which the CP ↓ will communicate via RcCircuit-I. The number is given as ↓ Tno, which must in the range 1..32. A terminal whose ↓ secondary address is configured to be equal to or greater ↓ than the value specified by NOTERMS will not be able to ↓ communicate with the CP. The default value is 16.↲ A value greater than 16 may only be specified if the ↓ configuration is "dual host" or "high performance"; ↓ otherwise it will be ignored, i.e. the default value will ↓ remain in effect.↲ ↲ ┆a1┆Local host links↲ When configured to support local host links the CP acts as a ↓ 3270 ┆a1┆CU┆e1┆ with ┆a1┆L┆e1┆AN ┆a1┆I┆e1┆nterface (CUL/CULI). As such, it may ↓ interact with the 3270 device handler function of an RC8000 ↓ ADP (cf. ref. 6). The customization parameters for local ↓ ┆8c┆┆83┆┆b0┆↓ host links must be set in agreement with those chosen for ↓ the ADP.↲ ↲ ┆a1┆Number of local host links┆e1┆: CULCONS=n↲ CULCONS specifies the maximum number of local host links ↓ which can be active simultaneously. Each 3270 device handler ↓ pair on an RC8000 ADP (representing an RC8000 application) ↓ requires its own link. N gives the number, which must be in ↓ the range 0..10. The default value is 2.↲ ↲ ┆a1┆Output message size for local host links┆e1┆: CULOSIZE=n↲ CULOSIZE specifies the maximum size of individual messages ↓ transmitted from the RC8000 ADP to the CU (number of bytes). ↓ The actual size is negotiated with the device handler on the ↓ ADP when the link is established; to avoid waste, the same ↓ size should be specified for the CU and the ADP. N gives the ↓ number, which must be in the range 100..3860. The default ↓ value is 1024.↲ ↲ ┆a1┆Input message size for local host links┆e1┆: CULISIZE=n↲ CULISIZE specifies the maximum size of individual messages ↓ transmitted from the CU to the RC8000 ADP (number of bytes). ↓ The actual size is negotiated with the device handler on the ↓ ADP when the link is established; to avoid waste, the same ↓ size should be specified for the CU and the ADP. N gives the ↓ number, which must be in the range 256..3860. The default ↓ value is 256.↲ ↲ ┆a1┆CU port name for local host link┆e1┆: CULIPORT=pname↲ Every CU attached to the LAN has a port name by which it is ↓ known to the RC8000 ADP. CULIPORT specifies this name. Pname ↓ must be a string of at most 12 characters. The ADP requires↲ port names to have the form CUxx, where xx is a decimal ↓ number starting from 00; i.e. the names of the CUs attached ↓ to a given LAN must be specified as CU00, CU01, CU02 etc. ↓ The default port name is CU00.↲ ↲ ┆8c┆┆83┆┆bc┆↓ ┆a1┆Soft devices↲ If the soft device function of the CP is activated, it is ↓ necessary to specify the numbers of the desired soft devices ↓ (cf. section E, Device number management).↲ ↲ ┆a1┆Device numbers┆e1┆: SOFTDEVS=devno-list↲ SOFTDEVS specifies the numbers of soft devices to be ↓ activated on the CP. Devno-list must be a list of device ↓ numbers in the range 0..127, separated by commas. By ↓ default there are no soft devices.↲ ↲ ┆a1┆Soft device timeout┆e1┆: SOFTMOUT=t↲ SOFTMOUT specifies the timeout period used by soft devices ↓ (when the local application program is waiting for a locked ↓ keyboard or a USM order, cf. ref. 5). T, which must a number ↓ in the range 1..255, gives the timeout period in seconds.↲ ↲ ┆a1┆Parameters for Teletex↲ If the Teletex service is activated the following three ↓ parameters will be effective:↲ ↲ ┆a1┆Class 0 pages┆e1┆: CLASS0P=c0p↲ CLASS0P specifies the maximum length in pages of a class 0 ↓ document. A higher priority is assigned to class 0 documents ↓ than to longer documents. C0p must be a number in the range ↓ 0..32675. The default value is 10.↲ ↲ ┆a1┆Number of letters┆e1┆: MAXL=n↲ MAXL specifies the maximum number of letters which the ↓ Teletex communication service can handle simultaneously. All ↓ letters queued for transmission and not yet completely ↓ transmitted as well as all partially received letters count ↓ against this maximum. The default value for n, which must be ↓ a number in the range 0..32675, is 30.↲ ════════════════════════════════════════════════════════════════════════ ↓ ┆a1┆Address of Telex conversion facility┆e1┆: CFADDR=addr↲ CFADDR specifies the Teletex address to which Telex ↓ documents should be sent (Telex conversion facility). Addr ↓ must be given as a string of at most 24 characters. The ↓ default value is 2381-01=CFTELEX.↲ ↲ ════════════════════════════════════════════════════════════════════════ ↓ ┆14┆┆b3┆↲ ┆14┆┆b1┆┆b0┆ RC3931 Communications Processor┆05┆System Management E↲ ┆14┆┆b2┆┆b0┆ E System Management┆05┆RC3931 Communications Processor ↲ ┆15┆┆b3┆↲ ┆15┆┆b1┆┆b0┆ Update 1/86┆05┆Page E-┆0b┆ E↲ ┆15┆┆b2┆┆b0┆ E Page E-┆0b┆┆05┆Update 1/86 ↲ ╱04002d4e0a000600000000030c4731000000000000000000000000000000000000000000000000000c16202a343c48525c66707a848effff04╱ ╱04002d4e0a000600000000030c4731000000000000000000000000000000000000000000000000000c161b202a343e48525c66707a848eff04╱ ↓ ┆a1┆E. System Management↲ ↲ The responsibilities of the system administrator in con┄↓ ╱04002d4e0a000600000000020c4731000000000000000000000000000000000000000000000000000c16202a343c48525c66707a848effff04╱ ╱04002d4e0a000600000000030c4731000000000000000000000000000000000000000000000000000c16202a343c48525c66707a848effff04╱ ↓ junction with the CP are:↲ ↲ ╱04002d4e0a000600000000030c4731000000000000000000000000000000000000000000000000000c16202a343c48525c66707a848effff04╱ ╱04002d4e0a000600000000020c4731000000000000000000000000000000000000000000000000000c16202a343c48525c66707a848effff04╱ ↓ - ┆84┆configuring and customizing the CP by editing the ↓ ┆19┆┆82┆┄┄configuration and customization parameter files,↲ - ┆84┆managing the assignment of device numbers to devices in an ↓ ┆19┆┆82┆┄┄emulated 3270 cluster,↲ ╱04002d4e0a000600000000020c4731000000000000000000000000000000000000000000000000000c16202a343c48525c66707a848effff04╱ ╱04002d4e0a000600000000030c4731000000000000000000000000000000000000000000000000000c16202a343c48525c66707a848effff04╱ ↓ - reporting errors.↲ ↲ ╱04002d4e0a000600000000030c4731000000000000000000000000000000000000000000000000000c16202a343c48525c66707a848effff04╱ ╱04002d4e0a000600000000020c4731000000000000000000000000000000000000000000000000000c16202a343c48525c66707a848effff04╱ ↓ Some of the information provided in this main section is ↓ intended to help the system administrator with respect to ↓ finding and editing the configuration and customization ↓ parameter files. The remaining part of the section aims to ↓ enable the system administrator to determine whether a ↓ malfunction of the CP is due to improper customization or ↓ installation, or whether the product is defective, so that ↓ an error report should be made.↲ ↲ ┆a1┆Resetting the CP↲ ↲ In order to reset the CP, thereby causing it to read the ↓ configuration and parameter files and activate its functions ↓ accordingly, it is necessary to reset the complete RC39 ↓ system. This is done by switching power on or pressing the ↓ reset button.↲ Note that the standard procedure for shutting down the ↓ XENIX operating system should always be followed before ↓ power is switched off or the system reset, cf. ref. 1.↲ It is important to note that when the configuration or ↓ parameter files have been changed, and/or when a new SW ↓ package for the CP has been installed, the CP must be reset ↓ before the changes will take effect. The configuration and ↓ parameter files are ┆a1┆only┆e1┆ read by the CP when it is reset.↲ ↲ ════════════════════════════════════════════════════════════════════════ ↓ ┆a1┆Files belonging to the CP↲ ↲ When a SW package for the CP is installed, a number of files ↓ are copied from the distribution diskette to the RC39 disk ↓ utilizing the disk filing functions of the XENIX operating ↓ system which governs the LAP.↲ All files that belong to the CP are kept in the directory ↓ /usr/cp. These files include: software modules to be loaded ↓ and executed on the CP including adapter boards, program ↓ files for download to terminals, customization files to be ↓ read by the CP during load, and auxiliary files (see below).↲ In the sense of the XENIX operating system the CP files ↓ belong to the root and are protected against access by other ↓ users. However, by logging in as root (super user), the ↓ system administrator may manipulate the CP files using any ↓ available tools such as XENIX utility programs, text editor ↓ or word processor etc.↲ All CP files have names of the form "name.ext", where name ↓ consists of at most 8 characters and ext, the file name ↓ extension, is at most 3 characters. Files with same file ↓ name extension are referred to collectively as "*.ext" ↓ files. The form "name.*" is used similarly.↲ The names of CP files are relative to the directory ↓ /usr/cp, so that the complete path name of a CP file is ↓ /usr/cp/name.ext.↲ ↲ ┆a1┆Auxiliary files↲ For each customization parameter file read by the CP (cf. ↓ section D.2, Customization, Parameter Files) one or more ↓ auxiliary files ("help files") are distributed as part of ↓ the operating system package (SW3910). The auxiliary files ↓ are ┆a1┆not┆e1┆ read or otherwise accessed by the CP. They are only ↓ intended as an aid to the system administrator when ↓ customizing the CP.↲ All the auxiliary files for a given parameter file have ↓ the same file name extension which is derived from the name ↓ of the parameter file. The correspondence is shown in the ↓ following table:↲ ↲ ┆8c┆┆83┆┆d4┆↓ ╱04002d4e0a000600000000030c4731000000000000000000000000000000000000000000000000000c13202a343c48525c66707a848effff04╱ ╱04002d4e0a000600000000030c4731000000000000000000000000000000000000000000000000000c16202a343c48525c66707a848effff04╱ ↓ ╞ ┆a1┆Parameter file╞ Auxiliary files↲ ╞ MENUDL.CST╞ ╞ ╞ *.MDL↲ ╞ CONV1.CST (CONV.CST), CONV2.CST╞ *.CNV↲ ╞ TEXTS.CST╞ ╞ ╞ *.TXT↲ ╞ COMM.CST╞ ╞ ╞ *.CMM↲ ↲ Three auxiliary files: DEFAULT.MDL, DEFAULT.TXT, and ↓ DEFAULT.CMM, contain parameter lines which show how the ↓ default parameter values may be specified. It may be ↓ convenient for the system administrator to create parameter ↓ (*.CST) files for a given CP installation by editing and ↓ renaming the DEFAULT.* files rather than starting from ↓ scratch. It is recommended that superfluous lines and lines ↓ that do not apply to the chosen configur┄ation be deleted ↓ when this is done.↲ The file DEFAULT.CFG, which explains how to set configur┄↓ ation switches (cf. section D.1, Configuration), is similar ↓ to the other DEFAULT.* files in that it is intended to be ↓ edited and renamed, in this case as CONFIG.CST.↲ The file DMENU.MDL contains a Danish language version of ↓ the default download menu. Similarly, the file DANSK.TXT ↓ contains standard Danish texts for status line messages and ↓ host link menus. If these two files are renamed as ↓ MENUDL.CST and TEXTS.CST, respectively, all messages ↓ pertaining to CP functions will be shown to the terminal ↓ operator in Danish.↲ ↲ ┆a1┆Selecting character conversion↲ When performing 3270 emulation the CP converts between two ↓ encodings of characters: internal code and EBCDIC code. A ↓ general discussion of this topic is found in section D.2, ↓ Conversion tables.↲ The default conversion tables are appropriate only if the ↓ internal character set is US English (ASCII) and the desired ↓ EBCDIC code is US English. Often this will not be the case, ↓ and modifications will therefore be necessary.↲ ════════════════════════════════════════════════════════════════════════ ↓ Conversion table modifications suitable for a number of ↓ standard combinations of internal and EBCDIC encodings are ↓ found in the *.CNV files. When one of these standard com┄↓ binations is applicable, customization of the character ↓ conversion is achieved simply by renaming the proper *.CNV ↓ file as CONV1.CST (EBCDIC code 1) or CONV2.CST (EBCDIC code ↓ 2).↲ Code tables for all standard internal character sets and ↓ the corresponding standard EBCDIC encodings are included as ↓ appendices H.2 and H.3. The following table shows which ↓ *.CNV file to select for a given standard combination:↲ ↲ ╱04002d4e0a000600000000030c4731000000000000000000000000000000000000000000000000000c16202a343c48525c66707a848effff04╱ ╱04002d4e0a000600000000030c4731000000000000000000000000000000000000000000000000000c13202a343c48525c66707a848effff04╱ ↓ internal cha-╞ EBCDIC encoding╞ ╞ file↲ ┆a1┆┆e1┆ ┆a1┆ racter set╞ ╞ ╞ ╞ ↲ US English╞ US English╞ ╞ default↲ UK English╞ UK English╞ ╞ ENGLISH.CNV↲ German╞ ╞ German╞ ╞ ╞ GERMAN.CNV↲ German╞ ╞ German, alternate╞ ╞ GERMANA.CNV↲ Swedish╞ ╞ Swedish╞ ╞ ╞ SWEDISH.CNV↲ Swedish╞ ╞ Swedish, alternate╞ ╞ SWEDISHA.CNV↲ Standard Danish╞ Standard Danish╞ ╞ STDK.CNV↲ Standard Danish╞ Standard Danish, alternate╞ STDKA.CNV↲ Danish OS╞ Danish OS╞ ╞ ╞ DOS.CNV↲ Danish OS╞ Danish OS, alternate╞ DOSA.CNV↲ ↲ ┆a1┆External cable connections↲ ↲ Normally the signal cables which connect the CP to units ↓ which are external to the RC39 system are mounted when the ↓ CP hardware is installed. The present brief description is ↓ intended to enable the system administrator to ascertain by ↓ inspection that the connections are properly in place.↲ Figure E-1 shows the connector panel located behind the ↓ rear cover of the RC39 cabinet.↲ Connector J51 must be used for the RcCircuit signal cable. ↓ Notice that this cable contains two twisted wire pairs. One ↓ twisted pair is used for character-mode communication ↓ ════════════════════════════════════════════════════════════════════════ ↓ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ╞ < Figure E-1 >↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ Figure E-1. RC39 connector panel.↲ ↲ between terminals and the RC39 LAP, a function which does ↓ not involve the CP. The other twisted pair is used for ↓ ════════════════════════════════════════════════════════════════════════ ↓ block-mode communication between terminals and the CP, i.e. ↓ for the functions which are described in this guide.↲ When the CP is connected to a LAN, connector J2 must be ↓ used for the transceiver cable. The transceiver cables used ↓ for the two kinds of LAN, Ethernet and RcMicronet, are ↓ different, but both cables fit the J2 connector.↲ The connectors J11, J12, J13 and J14, marked V.24/X.21 ↓ COMM., are for the signal cables used to establish remote ↓ 3270 host links. The connectors are used as follows, ↓ depending on the configuration (cf. section D.1, remote host ↓ links):↲ ↲ ┆a1┆configuration╞ connector(s) used↲ ╱04002d4e0a000600000000020c4731000000000000000000000000000000000000000000000000000c16202a343c48525c66707a848effff04╱ ╱04002d4e0a000600000000030c4731000000000000000000000000000000000000000000000000000c16202a343c48525c66707a848effff04╱ ↓ 3270B╞ J11 - BSC link 1↲ ↲ 3270BH╞ J13 - BSC link 1↲ ↲ 3270BD╞ J11 - BSC link 1↲ ╞ ╞ J13 - BSC link 2↲ ↲ 3270S╞ J12 - SNA/SDLC link 1↲ ↲ 3270SH╞ J14 - SNA/SDLC link 1↲ ↲ 3270SD╞ J12 - SNA/SDLC link 1↲ ╞ ╞ J14 - SNA/SDLC link 2↲ ↲ 3270BS╞ J12 - SNA/SDLC link 1↲ ╱04002d4e0a000600000000030c4731000000000000000000000000000000000000000000000000000c16202a343c48525c66707a848effff04╱ ╱04002d4e0a000600000000020c4731000000000000000000000000000000000000000000000000000c16202a343c48525c66707a848effff04╱ ↓ ╞ ╞ J13 - BSC link 1↲ ↲ The connector used for a link is independent of whether the ↓ kind of the link is V.24 or X.21, but the signal cables used ↓ to connect the CP to a V.24 modem or to an X.21 DCE, ↓ respectively, are different (see Appendix H.4 for details). ↓ Both kinds of signal cable fit all four J1X connectors.↲ The connector J1, marked X.21, is for the signal cable ↓ used to connect the CP to an X.21 DCE to obtain Teletex ↓ service.↲ ↲ ┆a1┆┆a1┆Device number management (3270)↲ ↲ As discussed in section B.2, Emulated 3270 devices, device ↓ numbers are not customized in the parameter files of the CP, ↓ ════════════════════════════════════════════════════════════════════════ ↓ but in the various units which emulate the devices. It is ↓ the responsibility of the system administrator to assign the ↓ available device numbers to devices and to oversee that ↓ device numbers are properly configured in the various units, ↓ i.e. terminals and PCs. Only the device numbers for soft ↓ devices which reside within the CP are part of CP custom┄↓ ization.↲ It is recommended for the system administrator to maintain ↓ a list showing the use of each device number: physical ↓ location, type of terminal or other use etc.↲ It is also the responsibility of the system administrator ↓ to coordinate the assignment of device numbers within an ↓ emulated 3270 cluster with the customization of the remote ↓ host computer(s). Often fairly rigid rules are applied to ↓ the selection of device numbers within the host computer ↓ system. It is therefore recommended that cooperation with ↓ host computer operating staff be established before device ↓ numbers are assigned.↲ ↲ ┆a1┆CP log file↲ ↲ The CP logs certain types of information in a log file. This ↓ happens when the configuration and customization files are ↓ read, during load of software modules, and when errors are ↓ detected while the CP is in operation. The CP log file is ↓ named ERRORLOG. Upon reset of the CP the previous log file ↓ is renamed as ERRORLOG.BAK before a new log is opened.↲ In general, the information in the system log is intended ↓ for RC software maintenance staff and not for the user. It ↓ may, however, be useful to read the log if the customization ↓ parameters prepared in the *.CST files by the system admini┄↓ strator do not have the intended effect.↲ When a parameter specification line in one of the files is ↓ not acceptable to the CP, either because of a syntax error, ↓ or because the parameter does not apply to the configuration ↓ as specified in the CONFIG.CST file, a line is written in ↓ the log file. This line will contain the name of the para┄↓ ════════════════════════════════════════════════════════════════════════ ↓ meter file and the parameter name found at the beginning of ↓ the rejected line. All information about rejected parameter ↓ specification lines will appear in the first lines of the ↓ log. The system administrator may therefore read the ↓ beginning of the log as a report on the acceptability of the ↓ attempted customization.↲ Whether or not the system administrator considers it ↓ useful to read the log, it is recommended practice to print ↓ out the ERRORLOG file in case of a malfunction attributable ↓ to the CP. Such a printout should be submitted with any ↓ error report concerning a CP function.↲ ↲ ┆a1┆Lamps on the front panel↲ ↲ Eight small lamps, organized in two rows of four, are ↓ visible on the front panel of the RC39 cabinet; see Figure ↓ E-2. The lamps in the bottom row, marked ERROR, HOST 1, HOST ↓ 2 and LTN, and the lamp in the top row which is marked LAN, ↓ indicate the status of the CP.↲ ┆0e┆↓ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ╞ < Figure E-2 >↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ Figure E-2. RC39 front panel.↲ ┆0f┆↓ ↲ ════════════════════════════════════════════════════════════════════════ ↓ Note that the lamps in the bottom row are inoperative - ↓ never lit - unless at least one communication adapter is ↓ installed as part of the CP subsystem.↲ The ERROR lamp only lights to indicate that the CP has ↓ ceased to operate. This may occur during the self-test ↓ sequence which follows a reset, or it may occur when an ↓ unrecoverable error is detected during normal operation. In ↓ the latter case the CP will attempt to write diagnostic ↓ information about the fault in the log before it halts.↲ When the CP ERROR lamp lights the CP can only be activated ↓ by reset, cf. section E, Resetting the CP.↲ The remaining CP status lamps indicate activity on the ↓ various serial communication lines. The HOST 1 and HOST 2 ↓ lamps show activity on the remote 3270 host link(s): HOST 1 ↓ corresponds to the link which uses a signal cable mounted on ↓ connector J11 or J12, and HOST 2 similarly corresponds to ↓ connector J13 or J14. Refer to section E, External cable ↓ connections, to see how host links are assigned to connec┄↓ tors for the various possible configurations.↲ The LTN (local terminal network) lamp shows activity on ↓ RcCircuit-I, and the LAN lamp shows activity on the local ↓ area network.↲ ════════════════════════════════════════════════════════════════════════ ↓ ↲ ════════════════════════════════════════════════════════════════════════ ↓ ┆14┆┆b3┆↲ ┆14┆┆b1┆┆b0┆ RC3931 Communications Processor┆05┆Normal Use F↲ ┆14┆┆b2┆┆b0┆ F Normal Use┆05┆RC3931 Communications Processor ↲ ┆15┆┆b3┆↲ ┆15┆┆b1┆┆b0┆ Update 1/86┆05┆Page F-┆0b┆ F↲ ┆15┆┆b2┆┆b0┆ F Page F-┆0b┆┆05┆Update 1/86 ↲ ╱04002d4e0a000600000000030c4731400000000000000000000000000000000000000000000000000c16202a343e48525c66707a848e98ff04╱ ╱04002d4e0a000600000000030c4731000000000000000000000000000000000000000000000000000c16202a343c48525c66707a848effff04╱ ↓ ┆a1┆F. Normal Use↲ ↲ During normal use the CP will not be visible to the user. ↓ The functions of the CP will appear either as functions of ↓ the terminal or PC or as functions of the RC39 LAP. As long ↓ as all components in the system work correctly, the user ↓ will not be aware of the CP. In general, the information ↓ needed by users of the terminal emulator programs is ↓ found in the relevant user's guides and not in this guide.↲ The CP, however, also has a monitoring function: it ↓ discovers when errors or abnormal situations arise in the ↓ various types of communication it supports. In these ↓ instances operator messages issued by the CP will be shown ↓ on the relevant terminal or PC display.↲ The term error is used here not to indicate a fault on the ↓ part of the CP, but rather in the external part of the ↓ system or in the configuration and customization of the ↓ system as set up by the user (system administrator).↲ The situations which are indicated by operator messages ↓ are discussed in the following two subsections, one dealing ↓ with download of terminals, the other with 3270 emulation. ↓ All the messages discussed may be customized, i.e. modified ↓ according to user taste or preference, e.g. translated to a ↓ different language, cf. section D.2, Customization, ↓ Parameter Files.↲ In the following subsections the default versions of the ↓ messages are shown with an indication, given in parentheses, ↓ of the parameter name and text number to be used when custo┄┄↓ mizing a replacement text.↲ ↲ ┆a1┆Error messages during download↲ ↲ The error messages which occur in conjunction with download ↓ of terminals may be customized in the file MENUDL.CST.↲ ↲ ┆a1┆Disk access error┆e1┆ (ETEXT,1)↲ The CU attempted to gain access to the disk filing system on ↓ the RC39 LAP, but failed. This could be due to a temporary ↓ ════════════════════════════════════════════════════════════════════════ ↓ lack of resources in case of many simultaneous interactions ↓ between the CP and the LAP. A couple of retries should be ↓ attempted before the error is reported.↲ ↲ ┆a1┆Program not found┆e1┆ (ETEXT,4)↲ The CU accessed the disk filing system of the LAP correctly, ↓ but only to find that the selected program file did not ↓ exist. The relationship between selection lines in the ↓ download menu and file names is explained in section D.2, ↓ Download menus.↲ The most obvious reason for a program file to be missing ↓ is that it has not been installed. Terminal programs are ↓ distributed in separate packages which must be installed ↓ before the programs can be loaded.↲ ↲ ┆a1┆CU disconnected┆e1┆ (ETEXT,2)↲ The connection between the CU and the terminal was broken. A ↓ couple of retries should be attempted before the error is ↓ reported, since the problem may be only temporary, e.g. when ↓ the RC39 MUCS is reset.↲ A program file is downloaded as a number of data messages ↓ (blocks). Each data message is protected during transmission ↓ on the RcCircuit-I by a cyclic redundancy check and retrans┄↓ mitted in case of error. An excessive number of retrans┄↓ missions, which may occur if the cable is in very poor ↓ condition or poorly connected, causes the CU connection to ↓ be broken.↲ The connection is also broken, as observed from the ↓ terminal, if the CP ceases to operate (cf. section E, Lamps ↓ on the front panel).↲ Note that this message will not appear if the connection ↓ has not been established at all, e.g. if no physical ↓ connection (RcCircuit-I) exists.↲ ↲ ┆a1┆Checksum error┆e1┆ (ETEXT,3)↲ An error was detected when a checksum was computed on the ↓ complete program after all blocks had been transferred to ↓ ════════════════════════════════════════════════════════════════════════ ↓ the terminal. This message therefore does not indicate a ↓ transmission problem. The reason may be that a bad program ↓ file was read from the RC39 disk, or a RAM error within the ↓ terminal. Some prelease program files may not be furnished ↓ with a checksum at all, in which case the message has no ↓ significance. In spite of the checksum error, the downloaded ↓ program will be started in the terminal.↲ ↲ ┆a1┆3270 emulator status messages↲ ↲ The status messages which occur in conjunction with 3270 ↓ emulation may be customized in the file TEXTS.CST.↲ ↲ ┆a1┆Device status messages↲ The status messages which concern an individual device ↓ within a cluster or the relationship between the CU and one ↓ or more devices without relating to host links are shown a ↓ little to the right of the center of the status line ↓ (positions 35 through 55). This is true for all terminals or ↓ PCs which emulate 3270 display devices.↲ The last five messages discussed in this subsection ↓ concern the use of a magnetic card reader. The card reader ↓ is not monitored by the CU, but the messages are mentioned ↓ here, because they appear in the same part of the status ↓ line and are customizable in the same fashion as the other ↓ device status messages.↲ ↲ ┆a1┆Configuration error┆e1┆ (DSTEXT,10)↲ A device was activated with an illegal device number. The ↓ device need not be a display device; it could also be a ↓ printer device.↲ A device number is illegal if it is larger than the ↓ maximum device number customized for the cluster, cf. ↓ section D.2, Cluster size.↲ A device number is also illegal if there is already an ↓ active device with the same number. The problem must be ↓ ════════════════════════════════════════════════════════════════════════ ↓ solved by appropriately assigning device numbers to physical ↓ equipment and configuring the terminals and PCs accordingly, ↓ cf. section E, Device number management.↲ ↲ ┆a1┆CU disconnected┆e1┆ (DSTEXT,11)↲ The connection between the 3270 CU emulator module and the ↓ terminal emulator program was broken. This may occur for ↓ several different reasons:↲ The RC39 MUCS may have been reset in which case the ↓ message will disappear when the CP has been reloaded.↲ An error may have occurred which caused the CP to cease to ↓ operate, cf. section E, Lamps on the front panel.↲ The condition of the cable or its connections may be so ↓ poor that an excessive number of retransmissions occurred, ↓ causing the CU to abandon the connection. In this case, the ↓ connection is likely to go on and off, since the CU and the ↓ terminal automatically attempt to reestablish communication.↲ ↲ ┆a1┆Printer unavailable┆e1┆ (DSTEXT,4)↲ Hard-copy printout was requested by the operator, but no ↓ printer was available to execute the request. The printer ↓ configured as hard-copy printer is either not active, i.e. ↓ the terminal or PC to which the printer is attached is not ↓ running the 3270 emulator program, or the display device ↓ does not belong to the source list of the printer (cf. ↓ section D.2, Printer authorization). If the hard-copy ↓ printer is specified as a printer class, the message ↓ indicates that none of the printers in the class are ↓ available.↲ In response to this message the operator should check the ↓ hard-copy printer configuration in the terminal or PC.↲ ↲ ┆a1┆Printer busy┆e1┆ (DSTEXT,5)↲ Hard-copy printout was requested by the operator, but the ↓ printer was busy. It may be that the printer is performing a ↓ hard-copy printout for another display device, or it may be ↓ performing a host-initiated printout operation. If the hard-↓ ════════════════════════════════════════════════════════════════════════ ↓ copy printer is specified as a printer class, the message ↓ indicates that all printers in the class are temporarily ↓ occupied.↲ When this message is shown, the printout request is queued ↓ within the CU until the printer becomes ready to execute it. ↓ While the request remains in the queue the keyboard will be ↓ locked. It can be reset in the usual way, whereby the ↓ printout request is dropped from the queue.↲ If the printer device is emulated on a PC (cf. section ↓ B.2, Emulated 3270 devices) and the actual printer is ↓ reserved by another PC application, e.g. a word processor, ↓ the printout request is dropped and not queued.↲ ↲ ┆a1┆Print cancelled┆e1┆ (DSTEXT,2)↲ A command was received in the 3270 data stream from the host ↓ computer while a hard-copy printout request was queued. This ↓ caused the request to be cancelled, because the received ↓ command is likely to cause the display image to change. If a ↓ hard-copy of the updated image is desired, the operator must ↓ press the PRINT key again.↲ ↲ ┆a1┆Printer offline┆e1┆ (DSTEXT,3)↲ A printout operation initiated by a hard-copy request went ↓ wrong and was given up. Part of the display image may have ↓ been printed.↲ The operation went wrong because the online signal from ↓ the printer to the terminal or PC to which it is attached ↓ went off. The reason for this may have been that the printer ↓ was selected locally, was powered off, or ran out of paper; ↓ or the printer may simply be poorly connected. This is the ↓ message which will normally occur in case of printer mal┄↓ function.↲ ↲ ┆a1┆Printer not ready┆e1┆ (DSTEXT,1)↲ A printout operation initiated by a hard-copy request went ↓ wrong and was given up. Part of the display image may have ↓ been printed.↲ ════════════════════════════════════════════════════════════════════════ ↓ The situation is similar to the one discussed above ↓ (Printer offline). It occurs when the online signal from the ↓ printer remains on, but a timeout occurs while the control ↓ logic of the terminal to which the printer is attached is ↓ waiting for the printer busy signal to go off, allowing the ↓ next character to be transmitted. This situation should ↓ occur very rarely and most likely indicates that the ↓ terminal emulator program is not well adjusted to the ↓ printer in question.↲ ↲ ┆a1┆Protected field┆e1┆ (DSTEXT,6)↲ An attempt was made to read data from the magnetic card ↓ reader into the display buffer while the cursor was ↓ positioned in a protected field. The cursor must be moved to ↓ an input field before the card can be read.↲ ↲ ┆a1┆Card read error┆e1┆ (DSTEXT,7)↲ An unsuccessful attempt was made to read a magnetic card. ↓ The card may have been incompletely inserted, or it may have ↓ been inserted at an uneven speed. The card should be re┄↓ inserted.↲ ↲ ┆a1┆Card format error┆e1┆ (DSTEXT,8)↲ A magnetic card was read, and the card was rejected because ↓ of invalid data. Most likely the card is invalid, and it ↓ will do no good to reinsert it.↲ ↲ ┆a1┆Field size error┆e1┆ (DSTEXT,9)↲ A magnetic card was read, but the input field into which the ↓ data were read was too small. The cursor must be moved to a ↓ larger field, or be backspaced so as to leave more input ↓ positions before end-of-field.↲ ↲ ┆a1┆Illegal position┆e1┆ (DSTEXT,12)↲ This message will only occur when the display device is in ↓ session with the SSCP (SNA). When the SSCP expects input, ↓ ════════════════════════════════════════════════════════════════════════ ↓ the input area is defined as starting from the cursor ↓ position - as left by the SSCP - and extending 256 character ↓ positions or to the end of the display. The message indi┄↓ cates that the cursor was moved before a magnetic card was ↓ read so that the card data, starting from the current cursor ↓ position, would not fit into the input area.↲ ↲ ┆a1┆Communication status messages, remote host links↲ The status messages which concern the host link to which a ↓ display device is attached are shown in the rightmost part ↓ of the status line (positions 57 through 80). This is true ↓ for all terminals or PCs which emulate 3270 display devices.↲ The messages discussed in this subsection concern remote ↓ host links, i.e. they indicate an error or status pertaining ↓ to a V.24 modem, an X.21 DCE, or the remote host computer or ↓ RC3803 FE. The messages which may appear when a display ↓ device is attached to a local link (cf. section B.2, Local ↓ host links) are discussed in the following subsection.↲ ↲ ┆a1┆Modem off┆e1┆ (CSTEXT,1)↲ V.24 link: ┆84┆The Data Set Ready (DSR) signal from the modem is ↓ ┆19┆┆8b┆┄┄off. The reason may be that the modem is powered ↓ ┆19┆┆8b┆┄┄off or not present, or that the signal cable is ↓ ┆19┆┆8b┆┄┄not correctly connected.↲ ↲ X.21 link: ┆84┆The DCE fails to indicate the DCE ready state, ↓ ┆19┆┆8b┆┄┄i.e. call establishment cannot be initiated. The ↓ ┆19┆┆8b┆┄┄reason may be that the DCE is powered off or not ↓ ┆19┆┆8b┆┄┄present.↲ ↲ ┆a1┆Line not ready┆e1┆ (CSTEXT,2)↲ BSC link: ┆84┆No polling sequences issued by the host computer ↓ ┆19┆┆8a┆┄┄or FE can be detected.↲ ↲ SNA/SDLC l┆84┆ink: Communication with the host computer cannot ↓ ┆19┆┆8a┆┄┄be established; one of the following codes - which ↓ ┆19┆┆8a┆┄┄refer to events in the SDLC protocol or X.21 call ↓ ════════════════════════════════════════════════════════════════════════ ↓ ┆19┆┆8a┆┄┄establishment - is shown to indicate the reason:↲ 1:╞ ┆84┆The host computer stopped polling (20 seconds ↓ ┆19┆┆8a┆┄┄timeout).↲ 4:╞ Disconnect Frame received.↲ 5: ┆84┆The host committed a protocol error, FRMR (Frame ↓ ┆19┆┆8a┆┄┄Reject) was transmitted.↲ 6:╞ Transmitter malfunction.↲ 8: ┆84┆Link disconnected by SNRM (Set Normal Response ↓ ┆19┆┆8a┆┄┄Mode) received from the host computer.↲ 10:╞ Initialization problem:↲ ╞ V.24: ┆84┆SNRM not received within 5 seconds after ↓ ┆19┆┆90┆┄┄DSR. Likely reasons are:↲ ╞ - The link has not been started at the host.↲ ╞ - ┆84┆SDLC address or NRZI encoding not custo┄↓ ┆19┆┆92┆┄┄mized correctly, i.e. not in agreeement ↓ ┆19┆┆92┆┄┄with the host.↲ ╞ X.21: ┆84┆The CU gave up trying to establish a call, ↓ ┆19┆┆90┆┄┄in which case the "Call status CP" or "Call ↓ ┆19┆┆90┆┄┄error" message (see below) will have been ↓ ┆19┆┆90┆┄┄displayed previously, or the call was ↓ ┆19┆┆90┆┄┄cleared by the network before SNRM was ↓ ┆19┆┆90┆┄┄received.↲ ↲ ┆a1┆System not available┆e1┆ (CSTEXT,3)↲ Polling and/or selection sequences from the host computer or ↓ FE are detected, but not received by the CU, because the ↓ address they contain does not match the CU number. The most ↓ likely reasons are: improper customization of the CU number ↓ or improper generation of a multidropped line at the host ↓ site. Host computer operating staff should be consulted.↲ This message applies to BSC links only.↲ ↲ ┆a1┆Cabling error┆e1┆ (CSTEXT,4)↲ This message indicates that an X.21 signal cable has been ↓ connected to a connector for a link which has been custo┄↓ mized as V.24, or vice versa. The correspondence between ↓ ════════════════════════════════════════════════════════════════════════ ↓ links and signal cable connectors is discussed in section E, ↓ External cable connections.↲ The message may also appear in conjunction with an X.21 ↓ link if the cable is not mounted. If the link is V.24 a ↓ missing cable will cause the "Modem off" message to be ↓ shown.↲ ↲ ┆a1┆Device not supported┆e1┆ (CSTEXT,5)↲ An attempt was made to attach a display device with a device ↓ number greater than 63 to a BSC link. The device was ↓ rejected.↲ ↲ ┆a1┆Call status CP┆e1┆ (CSTEXT,6)↲ An attempt by the CU to establish a call through the public ↓ data network to the host computer or FE failed. The network ↓ delivered a Call Progress (CP) signal with a code indicating ↓ the reason for the failure. The code is shown as a two-digit ↓ number adjacent to the text. Information on the meaning of ↓ specific CP codes should be obtained from the provider of ↓ the network service.↲ This message will not appear if the link is customized as ↓ V.24.↲ ↲ ┆a1┆Call error┆e1┆ (CSTEXT,7)↲ An attempt to establish a call through the public data ↓ network failed, but no CP code was received. One of the ↓ following codes is shown to indicate the reason (the meaning ↓ of these codes will be obscure to the user; they are for the ↓ use of RC technicians and should be included in the error ↓ ╱04002d4e0a000600000000020c4731400000000000000000000000000000000000000000000000000c16202a343e48525c66707a848e98ff04╱ ╱04002d4e0a000600000000030c4731400000000000000000000000000000000000000000000000000c16202a343e48525c66707a848e98ff04╱ ↓ report, should the problem persist):↲ ↲ ╱04002d4e0a000600000000030c4731400000000000000000000000000000000000000000000000000c16202a343e48525c66707a848e98ff04╱ ╱04002d4e0a000600000000020c4731400000000000000000000000000000000000000000000000000c16202a343e48525c66707a848e98ff04╱ ↓ 00: ┆84┆A call is properly established, but is then ↓ ┆19┆┆8a┆┄┄cleared illegally - by the FE, the network, or the ↓ ┆19┆┆8a┆┄┄DCE - out of step with the BSC protocol (BSC ↓ ┆19┆┆8a┆┄┄only).↲ 01:╞ Clear from DCE during call establishment↲ 02:╞ Receiver overrun↲ ════════════════════════════════════════════════════════════════════════ ↓ 03:╞ Receiver parity error↲ 04:╞ Unexpected interrupt↲ 06:╞ Time limit T1↲ 07:╞ Time limit T2↲ 08:╞ Time limit T3A/T3B↲ 09:╞ Time limit T4↲ 10:╞ Time limit T5/T6↲ ╱04002d4e0a000600000000020c4731400000000000000000000000000000000000000000000000000c16202a343e48525c66707a848e98ff04╱ ╱04002d4e0a000600000000030c4731400000000000000000000000000000000000000000000000000c16202a343e48525c66707a848e98ff04╱ ↓ 11:╞ Time limit T11↲ ↲ ╱04002d4e0a000600000000030c4731400000000000000000000000000000000000000000000000000c16202a343e48525c66707a848e98ff04╱ ╱04002d4e0a000600000000020c4731400000000000000000000000000000000000000000000000000c16202a343e48525c66707a848e98ff04╱ ↓ This message will not appear if the link is customized as ↓ V.24.↲ ↲ ┆a1┆Waiting for menu┆e1┆ (CSTEXT,8)↲ The display device is attached to a sublink of an X.21-BSC ↓ host link, i.e. a specific RC3803 FE has been selected, but ↓ the menu shown by this FE to indicate the hosts or appli┄↓ cations available at the remote site has not yet been ↓ received by the CU. This message will only be shown for a ↓ brief time until the FE menu has been obtained. If the CU ↓ fails to communicate with the remote FE, the message will be ↓ replaced by another message (typically "Call status CP") ↓ indicating the reason for the failure.↲ This message can only appear if the link is customized as ↓ X.21-BSC.↲ ↲ ┆a1┆Communication status messages, local host links↲ When an emulated 3270 terminal is attached to a local host ↓ link, i.e. communicates with an RC8000 host via an ADP, ↓ there is only one message which may appear in the commu┄↓ nication status part of the status line (positions 57 ↓ through 80), viz:↲ ╞ Host timeout, data lost↲ This message indicates that the RC8000 has failed to receive ↓ input data from the ADP, most likely because the RC8000 has ↓ ceased to operate properly. The message cannot be custo┄↓ mized.↲ ════════════════════════════════════════════════════════════════════════ ↓ ┆14┆┆b3┆↲ ┆14┆┆b1┆┆b0┆ RC3931 Communications Processor┆05┆Appendices H↲ ┆14┆┆b2┆┆b0┆ H Appendices┆05┆RC3931 Communications Processor ↲ ┆15┆┆b3┆↲ ┆15┆┆b1┆┆b0┆ Update 1/86┆05┆Page H.1-┆0b┆ H↲ ┆15┆┆b2┆┆b0┆ H Page H.1-┆0b┆┆05┆Update 1/86 ↲ ╱04002d4e0a000600000000030c4731000000000000000000000000000000000000000000000000000c1116202a343e48525c66707a848eff04╱ ╱04002d4e0a000600000000030c4731400000000000000000000000000000000000000000000000000c16202a343e48525c66707a848e98ff04╱ ↓ ┆a1┆H.1 References↲ ↲ (1)╞ RCSL No.991 10413↲ ╞ ┆a1┆Users Guide for the RC39↲ ↲ ╞ ┆84┆The general user's guide for the RC39 MUCS describing ↓ ┆19┆┆85┆┄┄the RC39 LAP.↲ ↲ (2)╞ RCSL No.991 10412↲ ╞ ┆a1┆Partner IBM 3270 Emulator, Operation Guide↲ ↲ (3)╞ RCSL No.991 10338↲ ╞ ┆a1┆RC45 IBM 3180 Emulator, User's Guide↲ ↲ (4)╞ RCSL No.991 09859↲ ╞ ┆a1┆RC855 IBM 3270 Emulator, Betjeningsvejledning↲ ↲ ╞ ┆84┆User's guide for the 3270 terminal emulator program for ↓ ┆19┆┆85┆┄┄the RC 855 terminal. Published in Danish.↲ ↲ (5)╞ RCSL No.991 10266↲ ╞ ┆a1┆RC39 Programmer's Toolkit for 3270 Communication↲ ↲ ╞ ┆84┆The toolkit is a library of routines which allow an ↓ ┆19┆┆85┆┄┄application program running on the RC39 LAP to interact ↓ ┆19┆┆85┆┄┄with a remote host as if it were a 3270 display device. ↓ ┆19┆┆85┆┄┄The manual, intended for programmers, describes these ↓ ┆19┆┆85┆┄┄routines.↲ ↲ (6)╞ RCSL No.991 10227↲ ╞ ┆a1┆RC8000 Attached Device Processor, User's Guide↲ ↲ ╞ ┆84┆A description of the Attached Device Processor which is ↓ ┆19┆┆85┆┄┄used to attach an RC8000 mainframe computer to a LAN.↲ ↲ ════════════════════════════════════════════════════════════════════════ ↓ (7) RCSL No.991 0710↲ ╞ ┆a1┆RC39 Teletex, Brugervejledning↲ ↲ ╞ ┆84┆User's guide for the Teletex service. Published in ↓ ┆19┆┆85┆┄┄Danish.↲ ════════════════════════════════════════════════════════════════════════ ↓ ┆14┆┆b3┆↲ ┆14┆┆b1┆┆b0┆ RC3931 Communications Processor┆05┆Appendices H↲ ┆14┆┆b2┆┆b0┆ H Appendices┆05┆RC3931 Communications Processor ↲ ┆15┆┆b3┆↲ ┆15┆┆b1┆┆b0┆ Update 0/85┆05┆Page H.2-┆0b┆ H↲ ┆15┆┆b2┆┆b0┆ H Page H.2-┆0b┆┆05┆Update 0/85 ↲ ╱04002d4e0a000600000000030c4731400000000000000000000000000000000000000000000000000c16202a343e48525c66707a848e98ff04╱ ╱04002d4e0a000600000000030c4731000000000000000000000000000000000000000000000000000c1116202a343e48525c66707a848eff04╱ ↓ ┆a1┆H.2 Character Sets↲ ↲ This appendix contains charts showing the different national ↓ character sets that are available with RC terminal products. ↓ Each chart shows which characters belong to the character ↓ set in question and how they are encoded.↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ Figure H.2-1. US English character set↲ ════════════════════════════════════════════════════════════════════════ ↓ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ Figure H.2-2. UK English character set↲ ════════════════════════════════════════════════════════════════════════ ↓ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ Figure H.2-3. German character set↲ ════════════════════════════════════════════════════════════════════════ ↓ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ Figure H.2-4. Swedish character set↲ ════════════════════════════════════════════════════════════════════════ ↓ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ Figure H.2-5. Standard Danish character set↲ ↲ The Standard Danish character set is only available on RC855 ↓ terminals.↲ ════════════════════════════════════════════════════════════════════════ ↓ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ Figure H.2-6. Danish OS (public sector) character set↲ ↲ The Danish OS character set as shown in Figure H.2-6 is ↓ known under the abbreviation DOS3. It is supported as shown ↓ on RC45 terminals and RC750 PCs. On RC855 terminals two ↓ versions of the Danish OS character set are available, both ↓ of which differ from DOS3 in the representation of the ↓ character with code 60┆82┆Hex┆81┆, i.e. grave accent (┆a8┆Æ┆e8┆). In DOS1 ↓ the replacement character is o umlaut (@), in DOS2 it is up ↓ arrow (`).↲ ════════════════════════════════════════════════════════════════════════ ↓ ┆14┆┆b3┆↲ ┆14┆┆b1┆┆b0┆ RC3931 Communications Processor┆05┆Appendices H↲ ┆14┆┆b2┆┆b0┆ H Appendices┆05┆RC3931 Communications Processor ↲ ┆15┆┆b3┆↲ ┆15┆┆b1┆┆b0┆ Update 0/85┆05┆Page H.3-┆0b┆ H↲ ┆15┆┆b2┆┆b0┆ H Page H.3-┆0b┆┆05┆Update 0/85 ↲ ╱04002d4e0a000600000000030c4731400000000000000000000000000000000000000000000000000c16202a343e48525c66707a848e98ff04╱ ╱04002d4e0a000600000000030c4731400000000000000000000000000000000000000000000000000c16202a343e48525c66707a848e98ff04╱ ↓ ┆a1┆H.3 EBCDIC Character Codes↲ ↲ This appendix contains charts showing the standard EBCDIC ↓ encodings of the various national character sets which are ↓ used for 3270 remote host communication. It is possible to ↓ customize the CP to support differing encodings. Those shown ↓ in this appendix are supported by the *.CNV auxiliary files ↓ distributed as part of the basic SW package for the CP ↓ (SW3901), cf. section E, Selecting character conversion.↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ Figure H.3-1. US English EBCDIC codes.↲ ↲ US English EBCDIC code may be used if the character set of ↓ the terminal cluster is US English, cf. appendix H.2.↲ ════════════════════════════════════════════════════════════════════════ ↓ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ Figure H.3-2. UK English EBCDIC codes.↲ ↲ UK English EBCDIC code may be used if the character set of ↓ the terminal cluster is UK English, cf. appendix H.2.↲ ════════════════════════════════════════════════════════════════════════ ↓ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ Figure H.3-3. German EBCDIC codes.↲ ↲ German EBCDIC code may be used if the character set of the ↓ terminal cluster is German, cf. appendix H.2.↲ ════════════════════════════════════════════════════════════════════════ ↓ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ Figure H.3-4. German alternate EBCDIC codes.↲ ↲ German alternate EBCDIC code may be used if the character ↓ set of the terminal cluster is German, cf. appendix H.2.↲ The German character set includes five characters which do ↓ not appear in the chart above ($┆a8┆YÆ┆e8┆#"). The conversion table ↓ modifications distributed as file GERMANA.CNV cause these ↓ characters to be transmitted to a remote host as blanks ↓ (code 40┆82┆Hex┆81┆).↲ ════════════════════════════════════════════════════════════════════════ ↓ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ Figure H.3-5. Swedish EBCDIC codes.↲ ↲ Swedish EBCDIC code may be used if the character set of the ↓ terminal cluster is Swedish, cf. appendix H.2.↲ ════════════════════════════════════════════════════════════════════════ ↓ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ Figure H.3-6. Swedish alternate EBCDIC codes.↲ ↲ Swedish (alternate) EBCDIC code may be used if the character ↓ set of the terminal cluster is Swedish, cf. appendix H.2.↲ ════════════════════════════════════════════════════════════════════════ ↓ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ Figure H.3-7. Standard Danish EBCDIC codes.↲ ↲ Standard Danish EBCDIC code may be used if the character set ↓ of the terminal cluster is Standard Danish, cf. appendix ↓ H.2.↲ ════════════════════════════════════════════════════════════════════════ ↓ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ Figure H.3-8. Standard Danish alternate EBCDIC codes.↲ ↲ Standard Danish alternate EBCDIC code may be used if the ↓ character set of the terminal cluster is Standard Danish, ↓ cf. appendix H.2.↲ The conversion table modifications distributed as file ↓ STDKA.CNV cause both Å and $ to be transmitted to a remote ↓ host as code 5B┆82┆Hex┆81┆. When this code is received from a remote ↓ host it is converted to the internal code for Å (5D┆82┆Hex┆81┆). ↓ Similarly, Æ and ┆a8┆Y┆e8┆ are both transmitted as code 7B┆82┆Hex┆81┆, and ↓ ════════════════════════════════════════════════════════════════════════ ↓ when this code is received it is converted to the internal ↓ code for Æ (5B┆82┆Hex┆81┆).↲ The Standard Danish character set is only available on ↓ RC855 terminals.↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ Figure H.3-9. Danish OS EBCDIC codes.↲ ↲ Danish OS EBCDIC code may be used if the character set of ↓ the terminal cluster is Danish OS, cf. appendix H.2.↲ ════════════════════════════════════════════════════════════════════════ ↓ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ ↲ Figure H.3-10. Danish OS alternate EBCDIC codes.↲ ↲ Danish OS alternate EBCDIC code may be used if the character ↓ set of the terminal cluster is Danish OS, cf. appendix H.2.↲ The conversion table modifications distributed as file ↓ DOSA.CNV cause both Å and $ to be transmitted to a remote ↓ host as code 5B┆82┆Hex┆81┆. When this code is received from a remote ↓ host it is converted to the internal code for Å (5D┆82┆Hex┆81┆).↲ ════════════════════════════════════════════════════════════════════════ ↓ ┆14┆┆b3┆↲ ┆14┆┆b1┆┆b0┆ RC3931 Communications Processor┆05┆V.24/X.21 Connectors H↲ ┆14┆┆b2┆┆b0┆ H V.24/X.21 Connectors┆05┆RC3931 Communications Processor ↲ ┆15┆┆b3┆↲ ┆15┆┆b3┆↲ ┆15┆┆b1┆┆b0┆ Update 0/85┆05┆Page H.4-┆0b┆ H↲ ┆15┆┆b2┆┆b0┆ H Page H.4-┆0b┆┆05┆Update 0/85 ↲ ╱04002d4e0a000600000000030c4731400000000000000000000000000000000000000000000000000c16202a343e48525c66707a848e98ff04╱ ╱04002d4e0a000600000000030c4731400000000000000000000000000000000000000000000000000c16202a343e48525c66707a848e98ff04╱ ↓ ┆a1┆H.4 V.24/X.21 Connectors↲ ↲ The connectors used to mount the signal cables for external ↓ communications according to the V.24 or X.21 interface ↓ standards are located on the connector panel of the RC39 ↓ cabinet as described in section E, External cable connec┄↓ tions. The present description applies to the connectors ↓ marked J11, J12, J13 and J14. Standard 25-pin D-connectors ↓ are used with pin assignments allowing the same connector to ↓ be used for either V.24 or X.21 connections by means of ↓ different cables.↲ The correspondence between connector pins and those V.24 ↓ interface circuits which are used complies with ISO standard ↓ ╱04002d4e0a000600000000020c4731400000000000000000000000000000000000000000000000000c16202a343e48525c66707a848e98ff04╱ ╱04002d4e0a000600000000030c4731400000000000000000000000000000000000000000000000000c16202a343e48525c66707a848e98ff04╱ ↓ 2110 as shown below:↲ ↲ ┆a1┆pin no.╞ ╞ V.24 interface circuit↲ 1╞ ╞ protective ground↲ 2╞ ╞ transmitted data (103)↲ 3╞ ╞ received data (104)↲ 4╞ ╞ request to send (105)↲ 5╞ ╞ ready for sending (106)↲ 6╞ ╞ data set ready (107)↲ 7╞ ╞ signal ground (102)↲ 8╞ ╞ carrier (109)↲ 15╞ ╞ transmit clock (114)↲ 17╞ ╞ receive clock (115)↲ 20╞ ╞ data terminal ready (108/2)↲ ↲ ╱04002d4e0a000600000000030c4731400000000000000000000000000000000000000000000000000c16202a343e48525c66707a848e98ff04╱ ╱04002d4e0a000600000000020c4731400000000000000000000000000000000000000000000000000c16202a343e48525c66707a848e98ff04╱ ↓ The X.21 interface circuits are assigned to the pins no┄t ↓ ╱04002d4e0a000600000000020c4731400000000000000000000000000000000000000000000000000c16202a343e48525c66707a848e98ff04╱ ╱04002d4e0a000600000000030c4731400000000000000000000000000000000000000000000000000c16202a343e48525c66707a848e98ff04╱ ↓ used for V.24 signals as shown below:↲ ↲ ┆a1┆pin no.╞ ╞ X.21 interface circuit↲ 1╞ ╞ protective ground↲ 7╞ ╞ signal ground (G)↲ 9╞ ╞ transmit (T) A↲ 10╞ ╞ indication (I) A↲ 12╞ ╞ transmit (T) B↲ 14╞ ╞ control (C) B↲ 16╞ ╞ signal element timing (S) B↲ 18╞ ╞ signal element timing (S) A↲ 19╞ ╞ receive (R) B↲ 21╞ ╞ receive (R) A↲ 24╞ ╞ indication (I) B↲ 25╞ ╞ control (C) A↲ ↲ ╱04002d4e0a000600000000030c4731400000000000000000000000000000000000000000000000000c16202a343e48525c66707a848e98ff04╱ ╱04002d4e0a000600000000020c4731400000000000000000000000000000000000000000000000000c16202a343e48525c66707a848e98ff04╱ ↓ ════════════════════════════════════════════════════════════════════════ ↓ Pin 11 is used to distinguish a cable intended for a V.24 ↓ interface from one intended for X.21. The signal should be ↓ ON for V.24, OFF for X.21.↲ ════════════════════════════════════════════════════════════════════════ ↓ ┆14┆┆b3┆↲ ┆14┆┆b1┆┆b0┆ RC3931 Communications Processor┆05┆Appendices H↲ ┆14┆┆b2┆┆b0┆ H Appendices┆05┆RC3931 Communications Processor ↲ ┆15┆┆b3┆↲ ┆15┆┆b1┆┆b0┆ Update 1/85┆05┆Page H.5-┆0b┆ H↲ ┆15┆┆b2┆┆b0┆ H Page H.5-┆0b┆┆05┆Update 1/85 ↲ ╱04002d4e0a000600000000030c4731000000000000000000000000000000000000000000000000000c161824263e48525c66707a84ffffff04╱ ╱04002d4e0a000600000000030c4731400000000000000000000000000000000000000000000000000c16202a343e48525c66707a848e98ff04╱ ↓ ┆a1┆H.5 Host Link Information Displays↲ ↲ Information about the current state of a remote host link ↓ may be displayed on an emulated display device, i.e. a ↓ terminal or PC running the appropriate emulator program, ↓ working in ┆a1┆link information mode┆e1┆. Information is obtained ↓ about the link to which the device is attached. Only one ↓ device per link may be active in link information mode at a ↓ time. The key combination which is used to enter link ↓ information mode depends on the terminal (or PC) as follows:↲ ↲ ╞ ┆a1┆terminal╞ key combination↲ ╞ ╞ RC45╞ ╞ ALT+TEST↲ ╞ ╞ RC855╞ ╞ SELECT T↲ ╞ ╞ RC750╞ ╞ CTRL+T↲ ↲ The same key combination is used to leave link information ↓ mode and return to normal emulation.↲ Note that the contents of the device buffer is abandoned ↓ when link information mode is entered. The display will ↓ therefore be cleared when the return is made to normal ↓ emulation.↲ The information displays which are available are different ↓ for BSC and SNA/SDLC. The two cases are dealt with in the ↓ two sections that follow.↲ ↲ ┆a1┆H.5.1 BSC Link Information↲ ↲ Two functions are available: display BSC statistics and ↓ reset BSC statistics, i.e. counters. The choice is made ↓ from a menu which is shown when link information mode is ↓ entered and again whenever the CLEAR key is pressed.↲ The BSC statistics display is self-explanatory.↲ ↲ ════════════════════════════════════════════════════════════════════════ ↓ ┆a1┆H.5.2 SNA/SDLC Link Information↲ ↲ Three displays are available: SNA statistics, SDLC stati┄↓ stics and X.21 statistics, the latter only for an SDLC-X.21 ↓ link. The choice is made from a menu which is shown when ↓ link information mode is entered and again whenever the ↓ CLEAR key is pressed.↲ The menu also provides a reset statistics function, which ↓ causes all the statistics (counters) pertaining to the link ↓ to be reset. Each of the statistics displays shows the time ↓ in minutes and seconds since the last time the statistics ↓ were reset (or the CU was loaded).↲ The three displays are discussed in detail below.↲ ↲ ┆a1┆SNA statistics↲ ↲ This display contains information about the customizations ↓ of printer sharing and maximum device number and about the ↓ state of the Physical Unit (PU), the Logical Units (LU) and ↓ the LU-LU sessions. If the PU is inactive, the SNA stati┄↓ stics will appear as shown in Figure H.5.1. If the PU is ↓ active the display is extended with a line for each LU that ↓ has been activated by the host, see Figure H.5.2.↲ ↲ ╱04002d4e0c000600000000020c5b31400000000000000000000000000000000000000000000000000c0f19232d37414b525c66707a848eff04╱ ╱04002d4e0a000600000000030c4731000000000000000000000000000000000000000000000000000c161824263e48525c66707a84ffffff04╱ ↓ ↲ ╞ S N A S T A T I S T I C S 1 MIN. 18 SEC.↲ ↲ ╞ PU INACTIVE↲ ╞ Max. number of devices = 64↲ ╞ Printer sharing is between brackets↲ ↲ ↲ ↲ ↲ ↲ ╞ Press CLEAR to return to statistics menu↲ ↲ ╱04002d4e0a000600000000030c4731400000000000000000000000000000000000000000000000000c16202a343e48525c66707a848e98ff04╱ ╱04002d4e0c000600000000020c5b31400000000000000000000000000000000000000000000000000c0f19232d37414b525c66707a848eff04╱ ↓ ↲ Figure H.5.1. SNA statistics display for an inactive PU.↲ ↲ ════════════════════════════════════════════════════════════════════════ ↓ ╱04002d4e0c000600000000020c5c31600000000000000000000000000000000000000000000000000f19232d37414b56606a747e8892ffff04╱ ╱04002d4e0a000600000000030c4731400000000000000000000000000000000000000000000000000c16202a343e48525c66707a848e98ff04╱ ↓ ↲ ╞ S N A S T A T I S T I C S 1 MIN. 18 SEC.↲ ↲ ╞ PU ACTIVE↲ ╞ Max. number of devices = 64↲ ╞ Printer sharing is between brackets↲ ↲ ╞ LU DEV LU-LU SESSION DIV INTERNAL↲ ↲ ╞ ╞ ╞ type hostname pacing bracket chain ss dir↲ ↲ ╞ 2 0 C ACTIVE-2 2 TESTIMS 0 0 0 0 BETB BETC C N XXX...XX↲ ╞ 3 1 D INACTIVE↲ ╞ 4 2 D INACTIVE↲ ╞ 5 3 D INACTIVE↲ ↲ ↲ ↲ ↲ ╞ Press CLEAR to return to statistics menu↲ ↲ ╱04002d4e0a000600000000020c473160000000000000000000000000000000000000000000000000141e242e38424c56606a747e8892ffff04╱ ╱04002d4e0c000600000000020c5c31600000000000000000000000000000000000000000000000000f19232d37414b56606a747e8892ffff04╱ ↓ ↲ Figure H.5.2. SNA statistics display for an active PU.↲ ↲ ↲ Each LU line (cf. Figure H.5.2) should be interpreted as:↲ ↲ LU╞ is the LU number as specified in the host (2-129)↲ ↲ DEV╞ ┆84┆is the corresponding device number (0-127) and the ↓ ┆19┆┆88┆┄┄state of the device↲ ↲ ╞ C╞ device is connected,↲ ╞ D╞ device is disconnected,↲ ╞ R╞ device is reserved (printer only).↲ ↲ LU-LU SESSION↲ ╞ ┆84┆gives the state of a session between the LU and an ↓ ┆19┆┆88┆┄┄application in the host↲ ↲ ╞ INACTIVE╞ ┆84┆no session exists; the rest of the line ↓ ┆19┆┆92┆┄┄will be empty.↲ ↲ ╞ ACTIVE-1╞ ┆84┆session exists but data cannot be sent ↓ ┆19┆┆92┆┄┄because no Start Data Traffic command has ↓ ┆19┆┆92┆┄┄been sent by the host.↲ ↲ ╞ ACTIVE-2╞ ┆84┆session exists and data can be sent. This ↓ ┆19┆┆92┆┄┄is the normal active state of a session.↲ ↲ ╞ ACTIVE-3╞ ┆84┆session exists and is closing down after ↓ ┆19┆┆92┆┄┄Shutdown command is received from the ↓ ┆19┆┆92┆┄┄host.↲ ↲ ╞ CLEARING╞ session is about to be removed.↲ ↲ ════════════════════════════════════════════════════════════════════════ ↓ type╞ is the type of the session↲ ↲ ╞ 1╞ SNA character stream printer↲ ╞ 2╞ 3270 display↲ ╞ 3╞ 3270 printer↲ ↲ hostname↲ ╞ is the name of the application in the host↲ ↲ pacing╞ ┆84┆4 numbers giving receive pacing count, transmit ↓ ┆19┆┆88┆┄┄pacing count, current allowed receive count, current ↓ ┆19┆┆88┆┄┄allowed transmit count. If zeroes are shown, pacing ↓ ┆19┆┆88┆┄┄is not used for this session.↲ ↲ bracket╞ is the bracket state↲ ↲ ╞ BETB╞ between brackets↲ ╞ INB╞ in bracket↲ ╞ PEND╞ pending begin bracket↲ ↲ chain╞ is the chain state↲ ↲ ╞ BETC╞ between chains↲ ╞ INC╞ in chain↲ ↲ ss╞ is the session state↲ ↲ ╞ C╞ contention↲ ╞ E╞ error↲ ╞ R╞ receive↲ ╞ S╞ send↲ ↲ dir╞ is the direction↲ ↲ ╞ F╞ from host↲ ╞ N╞ neutral↲ ╞ T╞ to host↲ ↲ DIV INT.↲ ╞ ┆84┆14 characters with internal information about ↓ ┆19┆┆88┆┄┄program states etc.↲ ╱04002d4e0a000600000000030c473160000000000000000000000000000000000000000000000000141e242e38424c56606a747e8892ffff04╱ ╱04002d4e0a000600000000020c473160000000000000000000000000000000000000000000000000141e242e38424c56606a747e8892ffff04╱ ↓ ↲ Each SNA statistics display has room for 10 lines of LU ↓ information. If there is more information than shown, this ↓ is indicated in the bottom part of the display, and PA1/PF1 ↓ can be used to retrieve subsequent lines.↲ ↲ ════════════════════════════════════════════════════════════════════════ ↓ ┆a1┆SDLC statistics↲ ↲ This display contains information about the customization of ↓ the link (SDLC-address, terminal-ID, X.21/V.24, nrzi, COM ↓ board number, and host link identification; for V.24 also ↓ half/full duplex, point-to-point/multi-point and Data ↓ Terminal Ready handling) and the activity on the link ↓ (received/transmitted frames etc.).↲ The display for an SDLC-V.24 link is shown in Figure H.5.3 ↓ and the display for an SDLC-X.21 link in Figure H.5.4.↲ ↲ ↲ ╱04002d4e0c000600000000020c5731600000000000000000000000000000000000000000000000000f3037414b56606a747e8892ffffffff04╱ ╱04002d4e0a000600000000030c473160000000000000000000000000000000000000000000000000141e242e38424c56606a747e8892ffff04╱ ↓ ╞ S D L C / L I N K S T A T I S T I C S 0 MIN. 38 SEC.↲ ↲ ╞ SDLC-addr = C1↲ ╞ NRZI = yes↲ ╞ Term-id = 01043↲ ↲ ╞ V.24 / Full duplex / Point-to-point / Nonswitched↲ ╞ COM board = 1 / SNA link 1↲ ↲ ╞ Received I-frames╞ 1752↲ ╞ Transmitted I-frames╞ 1587↲ ╞ Received RNR╞ 0↲ ╞ Transmitted RNR╞ 0↲ ╞ Received TEST╞ 0↲ ╞ Transmitted TEST╞ 0↲ ╞ Receiver overrun╞ 0↲ ╞ Transmitter underrun╞ 0↲ ╞ Received CRC-errors╞ 0↲ ╞ Received aborts╞ 0↲ ╞ Retransmitted I-frames╞ 0↲ ╞ CD failures╞ 0↲ ╞ CTS failures╞ 0↲ ↲ ╞ Press CLEAR to return to statistics menu↲ ↲ ↲ ╱04002d4e0c000600000000020c4731600000000000000000000000000000000000000000000000000f1a242e38424c56606a747e88929cff04╱ ╱04002d4e0c000600000000020c5731600000000000000000000000000000000000000000000000000f3037414b56606a747e8892ffffffff04╱ ↓ ╞ ↓ ╱04002d4e0a000600000000030c473160000000000000000000000000000000000000000000000000101a242e38424c56606a747e88929cff04╱ ╱04002d4e0c000600000000020c4731600000000000000000000000000000000000000000000000000f1a242e38424c56606a747e88929cff04╱ ↓ ↲ Figure H.5.3. SDLC statistics display for an SDLC-V.24 link↲ ↲ ┆a1┆┆e1┆If the link uses a dial-up line, no attention should be paid ↓ to the CD failures counter.↲ ════════════════════════════════════════════════════════════════════════ ↓ ╱04002d4e0c000600000000020c5731600000000000000000000000000000000000000000000000000f3037414b56606a747e88929cffffff04╱ ╱04002d4e0a000600000000030c473160000000000000000000000000000000000000000000000000101a242e38424c56606a747e88929cff04╱ ↓ ↲ ╞ S D L C / L I N K S T A T I S T I C S 2 MIN 57 SEC↲ ↲ ╞ SDLC-addr = C1↲ ╞ NRZI = no↲ ╞ Term-id = 23CBF↲ ↲ ╞ X.21↲ ╞ COM board = 2 / SNA link 1↲ ↲ ╞ Received I-frames╞ 12↲ ╞ Transmitted I-frames╞ 8↲ ╞ Received RNR╞ 0↲ ╞ Transmitted RNR╞ 0↲ ╞ Received TEST╞ 0↲ ╞ Transmitted TEST╞ 0↲ ╞ Receiver overrun╞ 0↲ ╞ Transmitter underrun╞ 0↲ ╞ Received CRC-errors╞ 0↲ ╞ Received aborts╞ 0↲ ╞ Retransmitted I-frames╞ 0↲ ↲ ↲ ↲ ╞ Press CLEAR to return to statistics menu↲ ↲ ╱04002d4e0a000600000000030c473160000000000000000000000000000000000000000000000000101a242e38424c56606a747e88929cff04╱ ╱04002d4e0c000600000000020c5731600000000000000000000000000000000000000000000000000f3037414b56606a747e88929cffffff04╱ ↓ ↲ Figure H.5.4. SDLC statistics display for an SDLC-X.21 link↲ ↲ ════════════════════════════════════════════════════════════════════════ ↓ ┆a1┆X.21 statistics↲ ↲ This display contains information about the activity at the ↓ X.21 interface level (outgoing calls, incoming calls, ↓ received call progress codes and error codes). The ↓ subscriber numbers of the CU and the host, and the state of ↓ the X.21 Short Hold Mode session are also shown (cf. Figure ↓ H.5.5).↲ ↲ ╱04002d4e0c000600000000020c5331600000000000000000000000000000000000000000000000000f19232d37414b56606a747e8892ffff04╱ ╱04002d4e0a000600000000030c473160000000000000000000000000000000000000000000000000101a242e38424c56606a747e88929cff04╱ ↓ ╞ X 2 1 S T A T I S T I C S 3 MIN. 44 SEC.↲ ↲ ╞ CU-DX = 125333 HOST-DX = 125334↲ ╞ Short Hold Mode Session = active↲ ↲ ╞ Outgoing calls OK╞ ╞ 4↲ ╞ Outgoing calls CP code╞ 1↲ ╞ Outgoing calls Error╞ 0↲ ╞ Incoming calls OK╞ ╞ 2↲ ╞ Incoming calls Error╞ 0↲ ↲ ╞ CP codes:↲ ╞ 45= 1↲ ╞ Error codes: none↲ ↲ ↲ ↲ ↲ ╞ Press CLEAR to return to statistics menu↲ ↲ ╱04002d4e0a000600000000030c473160000000000000000000000000000000000000000000000000101a242e38424c56606a747e88929cff04╱ ╱04002d4e0c000600000000020c5331600000000000000000000000000000000000000000000000000f19232d37414b56606a747e8892ffff04╱ ↓ ↲ Figure H.5.5. X.21 statistics display for an SDLC-X.21 link↲ ════════════════════════════════════════════════════════════════════════ ↓ ↲ ┆1a┆┆1a┆ ↓ Terminal Ready handlinginformatitirmal emulation.↲ Note that the contents of the device