|
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: 21632 (0x5480)
Types: TextFile
Names: »D44«
└─⟦2294a1cd1⟧ Bits:30005867/disk06.imd Dokumenter (RCSL m.m.)
└─⟦this⟧ »D44«
i
T_A_B_L_E_ _O_F_ _C_O_N_T_E_N_T_S_ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _P_A_G_E_
3. TELESYNTAX ............................................ 1
3.1 Example .......................................... 2
3.2 Call ............................................. 3
3.3 Explanation of the Parameters .................... 4
3.4 Telesyntax Model ................................. 6
3.4.1 Function .................................. 6
3.4.2 Database Description ...................... 6
3.4.3 Sodald Description ........................ 7
3.4.4 Duet-Program .............................. 7
3.4.4.1 Start Command .................... 8
3.4.4.2 Stop Command ..................... 8
3.4.4.3 Create Command ................... 8
3.4.4.4 Delete Command ................... 9
3.4.4.5 Print Command .................... 9
3.4.4.6 Write Command .................... 10
3.4.5 ALGOL Operations .......................... 10
3.5 Requirements ..................................... 11
3.6 Messages from the Program ........................ 11
3.7 Listings from the Program ........................ 11
3.8 Error Messages ................................... 16
\f
ii
\f
3_._ _ _ _ _ _ _ _ _T_E_L_E_S_Y_N_T_A_X_ 3.
The Telesyntax program is intended for an off-line maintenance of
a number of syntax description pictures stored in a cf-master
file.
A syntax description picture is composed of a maximum of 23 lines
of 80 characters stored in a record. Each record is composed of a
picture identification, a line number within the picture, a print
class, and the above mentioned 80 characters.
The syntax descriptions are intended to be used in the on-line
system for the guidance of the terminal operators.
This manual describes how to utilize the batch system, which
consists of:
- telesyntax, a control program for the DUET-SODA system
- a database description
- a sodald description
- a duetprogram.
Furthermore an input file, which contains examples of commands
and syntax description pictures, is supplied.
\f
Database and Duetprogram
sodald description
TSDESCRIP TSDUETFILE
TELESYNTAX
TSINPUT
TDSYNTAX SODA- DUET-
dbms inter-
preter
TSERROR
TSREPORT
Figure 3.1: Teledata syntax display maintenance system.
Note: The batch system is provided with a separate database and
sodald description.
3_._1_ _ _ _ _ _ _ _E_x_a_m_p_l_e_ 3.1
The input file tsinput contains:
0S5 start
0S5 create lfm 0 7
Syntax Description
Logical file maintenance - - - lfm - - -
0S5 stop
0S5 stop
\f
The program call:
Telesyntax descrip.tsdescrip ldsection.152.1,
duetfile.tsduetfile,
read.tsinput,
print.2.tserror.tsreport
The result will be:
- creation of two new records in the syntax display (cf-master)
file (key: lfm 0, print class 7). In the on-line system these
two records will be a part of a picture identified by the code
lfm.
- a report containing information about the processing.
3_._2_ _ _ _ _ _ _ _C_a_l_l_ 3.2
The program call and FP parameters are
stdout.<name>
read.<name>
M_m_m_ stdassign.<no>
<no>
print.<no> (. <name>)
telesyntax <no>
P_p_p_ descript.<name>
ldsection.<no>
duetfile.<name>
user.<no>
duetarea. where: <name> is a name
of a discfile
<no> is a number
All the parameters have a default value.
\f
3_._3_ _ _ _ _ _ _ _E_x_p_l_a_n_a_t_i_o_n_ _o_f_ _t_h_e_ _P_a_r_a_m_e_t_e_r_s_ 3.3
read.<name>
States the name of the file, used for reading character input by
means of the duet operations read and getline. If used, the file
must exist.
stdassign.<no>
Controls the assignment of norm value to a variable when a
standard mark is read (duet operation read).
<no' = 0 means that the variable is not altered.
<no'<' 0 means that the norm value is assigned to the variable.
Detault: stdassign.1
M_m_m_ <no>
print.<no> ( .<name> )
P_p_p_ <no>
Defines the number of print channels (for the duet operation
print), and the corresponding names of disc files. <no> is the
number of print channels. They will be numbered 1, 2, ... <no>.
<no> must not exceed 5.
The exact <no> number of different file names must be stated. The
files must exist (if used).
Default: print.1.printout.
descrip.<name>
States the name of the description file, containing the compiled
SODALD description.
Default descrip.descripfile.
\f
ldsection.<no>
States the section no of the compiled SODALD description as
identification of the LD description in question (among others in
the description file).
Default: ldsection.0.
duetfile.<name>
States the name of the file containing the compiled DUET program.
Default: duetfile.duetfile.
user.<no>
States the user number of this program call. Used by the DUET
interpreter for dynamic checking of legal block references.
User.0 means all users.
Default: user.0.
duetarea.<no>
States the size (in number of words) of the core buffer used by
the DUET interpreter for dynamic storage of compiled duet program
blocks.
Default: duetarea.3000.
stdout.<name>
States the name of the file on which the DUET/SODA system
normally writes error messages. The file must exist.
Default: stdout.duetlog.
\f
3_._4_ _ _ _ _ _ _ _T_e_l_e_s_y_n_t_a_x_ _M_o_d_e_l_ 3.4
3_._4_._1_ _ _ _ _ _F_u_n_c_t_i_o_n_ 3.4.1
On basis of commands stated in the input file the relevant
function of the system is executed. The functions included are:
input reading control, creation of syntax display pictures,
deletion of syntax display pictures, and finally printing of
syntax display pictures.
Input reading control:
- based on the commands 0S5 start and 0S5 stop
- input is divided into one or more blocks
- input lines outside a start - stop block will not be processed.
Creation of syntax display pictures:
- based on the command 05 create
- creation of total pictures
- creation of a part of a picture.
Deletion of syntax display pictures:
- based on the command 0S5 delete
- partial or total deletion.
Printing of syntax display pictures:
- based on the commands 0S5 print and 0S5 write
- print single picture (0S5 print)
- print pictures belonging to a print class (0S5 write).
3_._4_._2_ _ _ _ _ _D_a_t_a_b_a_s_e_ _D_e_s_c_r_i_p_t_i_o_n_ 3.4.2
A seperate database description is supplied for the batch part of
the system. The on-line and the batch database descriptions must
of course be identical as regards the parts dealing with the
syntax description file.
\f
The batch database description contains:
- file section, with general information about the syntax file
- list section, empty
- logical file section, describing the record types
- i1501 syntax record
- i1502 message record.
Only record type 1501 is used in the syntax display system.
3_._4_._3_ _ _ _ _ _S_o_d_a_l_d_ _D_e_s_c_r_i_p_t_i_o_n_ 3.4.3
The sodald description contains:
- variables used in the batch system
- norm values and value spectra
- a record set (set No 1) used to get access to the records in
the syntax file.
3_._4_._4_ _ _ _ _ _D_u_e_t_-_P_r_o_g_r_a_m_ 3.4.4
The duet-program reads input lines stored in an ordinary text
file. The processing of the lines depend on the line type: data
line or command line.
A data line is normally a line, which shall be inserted in a
syntax picture.
A command line, identified by a dollar-sign as the first
character, tells the system, which kind of function must be
executed next.
The syntax and purpose of the command lines are described in the
subsections 3.4.4.1 to 3.4.4.6.
\f
3_._4_._4_._1_ _ _ _S_t_a_r_t_ _C_o_m_m_a_n_d_ 3.4.4.1
Syntax: 0S5 start <any comment> <nl>
Purpose: Starts a block of input to be processed by the program.
Input mode will be changed to active, i.e, all lines
following the start command will be processed by
telesyntax until a stop command occurs.
3_._4_._4_._2_ _ _ _S_t_o_p_ _C_o_m_m_a_n_d_ 3.4.4.2
Syntax: 0S5 stop <any comment> <nl>
Purpose: Stops a block of input.
Stops the reading of the input file.
Input mode will be changed to not active, i.e. Lines
will be skipped by telesyntax until next start or stop
command occurs. If a stop command occurs without a
corresponding start command (end of input) or an
em-character (iso value 25, end of file) occurs the
program will be terminated.
3_._4_._4_._3_ _ _ _C_r_e_a_t_e_ _C_o_m_m_a_n_d_ 3.4.4.3
M_m_m_ 1
Syntax: 0S5 create <id1> <id2> <prcl> (<lno>) <nl>
0
P_p_p_
<id1>: first picture identification
<id2>: second picture identification
text max. 3 characters or numeric 0.
<prcl>: print class
numeric min. 0 max. 99.
<lno>: start line number
numeric min. 1 max. 23.
\f
Purpose: Tells the system the identification of the picture that
is to be created.
The lines following the command are inserted (created)
in the picture.
The line number is automatically updated by 1 for each
new picture line created. The basis line number is 1 or
start line no. keyed in the command line.
Notes: The on-line system will use the record with a line
number equal to one to check that a description with a
given key exists in the syntax file.
At present the duet program does not support the reading
of a user number as a part of the syntax description
key.
3_._4_._4_._4_ _ _ _D_e_l_e_t_e_ _C_o_m_m_a_n_d_ 3.4.4.4
M_m_m_ *
Syntax: 0S5 DELETE <id1> <id2> (<lno>) <nl>
0
P_p_p_
<id1>, <id2>, <lno> cf. 3.4.4.3.
Purpose: Deletes the specified picture or lines in the picture
from the tdsyntax file.
3_._4_._4_._5_ _ _ _P_r_i_n_t_ _C_o_m_m_a_n_d_ 3.4.4.5
Syntax: 0S5 print <id1> <id2> <nl>
<id1>, <id2> cf. 3.4.4.3.
Purpose: prints the specified picture.
\f
3_._4_._4_._6_ _ _ _W_r_i_t_e_ _C_o_m_m_a_n_d_ 3.4.4.6
M_m_m_ 1
Syntax: 0S5 write (<prcl>) <nl>
0
P_p_p_ <prcl> cf. subsection 3.4.4.3.
Purpose: prints the contents of the syntax display file.
If a print call is specified only pictures (records)
belonging to this class will be printed.
If no print class is specified all the pictures will be
printed.
3_._4_._5_ _ _ _ _ _A_L_G_O_L_ _O_p_e_r_a_t_i_o_n_s_ 3.4.5
A_l_g_o_l_ _1_,_ _f_e_t_c_h_ _c_u_r_r_e_n_t_ _d_a_t_e_ _a_n_d_ _t_i_m_e_
Call : algol 1 (date, time).
Parameters: date (long, return parameter) containing the current
date on ISO-form YYMMDD.
time (long, return parameter) containing the current
time on the form HHMMSS.
A_l_g_o_l_ _2_,_ _r_e_m_o_v_e_ _l_a_s_t_ _c_h_a_r_a_c_t_e_r_,_ _n_l_/_e_m_
Call : algol 2(addr(text1), addr(text2), pos).
Parameters: text1 (text, call parameter).
The text to be processed.
text2 (text, return parameter).
The text (text1) after the specified character has
been removed.
\f
pos (word, call and return parameter).
Call - position of the character to be removed.
Return - the ISO-value of the character which has
been removed.
3_._5_ _ _ _ _ _ _ _R_e_q_u_i_r_e_m_e_n_t_s_ 3.5
Size: 70000
Area: 10
Buffer: 6
Time: Input dependent.
3_._6_ _ _ _ _ _ _ _M_e_s_s_a_g_e_s_ _f_r_o_m_ _t_h_e_ _P_r_o_g_r_a_m_ 3.6
The program call generates the standard log of the DUET-SODA
system.
3_._7_ _ _ _ _ _ _ _L_i_s_t_i_n_g_s_ _f_r_o_m_ _t_h_e_ _P_r_o_g_r_a_m_ 3.7
Figure 3.2 is an example of the report generated during the
processing of the input file.
Figure 3.3 is an example of a syntax description picture
identified by the key: lfm 0 and print class: 2.
In the on-line system the picture will be displayed by typing:
? lfm
The picture is printed by means of the command 0S5 print lfm 0
(or
0S5 write 2).
Only the texts within the frame of the line numbers and character
position points are part of the syntax description.
\f
Figure 3.4 like figure 3.3 apart from the key: ic i, and the
print class: 6.
This picture is produced in the on-line system by typing:
? ic i
or if the operator are actually working on a voucher of the type
ic just by typing:
? i
Figure 3.2, 3.3 and 3.4, see the following pages.
\f
F_
\f
F_
\f
F_
\f
F_ 3_._8_ _ _ _ _ _ _ _E_r_r_o_r_ _M_e_s_s_a_g_e_s_ 3.8
1. Unknown command.
* <line no.> <input line>
2. Unknown picture.
* <line no.> <input line>
3. Line no. is out of range.
* <line no.> <input line>
4. Too many lines for one picture.
* <line no.> <input line>
5. Wrong termination after reading first key.
* <line no.> <input line>
6. Wrong termination after reading second key.
* <line no.> <input line>
7. Write class is out of range.
* <line no.> <input line>
All duet data errors.
All duet program errors.
All duet system errors.
A_c_t_i_o_n_ _o_n_ _e_r_r_o_r_s_
Errors number 1 to 7, data errors and program error: continue
with next input line.
System error: terminate run.\f
\f
«eof»