|
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: 58496 (0xe480)
Types: RcTekst
Names: »99109714.WP«
└─⟦dedaa6eab⟧ Bits:30005866/disk1.imd Dokumenter i RcTekst format (RCSL 99-1-*)
└─⟦this⟧ »99109714.WP«
╱0400274e0c0006000000000301483160000000000000000000000000000000000000000000000000050a0f14191e23282d32373c41464bff04╱
↲
↲
↲
↲
↲
↲
↲
↲
↲
↲
↲
↲
↲
↲
↲
↲
↲
↲
↲
┆06┆RC890 Control Unit,↲
┆06┆Operation and System Customization Manual↲
↲
↲
↲
↲
↲
↲
↲
↲
↲
↲
↲
↲
↲
↲
↲
↲
A/S REGNECENTRALEN af 1979┆05┆April 1984↲
Information Department┆05┆RCSL No 99-1-09714↲
↲
════════════════════════════════════════════════════════════════════════
↓
↲
↲
↲
↲
╞ ╞ Author:╞ ╞ Pierce C. Hazelton↲
↲
╞ ╞ Keywords:╞ ╞ RC890, RC855, Operation, Customization↲
↲
╞ ╞ Abstract:╞ ╞ ┆84┆Describes operation of the RC890 control unit ↓
┆19┆┆98┆┄┄and customization of the RC890 based RC855 ↓
┆19┆┆98┆┄┄terminal system.↲
↲
╞ ╞ ╞ ╞ ╞ (52 printed pages)↲
↲
↲
↲
↲
↲
╞ ╞ ┆a1┆Notice↲
↲
╞ ╞ ┆84┆CP/M is a registered trademark of Digital Research.↲
╞ ╞ ┆84┆WordStar is a trademark of Micropro International Corporation.↲
↲
↲
════════════════════════════════════════════════════════════════════════
↓
┆06┆i↲
↲
╞ ╞ ┆a1┆┆b0┆FOREWORD↲
↲
╞ ╞ First edition: RCSL No. 42-i2454.↲
↲
╞ ╞ Second edition: RCSL No. 99-1-09714.↲
╞ ╞ ┆84┆This edition supersedes the first edition. The text has been ↓
┆19┆┆89┆┄┄brought up to date and partly rewritten. Important additions ↓
┆19┆┆89┆┄┄include descriptions of the RC890 textfile editor and in┄↓
┆19┆┆89┆┄┄stallation of new RC855 program images. Significant changes in ↓
┆19┆┆89┆┄┄the text are marked by a vertical line in the left-hand margin.↲
↲
╞ ╞ Pierce C. Hazelton↲
╞ ╞ A/S REGNECENTRALEN af 1979, April 1984↲
↲
════════════════════════════════════════════════════════════════════════
↓
┆06┆ii↲
↲
↲
↲
╞ ╞ ┆a1┆┆b0┆IMPORTANT↲
↲
╞ ╞ ┆84┆The RESET button must be pressed following any modification of ↓
┆19┆┆89┆┄┄the system diskette or installation of a new system.↲
↲
↲
════════════════════════════════════════════════════════════════════════
↓
┆06┆iii↲
↲
┆81┆ ┆a1┆┆a1┆┆b0┆TABLE OF CONTENTS┆05┆PAGE↲
╱0400274e0c00060000000003014a3160000000000000000000000000000000000000000000000000050a0f14191e23282d32373c41464bff04╱
╱0400274e0c0006000000000301483160000000000000000000000000000000000000000000000000050a0f14191e23282d32373c41464bff04╱
↓
↲
╞ ╞ 1. INTRODUCTION .............................................1↲
↲
╞ ╞ 2. OPERATION OF THE RC890 CONTROL UNIT ......................3↲
╞ ╞ 2.1 System Startup Procedure ............................3↲
╞ ╞ 2.2 Diskette Drive and the CU Diskette ..................5↲
╞ ╞ 2.3 Power Switch ........................................6↲
╞ ╞ 2.4 Status Lamps ........................................6↲
╞ ╞ 2.4.1 Self-Test and Program Load ...................7↲
╞ ╞ ╞ 2.4.2 Normal Operation .............................8↲
╞ ╞ ╞ 2.4.3 Re┆88┆'sume┆88┆' .......................................8↲
╞ ╞ 2.5 Error Handling ......................................9↲
╞ ╞ 2.6 Back Panel and Signal Cable Connectors .............10↲
↲
╞ ╞ 3. THE TERMINAL SYSTEM IN A NUTSHELL .......................12↲
╞ ╞ 3.1 RC855 Terminal .....................................12↲
╞ ╞ 3.2 RC890 CU Customization Parameters ..................13↲
╞ ╞ 3.3 Downline Loading and Terminal Menus ................13↲
↲
╞ ╞ 4. CUSTOMIZATION OF THE TERMINAL SYSTEM ....................17↲
╞ ╞ 4.1 NVM Parameters .....................................17↲
╞ ╞ 4.2 Files on the CU Diskette ...........................18↲
╞ ╞ ╞ 4.2.1 Survey of the CU Diskette Files .............18↲
╞ ╞ ╞ 4.2.2 Modification of Textfiles ...................19↲
╞ ╞ 4.3 PARAMS.CU File .....................................20↲
╞ ╞ ╞ 4.3.1 Character Set Conversion ....................22↲
╞ ╞ ╞ 4.3.2 Communication Line Parameters, General.......23↲
╞ ╞ ╞ 4.3.3 Communication Line Parameters, BSC ..........23↲
╞ ╞ ╞ 4.3.4 Communication Line Parameters, SNA/SDLC .....24↲
╞ ╞ ╞ 4.3.5 Display Screen Texts ........................26↲
╞ ╞ ╞ 4.3.6 Printer Authorization .......................28↲
╞ ╞ ╞ 4.3.7 Miscellaneous ...............................30↲
╞ ╞ 4.4 MENU.DLL File ......................................30↲
╞ ╞ ╞ 4.4.1 Instructive Texts and Status Texts ..........31↲
╞ ╞ ╞ 4.4.2 Application Descriptions ....................32↲
╞ ╞ ╞ 4.4.3 Terminal Menus ..............................33↲
↲
════════════════════════════════════════════════════════════════════════
↓
┆06┆iv↲
↲
╞ ╞ ┆a1┆┆b0┆TABLE OF CONTENTS PAGE↲
↲
╞ ╞ 5. RC890 TEXTFILE EDITOR OPERATION .........................34↲
╞ ╞ 5.1 Edit ...............................................35↲
╞ ╞ 5.2 Print ..............................................37↲
╞ ╞ 5.3 Read File ..........................................37↲
╞ ╞ 5.4 Write File .........................................37↲
╞ ╞ 5.5 Rename File ........................................38↲
╞ ╞ 5.6 Delete File ........................................38↲
╞ ╞ 5.7 Read Catalog .......................................38↲
╞ ╞ 5.8 Error Messages .....................................39↲
↲
╞ ╞ 6. INSTALLATION OF RC855 SOFTWARE ..........................40↲
↲
↲
╞ ╞ ┆a1┆┆b0┆APPENDICES↲
↲
╞ ╞ A. REFERENCES ..............................................42↲
↲
╞ ╞ B. PARAMS.CU FILE ..........................................43↲
↲
╞ ╞ C. MENU.DLL FILE ...........................................44↲
↲
════════════════════════════════════════════════════════════════════════
↓
┆14┆┆b3┆┆06┆┆0b┆↲
↲
┆a1┆┆b0┆1.╞ INTRODUCTION↲
↲
↲
╞ ╞ ┆84┆The RC890 control unit permits RC855 terminals to access host ↓
┆19┆┆89┆┄┄systems utilizing the SNA/SDLC as well as the BSC protocol for ↓
┆19┆┆89┆┄┄remote connection of IBM 3270 Display Stations. The RC855 ter┄↓
┆19┆┆89┆┄┄minals are connected to the RC890 control unit by means of a ↓
┆19┆┆89┆┄┄multidropped terminal network, called RcCircuit.↲
↲
╞ ╞ ┆84┆The RC890 control unit is available in two models: RC890-10 ↓
┆19┆┆89┆┄┄(single host) and RC890-20 (dual host or high performance). The ↓
┆19┆┆89┆┄┄RC890-10 handles a single communication line with a maximum ↓
┆19┆┆89┆┄┄speed of 9,600 bits per second, and supports up to sixteen ↓
┆19┆┆89┆┄┄RC855 terminals; to each of these terminals a printer may be ↓
┆19┆┆89┆┄┄connected, for local or remote printing. The RC890-20 is ↓
┆19┆┆89┆┄┄available in two versions:↲
↲
- ┆84┆High performance: a single communication line with a maximum ↓
┆19┆┆8b┆┄┄speed of 19,200 bits per second, and up to thirty-two RC855 ↓
┆19┆┆8b┆┄┄terminals (at most thirty-two devices including printers).↲
↲
╞ ╞ - ┆84┆Dual host: two 9,600 bps lines, and up to sixteen RC855 ter-↓
┆19┆┆8b┆┄┄minals.↲
↲
╞ ╞ ┆84┆Application programs for RC855 terminals connected to the RC890 ↓
┆19┆┆89┆┄┄control unit are downline loaded from diskette, after optional ↓
┆19┆┆89┆┄┄selection from a menu. An RC855 which is itself equipped with a ↓
┆19┆┆89┆┄┄diskette drive may be used for local data processing (the RC855 ↓
┆19┆┆89┆┄┄being loaded from the local diskette with the CP/M operating ↓
┆19┆┆89┆┄┄system) as well as remote host communication.↲
↲
┆8c┆┆83┆┄↓
╞ ╞ ┆84┆The present operation and system customization manual for the ↓
┆19┆┆89┆┄┄RC890 control unit describes, in Chapter 2, the operation of ↓
┆19┆┆89┆┄┄the control unit and, in Chapter 4, the customization of the ↓
┆19┆┆89┆┄┄control unit and connected terminals to suit individual user ↓
┆19┆┆89┆┄┄requirements.↲
↲
┆84┆As a background for customization of the terminal system, Chap┄↓
┆19┆┆89┆┄┄ter 3 contains a short account of the RC855 termi┄nal, RC890 CU ↓
┆19┆┆89┆┄┄customization parameters, downline loading, and terminal menus.↲
↲
╞ ╞ ┆84┆Chapter 5 explains the RC890 textfile editor, which can be used ↓
┆19┆┆89┆┄┄to modify textfiles on the RC890 system disk┄ette in order to ↓
┆19┆┆89┆┄┄customize the terminal system.↲
↲
╞ ╞ ┆84┆The RC890 Software Install program, which is used to install ↓
┆19┆┆89┆┄┄new RC855 program images on the RC890 system diskette, is ↓
┆19┆┆89┆┄┄described in Chapter 6.↲
↲
╞ ╞ ┆84┆Information about matters other than control unit operation and ↓
┆19┆┆89┆┄┄terminal system customization will be found in the referenced ↓
┆19┆┆89┆┄┄publications, which are listed in Appendix A.↲
↲
════════════════════════════════════════════════════════════════════════
↓
┆a1┆┆b0┆2.╞ ╞ OPERATION OF THE RC890 CONTROL UNIT↲
↲
↲
╞ ╞ ┆84┆The front panel of the RC890 control unit (CU) is of primary ↓
┆19┆┆89┆┄┄interest to the RC890 operator. The front panel contains a ↓
┆19┆┆89┆┄┄diskette drive, a row of status lamps, and a power switch.↲
Fig. 1 shows the front panel of the RC890 control unit.↲
↲
↲
↲
↲
↲
↲
↲
↲
↲
↲
↲
↲
↲
↲
Figure 1: RC890 Control Unit, Front Panel.↲
↲
↲
┆a2┆┆e2┆┆a1┆┆b0┆2.1╞ ╞ System Startup Procedure↲
↲
↲
╞ ╞ ┆84┆1. Check that the CU diskette is in the RC890 diskette drive.↲
╞ ╞ 2. Apply power to the RC890.↲
╞ ╞ 3. Observe the RC890 status lamps.↲
╞ ╞ 4. Apply power to the connected RC855 terminals.↲
↲
╞ ╞ ┆84┆In the normal system startup sequence, the status lamps on the ↓
┆19┆┆89┆┄┄RC890 will light as follows:↲
↲
════════════════════════════════════════════════════════════════════════
↓
╞ ╞ ┆a1┆Lamps Lit╞ ╞ Duration╞ ╞ Phase╞ ╞ ╞ ╞ ↲
╞ ╞ all╞ ╞ ╞ less than 1 sec.╞ RC890 power switched on↲
╞ ╞ TEST╞ ╞ ╞ approx. 1 sec. RC890 self-test↲
╞ ╞ READY TEST╞ approx. 30 secs. RC890 program load ↓
╞ ╞ READY STATUS 3 15 secs. or more╞ ┆84┆RC855 menu transmission ↓
┆19┆┆af┆┄┄and program load↲
╞ ╞ READY╞ ╞ ╞ ╞ ╞ ╞ normal operation↲
↲
╞ ╞ ┆84┆READY will be lit, and STATUS 3 will flash on and off, during ↓
┆19┆┆89┆┄┄RC855 menu transmission and program loading.↲
↲
╞ ╞ ┆84┆From the moment power is applied to the connected RC855 termi┄↓
┆19┆┆89┆┄┄nal and until its menu is received, the RC855 status line will ↓
┆19┆┆89┆┄┄display the message:↲
↲
╞ ╞ ______________________________________________________________↲
╞ ╞ ┆a1┆ RC855╞ ╞ ╞ ╞ ╞ ╞ ╞ LC ↲
↲
╞ ╞ ┆84┆The menu transmission time is approximately 5 seconds, once the ↓
┆19┆┆89┆┄┄RC890 is past its own program load phase. When the menu has ↓
┆19┆┆89┆┄┄been received, the RC855 status line will display the message:↲
↲
╞ ╞ ______________________________________________________________↲
╞ ╞ ┆a1┆ RC855 ↲
↲
╞ ╞ ┆84┆The above message is displayed during automatic selection of ↓
┆19┆┆89┆┄┄the terminal's default application (no menu displayed) or while ↓
┆19┆┆89┆┄┄the RC855 operator is selecting an application (from the dis┄↓
┆19┆┆89┆┄┄played menu). When loading of the selected application program ↓
┆19┆┆89┆┄┄begins, the RC855 status line will display the message:↲
↲
╞ ╞ ______________________________________________________________↲
╞ ╞ ┆a1┆ RC855 LA ↲
↲
╞ ╞ ┆84┆The program load time is approximately 10 seconds; however, if ↓
┆19┆┆89┆┄┄several RC855 terminals must be loaded simultaneously, a longer ↓
┆19┆┆89┆┄┄time will be required.↲
↲
════════════════════════════════════════════════════════════════════════
↓
╞ ╞ ┆84┆The operation of the RC890 control unit is described in detail ↓
┆19┆┆89┆┄┄in the remaining sections of this chapter. The RC855 terminal, ↓
┆19┆┆89┆┄┄downline loading, and terminal menus are further described in ↓
┆19┆┆89┆┄┄Chapter 3.↲
↲
↲
┆a1┆┆b0┆2.2╞ ╞ Diskette Drive and the CU Diskette↲
↲
↲
╞ ╞ ┆84┆The programs to be loaded on the RC890 control unit (CU) are ↓
┆19┆┆89┆┄┄contained in files on the RC890 system diskette, also called ↓
┆19┆┆89┆┄┄the CU diskette (4.2).↲
↲
╞ ╞ ┆84┆It is wise to make one or more backup copies of the CU disk┄↓
┆19┆┆89┆┄┄ette, if possible, before proceeding to operate the control ↓
┆19┆┆89┆┄┄unit.↲
↲
╞ ╞ ┆84┆Backup copies may be made on an RC855 terminal running under ↓
┆19┆┆89┆┄┄the CP/M operating system. The RC855 in question must be e┄↓
┆19┆┆89┆┄┄quipped with an RC874 diskette unit. The copying procedure is ↓
┆19┆┆89┆┄┄described in the RC855 Work Station User's Guide (4). For the ↓
┆19┆┆89┆┄┄operation of the RC855 terminal and the care of diskettes in ↓
┆19┆┆89┆┄┄general, see the RC855 Operating Guide (2).↲
↲
╞ ╞ Backup copies of the CU diskette may be ordered separately.↲
↲
╞ ╞ ┆84┆To return to the RC890 control unit, the CU diskette can be ↓
┆19┆┆89┆┄┄inserted in the diskette drive only when the latch on the drive ↓
┆19┆┆89┆┄┄is horizontal. The label on the diskette must face up and away ↓
┆19┆┆89┆┄┄from the drive. The diskette is inserted by pushing it gently ↓
┆19┆┆89┆┄┄into the drive slot until it is seated. The latch must then be ↓
┆19┆┆89┆┄┄turned clockwise until it is vertical.↲
↲
╞ ╞ ┆84┆Note that the application and removal of power (2.3) has no ↓
┆19┆┆89┆┄┄effect on the CU diskette when the latter is in the diskette ↓
┆19┆┆89┆┄┄drive; in fact, it is good practice just to leave it there.↲
↲
════════════════════════════════════════════════════════════════════════
↓
╞ ╞ ┆84┆The CU diskette is removed from the diskette drive by turning ↓
┆19┆┆89┆┄┄the latch on the drive counter-clockwise until it is horizon┄↓
┆19┆┆89┆┄┄tal. This will unseat the diskette, so that it can be easily ↓
┆19┆┆89┆┄┄withdrawn from the slot.↲
↲
╞ ╞ ┆84┆The lamp on the diskette drive lights when the drive is select┄↓
┆19┆┆89┆┄┄ed and the diskette revolves.↲
↲
↲
┆a1┆┆b0┆2.3╞ ╞ Power Switch↲
↲
╞ ╞ ┆84┆With the power cable (on the back panel) properly connected, ↓
┆19┆┆89┆┄┄the power switch, at the extreme right of the front panel, can ↓
┆19┆┆89┆┄┄be pressed to apply power to the control unit. The switch will ↓
┆19┆┆89┆┄┄light, and remain lit as long as the power is on. Power is ↓
┆19┆┆89┆┄┄removed from the control unit by pressing the same switch ↓
┆19┆┆89┆┄┄again.↲
↲
↲
┆a1┆┆b0┆2.4╞ ╞ Status Lamps↲
↲
╞ ╞ ┆84┆The front panel of the RC890 control unit contains a row of ↓
┆19┆┆89┆┄┄eight status lamps, labeled, from left to right: READY, TEST, ↓
┆19┆┆89┆┄┄ERROR, RETRY, STATUS 1, STATUS 2, STATUS 3, and STATUS 4. The ↓
┆19┆┆89┆┄┄significance of these lamps is explained in the following.↲
↲
╞ ╞ ┆84┆The RC890 control unit is reset when power is applied, and ↓
┆19┆┆89┆┄┄thereafter whenever the reset button (on the back panel) is ↓
┆19┆┆89┆┄┄pressed. On being reset, the control unit automatically per┄↓
┆19┆┆89┆┄┄forms a built-in self-test. On successful completion of the ↓
┆19┆┆89┆┄┄self-test, the programs for the control unit are automatically ↓
┆19┆┆89┆┄┄loaded from the CU diskette.↲
↲
↲
════════════════════════════════════════════════════════════════════════
↓
┆a1┆┆b0┆2.4.1╞ Self-Test and Program Load↲
↲
╞ ╞ ┆84┆The self-test is performed by the COM and CPU boards in the ↓
┆19┆┆89┆┄┄control unit. Each of these printed circuit boards has its own ↓
┆19┆┆89┆┄┄microprocessor and runs its own program (cf. 4.2.1). The CPU ↓
┆19┆┆89┆┄┄board has overall control of the system. The COM board is the ↓
┆19┆┆89┆┄┄communication line interface. Some features require an addi┄↓
┆19┆┆89┆┄┄tional COM board.↲
↲
╞ ╞ ┆84┆When power is applied to the control unit, all lamps light for ↓
┆19┆┆89┆┄┄a moment (or for as long as the reset button is held de┄↓
┆19┆┆89┆┄┄pressed). Then the TEST lamp lights, and remains lit during the ↓
┆19┆┆89┆┄┄COM test. If an error is detected, the ERROR lamp lights ↓
┆19┆┆89┆┄┄together with at least one of the RETRY and STATUS lamps. The ↓
┆19┆┆89┆┄┄control unit will normally stop in this situation, and the ↓
┆19┆┆89┆┄┄operator should note down which of the RETRY and STATUS lamps ↓
┆19┆┆89┆┄┄are lit, as this is an error code.↲
↲
╞ ╞ ┆84┆On successful completion of the COM test, the READY lamp ↓
┆19┆┆89┆┄┄lights, and the TEST lamp remains lit.↲
↲
╞ ╞ ┆84┆READY and TEST stay lit together while the CPU board concludes ↓
┆19┆┆89┆┄┄its self-test, loads its own software, reads the textfiles ↓
┆19┆┆89┆┄┄MENU.DLL and PARAMS.CU, and finally loads the program which is ↓
┆19┆┆89┆┄┄to run on the COM board. The TEST lamp is not extinguished ↓
┆19┆┆89┆┄┄until the final loading operation has been successfully com┄↓
┆19┆┆89┆┄┄pleted. The time required for program loading depends on the ↓
┆19┆┆89┆┄┄length of the textfiles read (cf. 2.1).↲
↲
╞ ╞ ┆84┆If an error is detected during either of the above loading ↓
┆19┆┆89┆┄┄operations, the ERROR lamp lights, and the READY lamp is extin┄↓
┆19┆┆89┆┄┄guished. The TEST lamp remains lit. None of the RETRY and ↓
┆19┆┆89┆┄┄STATUS lamps lights, i.e. the error code is 0.↲
↲
↲
════════════════════════════════════════════════════════════════════════
↓
┆a1┆┆b0┆2.4.2╞ Normal Operation↲
↲
╞ ╞ ┆84┆During normal operation, READY is lit, whereas TEST and ERROR ↓
┆19┆┆89┆┄┄are not. The other five lamps are used in the following manner:↲
↲
╞ ╞ RETRY : when lit, retransmission on a communication line↲
╞ ╞ STATUS 1 : when lit, activity on host line 1↲
╞ ╞ STATUS 2 : when lit, activity on host line 2↲
╞ ╞ STATUS 3 : when lit, activity on RcCircuit↲
╞ ╞ STATUS 4 : reserved for local area network activity↲
↲
╞ ╞ ┆84┆On a detected unrecoverable error, i.e. in a situation where ↓
┆19┆┆89┆┄┄the control unit has no way of continuing, the ERROR lamp ↓
┆19┆┆89┆┄┄lights, and the READY lamp is extinguished. Again, the operator ↓
┆19┆┆89┆┄┄should note down the error code indicated by the RETRY and ↓
┆19┆┆89┆┄┄STATUS lamps.↲
↲
↲
┆a1┆┆b0┆2.4.3╞ Re┆88┆'sume┆88┆'↲
↲
╞ ╞ ┆84┆READY, TEST, and ERROR have primary significance.↲
↲
╞ ╞ ┆84┆┆a1┆TEST┆e1┆ is lit only during the self-test. If TEST remains lit, it ↓
┆19┆┆89┆┄┄is owing to an error.↲
↲
╞ ╞ ┆84┆During normal operation, ┆a1┆READY┆e1┆ is the only one of these three ↓
┆19┆┆89┆┄┄lamps which is lit.↲
↲
╞ ╞ ┆84┆READY lights toward the end of the self-test, while TEST is ↓
┆19┆┆89┆┄┄still lit, as the programs for the control unit are loaded from ↓
┆19┆┆89┆┄┄the CU diskette. If READY and TEST remain lit together, it is ↓
┆19┆┆89┆┄┄owing to an erroneous conclusion of the self-test (on the CPU ↓
┆19┆┆89┆┄┄board).↲
↲
════════════════════════════════════════════════════════════════════════
↓
╞ ╞ ┆84┆┆a1┆ERROR┆e1┆ lights on a detected error. If TEST is lit, too, the ↓
┆19┆┆89┆┄┄error occurred before the start of normal operation. If none of ↓
┆19┆┆89┆┄┄the RETRY and STATUS lamps is lit, the error was detected dur┄↓
┆19┆┆89┆┄┄ing program loading from the CU diskette. The operator should ↓
┆19┆┆89┆┄┄check that the CU diskette is in the diskette drive.↲
↲
╞ ╞ ┆84┆If ERROR lights after TEST has been extinguished, it is owing ↓
┆19┆┆89┆┄┄to an error detected by the control unit's communication pro┄↓
┆19┆┆89┆┄┄gram (i.e. the IBM 3274 emulator).↲
↲
↲
┆a1┆┆b0┆2.5╞ ╞ Error Handling↲
↲
╞ ╞ ┆84┆Whenever the ERROR lamp lights, the operator should observe and ↓
┆19┆┆89┆┄┄note down which status lamps are lit and which not.↲
↲
╞ ╞ ┆84┆The operator should then correct any obvious error, such as ↓
┆19┆┆89┆┄┄inserting a missing CU diskette, and thereafter reset the con┄↓
┆19┆┆89┆┄┄trol unit by means of the reset button on the back panel.↲
↲
╞ ╞ ┆84┆If the error persists, the operator should report it together ↓
┆19┆┆89┆┄┄with the status lamps observed.↲
↲
╞ ╞ ┆84┆Before resetting the control unit, the operator should, if ↓
┆19┆┆89┆┄┄possible, display and print (or at least note down) the con┄↓
┆19┆┆89┆┄┄tents of the ERRORLOG. file on the CU diskette (4.2.1). This ↓
┆19┆┆89┆┄┄may be done on an RC855 terminal running under the CP/M oper┄↓
┆19┆┆89┆┄┄ating system (cf. 2.2).↲
↲
↲
════════════════════════════════════════════════════════════════════════
↓
┆a1┆┆b0┆2.6╞ ╞ Back Panel and Signal Cable Connectors↲
↲
╞ ╞ ┆84┆The back panel of the RC890 control unit contains a fuse, a ↓
┆19┆┆89┆┄┄reset button, a power cable connector, and eight connectors for ↓
┆19┆┆89┆┄┄signal cables. Fig. 2 shows the back panel of the control unit.↲
↲
↲
↲
↲
↲
↲
↲
↲
↲
↲
↲
↲
↲
↲
↲
Figure 2: RC890 Control Unit, Back Panel.↲
↲
╞ ╞ ┆84┆The signal cable connectors are used as follows:↲
↲
╞ ╞ ┆a1┆Connector┆e1┆╞ ╞ ┆a1┆Use↲
╞ ╞ J1-J2╞ ╞ first COM board:↲
╞ ╞ ╞ ╞ ╞ J1 : BSC↲
╞ ╞ ╞ ╞ ╞ J2 : SNA/SDLC↲
╞ ╞ J3-J4╞ ╞ described below↲
╞ ╞ C1╞ ╞ ╞ RcCircuit↲
╞ ╞ C2╞ ╞ ╞ not used↲
╞ ╞ K1╞ ╞ ╞ TTY to port on CPU board↲
╞ ╞ LAN╞ ╞ ╞ local area network↲
↲
┆8c┆┆83┆┆98┆↓
╞ ╞ ┆84┆The use of the signal cable connector group labeled V.24/X.21 ↓
┆19┆┆89┆┄┄COMM. is dependent on the particular model and features of the ↓
┆19┆┆89┆┄┄RC890 control unit as follows:↲
↲
╞ ╞ ┆a1┆Model┆e1┆ ┆e1┆╞ ╞ ╞ ╞ ╞ ┆a1┆Connector↲
╞ ╞ RC890-10:↲
╞ ╞ BSC, 9600 bps╞ ╞ ╞ ╞ ╞ J1↲
╞ ╞ SNA/SDLC, 9600 bps╞ ╞ ╞ J2↲
╞ ╞ RC890-20:↲
High performance: BSC, 19200 bps╞ ╞ J3↲
╞ ╞ High performance: SNA/SDLC, 19200 bps J4↲
╞ ╞ Dual host: BSC, line 1╞ ╞ ╞ ╞ J1↲
╞ ╞ ╞ ╞ ╞ line 2╞ ╞ ╞ ╞ J3↲
╞ ╞ Dual host: SNA/SDLC, line 1╞ ╞ ╞ J2↲
╞ ╞ ╞ ╞ ╞ ╞ line 2╞ ╞ ╞ J4↲
┆84┆↲
════════════════════════════════════════════════════════════════════════
↓
┆a1┆┆b0┆3.╞ ╞ THE TERMINAL SYSTEM IN A NUTSHELL↲
↲
╞ ╞ ┆84┆The present chapter briefly describes the RC855 terminal, RC890 ↓
┆19┆┆89┆┄┄CU customization parameters, downline loading, and terminal ↓
┆19┆┆89┆┄┄menus. This information is included in the manual primarily as ↓
┆19┆┆89┆┄┄a background for the customization of the terminal system de┄↓
┆19┆┆89┆┄┄scribed in the next chapter.↲
↲
↲
┆a1┆┆b0┆3.1╞ ╞ RC855 Terminal↲
↲
╞ ╞ ┆84┆The RC855 is based on a soft-programmed microcomputer. This ↓
┆19┆┆89┆┄┄means that, in the case of an RC855 work station, the RC855 may ↓
┆19┆┆89┆┄┄be alternately loaded from the RC890 with the IBM 3270 emulator ↓
┆19┆┆89┆┄┄and from the local diskette with the CP/M operating system. ↓
┆19┆┆89┆┄┄Thus the RC855 may be used interchangely for remote host commu┄↓
┆19┆┆89┆┄┄nication and local data processing.↲
↲
╞ ╞ ┆84┆The RC855 is reset when power is applied, and thereafter when┄↓
┆19┆┆89┆┄┄ever its reset button is pressed. On being reset, the RC855 ↓
┆19┆┆89┆┄┄automatically performs a built-in self-test. An application ↓
┆19┆┆89┆┄┄program can then be loaded into the RAM (random-access memory) ↓
┆19┆┆89┆┄┄of the RC855 and executed.↲
↲
╞ ╞ ┆84┆Various media are employed to load RC855 application programs, ↓
┆19┆┆89┆┄┄e.g. RcCircuit, where the program is fetched from the RC890 CU ↓
┆19┆┆89┆┄┄diskette, or a diskette on a drive connected to the RC855 it┄↓
┆19┆┆89┆┄┄self (3.3).↲
↲
╞ ╞ ┆84┆The current load medium and several other configuration para┄↓
┆19┆┆89┆┄┄meters for the individual terminal are stored in the NVM (non┄↓
┆19┆┆89┆┄┄volatile memory) of each RC855. The values of these NVM para┄↓
┆19┆┆89┆┄┄meters can be set to suit the requirements of the terminal ↓
┆19┆┆89┆┄┄system as a whole as well as those of the particular RC855 ↓
┆19┆┆89┆┄┄operator. The NVM parameters that relate to CU-terminal commu┄↓
┆19┆┆89┆┄┄nication are briefly described in Section 4.1.↲
↲
┆8c┆┆83┆┆bc┆↓
╞ ╞ ┆84┆The first twenty-four lines of the RC855 display screen are ↓
┆19┆┆89┆┄┄used for the terminal menu and for interaction between the ↓
┆19┆┆89┆┄┄RC855 operator and the application program. The bottom (twenty-↓
┆19┆┆89┆┄┄fifth) line, which is called the status line, is used for sys┄↓
┆19┆┆89┆┄┄tem messages to the operator.↲
↲
╞ ╞ ┆84┆The RC855 is described in detail in other publications, viz. ↓
┆19┆┆89┆┄┄the RC855 Operating Guide (2), the RC855 IBM 3270 BSC Emulator ↓
┆19┆┆89┆┄┄Operating Guide (3), and the RC855 Work Station User's Guide↲
(4).↲
↲
↲
┆a1┆┆b0┆3.2╞ ╞ RC890 CU Customization Parameters↲
↲
╞ ╞ ┆84┆The IBM 3274 emulator in the RC890 CU contains a number of ↓
┆19┆┆89┆┄┄user-specifiable parameters. These RC890 CU customization para┄↓
┆19┆┆89┆┄┄meters are read during the RC890 program load phase (2.4.1) ↓
┆19┆┆89┆┄┄from a textfile named PARAMS.CU. The parameters can be modified ↓
┆19┆┆89┆┄┄by editing this textfile.↲
↲
╞ ╞ ┆84┆The modification of textfiles in general is described in Sec┄↓
┆19┆┆89┆┄┄tion 4.2.2. The PARAMS.CU file is described in Section 4.3.↲
↲
↲
┆a1┆┆b0┆3.3╞ ╞ Downline Loading and Terminal Menus↲
↲
╞ ╞ ┆84┆The application program to be run on the RC855 terminal can be ↓
┆19┆┆89┆┄┄loaded from any of several media. This section describes down┄↓
┆19┆┆89┆┄┄line loading of RC855 terminals (where the load medium is Rc┄↓
┆19┆┆89┆┄┄Circuit) and program selection from terminal menus.↲
↲
╞ ╞ ┆84┆The terminal system offers a selection of RC855 application ↓
┆19┆┆89┆┄┄programs. (The standard selection is modest). These applica┄↓
┆19┆┆89┆┄┄tions are specified in a textfile on the CU diskette named ↓
┆19┆┆89┆┄┄MENU.DLL, which also contains the menus specified for the indi┄↓
┆19┆┆89┆┄┄vidual terminals. This file is read during the RC890 program ↓
┆19┆┆89┆┄┄load phase (2.4.1).↲
↲
┆8c┆┆83┆┆c8┆↓
╞ ╞ ┆84┆The menu for a terminal includes applications, contained in ↓
┆19┆┆89┆┄┄program-image files on the CU diskette, which are loaded from ↓
┆19┆┆89┆┄┄the RC890 via RcCircuit. CP/M based applications, on a local ↓
┆19┆┆89┆┄┄RC855 diskette, may also be included in the menu when the RC855 ↓
┆19┆┆89┆┄┄in question is equipped with a diskette drive. Each terminal ↓
┆19┆┆89┆┄┄has access to all or a portion of the applications in the sys┄↓
┆19┆┆89┆┄┄tem, as specified in the MENU.DLL file. For each terminal, one ↓
┆19┆┆89┆┄┄of the specified applications may be designated the default ↓
┆19┆┆89┆┄┄application.↲
↲
╞ ╞ ┆84┆The contents of the MENU.DLL file can be modified by editing. ↓
┆19┆┆89┆┄┄The modification of textfiles in general is described in Sec┄↓
┆19┆┆89┆┄┄tion 4.2.2. The MENU.DLL file is described in Section 4.4.↲
↲
╞ ╞ ┆84┆In the description to follow, it is assumed that the value of ↓
┆19┆┆89┆┄┄the RC855 NVM parameter LD is 1, i.e. the load medium is RcCir┄↓
┆19┆┆89┆┄┄cuit, default application (4.1).↲
↲
╞ ╞ ┆84┆Whenever the RC855 is reset, the reset event is signaled to the ↓
┆19┆┆89┆┄┄RC890 via RcCircuit. Using the information contained in the ↓
┆19┆┆89┆┄┄MENU.DLL file, the RC890 returns the appropriate menu to the ↓
┆19┆┆89┆┄┄RC855.↲
↲
╞ ╞ ┆84┆Once the RC855 has received the menu, the application can be ↓
┆19┆┆89┆┄┄selected in either of two ways:↲
╞ ╞ - The default application is selected.↲
╞ ╞ - ┆84┆The terminal menu is displayed, and the RC855 operator ↓
┆19┆┆8b┆┄┄selects an application from the menu.↲
↲
╞ ╞ ┆84┆The terminal menu is displayed in either of two situations:↲
╞ ╞ - If no default application has been specified.↲
╞ ╞ - ┆84┆If the operator holds the key marked "M" depressed while the ↓
┆19┆┆8b┆┄┄RC855 is performing its self-test (4.1).↲
↲
╞ ╞ ┆84┆If the menu is displayed, the operator must first enter any ↓
┆19┆┆89┆┄┄user parameters required and then press the proper function ↓
┆19┆┆89┆┄┄key. The program thus selected will thereafter be loaded and ↓
┆19┆┆89┆┄┄started with the specified parameters. Here is an example of a ↓
┆19┆┆89┆┄┄menu displayed on a terminal:↲
┆8c┆┆83┆┆d4┆↓
╞ ╞ ╞ ╞ ╞ ╞ RC855 APPLICATION MENU↲
╞ ╞ ╞ ╞ ╞ ╞ Key Description↲
╞ ╞ ╞ ╞ ╞ ╞ PA1 RC855 Configurator↲
╞ ╞ ╞ ╞ ╞ ╞ PA2 RC855/RC890 IBM 3270↲
╞ ╞ ╞ ╞ ╞ ╞ PA3 WordStar↲
╞ ╞ ╞ ╞ ╞ ╞ ...↲
╞ ╞ Press function key to select application ↲
╞ ╞ RC855↲
↲
╞ ╞ ┆84┆If no menu is displayed, the default application program is ↓
┆19┆┆89┆┄┄automatically loaded and started with default user parameters ↓
┆19┆┆89┆┄┄(taken from the MENU.DLL file).↲
↲
╞ ╞ ┆84┆Whether the menu is displayed or not, a parameter string is ↓
┆19┆┆89┆┄┄passed to the loaded application program before it is started. ↓
┆19┆┆89┆┄┄This parameter string consists of the standard parameters con┄↓
┆19┆┆89┆┄┄catenated with the user parameters (4.4.2).↲
↲
╞ ╞ The following errors can occur:↲
↲
╞ ╞ 1. ┆84┆The downline load software in the RC890 cannot access the CU ↓
┆19┆┆8c┆┄┄diskette. Following message is displayed on the RC855 status ↓
┆19┆┆8c┆┄┄line:↲
╞ ╞ ___________________________________________________________↲
╞ ╞ ┆a1┆ RC855 - CU diskette error ↲
↲
╞ ╞ 2. ┆84┆The connection between the RC855 and the RC890 is lost. The ↓
┆19┆┆8c┆┄┄following message is displayed:↲
╞ ╞ ___________________________________________________________↲
╞ ╞ ┆a1┆ RC855 - CU disconnected ↲
↲
╞ ╞ 3. ┆84┆A checksum error is detected in the program image loaded on ↓
┆19┆┆8c┆┄┄the RC855. The following message is displayed:↲
╞ ╞ ___________________________________________________________↲
╞ ╞ ┆a1┆ RC855 - Checksum error ↲
↲
┆8c┆┆83┆┆b0┆↓
╞ ╞ 4. ┆84┆The selected program is not present on the CU diskette. The ↓
┆19┆┆8c┆┄┄following message is displayed:↲
╞ ╞ ___________________________________________________________↲
╞ ╞ ┆a1┆ RC855 - CU program not found ↲
↲
╞ ╞ 5. ┆84┆The RC855 operator presses a function key not associated ↓
┆19┆┆8c┆┄┄with a program. No error message is displayed on the status ↓
┆19┆┆8c┆┄┄line, but the RC855 gives a beep.↲
↲
╞ ╞ ┆84┆On the first four errors, the operator must reset the RC855 by ↓
┆19┆┆89┆┄┄pressing the CLEAR key while holding the CTRL key depressed. On ↓
┆19┆┆89┆┄┄the last error, the operator need only press another function ↓
┆19┆┆89┆┄┄key.↲
↲
╞ ╞ ┆84┆The status texts above (e.g. "CU diskette error") are contained ↓
┆19┆┆89┆┄┄in the MENU.DLL file↲
↲
════════════════════════════════════════════════════════════════════════
↓
┆a1┆┆b0┆4.╞ ╞ CUSTOMIZATION OF THE TERMINAL SYSTEM↲
↲
╞ ╞ ┆84┆This chapter describes how the RC890 control unit and connected ↓
┆19┆┆89┆┄┄RC855 terminals are customized to suit individual user require┄↓
┆19┆┆89┆┄┄ments. It is strongly suggested that the reader acquaint him┄↓
┆19┆┆89┆┄┄self with the background information provided in Chapter 3.↲
↲
↲
┆a1┆┆b0┆4.1╞ ╞ NVM Parameters↲
↲
╞ ╞ ┆84┆The RC855 configuration parameters which relate to the terminal ↓
┆19┆┆89┆┄┄system as a whole, i.e. to CU-terminal communication, are ↓
┆19┆┆89┆┄┄briefly described in this section. These and other RC855 confi┄↓
┆19┆┆89┆┄┄guration parameters are stored in the NVM (nonvolatile memory) ↓
┆19┆┆89┆┄┄of each RC855 terminal. The user can assign values to the NVM ↓
┆19┆┆89┆┄┄parameters by running the RC855 configurator program on the ↓
┆19┆┆89┆┄┄individual terminal. The configurator program is described in ↓
┆19┆┆89┆┄┄the RC855 IBM 3270 BSC Emulator Operating Guide (3).↲
↲
╞ ╞ ┆84┆The NVM parameters relevant to CU-terminal communication are as ↓
┆19┆┆89┆┄┄follows:↲
↲
╞ ╞ ┆a1┆Name┆e1┆ ┆a1┆Description↲
╞ ╞ LD╞ Program load medium for the terminal.↲
╞ ╞ ╞ Values: 0..15.↲
╞ ╞ ╞ The following values are defined:↲
↲
╞ ╞ ╞ 1 ("C") = RcCircuit, default application↲
╞ ╞ ╞ 2 ("M") = RcCircuit, menu↲
╞ ╞ ╞ 3 ("P") = terminal ROM (read-only memory)↲
╞ ╞ ╞ 4 ("D") = terminal hard disk↲
╞ ╞ ╞ 6 ("F") = terminal diskette↲
╞ ╞ ╞ 7 ("I") = terminal image load↲
↲
╞ ╞ ╞ ┆84┆The stored value of the LD parameter may be overridden ↓
┆19┆┆90┆┄┄by holding one of several character keys depressed while ↓
┆19┆┆90┆┄┄the RC855 is performing its self-test. The appropriate ↓
┆19┆┆90┆┄┄keys are indicated in parentheses above. For a complete ↓
┆19┆┆90┆┄┄description of the LD parameter, see the RC855 Operating ↓
┆19┆┆90┆┄┄Guide (2).↲
↲
┆8c┆┆83┆┆ec┆↓
┆e1┆┆a1┆┆e1┆╞ ╞ SA╞ Secondary address of the terminal on RcCircuit↲
╞ ╞ ╞ (cf. 4.3.5).↲
╞ ╞ ╞ Values: 0..15 (with high performance feature, 0..31).↲
↲
╞ ╞ DDN╞ Display device number of the terminal in the IBM 3270↲
╞ ╞ ╞ device cluster.↲
╞ ╞ ╞ Values: 0..31.↲
↲
╞ ╞ ADN╞ ┆84┆Alternative display device number of the terminal in the ↓
┆19┆┆90┆┄┄IBM 3270 device cluster.↲
╞ ╞ ╞ Values: 0..31.↲
↲
╞ ╞ PDN╞ ┆84┆Printer device number of a printer physically connected ↓
┆19┆┆90┆┄┄to the terminal.↲
╞ ╞ ╞ Values: 0..31.↲
↲
╞ ╞ HCP╞ ┆84┆Device number of the hardcopy printer or class number of ↓
┆19┆┆90┆┄┄the printer class logically associated with the termi-↓
┆19┆┆90┆┄┄nal. Values: 0..31 for device numbers and 40..55 for ↓
┆19┆┆90┆┄┄class numbers.↲
↲
↲
┆a1┆┆b0┆4.2╞ ╞ Files on the CU Diskette↲
↲
╞ ╞ ┆84┆This section gives a survey of the files on the CU diskette, ↓
┆19┆┆89┆┄┄and then describes how the user may go about modifying the ↓
┆19┆┆89┆┄┄contents of two of the textfiles on the CU diskette.↲
↲
↲
┆a1┆┆b0┆4.2.1╞ Survey of the CU Diskette Files↲
↲
╞ ╞ ┆a1┆Filename┆e1┆╞ ┆a1┆┆e1┆ ┆a1┆Description↲
↲
╞ ╞ PARAMS.CU╞ Textfile. See futher Sections 4.2.2 and 4.3.↲
╞ ╞ MENU.DLL╞ Textfile. See further Sections 4.2.2 and 4.4.↲
╞ ╞ DMENU.DLL╞ Textfile. (Danish version of MENU.DLL).↲
╞ ╞ *.855╞ ┆84┆File containing a program image which can be ↓
┆19┆┆97┆┄┄downline loaded, e.g. CONFI.855 or 3270.855.↲
════════════════════════════════════════════════════════════════════════
↓
╞ ╞ S.╞ ╞ ┆84┆File containing the (root) program for the CPU ↓
┆19┆┆97┆┄┄board.↲
╞ ╞ *.OBF╞ ┆84┆File containing object code which is loaded on ↓
┆19┆┆97┆┄┄the CPU board.↲
╞ ╞ *.COM╞ ┆84┆Files containing programs for the COM boards.↲
╞ ╞ *.CPU╞ Files containing programs for the CPU board.↲
╞ ╞ *.TRM╞ ┆84┆Files containing the terminal configuration (e.g. ↓
┆19┆┆97┆┄┄soft character generator in Arabic versions).↲
╞ ╞ ERRORLOG.╞ ┆84┆ Textfile containing error log information.↲
(cf. 2.5).↲
↲
╞ ╞ ╞ ╞ ┆84┆ Textfiles containing conversion table changes to:↲
↲
╞ ╞ DOS1/A.CU Danish public sector 1 alternative↲
╞ ╞ DOS2.CU╞ Danish public sector 2↲
╞ ╞ DOS2/A.CU╞ Danish public sector 2 alternative↲
╞ ╞ ENGLISH.CU UK English↲
╞ ╞ GERMAN.CU German↲
╞ ╞ GERMAN/A.CU German alternative↲
╞ ╞ INTNTL.CU international US English (default)↲
╞ ╞ STDK.CU╞ standard Danish↲
╞ ╞ STDK/A.CU standard Danish alternative↲
╞ ╞ SWEDISH.CU Swedish↲
╞ ╞ SWED/A.CU Swedish alternative↲
↲
Note that the filesnames S. and ERRORLOG. have no extension.↲
↲
↲
┆a1┆┆b0┆4.2.2╞ Modification of Textfiles↲
↲
╞ ╞ ┆84┆The contents of the textfiles PARAMS.CU and MENU.DLL on the CU ↓
┆19┆┆89┆┄┄diskette can be modified by the user. These files are described ↓
┆19┆┆89┆┄┄in detail in Sections 4.3 and 4.4, respectively.↲
↲
════════════════════════════════════════════════════════════════════════
↓
╞ ╞ ┆84┆Modifications to these textfiles can be made in two ways:↲
↲
╞ ╞ 1. ┆84┆Using the RC890 textfile editor on an RC855 terminal ↓
┆19┆┆8c┆┄┄connected to the RC890. See further Chapter 5.↲
╞ ╞ 2. ┆84┆Using a text editing program run under the CP/M operating ↓
┆19┆┆8c┆┄┄system on an RC855 terminal equipped with an RC874 diskette ↓
┆19┆┆8c┆┄┄unit. See further the RC855 Operating Guide (2) and the ↓
┆19┆┆8c┆┄┄RC855 Work Station User's Guide (4).↲
┆84┆↲
┆84┆Note that, in so far as a word processing program is used for ↓
┆19┆┆89┆┄┄editing, the PARAMS.CU and MENU.DLL files are not "docu┄ments" ↓
┆19┆┆89┆┄┄(e.g. "WP" files).↲
↲
╞ ╞ ┆84┆Before any modification is made, it is wise to print the con┄↓
┆19┆┆89┆┄┄tents of the files, if possible, in order to have a hardcopy ↓
┆19┆┆89┆┄┄record of the standard parameter values and the standard texts. ↓
┆19┆┆89┆┄┄It is also wise to print the files following a modifica┄tion. ↓
┆19┆┆89┆┄┄For the printing of textfiles, see Chapter 5 or the RC855 Work ↓
┆19┆┆89┆┄┄Sta┄tion User's Guide.↲
↲
╞ ╞ ┆84┆The modification of standard texts permits the user to supply ↓
┆19┆┆89┆┄┄his own (national) versions as required. A user-specified text ↓
┆19┆┆89┆┄┄should convey the same meaning as the standard text which it ↓
┆19┆┆89┆┄┄replaces. The standard display-screen texts in the PARAMS.CU ↓
┆19┆┆89┆┄┄file are numbered (4.3.4). The standard instructive texts and ↓
┆19┆┆89┆┄┄status texts in the MENU.DLL file are not numbered, but have ↓
┆19┆┆89┆┄┄predefined positions (4.4.1). It is important to secure a hard┄↓
┆19┆┆89┆┄┄copy record of the standard texts, because one must refer to ↓
┆19┆┆89┆┄┄these texts when reporting errors and the like.↲
↲
╞ ╞ ┆84┆IMPORTANT: The RESET button must be pressed following any modi-↓
┆19┆┆89┆┄┄fication of the CU diskette (system diskette).↲
↲
↲
┆a1┆┆b0┆4.3╞ ╞ PARAMS.CU File↲
↲
╞ ╞ ┆84┆The PARAMS.CU file contains a number of lines, each of which ↓
┆19┆┆89┆┄┄specifies one parameter value. Each line must be terminated by ↓
┆19┆┆89┆┄┄a CR character or a semicolon. A semicolon may be followed by a ↓
┆8c┆┆83┆┆d4┆↓
┆19┆┆89┆┄┄comment, which is ignored by the program. Each line contains a ↓
┆19┆┆89┆┄┄parameter identification and a parameter value separated by an ↓
┆19┆┆89┆┄┄equals sign. The parameter identification consists of a para┄↓
┆19┆┆89┆┄┄meter name, which in most cases must be followed by a comma and ↓
┆19┆┆89┆┄┄an argument. The argument will be a decimal or hexadecimal ↓
┆19┆┆89┆┄┄number or a textstring. Here are some examples:↲
↲
╞ ╞ EBCDIC,20=F1;╞ ╞ ╞ ╞ send space to the host as "1"↲
╞ ╞ BSCCU,1=3;╞ ╞ ╞ ╞ this CU is number 3↲
╞ ╞ BSCDUP,1=0;╞ ╞ ╞ ╞ the host line is half duplex↲
╞ ╞ DSTEXT,1= Skriver standset;╞ national version of a status text↲
╞ ╞ BSCID,1=-- myhost --;╞ ╞ a host line identification.↲
↲
╞ ╞ ┆84┆If a semicolon, equals sign, comma, or percent sign is to be ↓
┆19┆┆89┆┄┄included in the actual contents of a line, it must be preceded ↓
┆19┆┆89┆┄┄by a percent sign. A CR character immediately following a per┄↓
┆19┆┆89┆┄┄cent sign is ignored.↲
↲
╞ ╞ ┆84┆The following sections describe each of the user-specifiable ↓
┆19┆┆89┆┄┄parameters. For each parameter, type specifications enclosed by ↓
┆19┆┆89┆┄┄"<" and ">" show how the argument and the parameter value must ↓
┆19┆┆89┆┄┄be stated. Here are some examples of the notation used:↲
↲
╞ ╞ "dec(0..31)" means "decimal number in the range 0 to 31".↲
╞ ╞ "hex(0..BF)" means "hexadecimal number in the range 0 to BF".↲
╞ ╞ "string(5)" means "textstring containing at most 5 characters".↲
╞ ╞ "devno" means a device number, i.e. the same as "dec(0..31)".↲
↲
╞ ╞ ┆84┆Note that, in the event of a syntax error in a user-specified ↓
┆19┆┆89┆┄┄parameter, the IBM 3274 emulator in the RC890 CU will take the ↓
┆19┆┆89┆┄┄default parameter value.↲
↲
╞ ╞ ┆84┆The standard PARAMS.CU file with default parameter values is ↓
┆19┆┆89┆┄┄listed in Appendix B.↲
↲
↲
════════════════════════════════════════════════════════════════════════
↓
┆a1┆┆b0┆4.3.1╞ Character Set Conversion↲
↲
╞ ╞ ┆84┆In the communication with the host, the EBCDIC code (8 bits per ↓
┆19┆┆89┆┄┄character) is used. Internally in the CU and in the terminals, ↓
┆19┆┆89┆┄┄a code based on ISO 646 (ASCII), with values in the interval ↓
┆19┆┆89┆┄┄hex(0..BF), is used. The conversion between the two representa┄↓
┆19┆┆89┆┄┄tions takes place before transmission/after receipt of each ↓
┆19┆┆89┆┄┄text to/from the host by table lookup.↲
↲
┆84┆It is important that the character set in the CU and the termi┄↓
┆19┆┆89┆┄┄nal is the same. The CU uses by default international US-ASCII ↓
┆19┆┆89┆┄┄(the file INTNTL.CU). If the terminals use a character set dif┄↓
┆19┆┆89┆┄┄ferent from US-ASCII, the appropriate conversion table change ↓
┆19┆┆89┆┄┄file should be copied to or renamed PARAMS.CU, so that the CU ↓
┆19┆┆89┆┄┄will use the same character set as the terminals.╞ For example, ↓
┆19┆┆89┆┄┄if the terminals operate with Swedish conversion, the file ↓
┆19┆┆89┆┄┄SWEDISH.CU should be copied to PARAMS.CU before any other cus┄↓
┆19┆┆89┆┄┄to┄mization is carried out (cf. 4.2.1).↲
↲
┆84┆The conversion tables can be modified value by value.↲
↲
┆a1┆┆b0┆┆e1┆┆a1┆Conversion to EBCDIC↲
↲
╞ ╞ EBCDIC,<hex(0..BF)>=<hex(0..FF)>↲
↲
╞ ┆84┆specifies that the internal code indicated by the argument is ↓
┆19┆┆89┆┄┄to be converted to the parameter value.↲
↲
╞ ╞ ┆a1┆┆b0┆┆e1┆┆a1┆Conversion to Internal Code↲
↲
╞ ╞ INTCODE,<hex(0..FF)>=<hex(0..BF)>↲
↲
╞ ╞ ┆84┆specifies that the 8-bit EBCDIC code indicated by the argu┄ment ↓
┆19┆┆89┆┄┄is to be converted to the parameter value.↲
↲
╞ ╞ ┆84┆The EBCDIC and internal code sets are fully described in the ↓
┆19┆┆89┆┄┄RC890 IBM 3274 Emulator Reference Manual (1).↲
↲
↲
════════════════════════════════════════════════════════════════════════
↓
┆a1┆┆b0┆4.3.2╞ Communication Line Parameters, General↲
↲
╞ ╞ ┆84┆For each communication line (to a host) one can specify the ↓
┆19┆┆89┆┄┄handling of the DTR signal by the CU in three different ways.↲
↲
╞ ╞ ┆a1┆┆b0┆Switched/Nonswitched↲
↲
╞ ╞ SWITCHED,<1/2>=<0..2>↲
↲
╞ ╞ 0 : ┆84┆nonswitched. DTR is always set.↲
↲
╞ ╞ 1 : ┆84┆manual call. DTR is set initially, and DSR is awaited. If ↓
┆19┆┆8d┆┄┄DSR subsequently disappears, DTR is removed for 5 seconds ↓
┆19┆┆8d┆┄┄and thereafter set again.↲
↲
2 : ┆84┆automatic call (X.21 bis/DATEX-L). DTR is set and DSR is ↓
┆19┆┆8d┆┄┄awaited for 5 seconds. If DSR fails to appear or subse-↓
┆19┆┆8d┆┄┄quently disappears, DTR is removed for 5 seconds, where-↓
┆19┆┆8d┆┄┄upon the procedure is repeated. After eight unsuccessful ↓
┆19┆┆8d┆┄┄attempts, there is a 30-second pause, in which DTR is re-↓
┆19┆┆8d┆┄┄moved.↲
↲
╞ ╞ Default value: 0.↲
↲
↲
┆a1┆┆b0┆4.3.3╞ Communication Line Parameters, BSC↲
↲
╞ ╞ ┆84┆For each BSC communication line (to a host) one can specify the ↓
┆19┆┆89┆┄┄number of the CU as a number in the interval 0..31. The number ↓
┆19┆┆89┆┄┄of the CU determines the addressing sequences (poll and select) ↓
┆19┆┆89┆┄┄to which the CU will respond. It is also possible to specify ↓
┆19┆┆89┆┄┄whether the line is half or full duplex.↲
↲
════════════════════════════════════════════════════════════════════════
↓
╞ ╞ ┆a1┆┆b0┆CU Number↲
↲
╞ ╞ BSCCU,<1/2>=<dec(0..31)>↲
↲
╞ ╞ ┆84┆specifies the CU number for BSC line 1 or 2. (Line 2 occurs on ↓
┆19┆┆89┆┄┄models with the dual host feature). Default value: 0.↲
↲
╞ ╞ ┆a1┆┆b0┆Half/Full Duplex↲
↲
╞ ╞ BSCDUP,<1/2>=<0/1>↲
↲
╞ ╞ ┆84┆specifies half duplex (0) or full duplex (1) for BSC line 1 or ↓
┆19┆┆89┆┄┄2. Default value: 1.↲
↲
↲
┆a1┆┆b0┆4.3.4╞ Communication Line Parameters, SNA/SDLC↲
↲
╞ ╞ ┆84┆For each SNA/SDLC communication line (to a host) one can speci┄↓
┆19┆┆89┆┄┄fy the SDLC address of the CU. This address is used in all ↓
┆19┆┆89┆┄┄blocks (frames) sent from the host to the CU in question, i.e. ↓
┆19┆┆89┆┄┄blocks not containing the specified address will not be accept┄↓
┆19┆┆89┆┄┄ed by the CU. It is also possible to specify whether the line ↓
┆19┆┆89┆┄┄is full or half duplex, point-to-point or multipoint, and ↓
┆19┆┆89┆┄┄whether NRZI encoding is to be used. ┄Finally, one can specify ↓
┆19┆┆89┆┄┄the terminal-ID of the CU, which is part of the response to an ↓
┆19┆┆89┆┄┄XID command from the host.↲
↲
╞ ╞ ┆a1┆┆b0┆SDLC Address↲
↲
╞ ╞ SDLCADDR,<1/2>=<hex(0..FF)>↲
↲
╞ ╞ ┆84┆specifies the SDLC address for SNA/SDLC line 1 or 2. (Line 2 ↓
┆19┆┆89┆┄┄occurs on models with the dual host feature). Default value: ↓
┆19┆┆89┆┄┄┆81┆C1.┆82┆┆81┆┆82┆↲
↲
════════════════════════════════════════════════════════════════════════
↓
╞ ╞ ┆a1┆┆b0┆NRZI Encoding↲
↲
╞ ╞ SDLCNRZI,<1/2>=<0/1>↲
↲
╞ ╞ ┆84┆specifies that NRZI encoding is to be used (1) or not used (0) ↓
┆19┆┆89┆┄┄on SNA/SDLC line 1 or 2. Default value: 0.↲
↲
╞ ╞ ┆a1┆┆b0┆Half/Full Duplex↲
↲
╞ ╞ SDLCDUP,<1/2>=<0/1>↲
↲
╞ ╞ ┆84┆specifies half duplex (0) or full duplex (1) for SNA/SDLC line ↓
┆19┆┆89┆┄┄1 or 2. Default value: 1.↲
↲
┆a1┆┆b0┆Point-to-Point/Multipoint↲
↲
╞ ╞ MPOINT,<1/2>=<0/1>↲
↲
╞ ╞ ┆84┆specifies a multipoint connection (1) or a point-to-point ↓
┆19┆┆89┆┄┄connection (0) on SNA/SDLC line 1 or 2. Default value: 0.↲
↲
╞ ╞ ┆a1┆┆b0┆Terminal-ID↲
↲
╞ ╞ TERMID,<1/2>=<string(5)>↲
↲
╞ ╞ ┆84┆specifies the terminal-ID with which the CU is to respond, if ↓
┆19┆┆89┆┄┄the host sends XID on SNA/SDLC line 1 or 2. The charac┄ters in ↓
┆19┆┆89┆┄┄the string must be hexadecimal digits. Default value: 00000.↲
↲
╞ ╞ ┆a1┆┆b0┆Printer Sharing↲
↲
╞ ╞ ┆84┆When a printer is used for both local hard-copies and host-↓
┆19┆┆89┆┄┄initiated printout operations (shared mode, cf. 4.3.6) local ↓
┆19┆┆89┆┄┄hard-copy may take place either when the printer is not in an ↓
┆19┆┆89┆┄┄SNA session or, more liberally, whenever the communication is ↓
┆19┆┆89┆┄┄not in brackets.↲
↲
════════════════════════════════════════════════════════════════════════
↓
╞ ╞ PSHARING,<1/2>=<0/1>↲
↲
╞ ╞ ┆84┆specifies between session sharing only (0) or between bracket ↓
┆19┆┆89┆┄┄sharing allowed (1) for printers in shared mode with respect to ↓
┆19┆┆89┆┄┄printout operations initiated by the host on SNA/SDLC line 1 or ↓
┆19┆┆89┆┄┄2, respectively. Default value: 0.↲
┆81┆┆a1┆┆b0┆↲
↲
┆a1┆┆b0┆4.3.5╞ Display Screen Texts↲
↲
╞ ╞ ┆84┆Various texts are displayed on the RC855 status line (3.1) as ↓
┆19┆┆89┆┄┄an indication of the state of the terminal or the CU or in ↓
┆19┆┆89┆┄┄response to operator actions. The emulator has default values ↓
┆19┆┆89┆┄┄for all of these texts, but it is possible to modify them. For ↓
┆19┆┆89┆┄┄a description of the status line, see the RC855 IBM 3270 BSC ↓
┆19┆┆89┆┄┄Emulator Operating Guide (3).↲
↲
╞ ╞ ┆a1┆┆b0┆Device and Emulator System Status Texts↲
↲
╞ ╞ DSTEXT,<1..12>=<string(21)>↲
↲
╞ ╞ ┆84┆specifies a device or emulator system status text which re┄↓
┆19┆┆89┆┄┄places one of the following standard texts (all of which are ↓
┆19┆┆89┆┄┄introduced by a blank):↲
↲
╞ ╞ 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↲
╞ ╞ 9= Field size error↲
╞ ╞ 10= Configuration error↲
╞ ╞ 11= CU disconnected↲
╞ ╞ 12= Illegal position↲
↲
════════════════════════════════════════════════════════════════════════
↓
╞ ╞ ┆a2┆┆e2┆┆a1┆┆b0┆Communication Line Status Texts↲
↲
╞ ╞ CSTEXT,<1..3>=<string(24)>↲
↲
╞ ╞ ┆84┆specifies a communication line status text which replaces one ↓
┆19┆┆89┆┄┄of the following standard texts (all of which are intro┄duced by ↓
┆19┆┆89┆┄┄a blank):↲
↲
╞ ╞ 1= Modem off↲
╞ ╞ 2= Line not ready↲
╞ ╞ 3= System not available↲
↲
╞ ╞ ┆84┆Note that the SNA emulator uses only the first two texts (and ↓
┆19┆┆89┆┄┄only the first 15 characters of a text).↲
↲
╞ ╞ ┆a1┆┆b0┆Host Line Identification↲
↲
╞ ╞ BSCID,<1/2>=<string(12)>↲
╞ ╞ SNAID,<1/2>=<string(12)>↲
↲
╞ ╞ ┆84┆specify the text which identifies BSC line 1 or 2 and SNA/SDLC ↓
┆19┆┆89┆┄┄line 1 or 2, respectively. This text is also used in the host ↓
┆19┆┆89┆┄┄line menu. The same text may not be used to identify two dif┄↓
┆19┆┆89┆┄┄ferent lines. Default values: BSCID,1= BSC link 1; BSCID,2= BSC ↓
┆19┆┆89┆┄┄link 2; SNAID,1= SNA link 1; SNAID,2= SNA link 2.↲
↲
┆f0┆┆e1┆╞ ╞ ┆a1┆┆b0┆Host Line Menu Heading↲
↲
╞ ╞ HOSTMENU=<string(32)>↲
↲
╞ ╞ ┆84┆specifies the text to be written as a heading in the host line ↓
┆19┆┆89┆┄┄menu (not on the status line). Standard text: RC855/RC890 Host ↓
┆19┆┆89┆┄┄Line Menu.↲
↲
════════════════════════════════════════════════════════════════════════
↓
┆a1┆┆b0┆4.3.6╞ Printer Authorization↲
↲
╞ ╞ ┆84┆The use of printer devices in an RC890/RC855 cluster is ↓
┆19┆┆89┆┄┄control┄┄led by printer authorization parameters. There are three ↓
┆19┆┆89┆┄┄aspects of printer authorization:↲
↲
╞ ╞ 1. ┆84┆For each printer a ┆a1┆mode┆e1┆ is specified which determines ↓
┆19┆┆8c┆┄┄whether the printer is to be used exclusively for local ↓
┆19┆┆8c┆┄┄hard-copy (local mode), or exclusively for printout opera┄↓
┆19┆┆8c┆┄┄tions initiated by the host (system mode), or for both of ↓
┆19┆┆8c┆┄┄these types of printing (shared mode).↲
↲
╞ ╞ 2. ┆84┆Up to 16 ┆a1┆classes┆e1┆ of printers may be defined. A class is a ↓
┆19┆┆8c┆┄┄group of printers. The concept allows the hard-copy printer ↓
┆19┆┆8c┆┄┄for an RC855 terminal to be specified as a class rather than ↓
┆19┆┆8c┆┄┄an individual printer. A hard-copy printout requested for ↓
┆19┆┆8c┆┄┄the display may then be performed on any printer in the ↓
┆19┆┆8c┆┄┄class. The printer classes are numbered from 0 to 15.↲
↲
╞ ╞ 3. ┆84┆For each printer a ┆a1┆source device list┆e1┆ is defined. This is a ↓
┆19┆┆8c┆┄┄list of display devices for which the printer may execute ↓
┆19┆┆8c┆┄┄local hard-copy operations. If a display device does not ↓
┆19┆┆8c┆┄┄belong to the source device list of a given printer, hard-↓
┆19┆┆8c┆┄┄copy cannot take place on that printer even if it is se┄↓
┆19┆┆8c┆┄┄lected as the hard-copy printer for the device, either indi-↓
┆19┆┆8c┆┄┄vidually or as a member of a class.↲
↲
╞ ╞ ┆84┆Notice that the parameter specifications described below in┄↓
┆19┆┆89┆┄┄clude device numbers which in each case must identify either a ↓
┆19┆┆89┆┄┄printer or a display device. As the emulator does not know the ↓
┆19┆┆89┆┄┄devices in the cluster or their numbers when the PARAMS.CU file ↓
┆19┆┆89┆┄┄is read, some of the information in these parameter specifica-↓
┆19┆┆89┆┄┄tions may turn out to be meaningless, in which case it will ↓
┆19┆┆89┆┄┄have no effect.↲
┆a1┆┆b0┆↲
════════════════════════════════════════════════════════════════════════
↓
╞ ╞ ┆a1┆┆b0┆Printer Mode↲
↲
╞ ╞ ┆84┆PMODE,<devno>=<0/1/2>↲
↲
╞ ╞ ┆84┆specifies the mode of the printer whose device number is given ↓
┆19┆┆89┆┄┄as the argument:↲
↲
╞ ╞ ╞ 0╞ Local mode↲
╞ ╞ ╞ 1╞ System mode↲
╞ ╞ ╞ 2╞ Shared mode↲
↲
╞ ╞ Default value for all printers: 1.↲
↲
╞ ╞ ┆a1┆┆b0┆Printer Class↲
↲
╞ ╞ PCLASS,<dec(0..15)>=list of device numbers↲
↲
╞ ╞ ┆84┆specifies that the listed (printer) devices belong to the ↓
┆19┆┆89┆┄┄printer class whose number is given as the argument. The device ↓
┆19┆┆89┆┄┄numbers must be separated by commas. An interval of consecutive ↓
┆19┆┆89┆┄┄numbers may be written as the first number followed by a hyphen ↓
┆19┆┆89┆┄┄followed by the last number.↲
↲
╞ ╞ Example:↲
↲
╞ ╞ ╞ PCLASS,7=2,4,8-12↲
↲
╞ ╞ ┆84┆specifies that the printers with device numbers 2, 4, 8, 9, 10, ↓
┆19┆┆89┆┄┄11, and 12 belong to printer class number 7.↲
↲
╞ ╞ Default: all printer classes empty.↲
↲
════════════════════════════════════════════════════════════════════════
↓
╞ ╞ ┆a1┆┆b0┆Printer Source Device List↲
↲
╞ ╞ PSRCLIST,<devno>=list of device numbers↲
↲
╞ ╞ ┆84┆specifies that the source device list for the printer whose ↓
┆19┆┆89┆┄┄device number is given as the argument comprises precisely the ↓
┆19┆┆89┆┄┄listed (display) devices. The list is written in the same way ↓
┆19┆┆89┆┄┄as in the PCLASS parameter specification described above.↲
↲
╞ ╞ ┆84┆Default: all display devices belong to the source device lists ↓
┆19┆┆89┆┄┄of all printers, i.e. no exclusions.↲
↲
↲
┆a1┆┆b0┆4.3.7╞ Miscellaneous↲
↲
╞ ╞ ┆84┆The user can specify the number of RC855 terminals (secondary ↓
┆19┆┆89┆┄┄addresses) to be polled on RcCircuit.↲
↲
╞ ╞ ┆a1┆┆b0┆Number of Terminals↲
↲
╞ ╞ NOTERMS=<dec(1..32)>↲
↲
╞ ╞ ┆84┆specifies that only secondary addresses in the interval ↓
┆19┆┆89┆┄┄0..NOTERMS-1 are to be polled on RcCircuit.↲
↲
╞ ╞ ┆84┆Note that a terminal system must always include a terminal with ↓
┆19┆┆89┆┄┄secondary address 0. Default value: 16.↲
↲
↲
┆a1┆┆b0┆4.4╞ ╞ MENU.DLL File↲
↲
╞ ╞ ┆84┆The MENU.DLL file contains a number of lines, each of which ↓
┆19┆┆89┆┄┄must be terminated by a CR character or a semicolon. A semi┄↓
┆19┆┆89┆┄┄colon may be followed by a comment, which is ignored by the ↓
┆19┆┆89┆┄┄pro┄gram. Some lines consist of several fields, separated by a ↓
┆19┆┆89┆┄┄comma. (An equals sign will also terminate a field).↲
↲
════════════════════════════════════════════════════════════════════════
↓
╞ ╞ ┆84┆If a semicolon, comma, equals sign, or percent sign is to be ↓
┆19┆┆89┆┄┄included in the actual contents of a line, it must be preceded ↓
┆19┆┆89┆┄┄by a percent sign. A CR character immediately following a per┄↓
┆19┆┆89┆┄┄cent sign is ignored.↲
↲
╞ ╞ ┆84┆The MENU.DLL file has three parts: instructive texts and status ↓
┆19┆┆89┆┄┄texts, application descriptions, and terminal menus. Each of ↓
┆19┆┆89┆┄┄these parts is specifiable by the user, as described in the ↓
┆19┆┆89┆┄┄following sections.↲
↲
╞ ╞ ┆84┆Note that, in the event of an error in a user-specified text, ↓
┆19┆┆89┆┄┄the control unit will stop during program loading from the CU ↓
┆19┆┆89┆┄┄diskette. The error situation is described in Section 2.4.1.↲
↲
╞ ╞ The standard MENU.DLL file is listed in Appendix C.↲
↲
↲
┆a1┆┆b0┆4.4.1╞ Instructive Texts and Status Texts↲
↲
╞ ╞ ┆84┆The MENU.DLL file begins with four lines containing instructive ↓
┆19┆┆89┆┄┄texts. These texts form the frame of the menu displayed on the ↓
┆19┆┆89┆┄┄screen:↲
↲
╞ ╞ RC855 APPLICATION MENU↲
╞ ╞ Key Description↲
╞ ╞ Press function key to select application↲
╞ ╞ RC855↲
↲
╞ ╞ ┆84┆The instructive texts are followed by four lines containing ↓
┆19┆┆89┆┄┄status texts. These texts are displayed only when errors occur:↲
↲
╞ ╞ CU diskette error↲
╞ ╞ CU disconnected↲
╞ ╞ Checksum error↲
╞ ╞ CU program not found↲
↲
════════════════════════════════════════════════════════════════════════
↓
╞ ╞ ┆84┆The standard texts, listed above, can be replaced by user-spe┄↓
┆19┆┆89┆┄┄cified texts. Note, however, that there must be precisely four ↓
┆19┆┆89┆┄┄lines of instructive texts and four lines of status texts, each ↓
┆19┆┆89┆┄┄containing a maximum of 45 characters. Note also that the posi┄↓
┆19┆┆89┆┄┄tion of the standard texts is predefined.↲
↲
↲
┆a1┆┆b0┆4.4.2╞ Application Description↲
↲
╞ ╞ ┆84┆The four lines of instructive texts and the four lines of stat┄↓
┆19┆┆89┆┄┄us texts are followed by the application descriptions. Each ↓
┆19┆┆89┆┄┄application to be known by the menu software in the RC890 is ↓
┆19┆┆89┆┄┄described in one line. Each line consists of the following ↓
┆19┆┆89┆┄┄fields:↲
↲
╞ ╞ - ┆84┆number of the application (0 <= number <= 25)↲
↲
╞ ╞ - ┆84┆filename (maximum 12 characters) of an application program ↓
┆19┆┆8b┆┄┄residing on the RC890 CU diskette or, for a program to be ↓
┆19┆┆8b┆┄┄loaded under CP/M on the RC855, the character sequence A:↲
↲
╞ ╞ - ┆84┆text (maximum 25 characters) to describe the application ↓
┆19┆┆8b┆┄┄program in the displayed menu↲
↲
╞ ╞ - ┆84┆parameter fields (maximum 89 characters all told): standard ↓
┆19┆┆8b┆┄┄parameters and default user parameters, e.g. a CP/M command↲
↲
╞ ╞ Here are some examples of application descriptions:↲
↲
╞ ╞ 3,A:,WordStar,ws; CP/M based application↲
╞ ╞ 1,3270.855,RC855/RC890 IBM 3270↲
╞ ╞ 2,TEST.855,Test System↲
╞ ╞ 0,CONFI.855,RC855 Configurator↲
↲
╞ ╞ ┆84┆There must at all times be agreement between the application ↓
┆19┆┆89┆┄┄descriptions and the program files actually present on the ↓
┆19┆┆89┆┄┄diskette.↲
↲
╞ ╞ Note that an application with number 0 must always exist.↲
↲
════════════════════════════════════════════════════════════════════════
↓
┆a1┆┆b0┆4.4.3╞ Terminal Menus↲
↲
╞ ╞ ┆84┆The application descriptions are followed by the terminal ↓
┆19┆┆89┆┄┄menus, each on one line. A terminal menu consists of a number ↓
┆19┆┆89┆┄┄of fields, each of which contains a number. The first field ↓
┆19┆┆89┆┄┄contains the secondary address of the terminal (0..31); the ↓
┆19┆┆89┆┄┄address field must begin with a "T". The following fields con┄↓
┆19┆┆89┆┄┄tain the numbers of the applications to which the terminal is ↓
┆19┆┆89┆┄┄to have access, listed in the order in which they are to appear ↓
┆19┆┆89┆┄┄when the menu is displayed on the screen. A default application ↓
┆19┆┆89┆┄┄is marked by preceding it with a "D". The application numbers ↓
┆19┆┆89┆┄┄listed must, of course, occur in the application descriptions.↲
↲
╞ ╞ Here are some examples of terminal menus:↲
↲
╞ ╞ T0,D1,0,2,3,4,5,6↲
╞ ╞ T2,1,0,4,5,6↲
╞ ╞ T6,1,2,0,6,5,4↲
↲
┆a1┆┆b0┆↲
════════════════════════════════════════════════════════════════════════
↓
┆a1┆┆b0┆5.╞ ╞ RC890 TEXTFILE EDITOR OPERATION↲
↲
╞ ╞ ┆84┆With the RC890 textfile editor (in the following referred to as ↓
┆19┆┆89┆┄┄the editor) one can manipulate files and contents of files on ↓
┆19┆┆89┆┄┄the RC890 system diskette (CU diskette) from an RC855 terminal ↓
┆19┆┆89┆┄┄connected to the RC890. The editor is primarily a customization ↓
┆19┆┆89┆┄┄tool. Customization is carried out by editing the files ↓
┆19┆┆89┆┄┄PARAMS.CU and/or MENU.DLL (cf. 4.3 and 4.4).↲
↲
╞ ╞ ┆84┆The editor is downline loaded from the RC890 system diskette ↓
┆19┆┆89┆┄┄into the terminal, whereupon the editor menu is displayed:↲
↲
╞ ╞ ╞ ╞ Select function:↲
↲
╞ ╞ ╞ ╞ 1 Edit↲
╞ ╞ ╞ ╞ 2 Print↲
╞ ╞ ╞ ╞ 3 Read file↲
╞ ╞ ╞ ╞ 4 Write file↲
╞ ╞ ╞ ╞ 5 Rename file↲
╞ ╞ ╞ ╞ 6 Delete file↲
╞ ╞ ╞ ╞ 7 Read catalog↲
↲
╞ ╞ ┆84┆A function can now be selected by pressisng one of the keys ↓
┆19┆┆89┆┄┄marked 1..7.↲
↲
╞ ╞ ┆84┆After a function has been selected, a return to the editor menu ↓
┆19┆┆89┆┄┄can be made by pressing the ESC key.↲
↲
╞ ╞ ┆84┆At any time, a return to the RC890 menu can be made by pressing ↓
┆19┆┆89┆┄┄the key combination CTRL CLEAR.↲
↲
╞ ╞ ┆84┆The size of the memory area where the file is stored while it ↓
┆19┆┆89┆┄┄is being handled by the editor (in the following referred to ↓
┆19┆┆89┆┄┄as the edit buffer) is 25 Kbytes. This means that a file to be ↓
┆19┆┆89┆┄┄mani┄pu┄lated by the editor (functions 1-4) cannot exceed 25 ↓
┆19┆┆89┆┄┄Kbytes.↲
↲
┆8c┆┆83┆┆bc┆↓
╞ ╞ ┆84┆Filenames with the extension .855, .CU, .COM, .CPU, .TRM, or ↓
┆19┆┆89┆┄┄.DLL or with no extension are referred to as system files in ↓
┆19┆┆89┆┄┄the following.↲
↲
↲
┆a1┆┆b0┆5.1╞ ╞ Edit↲
↲
╞ ╞ ┆84┆Edit is a screen oriented editor. One can modify in that part ↓
┆19┆┆89┆┄┄of the edit buffer which is shown on the display (in the ↓
┆19┆┆89┆┄┄following referred to as the window). The window consists of 24 ↓
┆19┆┆89┆┄┄records, where a record is at most 80 characters (82 including ↓
┆19┆┆89┆┄┄the control characters CR and NL). Each record is represented ↓
┆19┆┆89┆┄┄as 1 line in the window.↲
↲
╞ ╞ ┆84┆When edit is entered, the window is set to the first 24 records ↓
┆19┆┆89┆┄┄of the edit buffer, and the cursor is set in the first position ↓
┆19┆┆89┆┄┄of the first line. The window is moved by moving the cursor.↲
↲
╞ ╞ The cursor is moved by means of the following keys:↲
↲
╞ ╞ ╞ ┆84┆The cursor is moved one line up, without changing the ↓
┆19┆┆8e┆┄┄position on the line. If the cursor was in the first line ↓
┆19┆┆8e┆┄┄of the window, the window is moved one record backward in ↓
┆19┆┆8e┆┄┄the edit buffer (unless it was the first record in the ↓
┆19┆┆8e┆┄┄edit buffer).↲
↲
╞ ╞ ╞ ┆84┆The cursor is moved one line down, without changing the ↓
┆19┆┆8e┆┄┄position on the line. If the cursor was in the last line ↓
┆19┆┆8e┆┄┄of the window, the window is moved one record forward in ↓
┆19┆┆8e┆┄┄the edit buffer (unless it was the last record in the ↓
┆19┆┆8e┆┄┄edit buffer).↲
↲
╞ ╞ ╞ ┆84┆The cursor is moved one position to the left. If the cur┄↓
┆19┆┆8e┆┄┄sor was in the first position of a line, it is moved to ↓
┆19┆┆8e┆┄┄the last position of the previous line. If the cursor was ↓
┆19┆┆8e┆┄┄in the first position of the first line in the window, the ↓
┆19┆┆8e┆┄┄window is moved one record backward in the edit buffer ↓
┆19┆┆8e┆┄┄(unless it was the first record in the edit buffer).↲
↲
┆8c┆┆83┆┆d4┆↓
╞ ╞ ╞ ┆84┆The cursor is moved one position to the right. If the ↓
┆19┆┆8e┆┄┄cursor was in the last position of a line, it is moved to ↓
┆19┆┆8e┆┄┄the first position of the next line. If the cursor was in ↓
┆19┆┆8e┆┄┄the last position of the last line in the window, the ↓
┆19┆┆8e┆┄┄window is moved one record forward in the edit buffer ↓
┆19┆┆8e┆┄┄(unless it was the last record in the edit buffer).↲
↲
╞ ╞ ╞ ┆84┆The cursor is moved to the first position of the next ↓
┆19┆┆8e┆┄┄line. If the cursor was in the last line of the window, ↓
┆19┆┆8e┆┄┄the window is moved one record forward in the edit buffer ↓
┆19┆┆8e┆┄┄(unless it was the last record in the edit buffer).↲
↲
╞ ╞ ╞ ┆84┆When keying in insert mode (see below), means insert ↓
┆19┆┆8e┆┄┄record termination, viz. the control characters CR and NL.↲
↲
╞ ╞ ╞ ┆84┆The cursor is not moved, but the window is moved 24 rec┄↓
┆19┆┆8e┆┄┄ords (one window) forward in the edit buffer.↲
↲
╞ ╞ ╞ ┆84┆The cursor is not moved, but the window is moved 24 rec┄↓
┆19┆┆8e┆┄┄ords (one window) backward in the edit buffer.↲
↲
╞ ╞ ╞ ┆84┆Home. The window is set to the first 24 records of the ↓
┆19┆┆8e┆┄┄edit buffer, and the cursor is set in the first position ↓
┆19┆┆8e┆┄┄of the first line.↲
╞ ╞ ↲
╞ ╞ ┆84┆The contents of the edit buffer are modified by keying in key ↓
┆19┆┆89┆┄┄mode or insert mode. In key mode existing data is overwrit┄ten. ↓
┆19┆┆89┆┄┄In insert mode data is inserted.↲
↲
╞ ╞ In edit, the following function keys are supported:↲
↲
╞ ╞ INS╞ ╞ Enable/disable insert mode. Note that the lamp on↲
╞ ╞ MODE╞ ╞ this key is lit when insert mode is enabled.↲
↲
╞ ╞ INS╞ ╞ Insert line. A line is inserted before the line↲
╞ ╞ LINE╞ ╞ ┆84┆in which the cursor is positioned. The cursor is ↓
┆19┆┆93┆┄┄moved to the first position of the new line.↲
↲
════════════════════════════════════════════════════════════════════════
↓
╞ ╞ DEL╞ ╞ Delete character. The character in which the cur-↲
╞ ╞ CHAR╞ ╞ ┆84┆sor is positioned is deleted. The rest of the line is ↓
┆19┆┆93┆┄┄moved one position to the left.↲
↲
DEL╞ ╞ Delete line. The characters from the position↲
╞ ╞ LINE╞ ╞ ┆84┆of the cursor to the last position on the line are ↓
┆19┆┆93┆┄┄deleted. The whole line is deleted when the cursor is ↓
┆19┆┆93┆┄┄set in the first position of the line.↲
↲
↲
┆a1┆┆b0┆5.2╞ ╞ Print↲
↲
╞ ╞ ┆84┆The contents of the edit buffer are printed on the printer ↓
┆19┆┆89┆┄┄physically connected to the RC855 terminal. The printing is ↓
┆19┆┆89┆┄┄terminated with a form feed. When printing is finished suc┄↓
┆19┆┆89┆┄┄cessfully, the editor automatically returns to the editor menu.↲
╞ ╞ ┆84┆This function does not change the contents of the edit buffer.↲
↲
↲
┆a1┆┆b0┆5.3╞ ╞ Read File↲
↲
╞ ╞ ┆84┆The editor will ask for the name of the file to be read. There ↓
┆19┆┆89┆┄┄are no restrictions; all files can be read (max. 25 Kbytes). ↓
┆19┆┆89┆┄┄The contents of the file are read into the edit buffer. Any ↓
┆19┆┆89┆┄┄previous contents of the edit buffer are deleted before read┄↓
┆19┆┆89┆┄┄ing. When reading is finished successfully, the editor auto┄↓
┆19┆┆89┆┄┄matically returns to the editor menu.↲
↲
↲
┆a1┆┆b0┆5.4╞ ╞ Write File↲
↲
╞ ╞ ┆84┆The editor will ask for the name of the file to be written. If ↓
┆19┆┆89┆┄┄the name given is that of a system file, the editor will ask ↓
┆19┆┆89┆┄┄for confirmation. The contents of the edit buffer are written ↓
┆19┆┆89┆┄┄in the file. If the file exists, it is overwritten; otherwise ↓
┆19┆┆89┆┄┄it is created. When writing is finished successfully, the ↓
┆19┆┆89┆┄┄editor automatically returns to the editor menu. This function ↓
┆19┆┆89┆┄┄does not change the contents of the edit buffer.↲
↲
════════════════════════════════════════════════════════════════════════
↓
┆a1┆┆b0┆5.5╞ ╞ Rename File↲
↲
╞ ╞ ┆84┆The editor will ask for the name of the file to be renamed and ↓
┆19┆┆89┆┄┄the name which it should be renamed to. If any of the given ↓
┆19┆┆89┆┄┄names is that of a system file, the editor will ask for confir┄↓
┆19┆┆89┆┄┄mation. When renaming is finished successfully, the editor ↓
┆19┆┆89┆┄┄automatically returns to the editor menu. This function does ↓
┆19┆┆89┆┄┄not change the contents of the edit buffer.↲
↲
↲
┆a1┆┆b0┆5.6╞ ╞ Delete File↲
↲
╞ ╞ ┆84┆The editor will ask for the name of the file to be deleted. If ↓
┆19┆┆89┆┄┄the name given is that of a system file, the editor will ask ↓
┆19┆┆89┆┄┄for confirmation. When deleting is finished successfully, the ↓
┆19┆┆89┆┄┄editor automatically returns to the editor menu. This function ↓
┆19┆┆89┆┄┄does not change the contents of the edit buffer.↲
↲
↲
┆a1┆┆b0┆5.7╞ ╞ Read Catalog↲
↲
╞ ╞ ┆84┆All filenames existing on the diskette are displayed (during ↓
┆19┆┆89┆┄┄which time the cursor is temporarily removed from the screen). ↓
┆19┆┆89┆┄┄This function does not change the contents of the edit buffer.↲
↲
↲
════════════════════════════════════════════════════════════════════════
↓
┆a1┆┆b0┆5.8╞ ╞ Error Messages↲
↲
╞ ╞ ┆84┆If an error is detected, the function currently being performed ↓
┆19┆┆89┆┄┄is terminated and an error message is displayed. After display┄↓
┆19┆┆89┆┄┄ing the error message, the editor waits for a key to be pressed ↓
┆19┆┆89┆┄┄before returning to the editor menu. The following error mes┄↓
┆19┆┆89┆┄┄sages exist:↲
↲
╞ ╞ For diskette:↲
↲
╞ ╞ Catalog error↲
╞ ╞ Diskette I/O error↲
╞ ╞ Diskette not mounted↲
╞ ╞ Diskette or catalog full↲
╞ ╞ File does not exist↲
╞ ╞ Illegal filename↲
↲
╞ ╞ For printer:↲
↲
╞ ╞ Printer offline↲
↲
╞ ╞ For CU (connection to RC890):↲
↲
╞ ╞ CU disconnected↲
↲
╞ ╞ For edit buffer:↲
↲
╞ ╞ File too big↲
↲
════════════════════════════════════════════════════════════════════════
↓
┆a1┆┆b0┆6.╞ ╞ INSTALLATION OF RC855 SOFTWARE↲
↲
╞ ╞ ┆84┆New RC855 program images can be installed on the RC890 system ↓
┆19┆┆89┆┄┄diskette (CU diskette) by means of the RC890 Software Install ↓
┆19┆┆89┆┄┄program. The install program is downline loaded from the RC890 ↓
┆19┆┆89┆┄┄system diskette into an RC855 terminal. The running of the ↓
┆19┆┆89┆┄┄install program is guided by the program itself, which asks ↓
┆19┆┆89┆┄┄questions and tells when to do what.↲
↲
╞ ╞ ┆84┆Note that the maximum size of a file to be installed is 42.5 ↓
┆19┆┆89┆┄┄Kbytes.↲
↲
When the program has been loaded, the following is displayed:↲
↲
╞ ╞ ╞ RC855/RC890 Install Program↲
↲
╞ ╞ Change diskette and type filename:↲
↲
╞ ╞ ┆84┆Remove the RC890 system diskette from the RC890 diskette drive ↓
┆19┆┆89┆┄┄and insert the diskette containing the RC855 program image to ↓
┆19┆┆89┆┄┄be installed. Type the name of the file which contains the ↓
┆19┆┆89┆┄┄program image. The program will now read the file; the follow┄↓
┆19┆┆89┆┄┄ing is displayed:↲
↲
╞ ╞ ╞ Reading file : <filename>↲
↲
╞ ╞ ┆84┆When the file has been read successfully, the folloving is ↓
┆19┆┆89┆┄┄displayed:↲
↲
╞ ╞ Mount the RC890 system diskette, press <return>↲
↲
╞ ╞ ┆84┆Remove the diskette containing the program-image file and ↓
┆19┆┆89┆┄┄reinsert the RC890 system diskette. When the return key is ↓
┆19┆┆89┆┄┄pressed, the file is written on the RC890 system diskette. The ↓
┆19┆┆89┆┄┄filename will be the same as the filename during reading, ↓
┆19┆┆89┆┄┄except for the extension, which always will be .855 (e.g. read ↓
┆19┆┆89┆┄┄file TTY.855 gives write file TTY.855, and read file TTY.COM ↓
┆19┆┆89┆┄┄gives write file TTY.855). If the file exists, it is over┄↓
┆19┆┆89┆┄┄written; otherwise it is created.↲
↲
════════════════════════════════════════════════════════════════════════
↓
╞ ╞ When the program starts writing, the following is displayed:↲
↲
╞ ╞ ╞ Writing file : <filename>↲
↲
╞ ╞ ┆84┆When the file has been written successfully, the following is ↓
┆19┆┆89┆┄┄displayed:↲
↲
╞ ╞ ╞ Install complete, press <ctrl clear>↲
↲
╞ ╞ ┆84┆When the key combination CTRL CLEAR is pressed, the program ↓
┆19┆┆89┆┄┄returns to the RC890 menu.↲
↲
╞ ╞ ┆84┆If an error is detected, an error message is displayed. After ↓
┆19┆┆89┆┄┄displaying an error message, the program waits for something to ↓
┆19┆┆89┆┄┄be keyed:↲
↲
╞ ╞ ╞ CTRL CLEAR╞ ╞ means return to the RC890 menu↲
↲
╞ ╞ ╞ any other key ╞ ┆84┆means repeat the step in the install ↓
┆19┆┆a2┆┄┄program in which the error was detect┄↓
┆19┆┆a2┆┄┄ed↲
↲
╞ ╞ The following error messages exist:↲
↲
╞ ╞ ╞ Catalog error↲
╞ ╞ ╞ CU disconnected↲
╞ ╞ ╞ Diskette I/O error↲
╞ ╞ ╞ Diskette not mounted↲
╞ ╞ ╞ Diskette or catalog full↲
╞ ╞ ╞ File does not exist↲
╞ ╞ ╞ File too big┆84┆↲
╞ ╞ ╞ Illegal filename↲
↲
════════════════════════════════════════════════════════════════════════
↓
┆a1┆┆b0┆A.╞ ╞ REFERENCES↲
↲
╞ ╞ (1)╞ In course of preparation:↲
╞ ╞ ╞ ┆a1┆┆b0┆┆f0┆RC890 IBM 3274 Emulator Reference Manual↲
↲
╞ (2)╞ RCSL No. 42-i2459:↲
╞ ╞ ╞ ┆a1┆┆b0┆┆f0┆RC855 Operating Guide↲
╞ ╞ ╞ Pierce C. Hazelton, February 1984↲
↲
╞ ╞ (3) RCSL No. 42-i2150:↲
╞ ╞ ╞ ┆a1┆┆b0┆┆f0┆RC855 IBM 3270 BSC Emulator Operating Guide↲
╞ ╞ ╞ Claus Terp, November 1982↲
↲
╞ ╞ (4) RCSL No. 42-i2347:↲
╞ ╞ ╞ ┆a1┆┆b0┆┆f0┆RC855 Work Station User's Guide↲
╞ ╞ ╞ Jeffrey C. Snider and Leif Olsen, June 1983↲
↲
════════════════════════════════════════════════════════════════════════
↓
┆a2┆┆e2┆┆a1┆┆b0┆B.╞ ╞ PARAMS.CU FILE↲
↲
════════════════════════════════════════════════════════════════════════
↓
┆a1┆┆b0┆C.╞ ╞ MENU.DLL FILE↲
↲
┆1a┆┆1a┆┆98┆↓
↓
┆1a┆↓
┆1a┆line↲