|
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: 12800 (0x3200)
Types: RcTekst
Names: »99109914.WP«
└─⟦670c8f5a6⟧ Bits:30005866/disk2.imd Dokumenter i RcTekst format (RCSL 99-1-*)
└─⟦this⟧ »99109914.WP«
╱04002d4e0a0006000000000301413140000000000000000000000000000000000000000000000000050f19232d37414b555f69737d8791ff04╱
┆06┆i↲
↲
┆b0┆┆a1┆TABLE OF CONTENTS┆05┆PAGE↲
↲
1. INTRODUCTION ............................................ 1↲
↲
2. ATTRIBUTES .............................................. 3↲
↲
3. PROGRAM CALL ............................................ 6↲
3.1 Syntax ............................................. 6↲
3.2 Semantics .......................................... 7↲
3.3 Function ........................................... 9↲
3.3.1 Info ........................................ 10 ↲
3.2.2 Host ........................................ 10 ↲
3.3.3 Terminal .................................... 10↲
3.3.4 Printer ..................................... 11↲
↲
4. ERROR MESSAGES .......................................... 12↲
↲
════════════════════════════════════════════════════════════════════════
↓
┆06┆ii↲
↲
════════════════════════════════════════════════════════════════════════
↓
┆14┆┆b3┆┆06┆┆0b┆↲
↲
┆a1┆┆e1┆┆b0┆┆a1┆1. INTRODUCTION↲
↲
This manual describes the utility program INITAMX with the faci┄↓
lities implemented in the system utility package SW8010/2 rel. ↓
1.0 or later releases. A number of the new facilities described ↓
can only be used in installations with Basis system package ↓
SW8001/2 rel. 3.0.↲
↲
The program can change parameters for terminals and printers ↓
connected to RC8000 via a RC3600 Device Controller.↲
↲
For terminals the parameters include:↲
↲
- terminal type (conversion table)↲
- input timer↲
- output timer↲
- prompt character↲
- enabling/disabling of attention↲
- enabling/disabling of upper case conversion↲
- enabling/disabling of echoing↲
- input continued (type ahead)↲
↲
For terminals connected via the RC3682 asynchronous multiplexer:↲
↲
- number of stopbits↲
- parity↲
- character length↲
- bitrate for receiver + bitrate for transmitter↲
- dc1/dc3 flow control (not RC800/20).↲
↲
════════════════════════════════════════════════════════════════════════
↓
For printers connected to an asynchronous multiplexer:↲
↲
- output timer↲
- number of stopbits (RC3682)↲
- parity (RC3682)↲
- bitrate (RC3682)↲
- dc1/dc3 flow control (RC3682 but not RC800/20)↲
↲
The program can run under the operating system 'S' or 'SOS'. ↓
Under 'SOS' the process must be included as user of the subhost ↓
involved.↲
↲
════════════════════════════════════════════════════════════════════════
↓
┆b0┆┆a1┆2. ATTRIBUTES↲
↲
This section describes the various parameters and their meaning. ↓
Most of them has an equivalence in the description of the termi┄↓
nal process.↲
↲
┆a1┆Terminal type┆e1┆ (default: 1)↲
↲
The terminal type is an integer in the range 0 to 9, and is an ↓
index for the conversion table used by the terminal.↲
↲
The maximum number of tables is ten, but the actual is determi┄↓
ned at system generation time.↲
↲
┆a1┆Input timer┆e1┆ (default: 60 sec)↲
↲
The input timer is the maximum timer in seconds allowed between ↓
each character. A zero timer means no timeout supervision.↲
↲
┆a1┆Output timer┆e1┆ (default: 60 sec)↲
↲
The output timer is the maximum timer in seconds allowed for the ↓
total output operation. The timeout value includes the time spent ↓
while the output channel is suspended when a DC3 character is ↓
received if flow control is in use.↲
↲
For the output timer a zero value will also turn off the timeout ↓
supervision.↲
↲
┆a1┆Prompt character┆e1┆ (default: <BELL>)↲
↲
The prompt character is output to indicate that input is ready ↓
(normally a BELL).↲
↲
════════════════════════════════════════════════════════════════════════
↓
The character can be changed or outputting of a prompt can be ↓
disabled.↲
↲
┆a1┆Attention┆e1┆ (default: enabled)↲
↲
A terminal is normally able to read an attention character even ↓
if no input message is issued. It can be disabled, which is ↓
necessary when flow control or type ahead on input is used.↲
↲
┆a1┆Connect messages┆e1┆ (default: enabled)↲
↲
When a terminal is connected or disconnected a number of messages ↓
are normally written to inform about the changes. If the terminal ↓
is used for other purposes these messages can be disabled.↲
↲
┆a1┆Upper case conversion┆e1┆ (default: enabled)↲
↲
The normal conversion of capital letters to small letters can be ↓
disabled.↲
↲
┆a1┆Echoing┆e1┆ (default: enabled)↲
↲
Echoing of input can be enabled or disabled. Note that it has no ↓
effect on terminals connected via a RC800/20 concentrator, as ↓
the characters are echoed locally by the concentrator.↲
↲
┆a1┆Input continued┆e1┆ (default: disabled)↲
↲
When input continued is enabled, characters read after a buffer ↓
is returned to RC8000 will be buffered, and delivered in the next ↓
input message.↲
↲
When this facility is used attention must be disabled and no ↓
prompt character written.↲
↲
════════════════════════════════════════════════════════════════════════
↓
┆a1┆Flow control┆e1┆ (default: no flow control)↲
↲
Terminals and printers connected via the RC3682 multiplexer ↓
supports flow control using dc1/dc3. The flow control can be used ↓
on the output channel, the input channel or both channels.↲
↲
Note! Flow control is only applicaple for terminals or printers ↓
connected via the RC3682 asynchronous multiplexer. It can not be ↓
used for RC3683, RC800/20 or any RC3682 which has possibility for ↓
connecting of one or more RC800/20.↲
↲
┆a1┆Channel characteristics↲
↲
For terminals and printers connected via the RC3682 multiplexer ↓
the following channel characteristics can be selected:↲
↲
- baudrate for receiver and transmitter (default: 2400 bps)↲
- parity control and generation (default: even)↲
- character length (default: 7)↲
- number of stopbits (default: 2)↲
↲
Note! These commands can not be used for terminals or printers ↓
connected via the RC3683 asynchronous multiplexer.↲
↲
════════════════════════════════════════════════════════════════════════
↓
┆b0┆┆a1┆3. Program Call↲
↲
The program has a number of commands, which addresses devices on ↓
a specific devicehost. Before these commands can be issued, a ↓
devicehost must be selected with a <host> command. Until a new ↓
host command is issued only devices on the selected host can be ↓
accessed.↲
↲
↲
┆b0┆┆a1┆3.1 Syntax↲
↲
initamx <command> ┆81┆*┆82┆↲
┆81┆1↲
┆82┆host↲
┆82┆info terminal↲
┆82┆ printer↲
<command>:: = ↲
┆81┆host <devicehost>↲
↲
terminal dhlink.<devno>┆81┆ <termparam>↲
┆81┆lookup↲
printer dhlink.<devno> <printparam>↲
↲
↲
type.<termtype> *┆81┆↲
timer.<intimer> .<outtimer> ┆81┆1↲
┆81┆0↲
s.<stopbits>↲
p.<parity>↲
l.<charlength>↲
r.<inrate> .<outrate> ┆81┆1↲
<termparam>::= ┆81┆0↲
dc1.<dctype>↲
echo.<echoing>↲
prompt.<char>↲
cont.<continous>↲
conv.<conversion>↲
att.<att>↲
mess.<message>↲
┆81┆1↲
════════════════════════════════════════════════════════════════════════
↓
timer.<outtimer> ┆81┆*↲
s.<stopbits>↲
p.<parity>↲
┆81┆<printparam>::= ┆82┆ l.<charlength>↲
r.<bitrate>↲
dc1.<flowcontrol> ┆82┆1↲
↲
↲
┆b0┆┆a1┆3.2 Semantics↲
↲
<devicehost> ┆84┆The devicehost number of the selected device ↓
┆19┆┆8f┆┄┄controller.↲
↲
<devno> ┆84┆The logical devicenumber of the selected terminal ↓
┆19┆┆8f┆┄┄or printer. In SW8001/2 rel. 3.0 a new local ↓
┆19┆┆8f┆┄┄command to the terminal has been implemented. The ↓
┆19┆┆8f┆┄┄name is 'id' and it prints the device number of ↓
┆19┆┆8f┆┄┄the terminal.↲
↲
<termtype> ┆84┆An integer in the range 0 to 9. It is used to ↓
┆19┆┆8f┆┄┄select a conversiontable for a terminal. If the ↓
┆19┆┆8f┆┄┄selected table is not included in the system ↓
┆19┆┆8f┆┄┄generation, the default table is chosen (index = ↓
┆19┆┆8f┆┄┄1).↲
↲
<intimer> ┆84┆The input timer in seconds (0 to 255) (described ↓
┆19┆┆8f┆┄┄in section 2).↲
↲
<outtimer> ┆84┆The output timer in seconds (0 to 255) (described ↓
┆19┆┆8f┆┄┄in section 2).↲
↲
<stopbits> The number of of stopbits. Legal values 1, 2.↲
↲
════════════════════════════════════════════════════════════════════════
↓
<parity> ┆84┆Parity control and generation↲
Legal values:↲
n: no parity↲
e: even parity↲
o: odd parity↲
↲
<charlength> ┆84┆The character length of data exclusive an eventual ↓
┆19┆┆8f┆┄┄parity bit.↲
Legal values: 5, 6, 7, 8.↲
↲
<inrate> ┆84┆The baudrate of the receiver.↲
┆84┆Legal values: 40, 50, 75, 110, 134, 150, 200, 220, ↓
┆19┆┆8f┆┄┄300, 600, 1200, 4800, 9600.↲
↲
<outrate> ┆84┆The baudrate of the transmitter. If it is not ↓
┆19┆┆8f┆┄┄specified, the same value as for the receiver is ↓
┆19┆┆8f┆┄┄chosen.↲
↲
<dctype> ┆84┆The kind of flowcontrol selected↲
Legal values:↲
no: No flowcontrol↲
input: Flowcontrol on the receiver↲
output: Flowcontrol on the transmitter↲
both: ┆84┆Flowcontrol on the receiver and the trans┄↓
┆19┆┆97┆┄┄mitter.↲
↲
<echoing> ┆84┆Enables or disables echoing of input.↲
Legal values:↲
yes: input echoed↲
no: input not echoed↲
↲
<char> ┆84┆The value of the character used for prompt. A zero ↓
┆19┆┆8f┆┄┄value will inhibit outputting of a prompt ↓
┆19┆┆8f┆┄┄character.↲
↲
════════════════════════════════════════════════════════════════════════
↓
<continous> ┆84┆Selecting of continous input (type ahead)↲
Legal values:↲
yes: continous input applied↲
no: normal input↲
↲
<conversion> ┆84┆The conversion mode used.↲
Legal values:↲
yes: ┆84┆Conversion of capital letters as described ↓
┆19┆┆94┆┄┄in the Terminal Process.↲
no: No conversion used.↲
↲
<att> ┆84┆Enables or disables attention when no input ↓
┆19┆┆8f┆┄┄message is present. ↲
Legal values:↲
ena: Enables attention↲
disa: Disables attention↲
↲
<message> ┆84┆Enables or disables disconnect and connect ↓
┆19┆┆8f┆┄┄messages on terminal.↲
Legal values:↲
yes: Messages are written↲
no: No messages are written↲
↲
<flowcontrol> ┆84┆Flowcontrol for printer.↲
Legal values:↲
yes: Flow control applied↲
no: No flow control↲
↲
↲
┆b0┆┆a1┆3.3 Function↲
↲
The program has four commands (info, host, terminal, printer) and ↓
they are described in the following sections.↲
↲
↲
════════════════════════════════════════════════════════════════════════
↓
┆b0┆┆a1┆3.3.1 Info↲
↲
This command prints a short summary of the available commands ↓
including the syntax of program calls.↲
↲
Example:↲
info host↲
info terminal↲
or info printer↲
↲
↲
┆b0┆┆a1┆3.3.2 Host↲
↲
The command terminate an eventual communication with a devicehost ↓
and create a link to the devicehost specified.↲
↲
Example:↲
host 5014↲
↲
↲
┆b0┆┆a1┆3.3.3 Terminal↲
↲
The terminal command can either change the parameters of a se┄↓
lected terminal, or it can print the parameters in use.↲
↲
Example:↲
terminal dhlink.1 r.4800↲
terminal dhlink.1 lookup↲
↲
When parameters are changed, any parameter not specified in the ↓
call will not be changed.↲
↲
This is only true if the Basis System (SW8001) is version 2 ↓
release 3.0 or later. In earlier releases of the Basis System it ↓
was not possible to read the parameters of a terminal, and there┄↓
fore the parameters not specified will get the default values ↓
described in section 2.↲
↲
════════════════════════════════════════════════════════════════════════
↓
In the same way the lookup function will just print all the ↓
default values of parameters.↲
↲
↲
┆b0┆┆a1┆3.3.4 Printer↲
↲
The printer command changes the parameters for a printer connect┄↓
ed via an asynchronous channel↲
↲
╞ printer dhlink.20 r.2400 timer.100↲
printer dhlink.20 timer.100 dc1.yes r.4800↲
↲
The devicehost linknumber of the printer can be obtained by the ↓
utility program 'lookuplink', or from the devicelist delivered ↓
with the Basis System.↲
↲
The new parameters will be the ones specified in the call, and ↓
for the rest of the parameters, default values are chosen.↲
↲
↲
════════════════════════════════════════════════════════════════════════
↓
┆b0┆┆a1┆4. ERROR MESSAGES↲
↲
Error messages have the format:↲
↲
***initamx: <error text>↲
↲
Errors in connection with selection of devicehost.↲
↲
<error text> =↲
╞ devicehost no <hostno> not found↲
↲
╞ It was not possible to find a hostprocess↲
↲
or↲
↲
<error text> =↲
link error <cause> connecting to devicehost no <hostno>↲
↲
<cause> = devicehost reserved↲
↲
┆84┆A process on the same computer is using initamx on the same ↓
┆19┆┆84┆┄┄devicehost.↲
↲
<cause> = no resources at jobhost↲
↲
┆84┆There is no free external processes.↲
↲
<cause> = timout↲
↲
┆84┆A user in the network is using the initamx program on that ↓
┆19┆┆84┆┄┄devicehost.↲
↲
┆84┆Another group of errors are caused by illegal parameters or wrong ↓
syntax of program call.↲
↲
<error text> = terminal not found.↲
↲
════════════════════════════════════════════════════════════════════════
↓
┆84┆The devicenumber specified (dhlink) is not a legal device of ↓
┆19┆┆84┆┄┄a terminal.↲
↲
<error text> = printer not found↲
↲
┆84┆The devicenumber specified is not a legal device for a prin┄↓
┆19┆┆84┆┄┄ter.↲
↲
<error text> = no linknumber specified↲
No dhlink statement↲
↲
<error text> = no devicehost connected↲
↲
┆84┆A printer or terminal command was issued without any previous ↓
┆19┆┆84┆┄┄host command.↲
↲
════════════════════════════════════════════════════════════════════════
↓
↲
↓
┆1a┆┆1a┆ted via the ages are written↲
↲
<flowcontrol> ┆84┆Flow