|
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: 8832 (0x2280)
Types: RcTekst
Names: »31-D718.WP«
└─⟦b9fe312e5⟧ Bits:30008868 Diskette med 3 stk RCSL-30-M og 3 stk RCSL-31-D
└─⟦this⟧ »31-D718.WP«
╱0400274e0c0006000000000301483160000000000000000000000000000000000000000000000000050a0f14191e23282d32373c41464bff04╱
┆06┆i↲
↲
╞ ╞ ┆a1┆┆b0┆Foreword↲
↲
╞ ╞ ┆84┆In RC8000 Basis System Version 2 (SW8001/2/2.0), a new facility ↓
┆19┆┆89┆┄┄is introduced on terminal processes:↲
╞ ╞ ┆84┆all the various parameters controlling the actual device hand-↓
┆19┆┆89┆┄┄ling have become available to RC8000 users, on an easy message-↓
┆19┆┆89┆┄┄basis. Previously, the program initamx had to be used.↲
↲
╞ ╞ ┆84┆The program termspec gives an easy access to the new facili┄↓
┆19┆┆89┆┄┄ties.↲
↲
↲
╞ ╞ Carl Henrik Dreyer↲
╞ ╞ A/S Regnecentralen, March 1984.↲
↲
════════════════════════════════════════════════════════════════════════
↓
┆06┆ii↲
════════════════════════════════════════════════════════════════════════
↓
┆06┆iii↲
↲
┆a1┆┆b0┆TABLE OF CONTENTS┆05┆PAGE↲
↲
┆b0┆┆f0┆┆b0┆1. INTRODUCTION ┆f0┆......................................................1↲
↲
┆f0┆┆f0┆┆b0┆┆f0┆┆b0┆2. EXAMPLES ┆f0┆..........................................................2↲
↲
┆b0┆┆f0┆┆b0┆3. CALL ┆f0┆..............................................................3↲
↲
┆b0┆┆f0┆┆b0┆4. FUNCTION ┆f0┆..........................................................5↲
↲
┆b0┆┆f0┆┆b0┆5. PARAMETERS ┆f0┆........................................................6↲
↲
┆b0┆┆f0┆┆b0┆6. FORMAT OF THE OUTPUT ┆f0┆..............................................7↲
↲
┆b0┆┆f0┆┆b0┆7. ERROR MESSAGES ┆f0┆....................................................8↲
↲
↲
┆b0┆APPENDIX↲
↲
┆b0┆┆f0┆┆b0┆A. REFERENCES ┆f0┆........................................................9↲
════════════════════════════════════════════════════════════════════════
↓
┆06┆iv↲
↲
↲
↲
↲
↲
↲
════════════════════════════════════════════════════════════════════════
↓
┆14┆┆b3┆┆06┆┆0b┆↲
↲
┆a1┆┆b0┆1.╞ ╞ INTRODUCTION↲
↲
╞ ╞ ┆84┆The program is intended for reading and changing the terminal ↓
┆19┆┆89┆┄┄specifications on terminals connected to RC8000 via a Device ↓
┆19┆┆89┆┄┄Controller and an FPA connection. This covers normal terminals ↓
┆19┆┆89┆┄┄connected via AMX as well as consoles, when the Device ↓
┆19┆┆89┆┄┄Controller is running the NCP program (may be either local ↓
┆19┆┆89┆┄┄Front End or Remote via RCNET). As the program uses the RC8000 ↓
┆19┆┆89┆┄┄process description for the terminal, it is required that the ↓
┆19┆┆89┆┄┄terminal is connected to the RC8000, i.e. a LINK exists.↲
↲
╞ ╞ ┆84┆Terminal specifications are described in "RC8000 terminal ↓
┆19┆┆89┆┄┄process, SW8001/2". (1).↲
↲
↲
════════════════════════════════════════════════════════════════════════
↓
┆a1┆┆b0┆2.╞ ╞ EXAMPLES.↲
↲
╞ ╞ ┆84┆The FP-command:↲
╞ ╞ ╞ termspec↲
╞ ╞ ┆84┆will display the specifications of the terminal being primary ↓
┆19┆┆89┆┄┄output to the process.↲
↲
╞ ╞ The FP-command:↲
╞ ╞ ╞ termspec normal↲
╞ ╞ ┆84┆will change the specifications of the primary output terminal ↓
┆19┆┆89┆┄┄to the ones normally used.↲
↲
╞ ╞ The FP-command:↲
╞ ╞ ╞ termspec prom.42↲
╞ ╞ ┆84┆will change the specifications of the primary output terminal, ↓
┆19┆┆89┆┄┄giving the prompt the character value 42 (an asterisk).↲
↲
╞ ╞ The FP-command:↲
╞ ╞ ╞ termspec sub0207↲
╞ ╞ ┆84┆will display the specifications of the terminal described in ↓
┆19┆┆89┆┄┄RC8000 as an external process named "sub027".↲
↲
╞ ╞ The FP-command:↲
╞ ╞ ╞ termspec 0↲
╞ ╞ ┆84┆is syntactically incorrect, and the program will display a ↓
┆19┆┆89┆┄┄short survey of the call syntax.↲
↲
↲
════════════════════════════════════════════════════════════════════════
↓
┆a1┆┆b0┆3.╞ ╞ CALL↲
↲
╞ ╞ ╞ ╞ ╞ ╞ ╞ normal↲
╞ ╞ ╞ ╞ ╞ ╞ ╞ conv.<yesno>↲
╞ ╞ ╞ ╞ ╞ ╞ ╞ cont.<yesno>↲
╞ ╞ ╞ ╞ ╞ ╞ ╞ echo.<yesno>↲
0╞ soft.<yesno>↲
╞ ╞ ┆81┆termspec (<proc.name>) ┆82┆╞ type.<table>↲
╞ ╞ ╞ ╞ ╞ ╞ ┆81┆ 1┆82┆ ┆82┆disa┆81┆↲
╞ ╞ ╞ ╞ ╞ ╞ ╞ ╞ att.↲
╞ ╞ ╞ ╞ ╞ ╞ ╞ ╞ ╞ ┆81┆ena┆82┆↲
╞ ╞ ╞ ╞ ╞ ╞ ╞ ╞ prom.<char>↲
╞ ╞ ╞ ╞ ╞ ╞ ╞ ╞ flow.<fe>↲
╞ ╞ ╞ ╞ ╞ ╞ ╞ ╞ ┆82┆1┆81┆↲
╞ ╞ ╞ ╞ ╞ ╞ ╞ ╞ stop.↲
╞ ╞ ╞ ╞ ╞ ╞ ╞ ╞ ╞ ┆81┆2┆82┆↲
╞ ╞ ╞ ╞ ╞ ╞ ╞ ╞ pari.<parity>↲
╞ ╞ ╞ ╞ ╞ ╞ ╞ ╞ time.<secs>↲
╞ ╞ ╞ ╞ ╞ ╞ ╞ ╞ char.<charbits>↲
╞ ╞ ╞ ╞ ╞ ╞ ╞ ╞ rate.<bps>(.<bps>)↲
╞ ╞ ╞ ╞ ╞ ╞ ╞ ╞ set.<index>.<shift>.<bits>.<value>↲
╞ ╞ ╞ ╞ ╞ ╞ ╞ ╞ test↲
↲
↲
╞ ╞ <proc.name> ::= name of RC8000 terminal process↲
╞ ╞ ╞ ╞ ╞ yes↲
╞ ╞ ╞ ╞ ╞ ┆81┆y┆82┆↲
╞ ╞ <yesno> ::= no↲
╞ ╞ ╞ ╞ ╞ ┆81┆n┆82┆↲
╞ ╞ <table> ::= integer in the range 0 - 9↲
╞ ╞ <char> ::= integer in the range 0 - 255↲
╞ ╞ ╞ ╞ ╞ no↲
╞ ╞ <fe> ::= io↲
╞ ╞ ╞ ╞ ╞ in↲
╞ ╞ ╞ ╞ ╞ out↲
↲
odd↲
╞ ╞ <parity>::= eve↲
╞ ╞ ╞ ╞ ╞ no↲
↲
════════════════════════════════════════════════════════════════════════
↓
╞ ╞ <secs> ::= integer in the range 0 - 255↲
╞ ╞ ╞ ╞ ╞ 5↲
╞ ╞ ╞ ╞ ╞ 6↲
╞ ╞ <charbits>::= 7↲
╞ ╞ ╞ ╞ ╞ 8↲
╞ ╞ <bps> ::= ┆84┆integer, one of the following values: 9600, ↓
┆19┆┆99┆┄┄4800, 2400, 1200, 600, 300, 220, 200, 150, 134, ↓
┆19┆┆99┆┄┄110, 75, 50, 40.↲
↲
╞ ╞ <index> ::= integer in the range 2 - 8.↲
╞ ╞ <shift> ::= integer in the range 0 - 23.↲
╞ ╞ <bits> ::= integer in the range 1 - 24.↲
╞ ╞ <value> ::= integer, any value.↲
↲
════════════════════════════════════════════════════════════════════════
↓
┆a1┆┆b0┆4.╞ ╞ FUNCTION.↲
↲
╞ ╞ ┆84┆The process specified by <proc name> is found, and selected ↓
┆19┆┆89┆┄┄parts of the process description are displayed.↲
╞ ╞ ┆84┆Default is the name of the primary output process to the job ↓
┆19┆┆89┆┄┄process.↲
↲
╞ ╞ ┆84┆If the process specified is not the primary output process, it ↓
┆19┆┆89┆┄┄is required that processkind is 84 or 85 (permanent or tempo┄┄↓
┆19┆┆89┆┄┄rary link), that the subkind is 8 (terminal), and that the job ↓
┆19┆┆89┆┄┄process has function bit 5 set (remove peripheral process), ↓
┆19┆┆89┆┄┄otherwise an error message is given. ↲
╞ ╞ ┆84┆A get-specification message is sent to the process.↲
╞ ╞ ┆84┆If parameters for changing specifications are stated, they are ↓
┆19┆┆89┆┄┄encoded.↲
┆84┆Now a set-specification message is sent to the process, fol┄↓
┆19┆┆89┆┄┄lowed by a get-specification message to get the resulting ↓
┆19┆┆89┆┄┄specifications. If the parameter "test" is stated, no set-↓
┆19┆┆89┆┄┄specification message will be sent, instead a testoutput is ↓
┆19┆┆89┆┄┄displayed concerning the specifications obtained and the speci-↓
┆19┆┆89┆┄┄fications changed as stated.↲
↲
╞ ╞ ┆84┆Finally the terminal specifications are displayed, including ↓
┆19┆┆89┆┄┄possible changes.↲
↲
════════════════════════════════════════════════════════════════════════
↓
┆a1┆┆b0┆5.╞ ╞ PARAMETERS↲
↲
╞ ╞ ┆84┆Most of the parameters are obviously related to the descrip-↓
┆19┆┆89┆┄┄tion in "RC8000 terminal process, SW8001/2", where details may ↓
┆19┆┆89┆┄┄be found (1). Parameters and corresponding changes are perform┄↓
┆19┆┆89┆┄┄ed in the order they are stated.↲
↲
╞ ╞ normal :╞ ┆84┆Equivalent to the parameters conv.yes cont.no ↓
┆19┆┆93┆┄┄echo.yes soft.yes type.1 prom.7 flow.no time.60.↲
╞ ╞ conv :╞ ┆84┆Set/reset the upper case conversion facility.↲
╞ ╞ cont :╞ ┆84┆Set/reset the continued-input facility.↲
╞ ╞ echo :╞ Enable/disable of echo.↲
╞ ╞ soft :╞ Set/reset soft parity check.↲
╞ ╞ type :╞ Index for input-output conversion tables.↲
╞ ╞ att : Enable/disable attention.↲
╞ ╞ prom : ┆84┆Character value of prompt. If = 0, no prompt is sent.↲
╞ ╞ flow : ┆84┆Flow control selection : no = no flow control, io = ↓
┆19┆┆93┆┄┄both on input and output, in = input only, out = ↓
┆19┆┆93┆┄┄output only.↲
╞ ╞ stop :╞ Set number of stopbits.↲
╞ ╞ pari : ┆84┆Set parity check : odd = odd parity, eve = even ↓
┆19┆┆93┆┄┄parity, no = no parity check.↲
╞ ╞ time : Set input timeout value.↲
╞ ╞ char : Set character length, in bits.↲
╞ ╞ rate : ┆84┆Set linespeed. If one parameter is stated, both input ↓
┆19┆┆93┆┄┄and output speed is set to this. If two parameters ↓
┆19┆┆93┆┄┄are stated, it means rate.<receiver bps>.<sender ↓
┆19┆┆93┆┄┄bps>↲
╞ ╞ set : ┆84┆Used for setting non-described bitmasks in set-speci-↓
┆19┆┆93┆┄┄fication message. <value> is inserted in mess ↓
┆19┆┆93┆┄┄(<index>), in the bit positions from (1 shift ↓
┆19┆┆93┆┄┄<shift>) to (1 shift (<shift>+<bits>)).↲
╞ ╞ test : ┆84┆Used to check the final contents of get- and set-spe-↓
┆19┆┆93┆┄┄cification messages. The set-specification message is ↓
┆19┆┆93┆┄┄avoided.↲
════════════════════════════════════════════════════════════════════════
↓
┆a1┆┆b0┆6.╞ ╞ FORMAT OF THE OUTPUT DISPLAYED↲
↲
╞ ╞ ┆84┆┆84┆The ┆a1┆first┆e1┆ line of output shows selected parts of the terminal ↓
┆19┆┆89┆┄┄process description:↲
↲
╞ ╞ <proc>:╞ ┆84┆jobhost=<jh>(<jhl>) devhost=<dh>(<dhl>) hws=<hws> ↓
┆19┆┆93┆┄┄kind=<k>(<sk>)↲
↲
╞ ╞ where:↲
╞ ╞ <proc>╞ name of terminal process↲
╞ ╞ <jh>╞ ╞ jobhost ident, i.e. RC8000 ident↲
╞ ╞ <jhl>╞ jobhost linkno, i.e. device number in RC8000↲
╞ ╞ <dh>╞ ╞ devicehost ident, i.e. ident of the Device Controller↲
╞ ╞ <dhl>╞ ┆84┆devicehost linkno, i.e. device number in the Device ↓
┆19┆┆93┆┄┄Controller↲
╞ ╞ <hws>╞ link buffer size, in halfwords↲
╞ ╞ <k>╞ ╞ ┆84┆process kind (in RC8000 monitor). 84 is permanent ↓
┆19┆┆93┆┄┄link via FPA. 85 is temperary link via FPA↲
╞ ╞ <sk>╞ ╞ subkind (in RC8000 monitor). 8 is terminal↲
↲
╞ ╞ ┆84┆If process kind is not 84 or 85, only <proc>, <jh> and <k> are ↓
┆19┆┆89┆┄┄output.↲
↲
╞ ╞ ┆84┆The ┆a1┆second┆e1┆ and ┆a1┆third┆e1┆ lines show the resulting terminal specifi-↓
┆19┆┆89┆┄┄cations, written in the same format as the FP-parameters.↲
↲
════════════════════════════════════════════════════════════════════════
↓
┆a1┆┆b0┆7.╞ ╞ ERROR MESSAGES↲
↲
╞ ╞ ┆84┆Any error message will set the FP mode bits:↲
╞ ╞ ╞ ok.no, warning.yes.↲
↲
╞ ╞ ***termspec syntax : <param> correct syntax is:↲
╞ ╞ (a short survey of call syntax)↲
╞ ╞ The parameter in <param> is incorred.↲
↲
╞ ╞ ***termspec sorry : not found:<proc>↲
╞ ╞ The terminal process <proc> cannot be found.↲
↲
╞ ╞ ***termspec sorry : not terminal↲
╞ ╞ ┆84┆The process description of the terminal process does not ↓
┆19┆┆8c┆┄┄indicate that it is a terminal, after all.↲
↲
╞ ╞ ***termspec sorry : no sepcs at: <proc> result <r> <s>↲
╞ ╞ Not-ok answer to get-specification message.↲
╞ ╞ <r> is result, <s> is status word.↲
↲
╞ ╞ ***termspec sorry : specs not set at: <proc> result <r> <s>↲
╞ ╞ Not-ok answer to set-specification message.↲
╞ ╞ <r> is result, <s> is status word.↲
↲
╞ ╞ ***termspec sorry : function bit 5 required.↲
╞ ╞ Function bit 5 is required when changing↲
╞ ╞ specifications of a terminal which is not primary output.↲
↲
════════════════════════════════════════════════════════════════════════
↓
┆a1┆┆b0┆8.╞ ╞ REFERENCES.↲
↲
╞ ╞ (1) LBJ 83.07.12 RC8000 Terminal Process, SW8001/2, Rel.2.0.↲
↲
↲
════════════════════════════════════════════════════════════════════════
↓
↲
↲
↲
┆1a┆┆1a┆t line> ::=↲
╞ ╞ <last line> ::= positive integer↲
↲
╞ ╞ ┆84┆The program