|
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: 149504 (0x24800) Types: TextFile Names: »D9«
└─⟦e61e7d03c⟧ Bits:30005867/disk01.imd Dokumenter (RCSL m.m.) └─⟦this⟧ »D9«
i T_A_B_L_E_ _O_F_ _C_O_N_T_E_N_T_S_ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _P_A_G_E_ 1. INTRODUCTION .......................................... 1 2. CONTROLS .............................................. 2 3. OPERATING PROCEDURES .................................. 6 4. GENERAL KEYBOARD DESCRIPTION .......................... 8 4.1 Character Keys ................................... 8 4.2 Program Controlled Keys .......................... 8 4.3 Local Control Keys ............................... 9 5. RC819 KEYBOARD ........................................ 10 5.1 Program Controlled Keys .......................... 10 5.2 Local Control Keys ............................... 10 6. RC822B KEYBOARD ....................................... 12 6.1 Program Controlled Keys .......................... 12 6.2 Local Control Keys ............................... 12 7. RC828B KEYBOARD ....................................... 15 7.1 Program Controlled Keys .......................... 15 7.2 Local Control Keys ............................... 15 \f ii \f 1_._ _ _ _ _ _ _ _ _I_N_T_R_O_D_U_C_T_I_O_N_ 1. Figure 1: Visual display unit and keyboard. The consoles/terminals described in this operating guide are all based on the same type of visual display unit whereas the key- boards have a different layout and different function keys depending on the specific RC product number of the console/ terminal. The visual display unit is referred to as VDU. \f F_ 2_._ _ _ _ _ _ _ _ _C_O_N_T_R_O_L_S_ 2. Figure 2: Controls. POWER ON/OFF - a mains power switch is located at the left side of the VDU. In console applications the switch can be switched to its ON position, and left in the ON position, at the first time of operation. The VDU will then be switched on/off as the system is switched on/off. 1) Indicators - when an indicator is lit, the fol- lowing is ment: PR (P_rogram R_eady): the system responds in order to show its availability to the user. \f CD (C_arrier D_etect): a feature of the communications equipment, showing that the connec- tion is established. RS (R_eady To S_end): like the CD indicator, but showing readiness for transmitting from the keyboard. Both the CD and the RS indicator should be lit, when the terminal is on-line. 2) BAUD RATE - when turning the knob, different selector speeds in communications can be selected. Usually to be left untuched by the operator as the setting is part of the overall system tuning (determi- ned by software). 3) Switch selectors - when pressed inwards the features are selected as descriebed below. The switches are self-locking, to deselect the features, press once more. TAPE - for maintenance purpose only. Causes all recieved characters to be displayed including control characters. The TAPE key on some keyboards provides the same feature. DUP (D_u_p_lex) - in-position: full duplex; out-position: half duplex. \f EIA - for maintenance purpose only. In-position selects EIA (or V.24) signals. SPLIT - not used. not labelled - not operable. LOCAL - for maintenance purpose only. PARITY ODD - in-position : odd parity; out-position: even parity. PARITY ON - in-position : parity on; out-position: parity off. The switches concerned with parity usually are to be left untuched by the operator as the setting is part of the overall system tuning (de- termined by software). 4) Display Screen Controls - adjustment of brigthness and con- trast are provided by these two control knobs. - knob closest to the front side: controls the brightness of the displayed characters. (Sometimes labelled BRIGHTNESS.) - knob closest to the front side: controls the contrast in displaying characters. (Sometimes labelled CONTRAST.) \f 5) Loudspeaker Adjustment - the knob is used to adjust the loudness of the acoustic signal from the loudspeaker. Note: The knob may be located at the rear side of the keyboard. The acoustic signal is heard when receiving a BELL code. On the RC819 and the RC828B it is also used to produce the key-sound which is heard when typing a key (this feature can be switched off). \f F_ 3_._ _ _ _ _ _ _ _ _O_P_E_R_A_T_I_N_G_ _P_R_O_C_E_D_U_R_E_S_ 3. Turn on the mains power with the POWER ON/OFF switch. When applied as a console, the power can be controlled via the system if the POWER ON/OFF switch is left in the ON position after first time of operation. The selector switches should normally be positioned as follows: TAPE : out-position DUP : in-position, or according to specifications EIA : in-position SPLIT : out-position not labelled : out-position LOCAL : out-position PARITY ODD : according to specifications PARITY ON : according to specifications At the time the communications facilities are available for use, the CD and ultimately the RS indicators will light. As long as the terminal is on-line, these indicators should light. The PR indicator will light whenever the system is available for terminal operations. How to access the system and further in- formation regarding terminal operations will be found in the publications concerned with software systems and applications. In a first-time operating situation and whenever convinient at start of operations the following check procedures are performed: 1. The display is checked by switching the DUP selector to its out-position, then select any of the character keys and hold that key pressed down along with pressing down the REPT key. On the RC819/828B it is sufficient just to keep the character key pressed down as these models feature an auto-repeat function. \f The screen should now be filled up with that character. (Note: After checking, restore DUP selector to correct position.) 2. Adjust the brightness control until the raster is no longer visible and then adjust the contrast control for the most pleasing presentation. A moment spent on determining the optimum setting for both brightness and contrast controls is well spent, since this will reduce operator fatique. Remember though, that the setting may need to be changed as the ambient light level changes. Adjustments of brightness and contrast are provided by the control knobs located at the right side of the terminal. \f F_ 4_._ _ _ _ _ _ _ _ _G_E_N_E_R_A_L_ _K_E_Y_B_O_A_R_D_ _D_E_S_C_R_I_P_T_I_O_N_ 4. The keyboards differ with respect to the RC product number. The different types of keyboards used with the VDU are described in the chapters following. Commen to all keyboards is the presence of three types of keys: - the character keys, - the program controlled keys, and - the local control keys. 4_._1_ _ _ _ _ _ _ _C_h_a_r_a_c_t_e_r_ _K_e_y_s_ 4.1 The character keys are functioning as on an ordinary typewriter, i.e. pressing a key will transmit the character to the system in accordance with the engraving on the key cap. Also the keyboard layout is like that of a typewriter. Different layouts may appear, depending on the national character set applied. 4_._2_ _ _ _ _ _ _ _P_r_o_g_r_a_m_ _C_o_n_t_r_o_l_l_e_d_ _K_e_y_s_ 4.2 It is important to note that the functions of the program con- trolled keys will differ from system to system. Specific infor- mation regarding function and usage should be found in the publi- cations covering software systems and applications. The program controlled keys are mentioned for each type of console/terminal as they appear in general on that type regardless of possible options. \f 4_._3_ _ _ _ _ _ _ _L_o_c_a_l_ _C_o_n_t_r_o_l_ _K_e_y_s_ 4.3 The local control keys are provided in order to enable usual typewriter functions, cursor controlling, etc. Note that a general-purpose terminal contains few program controlled keys and many local control keys opposite to a data entry terminal which contains many program controlled keys and few local control keys. Some of the local control keys (especially the cursor control keys) may as well be affected by the software system applied. \f F_ 5_._ _ _ _ _ _ _ _ _R_C_8_1_9_ _K_E_Y_B_O_A_R_D_ 5. 5_._1_ _ _ _ _ _ _ _P_r_o_g_r_a_m_ _C_o_n_t_r_o_l_l_e_d_ _K_e_y_s_ 5.1 ESC (E_s_c_ape) BELL LOCAL ATT DELETE LINE - function determined by software RETURN system DELETE CHAR RUB OUT CTRL - used to generate control codes which are not directly provided on the keyboard by assigned keys. The CRTL key is pressed down and kept in the down-position, at the same time an alphanumeric key is pressed down - a control code cor- responding to that alphanumeric character will then be transmitted. The alphanumeric character which has to be used as well as the func- tions which are caused, are deter- mined by the software. 5.2 5_._2_ _ _ _ _ _ _ _L_o_c_a_l_ _C_o_n_t_r_o_l_ _K_e_y_s_ SHIFT - this key, in conjunction with alphabetic or numeric keys, will select the upper legend or the upper-case character form. SHIFT LOCK - when locked in the down position, the key will select the upper-case character legends. The key is self- locking, to release press once more. \f PRINT ON - this code will cause all received and transmited data to be directed to the printer output. The connecting of a terminal prin- ter to the display terminal is available as an option. PRINT OFF - this code will remove the printer output connection. TAPE - for maintenance purposes only. Self- locking key - to release press once more. Causes all received character to be displayed including control charac- ters. FF (Form Feed) - function used with optional printer; causing form feed. LF (Line Feed) - function used with optional printer; causing line feed. Auto-repeat - the keyboard features an auto- repeat function, i.e. pressing a key down for longer than approx. 1 second will cause the character automatically to be repeated. \f F_ 6_._ _ _ _ _ _ _ _ _R_C_8_2_2_B_ _K_E_Y_B_O_A_R_D_ 6. 6_._1_ _ _ _ _ _ _ _P_r_o_g_r_a_m_ _C_o_n_t_r_o_l_l_e_d_ _K_e_y_s_ 6.1 ESCAPE LINE FEED RETURN - function determined by the software RUB OUT system. BREAK BACK SPACE CTRL - used to generate control codes which are not directly provided on the keyboard by assigned keys. The CTRL key is pressed down and kept in the down-position, at the same time an alphanumeric key is pressed down - a control code cor- responding to that alphanumeric character will then be transmitted. The alphanumeric character which has to be used as well as the func- tions which are caused, are deter- mined by the software. 6_._2_ _ _ _ _ _ _ _L_o_c_a_l_ _C_o_n_t_r_o_l_ _K_e_y_s_ 6.2 SHIFT - this key, in conjunction with alphabetic or numeric keys, will select the upper legend or the upper-case character form. ALPHA LOCK - when locked in the down position, the key will select the upper-case character legends with no effect on the numeric keys. The key is self- locking, to release press once more. \f REPT (R_e_p_eat_) - when pressed down and kept in the down position, any other character key may be pressed down at the same time and that character will be repeatedly generated as long as engaged. HOME - will return cursor to the >home> position (first character, first line). -' - causes the cursor to advance one (FORWARD CURSOR) character position to the right. If there are no character positions left to the right, the cursor will advance to the first character position of the next line. The cursor control codes (FORWARD CURSOR and the following codes) are non-destruct codes, i.e. the cursor may pass an >occupied> position without deleting the character of that position. <- - as FORWARD CURSOR, but to the left. (BACK CURSOR) - causes the cursor to move up one (UP ROW CURSOR) row. Reaching the first row the cursor remains there. - as UP ROW CURSOR, but downwards. (DOWN ROW CURSOR) Reaching the last row the cursor will move the data up one row, leaving the last row blank. \f TAB - horizontal tab, usually fixed to every fourth character position. Tab positions are fixed and do not depend on the start position of the cursor. ERAS EOL - this code will erase all data from (E_r_a_s_e to E_nd o_f L_ine) cursor position to end of line. ERAS EOS - this code will erase all data from (E_r_a_s_e to E_nd o_f S_creen) cursor position to end of screen. CLEAR - this code will erase all data and home the cursor. PRINT - this code will cause all received and transmited data to be directed to the printer output. The connecting of a terminal printer to the display terminal is available as an option. PRINT OFF - this code will remove the printer output connection. TAPE - for maintenance purposes only. Self-locking key - to release press once more. Causes all received character to be displayed including control charac- ters. LOAD TAPE - for maintenance purposes only. \f F_ 7_._ _ _ _ _ _ _ _ _R_C_8_2_8_B_ _K_E_Y_B_O_A_R_D_ 7. 7_._1_ _ _ _ _ _ _ _P_r_o_g_r_a_m_ _C_o_n_t_r_o_l_l_e_d_ _K_e_y_s_ 7.1 ESCAPE CLEAR SUB FORM DUP CHAR REC - function determined by software FIELD system. REC REL ERROR REL ENTER BY-PASS RECORD LOG IN 7_._2_ _ _ _ _ _ _ _L_o_c_a_l_ _C_o_n_t_r_o_l_ _K_e_y_s_ 7.2 SHIFT - this key, in conjunction with alpha- betic or numeric keys, will select the upper lengend or the upper-case character form. SHIFT LOCK - when locked in the down position, the key will select the upper-case character legends. The key is self- locking, to release press once more. Auto-repeat - the keyboard features an auto-re- peat function, i.e. pressing a key down for longer than approx. 1 se- cond will cause the character auto- matically to be repeated. \f \f A_P_P_E_N_D_I_X_ _D_:_ _D_I_A_G_R_A_M_ _O_F_ _H_O_W_ _T_O_ _U_S_E_ _T_H_E_ _C_O_D_E_ _P_R_O_C_E_D_U_R_E_ _'_R_E_T_U_R_N_'_ parameters Action txt1 txt2 check printout outputres cont Result Textmode Text function bit 0-5 bit 6-11 bit 12 bit 13 bit 14 bit 15 1: No text output Zero Zero C O Zero 1 irrelevant Zero irrelevant get new input (see be- (see be- low) low) 2: Standard text output first second C O P 1 no. to be Zero irrelevant get new input textno. textno. (see be- (see be- (see be- output low) low) low) 3: Param. 'text' output Zero Zero C O Zero 1 irrelevant 1 byte 1-80 = get new input (see be- (see bbe- text to low) low) output 4: No text output Zero Zero Zero O Zero Zero irrelevant Zero irrelevant termination (see be- low) 5: Standard text output first second Zero O P Zero no. to be Zero irrelevant termination textno. textno. (see be- (see be- output low) low) 6: Param. 'text' output Zero Zero Zero O Zero Zero irrelevant 1 byte 1-80 = termination (see be- text to low) output 7: Replace command R1 R1 Zero O Zero Zero R1 R2 R2 termination (see be- (see be- (see be- (see below) (see below) (see below) low) low) low) 8: Wait/signal Zero semaph. 1 wait = 0 Zero Zero irrelevant Zero irrelevant semaphore ident. signal = 1 \f RC 3600 DATA ENTRY RELEASE 2 SUPERVISOR PROGRAMMING GUIDE Second Edition A/S REGNECENTRALEN February 1978 Marketing Department RCSL 43-GL 4351\f Author: Birte Steckhahn Technical Editor: KEY WORDS: Data Entry, Superivsor programming guide. ABSTRACT: This manual describes how to make a supervisor program and explains the environment where the programs are operated. SUPPORTING AND REFERENCED DOCUMENTS: Reservation Copyright A/S Regnecentralen, 1977 Printed by A/S Regnecentralen, Copenhagen\f T_A_B_L_E_ _O_F_ _C_O_N_T_E_N_T_S_ ________________________________________P_A_G_E_ 1 INTRODUCTION 5 2 DISC FILES6 2.1 Libraries6 2.2 Jobs6 2.3 Batches7 3 CODING OF A SUPERVISOR PROGRAM8 4 DESCRIPTION OF STANDARD CODE PROCEDURES9 4.1 Code Procedure Get Command9 4.2 Code Procedure Get Parameter10 4.3 Code Procedure Return12 4.4 Code Procedure Access15 4.5 Code Procedure Allaccess16 4.6 Code Procedure Connect File17 4.7 Code Procedure Get Next Item18 4.8 Code Procedure Get Next Item20 4.9 Code Procedure Delay21 5 PROGRAMMING HINTS23 5.1 Printout23 5.1.1 Spool-File23 5.1.2 Hardcopy Devices24 5.1.3 Opening of Actual Device24 5.1.4 How to make the Printout25 5.2 Program Termination26 5.3 Error Procedures26 5.4 Creation of a batch27 6 OPERATOR COMMUNICATION29 7 INSTALLATION OF NEW SUPERVISOR PROGRAMS30 APP. A STRUCTURE OF A LIBRARY31 APP. B STRUCTURE OF A JOB32 APP. C STRUCTURE OF A BATCH33 C.1 Batch Head 33 C.2 Records 34 C.2.1 Data Records 34 C.2.2 Register Records 35 C.3 Batch End Mark 36 APP. D DIAGRAM OF HOW TO USE THE CODE PROCEDURE'RETURN'38\f T_A_B_L_E_ _O_F_ _C_O_N_T_E_N_T_S_ ________________________________________P_A_G_E_ APP. E STANDARD TEXT NUMBERS40 APP. F PROGRAM EXAMPLE VOLUME41 APP. G PROGRAM EXAMPLE DUMP43 APP. H REFERENCES 46 APP. I INDEX47 \f F_ 1 I_N_T_R_O_D_U_C_T_I_O_N_ This manual describes how to make a supervisor program to the Data Entry System, Release 2, and explains the environment where the programs are operated. The Supervisor is a part of RC 3600 Data Entry System, called NANNY which handles loading of and communication with super- visor programs and dialog with the operator, when the key sta- tion is in supervisor mode. When it receives a command it looks for the corresponding entry in the RC 3600 file system catalog, loads the program to the supervisor area in memory, start the program as a process and sends a message to the process con- taining the command line typed by the operator. Before starting to make a supervisor program, it is recommended to glance through the following sections: 2, 3, 5.1, 5.3, and 6. \f F_ 2 D_I_S_C_ _F_I_L_E_S_ 2.1 L_i_b_r_a_r_i_e_s_ The Data Entry System has 5 libraries. They are physically disc files containing a group of names. The 5 libraries are: 1. Job Library The library contains the names of all the jobs in the system. The name of the file on the disc is JBLIB. The structure of the library, see appendixA. 2. Format Library The library contains the names of all the trans- lated formats in the system. The name of the file on the disc is FBLIB. The structure of the library, see appendix A. 3. Subprogram Library The library contains the names of all the trans- lated subprograms in the system. The name of the file on the disc is SPLIB. The structure of the library, see appendix A. 4. Table Library The library contains the names of all the trans- lated tables in the system. The name of the file on the disc i TBLIB. The structure of the library, see appendix A. 5. Disc-table Library The librry contains the names of all the created disc-tabels in the system. The name on the file on the disc is DTLIB. The structure of the library, see appendix A. 2.2 J_o_b_s_ A job is a disc file containing a group of batch names, and for each batch name a status word containing a status of the batch. Each job name is included in the job library (JBLIB), and in\f each batch belonging to a job is the name mentioned, too. Further description of a job file, see appendix B. 2.3 B_a_t_c_h_e_s_ A batch is a disc file on the disc containing the data and re- gister records together with some informations about the batch, such as which job it belongs to. Every record then contains in- formation about itself, such as a record status, and a number of fields. The informations about the batch is placed in the first block in the file and this block is called the batch head. The infor- mation about a record is positioned at the beginning of the re- cord and is called the record head. A batch is terminated by a batch end mark. The exactly structure of a batch, see appendix C. \f F_ 3 C_O_D_I_N_G_ _O_F_ _A_ _S_U_P_E_R_V_I_S_O_R_ _P_R_O_G_R_A_M_ All supervisor programs must be coded in the MUSIL programming language and compiled using the MUSIL compiler. Output from the MUSIL compiler is relocatable binary object code, which can be added to the Data Entry System by loading it to disc (see sec- tion 7). The standard code procedures described in section 4 have been implemented in order to make it possible for the Data Entry Supervisor to - transfer command lines and parameters to the super- visor programs, and to get receipts from the pro- grams before removal of the process after program termination. (The procedures 'get command', 'get parameter', and 'return'). - lookup, delete or insert a name in a library or to search sequential through a library (the pro- cedures 'find item', and 'get next item'). - read the fields in a batch (the procedures 'access' and 'allaccess'). - slow down the supervisor program so that keying, rekeying, and editing will be unaffected of the run of a supervisor program ( the procedure 'de- lay'). - to open a file for the printout (the text that must be written on the hard copy device or on the super- visor key station display) the procedure 'connect file'). These procedures must be declared and called in the MUSIL pro- gram and copied into the program at compilation time. See refe- rence 1.\f F_ 4 D_E_S_C_R_I_P_T_I_O_N_ _O_F_ _S_T_A_N_D_A_R_D_ _C_O_D_E_ _P_R_O_C_E_D_U_R_E_S_ 4.1 C_o_d_e_ _P_r_o_c_e_d_u_r_e_ _G_e_t_ _C_o_m_m_a_n_d_ This procedure is used to receive a command line from the super- visor in the Data Entry System. The call of this procedure must be the first statement executed in the supervisor program. The procedure must be declared as follows: procedure cmnd (var comline: string (112); var return: integer); comebody; P_a_r_a_m_e_t_e_r_s_:_ Comline: Return parameter of type 'string'. The length of the parameter must be at least 112 bytes. The parameter contains a command line, typed in by the keying operator, and must not be changed by the program. Return: Return parameter of type 'integer'. The parameter contains the message address used by the supervisor. This parameter must be used when returning to the supervisor (see section 4.3), and when delaying the program (see section 4.9), and the value of the parameter must therefore not be changed by the program. After a syntax check, made by the supervisor, each parameter to the program will be packed in 'comline' as groups of information as follows: \f T_ 1. T_y_p_e_ _o_f_ _p_a_r_a_m_e_t_e_r_ 2 bytes; where 0 = integer parameter 1 = text parameter &_ 2 = termination 2. T_h_e_ _p_a_r_a_m_e_t_e_r_ 2 bytes for integer parameters, and 6 bytes for text parameters, each parameter terminated by at least one null character 3. T_e_r_m_i_n_a_t_o_r_ _f_o_r_ _p_a_r_a_m_e_t_e_r_ 2 bytes, where 0 = space 1 = period 2 = termination After a call of the procedure return (see section 4.3) it is possible to get an empty command line (i.e. only ENTER has been pressed on the supervisor key station). The contents of 'com- -0--255- line' will then be: 0 255 if no syntax check has been made, -0--2- or 0 2 after a syntax check (i.e. termination). 4.2 C_o_d_e_ _P_r_o_c_e_d_u_r_e_ _G_e_t_ _P_a_r_a_m_e_t_e_r_ This procedure is used to get a single parameter from the com- mand line. The first call of this procedure in the program will in parameter 'item' return the name of the file that later on must be opened for printout (see section 5.1) with the procedure 'connectfile' (see section 4.6). The parameter 'value' describes if the printout is to be produced on a hardcopy device or on the supervisor key station display screen. The contents of those two parameters must therefore be saved before a new call of the pro- cedure 'get parameter'. The subsequent calls will return the pa- rameters in the order in which they were typed on supervisor key station. The procedure must be declared as follows: \f T_ procedure gtpm (var comline: string (112) var item: string (6) var value: integer; var kind: integer; var sep: integer); &_ comebody; P_a_r_a_m_e_t_e_r_s_:_ Comline: Call parameter of type 'string'. See section 4.1. Item: Return parameter of type 'string'. The length of the parameter must be at least 6 bytes. The parameter containsa text from the command line if kind = 1. The text is terminated by at least one null charac- ter. The first character in a text parameter must be a letter followed by letters or digits. The first time the procedure is called, this para- meter contains the name of the printout file. Value: Return parameter of type 'integer'. The parameter contains an integer value if kind = 0. An integer parameter may be typed on the supervisor key station either in signed/unsigned decimal repre- sentation, or in octal representation (identified by a preceeding apostrophe). The first time the procedure is called, this parameter indicats whether the print- out must be produced on a hard copy device or on the supervisor keystation display screen: Value = 0: printout on display screen. Value = 1: printout on hard copy. Kind: Return parameter on type 'integer'. The parameter contains the type of the returned para- meter, where: Kind = 0 means integer parameter. Kind = 1 means text parameter. Kind = 2 means that the procedure has been called too many times (i.e. more that the number of parameters in the command line), or that an empty command line has been received (i.e.\f only ENTER has been pressed on the super- visor key station) after a call of the pro- cedure return (see section 4.3). Sep: Return parameter of type 'integer'. The parameter contains an integer value which indi- cates the terminator of the returned parameter,where: T_Sep = 0 means space Sep = 1 means period Sep = 2 means termination = last parameter (i.e. &_ ENTER on the supervisor key station). T_ 4.3 C_o_d_e_ _P_r_o_c_e_d_u_r_e_ _R_e_t_u_r_n_ This procedure is used to return to the Supervisor in the Data Entry System, either to get a new command line from the super- &_ visor key station or to indicate that the program execution must be terminated and the process must be removed from the super- visor area in memory. In case of termination the call of this procedure must be the last statement executed in the supervisor program. The procedure must be declared as follows: T_ procedure return (var return: integer; var result: integer; var action: integer; var textmode: integer; var text: string (80 or 160)); &_ comebody; P_a_r_a_m_e_t_e_r_s_: Return: Call parameter of type 'integer'. See section 4.1. Result: Call parameter of type 'integer'. This parameter may contain a number, which may be output on the supervisor key station display screen as an octal number, when a standard text is output (see parameter 'action'). Standard texts, see appen- dix E. Result cannot be output after a text in the parameter 'text'. \f Action: Call parameter of type 'integer'. The parameter contains information about a possible standard text to be output on the supervisor key station display screen, special actions to be taken by the supervisor, and about continuation of the pro- gram execution. The information must be packed as fol- lows: (txt1 shift 10) + (txt2 shift 4) + (check shift 3)+ (printout shift 2) + (outputres shift 1) + cont. txt1: If a standard text must be output, the num- ber of the first text must be placed here. txt1 = 0 means that no text is output, a text in the parameter 'text' is output or a semaphore function has to be performed. txt2:If a standard text is composed of two text numbers the second text number must be placed here. If a semaphore function has to be performed, the ident of the semaphore must be placed here (first semaphore = 1). 'txt2' = 0 means that only one standard text number is used (indicated in 'txt1'), no text is output, or that a text in the parameter 'text' is output. check: = 1 if the program execution must continue ('cont' = 1) and the new input from the supervisor must be syntaxchecked or if a semaphore function has to be performed. = 0 if no syntax-check of new input or if the program has to terminate ('cont' = 0). printout: = 1 if - a printout is produced and must beoutput to the hard copy device or thesupervisor key station display screen. - a signal semaphore function has to be performed. = 0 if - a printout must not be output (forexample after an error) or a printout has not been produced. \f - a wait semaphore function has to be per- formed. outputres:= 1 means that the number in the parameter 'result' must be output on the display screen after a standard text. = 0 means that the parameter 'result' must not be output after a standard text, or that a text in parameter 'text' is to be output ('result' cannot be output after such a text). In this case the contents of 'result' are irrelevant. cont: = 1 means that the program execution must continue. = 0 means program termination. Textmode: Call parameter of type 'integer'. This parameter describes the contents of parameter 'text'. = 0 means that the contents of 'text' are irrelevant, because the parameter 'action' is used for receipt specification. = 1 means that byte 1-80 of parameter 'text' contains a text to be output on the supervisor key station dis- play screen instead of a standard text. = 2 means that byte 1-80 of 'text' contains a text to be output and byte 81-160 of 'text' contains a replace command. Text: Call parameter of type 'string'. The length of the string must be 80 or 160 bytes, de- pending on the value of 'textmode'. Both a text to be output on the supervisor key station display screen and a replace command must be termina- ted by a null-character. A replace command is a supervisor command, i.e. a call of another supervisor program with termination of the first program in the same way as if the first program terminates, and the operator calls the secondprogram. A replace command cannot change the output device for the printout. If a program is called with output of printout on printer via spool-file, and this program\f terminates with a replace command, the new program will place the printout on the printer via spool-file, too. In appendix D a diagram is showing how to use the procedure. T_ 4.4 C_o_d_e_ _P_r_o_c_e_d_u_r_e_ _A_c_c_e_s_s_ The procedure is used to read transfer fields in the data records in a batch. The zone connected to the batch must be opened for reading and positioned just after the block with &_ the batch head, i.e. -batchname- zone.zname:= batchname ; open (zone, 1); ! read and check the batchhead! setposition (zone, 0, 1); Between the first and the last call of the procedure the zone may not be changed by calling other procedures using the zone. The procedure will skip register records and the fields with status 'no transfer' (register records and field states are described in appendix C). The procedure must be declared as follows: T_ procedure access (file z; var field: string (80); var number: integer; var status: integer; var subname:string (2)); &_ comebody; P_a_r_a_m_e_t_e_r_s_: z: Call and return parameter of type 'file'. The parameter must be defined as a disc-file, i.e. kind = 62 and share length = 512.z. zname must be a name of a batch, e.g. n_o_t_ a name of a job or a table. Field: Return parameter of type 'string'. The length of the string must be 80 bytes. \f The contents of 'field' is a field with the status transfer, if the parameter 'number' is greater that or equal to zero. 'Number' then indicates number of characters in the field. Number: Return parameter of type 'integer'. The parameter describes what has been read: -_0 -0: a field has been read. 'Number' contains the number of characters in the field which is placed in 'field'. The parameter 'status' contains the field status and the parameter 'subname' is undefined. =-1: a record head is read. 'Field' is undefined, 'status' contains the record status and 'subname' contains the name of the subformat, which has been used when keying the record. =-2: a record end is read. 'Field', 'status' and 'subname' are all undefined. =-3: a batch end mark is read. 'Field', 'status' and 'subname' are all undefined. Status: Return parameter of type 'integer' The parameter contains the record status if a re- cord head is read and the field status if a field is read. Otherwise 'status' is undefined. Subname: Return parameter of type 'string'. The length of the string must be 2 bytes. If a record head is read the parameter in the first byte contains the name of the subformat, which has been used when keying the record. The second byte is a null-character. 4.5 C_o_d_e_ _P_r_o_c_e_d_u_r_e_ _A_l_l_a_c_c_e_s_s_ This procedure is used in the same ways as the procedure 'access', and returns nearly the same. The only differences between 'access' and 'allaccess' are: \f - 'allaccess' is defined with the name allacinstead of access. - 'allaccess' returns fields with status notransfer, which are ignored by 'access'. The procedure is defined: T_ procedure allac (file z; var field: string (80); var number: integer; var status: integer; var subname: string (2)); &_ comebody; P_a_r_a_m_e_t_e_r_s_:_ Please consult section 4.4. T_ 4.6 C_o_d_e_ _P_r_o_c_e_d_u_r_e_ _C_o_n_n_e_c_t_ _F_i_l_e_ This procedure is used for opening the file where the printout must be placed (a work-file on the disc or one of the hardcopy &_ devices). The procedure looks up the catalog entry given by the name. If the entry is found and is a file descriptor (if the name is one of the names of hardcopy devices), the information about device name, mode, kind, file, block, and give up mask are transferred to the zone variables. If the name is the name of the work-file, a 'createentry' is per- formed (because the entry is deleted by the supervisor before calling the program). Before return to the MUSIL program the zone is opened with the mode specified. The procedure must only be called oned in a program. The procedure must be declared as follows: T_ procedure connec (file) z; const outmode: integer; const name: string (6)); &_ comebody;\f P_a_r_a_m_e_t_e_r_s_:_ z: Call and return parameter of type 'file'. The parameter must be defined as as file with the sharelength = 512. Outmode: Call parameter of type 'integer'. The parameter must be set to output mode, i.e. outmode:= 3; before call of the procedure. Name: Call parameter of type 'string'. The length of the string must be 6 bytes. The contents of 'name' must be the name of the file where the printout must be placed, (this name is re- ceived when the procedure 'get parameter' (section 4.2) is called the first time). T_ 4.7 C_o_d_e_ _P_r_o_c_e_d_u_r_e_ _F_i_n_d_ _I_t_e_m_ This procedure is used to search for a name, to insert a name &_ or to delete a name in a library or a job. The procedure must be declared as follows: T_ procedure fitem (file z; const optype: integer; const length: integer; const name: string (6)); &_ codebody; N_O_T_I_C_E_:_ In the MUSIL program there must be two integers defined just after the string 'name', for an extraword and a result, because the procedure uses those two integers, as they were parameters: If z.zname is a name of a job, i.e. 'name' is a name of a batch (specified by 'length' = 4, see 'length) the status of the batch taken from the job is placed in the first integer, called 'extra- word', and the result of the call of the procedure is placed in the second integer, called 'result'. \f P_a_r_a_m_e_t_e_r_s_: z: Call parameter of type 'file'. The parameter must be defined as a disc-file, i.e. kind = 62 and sharelength = 512. z. zname must be the name of the library or the job, where the procedure must look for 'name', insert it or delete it. The zone must be opened for reading before a call of the procedure. Optype: Call parameter of type 'integer'. The procedure first searches through the library or the job for 'name' and then looks at 'optype' to decide the action to be taken: = 0: search item: If 'name' is found, 'result' is set to 0, otherwise to 1. If 'name' is a batch name the status from thejob is placed in 'extraword'. = 1: delete item: If 'name' is found, the name is deleted and 'result' is set to 0, otherwise to 1. = 2: insert item: If 'name' is not found, the name is inserted and if 'name' is a name of a batch, the con- tents of 'extraword' is inserted after 'name' and 'result' is set to 0. If 'name' already exists, 'result' is set to 1. Length: Call parameter of type 'integer'. This parameter describes how many words in the library or the job, the item must use. If z. zname is a name of a job, 'length' must be 4 (3 words for the name and 1 word for the status). If z. zname is a name of a li- brary (job, format, subprogram, table, or disc table library), 'length' must be 3. Name: Call parameter of type 'string'. The length of the string must be 6 bytes, and the con- tents must be the name to search, insert or delete in the job or the library. A name must be a letter fol- lowed by not more than 4 letters or digits and termi- \f nated by at least one null-character. Extraword: This is not a parameter used in the call of the pro- cedure, but is an integer defined just after 'name' in the variable section in the MUSIL program. If 'length' = 4 the batch status from the job isplaced here if 'optype' = 0, and if 'optype' = 2 the contents of 'extraword' is inserted after 'name'. Result: This is not a parameter used in the call of the pro- cedure, but is an integer defined as second integer after 'name'. The contents of 'result' is 0 if the call of the pro- cedure causes no errors, otherwise 'result' is set to 1. T_ 4.8 C_o_d_e_ _P_r_o_c_e_d_u_r_e_ _G_e_t_ _N_e_x_t_ _I_t_e_m_ This procedure is used to run sequential through a job or a li- brary to get all the names one by one, e.g. run through a job in &_ order to dump all the batches. The zone with the job or library name must be opened for read- ing and positioned on the first block before the first call of the procedure. The procedure must be declared as follows: T_ procedure getnex (file z; const length: integer; var name: string (6); var extraword: integer; var status: integer); &_ codebody; P_a_r_a_m_e_t_e_r_s_:_ z: Call and return parameter of type 'file'. The parameter must be defined as a disc-file, i.e. kind = 62 and sharelength = 512. z. zname must be the name of the job or the library containing the names to be read. Length: Call parameter of type 'integer'. \f This parameter describes how many words in the library or the job one item uses. If z. zname is a name of a job, 'length' must be 4, and if z. zname is a name of library, 'length' must be 3. Name: Return parameter of type 'string'. The length of the string must be 6 bytes. The contents of 'name' after a call of the procedure is the next name read in the job or the library. Extraword: Return parameter of type 'integer'. If z. zname is a name of a job, the batch status from the job is placed here. If z. zname is a library name it is undefined. Status: Call and return parameter of type 'integer'. Beforethe first call of the procedure, 'status' may be undefined, but before the second and all the other calls it must have one of the following walues: =0: The disc zone has been used for something else, i.e. the zone has been destroyed and the jobor library name must be inserted in z. zname before calling the procedure. =1: The disc zone has not been used after lastcall. =-1: This value must be used in the first call with a new job or library name in z. zname afterthe procedure has been used on one job orlibrary. When the procedure returns to the MUSIL program, 'status' has the values: =0: The end of the job or library has not been reached yet. =1: The end of the job or library has beenreached. 'Name' and 'extraword' are undefined. T_ 4.9 C_o_d_e_ _P_r_o_c_e_d_u_r_e_ _D_e_l_a_y_ This procedure is used to slow down a supervisor program with &_ many disc transports in order to let keying operators work with- out speed-reduction, so the procedure must be used in programs,\f that read or write on the disc. The procedure makes the MUSIL program wait a number of timer- periodes(one timer-period = 20 milliseconds) standing in mess3 in a message buffer. The number is calculated by NANNY and de- pends on number of key stations in key, rekey and edit mode. The procedure is only effective if the supervisor key station has come to the supervisor mode by the control command SUPERVISOR SLOW. If the control command SUPERVISOR is used, mess3 is always set to 0. The procedure is declared as follows: procedure delay (var delayed: integer; var bufaddr: integer); comebody; P_a_r_a_m_e_t_e_r_s_:_ Delayed: Return parameter of type 'integer'. After a call of the procedure 'delayed' will contain the number of timer-periods the program has waited. Bufaddr: Call parameter of type 'integer'. The parameter must contain the address of that message buffer, where mess3 contains the number of timer- periods, the calling program must wait. This address is the return-value of the parameter 'return' in the code procedure 'get command' (see section 4.1). \f F_ 5 P_R_O_G_R_A_M_M_I_N_G_ _H_I_N_T_S_ 5.1 P_r_i_n_t_o_u_t_ A supervisor program can produce a printout in the form of a survey, log, listing, and the like. The section describes the administration of the printouts and how to make a printout. The printouts can be output in three ways: T_ HARDCOPY (3) DEVICE SUPERVISOR WORKFILE SPOOLFILE PROGRAM (1),(2) ON (2) ON(2) DISC DISC (1) DISPLAY SCREEN &_ (1) On the supervisor key station display screen. (2) On a hardcopy device (e.g. line printer or operator console device) via a so-called spool-file. (3) Directly on a hardcopy device. The way printout is to be produced is selected by the operator when the supervisor command is entered. T_ Examples: SYSTEM DISC Printout on display screen. SYSTEM.S DISC Printout on hardcopy device via spool-file. SYSTEM.L DISC Printout directly on hardcopy &_ device. T_ 5.1.1 S_p_o_o_l_-_f_i_l_e_ The spool-file can contain printouts from several supervisor programs and the operator can stop and start printing from the &_ spool-file. \f This means that the hardcopy device may be used for non-data entry functions (for example conversion) simultanously with production of some data entry printouts to be printed later. T_ 5.1.2 H_a_r_d_c_o_p_y_ _D_e_v_i_c_e_s_ When a system-tape is installed some catalog entries are created to describe hardcopy devices. It can be such as the line printer &_ or the operator console device (TTY). The entries contain information about the device: device name, mode, kind, file, block, and giveup-mask. The names of the entries are: HCOPY Normal hardcopy device It depends on the actual configura- tion, but can be the line printer for instance. HLPT Line printer HLPT1 Second line printer HSP Serial printer HSP1 Second serial printer HCPT Charaband printer HCPT1 Second charaband printer HTTY Operator console device (TTY) The current hardcopy device can be changed to another one by the SPOOL NEWDEVICE - command (see reference 2, section 9). T_ 5.1.3 O_p_e_n_i_n_g_ _o_f_ _A_c_t_u_a_l_ _D_e_v_i_c_e_ When a supervisor program is called, the Supervisor finds out, where the printout must be placed. If it is in the work-file, this file is deleted and later on created again (by code &_ procedure 'connect file'). When the code procedure 'get parameter' (section 4.2) is called the first time the name of the work-file or the name of the catalog entry describing current hardcopy device is returned in the parameter 'item'. In parameter 'value' the procedure returns\f if the printout must be written on the display screen or on a hardcopy device: T_ value = 0: display screen value = 1: hardcopy device. &_ It is necessary to know the length of the lines to be written because the display screen has space for 80 characters, and a line printer has space for 132 characters. To open the file the code procedure 'connect file' is used (see section 4.6). This procedure looks up the name in the catalog. If the entry is found, it is one of the names mentioned in section 5.1.2, and the procedure moves the device name, kind, and giveup-mask to the zone and or's the mode found with the mode given in the call of the procedure. If the entry is not found, it is the name of the work-file, which was deleted when calling the supervisor program. The procedure then creates an entry as a disc file. Hence it is very important that this procedure is called only once in a program. Finally the procedure opens the file and positions it at file and block. T_ 5.1.4 H_o_w_ _t_o_ _m_a_k_e_ _t_h_e_ _P_r_i_n_t_o_u_t_ A text string is written in the printout file by using the standard procedure OUTTEXT. This procedure stops writing the &_ text string in the zone, when it meets a null-character, i.e. all strings to be used by OUTTEXT must be terminated by at least one null-character. The character set to be used must be the ASCII code. When the printout is output to the actual device it is automatically converted if the output device does not use the ASCII code (for example a line printer). The last character to be output in the printout before closing the zone must be an end medium character: value 25. The last statement to be executed in a supervisor program must be a cll of the code procedure 'return' (section 4.3) with the parameter 'cont' equal to 0. If the program has made a printout with the end medium character as the last one, the parameter 'printout' must be set to one. This informs the Supervisor that a printout has been made, and if it is written in the work-file, the Supervisor copies the printout from the work-file to the display screen or to the spool-file and from the spoo-file to the hardcopy device. The copying is stopped when the end medium character is met. If the printout is copied to the display screen and a line contains more than 80 characters, theSuper-\f visor automatically inserts a 'new line'-character after the first 80 characters. All control characters (i.e. value less than 32 = SP) are ignored except 'new line' characters, this means that 'form feed' characters, for instance, has not effect. T_ 5.2 P_r_o_g_r_a_m_ _T_e_r_m_i_n_a_t_i_o_n_ Before the program returns to the Supervisor by a cll of the code procedure 'return' with the parameter 'cont' = 0, all &_ processes (i.e. driver- and area processes) which have been used by the program must be released (i.e. close (zone, 1);). Before closing the printout file, an end medium character must be OUTTEXTed. When using the code procedure 'return' it is important to set the values of the parameters in the right manner. Parameter 'action': 'cont' must be zero 'check' must be zero 'printout' must be 1 if a printout with an end medium character has been mode, otherwise to zero. 'outputres' must be set to 1 if 'txt1' and 'txt2' describe standard texts and if the contents of parameter 'result' must be output on the display screen after the standard texts. Otherwise 'outputres' must be set to zero. Parameter 'textmode': If the parameter is not initialized in the right way, it may causes some error-messages from the Supervisor. T_ 5.3 E_r_r_o_r_ _P_r_o_c_e_d_u_r_e_s_ After an error which cannot be corrected by the operator or no correction is wanted, the program execution must be terminated &_ as described in section 5.2. When the procedure CLOSE is called a program loop may occur after an output error because closing output zone may result in a new output message which will call\f the giveup-procedure again and so on. This program loop can be avoided in two ways: 1: The mode in erroneous zone is set to zero before closing the zone. This will prevent further output messages and the procedure CLOSE will only release the process, but some output data may be lost. (This action is shown in the program example in appendix F). 2: An error-counter is used to count number of errors. When a zone is opened the counter is set to zero. If the giveup-procedure is called the counter is increased by one and the program tries to close the zone. This may result in one of two things: - the giveup-procedure is called once more and the counter is increased by one - the error is corrected and the zone will be closed. If the error counter then gets greater than for example N the CLOSE-call cannot succeed and it is then skipped. If a call of CLOSE is succeeded the error-counter is then set to N. (This action is shown in the program example in appendix G, with N = 4). T_ 5.4 C_r_e_a_t_i_o_n_ _o_f_ _a_ _B_a_t_c_h_ If a batch is created by a supervisor program there are diffe- rent things to remember: &_ (The structure of a batch, see appendix C) a) in the batch head: - job name must be a name of a job file. If the job does not exist already, the job name must be inserted in the job li- brary (JBLIB) and a file with the job name must be created and the contents must be set according to the specifica- tions given in appendix B. - the format name must be a name of an existing translated format if the batch later on must be rekeyed or edited. - the batch name must be the same name as the name of the file where the batch is placed. - the batch status word must be set to closed, i.e. bit 0 = 1\f (status = 100000DD8UU) or to closed and invalid, i.e. bit 0 = 1 and bit 12 = 1 (status = 100010DD8UU). If the invalid bit (bit 12) is set, some of the field in the batch may be invalid. - number of blocks (word 14) and number of records (word 15) must be calculated and inserted in the batch head. - end format (word 26) must be set to 100000DD8UU as if the 'end'- statement in the format was executed. - the other words in the batch head must be set to zero. b) in the data record head: - subname must be the name of a subformat in the format spe- cified the the batch head. - the length of the record and the record number in the batch must be calculated and inserted. - the other bytes must be set to zero. The record status can be set to non-zero, if the record must not be dumped. (Normally the supervisor program 'dump' will skip records with invalid status). c) in the data record end: - subname must be the same as subname in the record head. - record end mark must be one byte with the value 28DD10UU. d) in the fields: - the field status can be set to non transfer if the data in the field must not be dumped or transferred. - the field end mark must be one byte with the value 27DD10UU. e) register records: - the register records may n_o_t_ be made by a supervisor program. If a batch, made by a supervisor program, must be corrected with EDIT the batch must contain register records. They are made in this way: 1) leave supervisor mode with the supervisor command STOP -batchname- 2) key: EDIT batchname 3) key: END This will causes the editor to run through the batch and make the register records. At the same time the states of the fields, the records and the batch will be set according to the format (specified in the batch head). After this the batch can be corrected with EDIT.\f F_ 6 O_P_E_R_A_T_O_R_ _C_O_M_M_U_N_I_C_A_T_I_O_N_ When a supervisor program has been called from the supervisor key station, the communication with the program may be done either from the supervisor key station, if the program uses the code procedures 'get command', 'get parameter' and 'return', or from the RC 3600 operator console device (TTY), if the program uses the standard operator communication procedures described in reference 1. The latter communication is recommended for greater supervisor programs such as print image programs, paper tape conversion programs etc., because it gives a possibility for temporary halts of the program execution caused by the operator. When using the code procedures 'get command', 'get parameter', and 'return' all the communication between the program and the operator is automatically written in the log-file by the Supervisor. This means that the supervisor program has not to make any action to write in the log-file. (The log-file can be dumped and printed by the standard supervisor programs DUMPSTAT and LISTLOG, see reference 2, section 9). As can be seen in appendix F communications via the key station has been made possible by 1) calling the codeprocedure 'return' with 'cont' = 1 2) calling the codeprocedure 'get command' this will wait until the operator has answered the question asked for with 'return'. The answer is given in 'comline' as a return parameter from 'get command' - if the answer has been syntax-checked by the Supervisor the items from the answer must be picked up by using 'get parameter'. - if the answer has not been syntax-checked 'comline' holds a normal text string. \f F_ 7 I_N_S_T_A_L_L_A_T_I_O_N_ _O_F_ _N_E_W_ _S_U_P_E_R_V_I_S_O_R_ _P_R_O_G_R_A_M_S_ A new supervisor program is put into the Data Entry System by means of the standard supervisor program PUT. In this way it is not necessary to generate a new system tape every time a new supervisor program has been made. The binary supervisor program (i.e. the output from the MUSIL compiler) may be read from either paper tape or magnetic tape. The supervisor command for PUT is fully described in reference 2, section 9. Please consult this description.\f F_ A_P_P_E_N_D_I_X_ _A_:_ _S_T_R_U_C_T_U_R_E_ _O_F_ _A_ _L_I_B_R_A_R_Y_ The five libraries in the Data Entry System are structured in the same way. Each of them is an extensible disc file containing a group of names with the same characteristics. A disc file is a collection of blocks. The first two bytes in the first block is a counter containing number of names in the library. The first two bytes in other blocks are undefined. The rest of each block is divided into groups of 6 bytes, each group containing one name. One block can in this way contain 85 names (one block = 512 bytes: two bytes for counter or undefined, 510 bytes for names of 6 bytes = 85 names). A name consists of a letter followed by not more than 4 letters or digits terminated by at least one null-character. T_ Examples: name BAJ01 name B75 1. byte B A 2. byte 1. byte B 7 2.byte 3. byte J 0 4. byte 3. byte 5 null 4. byte &_ 5. byte 1 null 6. byte 5. byte null null 6. byte When a name is deleted by the code procedure find item (section 4.7) the first two bytes in the name are overwritten with null- characters and the counter is decreased by one. This makes a free space in the library. When a name is inserted in the library by the same procedure, it is inserted on the first free place (and n_o_t_ after all the other names) and the counter is increased by one. \f F_ A_P_P_E_N_D_I_X_ _B_:_ _S_T_R_U_C_T_U_R_E_ _O_F_ _A_ _J_O_B_ A job is an extensible disc-file containing a group of batch names and for each batch name a status of the batch. The first two bytes in the first segment is a counter containing number of batches in the job. The first two bytes in the other blocks are undefined. The rest of each block is divided into groups of 8 bytes, each group containing one batch name and the status of the batch. One block can in this way contain 63 batch names with states (One block = 512 bytes: two bytes for counter or undefined, 510 bytes for names and states of 8 bytes = 63 names, rest 6 bytes). A name in a job (a batch name) is structured in the same way as a name in a library (see appendix A). The status of a batch in a job tells, if the batch is used for keying, rekeying or editing. T_ status = 0: the batch is not in use. status = 1: the batch is used for keying. status = 2: the batch is used for rekeying. status = 3: the batch is used for keying and rekeying. &_ status = 4: the batch is used for editing. \f F_ A_P_P_E_N_D_I_X_ _C_:_ _S_T_R_U_C_T_U_R_E_ _O_F_ _A_ _B_A_T_C_H_ A batch is a disc-file containing the records with the fields. The records are stored from the second block and forward in the file. The first block contains some information about the batch and is called the batch head. The batch is terminated by a batch end mark. Example: T_ block 0 block 1 block 2 block 3 block 4 block 5 &_batch head rec 1 rec 2 rec 3 rec 4 rec 5 rec 6 rec 7 batch end mark T_ C.1 B_a_t_c_h_ _H_e_a_d_ The contents of the batch head is: word 0-2: Job name: the name of the job, to which the &_ batch belongs. word 3-5: Format name: The name of the translated format to be used when keying, rekeying and editing the batch. word 6-8: Batch name. word 9: Batch status (see below). word 10: Byte count in old batch last block. word 11: Byte count in work batch last block. word 12: Block address of last register record. word 13: Byte address of last register record. word 14: Number of blocks in the batch inclusive the batch head. word 15: Number of data records in the batch. word 16: Number of rekeyed records. word 17: Number of invalid records. word 18: Activation time, real time clock 1. word 19: Activation tiem, real time clock 2. word 20: Block count in old batch. word 21: Block count in work batch. word 22: Name of current subformat. word 23: Current record number in old batch. word 24: Current record number in work batch. word 25: Maximum number of records in work batch. word 26: End format: = 100000DD8UU indicates thatthe\f 'end'-statement in the format is executed. The rest of the batch head is not in use yet, i.e. must all be zeroes. The batch status word is 16 bit, where the value of all the bits, except the last one (bit 15) gives a status: all bits = 0: the batch is empty bit 0 = 1: the batch is closed bit 1 = 1: the work batch is closed bit 2 = 1: the batch is editing. bit 3 = 1: the batch is rekeying. bit 4 = 1: the batch is keying. bit 5 = 1: the batch must be rekeyed (the parameter 'rekey' has been used in the 'set'-command). bit 6 = 1: the batch has been rekeyed. bit 7 = 1: the batch has been partial rekeyed. bit 8 = 1: the batch has been edited. bit 9 = 1: the batch has been saved by the supervisor program 'save'. bit 10 = 1: the batch has been dumped by the supervisor program 'dump'. bit 11 = 1: the batch has been transferred. bit 12 = 0: the batch is valid. bit 12 = 1: the batch is invalid, i.e. one or more fields are invalid. bit 13 = 1: the batch has been sorted. bit 14 = 1: the batch must be valid (the parameter 'valid' has been used in the 'set'-command). T_ C.2 R_e_c_o_r_d_s_ The are two types of records: data records containing the data which has been keyed to the batch, and register records, made by &_ NANNY as a copy of the register area, and is written in the batch for every 10 data records. T_ C.2.1 D_a_t_a_ _R_e_c_o_r_d_s_ A data record contains a record head, a number of fields and a &_ record end. \f T_ Example: ________________________________________________________________ rec. field 1 field 2 field 3 field 4 field 5 rec. &_ head end The contents of the record head is: byte 0: Subname: the name of the subformat used when keying the record. byte 1-2: The total record length. byte 3-4: Record number in the batch. byte 5: Record status: number of invalid fields in the record. byte 6: Rekeyed. byte 7-8: Block number of corresponding record in old batch. byte 9-10: Byte number of corresponding record in old batch. The contents of the record end is: byte 0: Subname the same as byte 0 in the record head. byte 1: Record and mark: one byte with the value 28DD10UU. The contents of a field is: byte 0: Field status: bit 7 = 1: invalid bit 7 = 0: valid bit 6 = 1: skip bit 5 = 1: skip by statement bit 5 = bit 6 = 0: not skip bit 0 = 0: transfer field bit 0 = 1: no transfer field byte 1 n: data (max 80 characters in ASCII code with values greater than 31DD10UU). byte n + 1: field end mark, value 27DD10UU. Fields with the status no transfer and fields with the lenght 0 are placed as the last fields in the record. T_ C.2.2 R_e_g_i_s_t_e_r_ _R_e_c_o_r_d_s_ A register record contains a record head, a register area and a &_ record end. \f T_ Example: ________________________________________________________________ rec. register area reg. head end &_ The contents of the record head is: byte 0: Subname, the ASCII character '?', value 63. byte 1-2: Total record length. byte 3-4: Record number in batch. byte 5-6: Not used for register records. byte 7-8: Block number of previous register record. byte 9-10: Byte number of previous register record. byte 11-12: Register top. byte 13-14: Number of rekeyed records. byte 15-16: Number of invalid records. The contents of the register area is: word 0: Pointer to length, and contents of register 01. word 1: Pointer to length, and contents of register 02. And so on to the last pointer to length, type, and contents of last register. After these pointers each register is described as follows: byte 0: Length of register X byte 1: Type of register X. 2 - n+1 pil byte 2 n+1: Contents of register X, n = the length of register X. The contents of the record end is: byte 0: Subname, the same byte 0 in the record head, i.e. '?'. byte 1: Record end mark: one byte with the value 28DD10UU. The register records may n_o_t_ be made by a supervisor program. They are made as checkpoints of the current state of the batch after keying a number of data records. T_ C.3 B_a_t_c_h_ _E_n_d_ _M_a_r_k_ &_ The batch end mark is one byte with the value 29DD10UU. \f The last bytes in a batch are then: T_ field 27DD10UU subname 28DD10UU 29DD10UU _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ ________________ field rec batch &_ end end end If the batch is empty the second block of the batch contains a batch end mark in the first byte, i.e. T_ batch head 29DD10UU ____________________ batch end &_ 1. block 2. block \f F_ A_P_P_E_N_D_I_X_ _D_:_ _D_I_A_G_R_A_M_ _O_F_ _H_O_W_ _T_O_ _U_S_E_ _T_H_E_ _C_O_D_E_ _P_R_O_C_E_D_U_R_E_ _'_R_E_T_U_R_N_'_ KOPI AF SKEMA FRA MANUSKRIPT SÆTTES IND HER! (side APP-D - se index - fotograferes ned til 16 cm i bredden)\f F_ C: The new input must be syntax checked: check = 0: yes check = 1: no O: A printout has been produced and must be copied to hardcopy device via spool-file or to supervisor key station display screen. printout = 0: no printout = 1: yes P: The number in parameter 'result' must be output after txt1 and txt2: outputres = 0: no outputres = 1: yes R1: These three places must be filled in as 4, 5, or 6. R2: The value of parameter 'textmode' gives the meaning of the contents of parameter 'text': textmode = 2: byte 1-80 of 'text' is a replace- command, i.e. a cll of another supervisor program. The command must be terminated by a null-character. textmode = 3: byte 1-80 of 'text' is a text (termi- nated by a null-character) to be output on the super- visor key station display instead of standard text(s). Byte 81-160 of 'text' is a replace-command (terminated by a null-character). \f F_ A_P_P_E_N_D_I_X_ _E_:_ _S_T_A_N_D_A_R_D_ _T_E_X_T_ _N_U_M_B_E_R_S_ In the Data Entry System the following texts with the corresponding numbers are available to be used in the code procedure 'return': Textnumber Text Textnumber Text 1 stop 26 length 2 printer27next 3 break28punch 4syntax29transmit 5batch30erase 6state31dte 7error32tape ser 8magtape33number 9load err34file gen 10** supv35informa 11not name36real seq 12ok37block 13cf list38factor 14cf list;39load 15disc40table 16file41full 17ident42printout 18unknown43in use 19exist44format 20no room45job 21name46subprogr 22chars47disctabl 23copied48reader 24not49library 25record\f F_ A_P_P_E_N_D_I_X_ _F_:_ _P_R_O_G_R_A_M_ _E_X_A_M_P_L_E_ _V_O_L_U_M_E_ This program example shows the communication between the program and the operator by using the code procedures 'get command' and 'return'. The program returns only with 'action' = continue, i.e. no check of the new input shall be made, and therefore the code procedure 'get parameter' is not used. This is done because the operator may key letters as well as digits after the text 'magtape number =' has appeared on the display screen, so the new input may not fullfil the syntax rules. In the giveup-procedure for magtape, procedure 'mterror', is zmode set to zero before the jump to the call of CLOSE, which will release the driver process if an error on the magtape occurs. \f F_ HER FØLGER 5 SIDER MED UDSKRIFTER\f F_ A_P_P_E_N_D_I_X_ _G_:_ _P_R_O_G_R_A_M_ _E_X_A_M_P_L_E_ _D_U_M_P_ This program example shows how to use all the standard code pro- cedures except procedure allaccess (this is used in the same way as procedure access), and it shows how to make a printout by 'outtext'. The main program starts by getting the command line into 'com- line'. Then it initializes all the error-counters to 4. When a zone is opened the corresponding error-counter is set to zero and when the zone is closed, it is set to 4 again. The parameter in 'comline' is received by calling the code pro- cedure 'get parameter ' (gtpm). First call gives the name of the printout file and it is saved in 'lname', which is used in the call of code procedure 'connect file' (connec). Most of the texts written with 'outtext' are constant texts spe- cified in the constant section of the program. They are termi- nated by invisible null-characters and 'outtext' will therefore stop on these null-characters. But if a constant string is moved to another string, this null-character is lost and must be in- serted as the last character. When writing the constant line 'headline' the name from the command line is inserted and to be sure that eventual null-characters in the name will not stop 'outtext' the procedure 'outname' is called to change the null- characters to spaces. When all of the batches in a job must be dumped, the job is opened and the batch names are found one by one by calling the code procedure 'get next item' (getnext). If the zone has not been destroyed between two calls, the parameter 'res' (correspon- ding to 'status') must be 1 before the call (i.e. if the batch does not exist as a disc-file or if the batch is used by another key station). The procedure 'dumpbatch' opens the batch and checks the batch head. Then it reads the data in the batch by calling the code procedure 'access' (acces), and when a new block is read, the program must wait some timer-periods by calling the code proce- dure 'delay'. Before running to the Supervisor by calling the code procedure 'return' (retur) the program must release all drivers and area processes, but only if the error-counter is smaller than 4. This\f will avoid a program loop if an error has occured. Then the pa- rameter 'rtext1' (corresponding to 'action') is packed and the call of 'return' will continue = 0 will return to the Supervisor. \f F_ HER FØLGER 15 SIDER MED UDSKRIFTER FRA LISC \f F_ A_P_P_E_N_D_I_X_ _H_:_ _R_E_F_E_R_E_N_C_E_S_ 1. MUSIL Programming Guide, RCSL 42-i 0344 2. Data Entry, Release 2, Users Guide, part 2 RCSL 43-GL 4796 \f F_ APPENDIX I I_N_D_E_X_ The references are pointing out page numbers. access.............................................4, 12, 13, 14, G-1 action............................................. 9, 25, F-1, G-1 adding new supervisor programs (see PUT) allac (see allaccess) allaccess.......................................... 4, 14, 15, G-1 apostrophe......................................... 7 ASCII code......................................... 24 batch.............................................. 3 - creation (see create batch).................. - end mark..................................... 3, 14, C-1, C-5 - head......................................... 3, 27, C-1 - name........................................27, C-1 - status....................................... 27, B-1, C-1, C-2 - structure.................................... C-1 - termination (see batch end mark)............. block..............................................15, 23 bufaddr............................................ 21 catalog entry...................................... 15 check..............................................9, 10, 25, D-1, D-2 close devices/processes............................25, 26, F-1 cmnd (see get command) code procedure, standard...........................5 coding of supervisor programs......................4 combine............................................5, 7, 29, G-1 command line.......................................4 - line, empty................................6,8 connec (see connectfile) connectfile........................................ 4, 6, 15, 24, G-1 cont............................................... 9, 10, 11, 25, 29,D-1 continue execution (see cont) control characters................................. 25 core tables (see table(s)) create batch....................................... 27 create entry....................................... 15 (husk at rette sidenummereringen før genoptryk !!!!!!!!!!!!!!!!!)\f data records....................................... 3, C-3 decimal numbers.................................... 7 delay.............................................. 21, G-1 delayed............................................ 21 delete in library (see library, delete) - item (see library, delete) device name........................................ 15, 23 differences, allaccess and access.................. 14 disc files......................................... 2 - table......................................... 2 - - library................................. 2, 18 DTLIB (see disc table library) DUMPSTAT.......................................... 29 EDIT............................................... 28 empty command line................................. 6, 8 end medium......................................... 24, 25 error counter...................................... 26, G-1 error procedures................................... 26 extraword.......................................... 17, 18, 19, 20 FBLIB (see format library) field.............................................. 13, 15, 28 - end mark..................................... 28, C-4 - status....................................... 13, 14, 28, C-4 - structure.................................... C-4 file..15, 23 - descriptor.................................... 15 find item.......................................... 4, 16, A-1 fitem (see find item) format............................................. 2 - library..................................... 2, 18 - name........................................ 27, C-1 get command........................................ 4, 5, 21, 29, F-1 - new input...................................... 8, 10, D-1 getnex (see get next item) get next item...................................... 4, 19, G-1 - parameter...................................... 4, 6, 16, 24, 29, F-1, G-1 give up mask....................................... 15, 23 - - procedure (see error procedure) gtpm (see get parameter) \f T_hard copy device................................... 4, 6, 10, 15, 22, &_ 23, 24, 25, D-2 HCOPY.............................................. 23 HCPT............................................... 23 HCPT1.............................................. 23 HLPT............................................... 23 HLPT1.............................................. 23 HSP................................................ 23 HSP1............................................... 23 HTTY............................................... 23 insert in library (see library, insert) - item (see library, insert) install new programs (see PUT) integer parameter................................. 6, 8 item............................................... 6, 7, 24 JBLIB (see job library) job................................................ 2, 3, 19 - library........................................ 2, 3, 18, 27 - name........................................... 27, C-1 -, read........................................... 18 - structure...................................... B-1 kind............................................... 7, 8, 15, 23 last parameter (see termination) length............................................. 16, 17, 18, 19 - , printout line.............................. 24 library............................................ 2, 17, 19 - , delete.................................... 4, 16 - , insert.................................... 4, 16 - , lookup.................................... 4 - , read...................................... 18, 19 - , search.................................... 4, 16 - , structure................................. A-1 LISTLOG............................................ 29 log file........................................... 29 lookup in library (see library, lookup) mess3.............................................. 5, 21 message address.................................... 5 mode............................................... 15, 23 MUSIL compiler..................................... 4 - programming.................................. 4 \f T_name............................................... 15, 16, 17, 18, 19, &_ 20, A-1 name definition.................................... A-1 NANNY.............................................. 21 new input (see get new input) - line........................................... 25 - supervisor program (see PUT) no text............................................ 9, D-1 - transfer field.................................. 12, 14, 28 null character..................................... 6, 7, 11, 14, 18, 24, D-2 number............................................. 13, 14 - , decimal.................................... 7 - , octal...................................... 7, 9 octal number....................................... 7, 9 open printout (see connect file) operator communication............................. 29 optype............................................. 16, 17 outmode............................................ 15, 16 output device for printout (see printout) outputres.......................................... 9, 11, 25, D-1, D-2 outtext............................................ 24, 25, G-1 parameter.......................................... 4 - , integer................................. 6, 8 - , last (see termination) - , termination............................. 6 - , terminator.............................. 6 - , text.................................... 6, 8 - , type.................................... 6 period............................................. 6, 8 printer............................................ 23 printout........................................... 6, 9, 10, 12, 15, 16, 22, 24, 25, D-1, D-2 - , conversion............................... 24 - file name................................. 7 - line, length.............................. 24 print, open (see connect file) program example.................................... F-1, G-1 - termination................................ 25 PUT................................................ 4, 30 read batch end mark................................ 14 \f read field......................................... 4, 12, 13 - - status.................................. 13 - in job (see job, read) read in library (see library, read) - record end....................................14 - - head...................................13 - - status.................................13 - subformat name................................13 receipt (see return) receive command line (see get command) record.............................................3, C-3 - , data (see data records) - end mark....................................14, 28, C-3, C-4, C-5 - head........................................3, 13, 27, 28, C-3, C-4 - , register (see register records) - status..................................... 3, 13, 14, 27, C-3 - structure................................... C-3 register area...................................... C-5 - records................................... 3, 12, 28, C-4 release devices/processes.......................... 25 reloctable binary object code...................... 4 remove process..................................... 8 replace current supervisor program................. 11, 12, D-1, D-2 result............................................. 9, 11, 17, 18, D-1, D-2 return............................................. 4, 5, 8, 9, 21, 25, 29, E-1, F-1, G-2 search in library (see library, search) - item (see library, search) semaphore function................................. 9, 10 - ident.................................... 10 - , signal.................................. 10, D-1 - , wait.................................... 10, D-1 sep................................................ 7 signal semaphore (see semaphore, signal) skip register records (see access) slow down.......................................... 4, 21 space.............................................. 6, 8 special actions.................................... 9 SPLIB (see subprogram library) spool file......................................... 23, 25, D-2 SPOOL NEWDEVICE.................................... 23 standard code procedures........................... 5 - text...................................... 9, 10 \f standard text number............................... E-1 - - output............................... D-1 T_status............................................. 13, 14, 15, 19, 20, &_ G-1 status word........................................ 3 subformat name..................................... 27, 28, C-1, C-3, C-4, C-5 subname............................................ 13, 14, 15 subprogram......................................... 2 - library................................. 2, 18 syntax check....................................... 5, 10, 29 SUPERVISOR......................................... 21 supervisor display................................. 4, 6, 10 SUPERVISOR SLOW.................................... 21 table.............................................. 2 - library..................................... 2, 18 TBLIB (see table library) termination........................................ 6, 8, 11, D-1 - , batch................................. 3 - , program............................... 26 terminator, parameter.............................. 6, 8 text............................................... 9, 10, 11, D-1, D-2 textmode........................................... 9, 11, 26, D-1, D-2 text parameter..................................... 6, 8 timer period....................................... 21 transfer field..................................... 13 TTY................................................ 23 txt1............................................... 9, D-1, D-2 - 2............................................... 9, 10, D-1, D-2 type, parameter.................................... 6 value.............................................. 6, 7, 24 wait semaphore (see semaphore, wait) - , timer periods................................ 21 work file.......................................... 15, 24, 25 z.................................................. 13, 15, 16, 17, 19 \f \f i T_A_B_L_E_ _O_F_ _C_O_N_T_E_N_T_S_ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _P_A_G_E_ 1. INTRODUCTION ........................................... 1 2. INSTALLATION ........................................... 2 \f ii \f 1_._ _ _ _ _ _ _ _ _I_N_T_R_O_D_U_C_T_I_O_N_ 1. The present issue of MailMerge 3.0 has been adapted for use on your RC700 Microcomputer System. The MailMerge option for WordStar 3.0 contains the following: - This manual "MailMerge for the RC700 Microcomputer System, In- stallation Guide". - MicroPro's dokumentation of MailMerge: - Sections No 9, 10 and 11 of the "WordStar, Reference Manual". - A diskette containing the MailMerge option to WordStar. Do not write on the original distribution diskette as it is your master copy and serves as last back-up in case of grave errors. \f F_ 2_._ _ _ _ _ _ _ _ _I_N_S_T_A_L_L_A_T_I_O_N_ 2. Start by making a copy of the original distribution diskette. Transfer the files from the MailMerge distribution diskette to a diskette containing your WordStar 3.0 system. No further instal- lation or modification is necessary. \f i T_A_B_L_E_ _O_F_ _C_O_N_T_E_N_T_S_ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _P_A_G_E_ 1. INTRODUCTION .......................................... 1 2. CONTROLS .............................................. 2 3. OPERATING PROCEDURES .................................. 5 4. GENERAL KEYBOARD DESCRIPTION .......................... 7 4.1 Character Keys ................................... 7 4.2 Program Controlled Keys .......................... 7 4.3 Local Control Keys ............................... 8 5. RC822 KEYBOARD ........................................ 9 5.1 Program Controlled Keys .......................... 9 5.2 Local Control Keys ............................... 9 6. RC828 KEYBOARD ........................................ 12 6.1 Program Controlled Keys .......................... 12 6.2 Local Control Keys ............................... 12 \f ii \f 1_._ _ _ _ _ _ _ _ _I_N_T_R_O_D_U_C_T_I_O_N_ 1. Figure 1: Visual display unit and keyboard. The consoles/terminals described in this operating guide are all based on the same type of visual display unit whereas the key- boards have a different layout and different function keys depending on the specific RC product number of the console/ terminal. The visual display unit is referred to as VDU. \f F_ 2_._ _ _ _ _ _ _ _ _C_O_N_T_R_O_L_S_ 2. Figure 2: Controls. POWER ON/OFF - a mains power switch is located at the left side of the VDU. In console applications the switch can be switched to its ON position, and left in the ON position, at the first time of operation. The VDU will then be switched on/off as the system is switched on/off. 1) Switch selectors - when pressed inwards the features are selected as described below. The switches are self-locking, to deselect the features, press once more. \f TAPE - for maintenance purpose only. Causes all recieved characters to be displayed including control characters. The tape key on some keyboards provide the same function. FULL DUP - in-position : full duplex; out-position: half duplex. DATA RATE - the switch provides selection between two preset communications speeds. Usually to be left untuched by the operator as the setting is part of the overall system tuning (deter- mined by software). EIA - for maintenance purpose only. In-position selects EIA (or V.24) signals. 2) Indicators - when an indicator is lit, the following is ment: CD (Carrier Detect): a feature of the communications equipment, showing that the connection is established. RS (Ready to Send): like the CD indicator, but showing readiness for transmitting from the keyboard. Both the CD and the RS indicator should be lit, when the terminal is on-line. \f 3) Display Screen Controls - adjustment of brightness and contrast are provided by these two control knobs. - knob closest to the front side: controls the brightness of the displayed characters. (Sometimes labelled BRIGHTNESS.) - knob closest to the rear side: controls the contrast in displaying characters. (Sometimes labelled CONTRAST.) 4) Loudspeaker Adjustment - the knob is used to adjust the loudness of the acoustic signal from the loudspeaker. The acoustic signal is heard when receiving a BELL code. \f F_ 3_._ _ _ _ _ _ _ _ _O_P_E_R_A_T_I_N_G_ _P_R_O_C_E_D_U_R_E_S_ 3. Turn on the mains power with the POWER ON/OFF switch. When applied as a console, the power can be controlled via the system if the POWER ON/OFF switch is left in the ON position after first time of operation. The selector switches should normally be positioned as follows: TAPE : out-position FULL DUP : in-position, or according to specification DATA RATE : according to specification EIA : in-position At the time the communications facilities are available for use, the CD and ultimately the RS indicators will light. As long as the terminal is on-line, these indicators should light. How to access the system and further information regarding terminal operations will be found in the publications concerned with software systems and applications. In a first-time operating situation and whenever convenient at start of operations the following check procedures are performed: 1. The display is checked by switching the FULL DUP selector to its out-position, then select any of the character keys and hold that key pressed down along with pressing down the REPT key. The screen should now be filled up with that character. (Note: After checking, restore FULL DUP selector to correct posi- tion.) Applicable to RC822 only. \f 2. Adjust the brightness control until the raster is no longer visible and then adjust the contrast control for the most pleasing presentation. A moment spent on determining the optimum setting for both brightness and contrast controls is well spent, since this will reduce operator fatique. Remember though, that the setting may need to be changed as the ambient light level changes. Adjustments of brightness and contrast are provided by the control knobs located at the right side of the terminal. \f F_ 4_._ _ _ _ _ _ _ _ _G_E_N_E_R_A_L_ _K_E_Y_B_O_A_R_D_ _D_E_S_C_R_I_P_T_I_O_N_ 4. The keyboards differ with respect to the RC product number. The different types of keyboards used with the VDU are described in the chapters following. Commen to all keyboards is the presence of three types of keys: - the character keys, - the program controlled keys, and - the local control keys. 4_._1_ _ _ _ _ _ _ _C_h_a_r_a_c_t_e_r_ _K_e_y_s_ 4.1 The character keys are functioning as on an ordinary typewriter, i.e. pressing a key will transmit the character to the system in accordance with the engraving on the key cap. Also the keyboard layout is like that of a typewriter. Different layouts may appear, depending on the national character set applied. 4_._2_ _ _ _ _ _ _ _P_r_o_g_r_a_m_ _C_o_n_t_r_o_l_l_e_d_ _K_e_y_s_ 4.2 It is important to note that the functions of the program con- trolled keys will differ from system to system. Specific infor- mation regarding function and usage should be found in the publi- cations covering software systems and applications. The program controlled keys are mentioned for each type of console/terminal as they appear in general on that type regardless of possible options. \f 4_._3_ _ _ _ _ _ _ _L_o_c_a_l_ _C_o_n_t_r_o_l_ _K_e_y_s_ 4.3 The local control keys are provided in order to enable usual typewriter functions, cursor controlling, etc. Note that a general-purpose terminal contains few program controlled keys and many local control keys opposite to a data entry terminal which contains many program controlled keys and few local control keys. Some of the local control keys (especially the cursor control keys) may as well be affected by the software system applied. \f F_ 5_._ _ _ _ _ _ _ _ _R_C_8_2_2_ _K_E_Y_B_O_A_R_D_ 5. 5_._1_ _ _ _ _ _ _ _P_r_o_g_r_a_m_ _C_o_n_t_r_o_l_l_e_d_ _K_e_y_s_ 5.1 ESCAPE LINE FEED RETURN RUB OUT- function determined by the software BREAK system. BACK SPACE CTRL - used to generate control codes which are not directly provided on the keyboard by assigned keys. The CRTL key is pressed down and kept in the down-position, at the same time an alphanumeric key is pressed down - a control code cor- responding to that alphanumeric character will then be transmitted. The alphanumeric character which has to be used as well as the func- tions which are caused, are deter- mined by the software. 5_._2_ _ _ _ _ _ _ _L_o_c_a_l_ _C_o_n_t_r_o_l_ _K_e_y_s_ 5.2 SHIFT - this key, in conjunction with alphabetic or numeric keys, will select the upper legend or the upper-case character form. ALPHA LOCK - when locked in the down position, the key will select the upper-case character legends with no effect on the numeric keys. The key is self- locking, to release press once more. \f REPT (R_e_p_eat_) - when pressed down and kept in the down position, any other character key may be pressed down at the same time and that character will be repeatedly generated as long as engaged. HOME - will return cursor to the >home> position (first character, first line). -' - causes the cursor to advance one (FORWARD CURSOR) character position to the right. If there are no character positions left to the right, the cursor will advance to the first character position of the next line. The cursor control codes (FORWARD CURSOR and the following codes) are non-destruct codes, i.e. the cursor may pass an >occupied> position without deleting the character of that position. <- - as FORWARD CURSOR, but to the left. (BACK CURSOR) - causes the cursor to move up one (UP ROW CURSOR) row. Reaching the first row the cursor remains there. - as UP ROW CURSOR, but downwards. (DOWN ROW CURSOR) Reaching the last row the cursor will move the data up one row, leaving the last row blank. \f TAB - horizontal tab, usually fixed to every fourth character position. Tab positions are fixed and do not depend on the start position of the cursor. ERAS EOL - this code will erase all data from (E_r_a_s_e to E_nd o_f L_ine) cursor position to end of line. ERAS EOS - this code will erase all data from (E_r_a_s_e to E_nd o_f S_creen) cursor position to end of screen. CLEAR - this code will erase all data and home the cursor. PRINT - this code will cause all received and transmited data to be directed to the printer output. The connecting of a terminal printer to the display terminal is available as an option. PRINT OFF - this code will remove the printer output connection. TAPE - for maintenance purposes only. Self-locking key - to release press once more. Causes all received character to be displayed including control charac- ters. LOAD TAPE - for maintenance purposes only. \f F_ 6_._ _ _ _ _ _ _ _ _R_C_8_2_8_ _K_E_Y_B_O_A_R_D_ 7. 6_._1_ _ _ _ _ _ _ _P_r_o_g_r_a_m_ _C_o_n_t_r_o_l_l_e_d_ _K_e_y_s_ 7.1 ESCAPE CLEAR SUB FORM DUP CHAR REC - function determined by software FIELD system. REC REL ERROR REL ENTER BY-PASS RECORD LOG IN 6_._2_ _ _ _ _ _ _ _L_o_c_a_l_ _C_o_n_t_r_o_l_ _K_e_y_s_ 7.2 SHIFT - this key, in conjunction with alpha- betic or numeric keys, will select the upper lengend or the upper-case character form. SHIFT LOCK - when locked in the down position, the key will select the upper-case character legends. The key is self- locking, to release press once more. \f «eof»