top - download
⟦eea0f269f⟧ Wang Wps File
Length: 61977 (0xf219)
Types: Wang Wps File
Notes: FIX/1151/PSP/0099
Names: »3348A «
Derivation
└─⟦3b8d69e90⟧ Bits:30005794 8" Wang WCS Floppy ( A0306A )
└─ ⟦this⟧ »3348A «
WangText
=…05…8…00…8…07……13……06……12……0d……12… …11……0c……11……02……11… …11……06……10……0b……10……0d……10……02……10… …0f……08……0f……0b……0f……0e……0f……02……0f……05……0e……08……0e……09……0e……0d……0e……00……0e……05……0d……08……0d……0a……0d……0b……0d……0e……0d……00……0d…
…0d……06……0c……09……0c……0c……0c……0e……0c……00……0c……02……0c……05……0b……08……0b……0a……0b……0d……0b……86…1
…02…
…02…
…02…
…02…FIX/1151/PSP/0099
…02…JJJ/881104…02…76a
TEP SUBSYSTEM
PSP
…02…MLA/830207
…02…FIKS
TEP Subsystem PSP
FIX/1151/PSP/0099
AK
FMK
FMK(5), AK(4)
FIKS Prgm.Mgr.
Docu.Config.Mgr.
…0f… 1.1
881104…0e……86…1 …02… …02… …02… …02… …02…
REVISION RECORD
REVISION RECORD
REVISION RECORD
REVISION RECORD
REVISION RECORD
Wang/Disk:
3348A/0306A
̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲
̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲…06…1 …02… …02… …02…
ISSUE DATE PAGES BRIEF
DESCRIPTION
OF
CHANGE
ISSUE DATE PAGES BRIEF
DESCRIPTION
OF
CHANGE
ISSUE DATE PAGES BRIEF
DESCRIPTION
OF
CHANGE
ISSUE DATE PAGES BRIEF
DESCRIPTION
OF
CHANGE
ISSUE DATE PAGES BRIEF
DESCRIPTION
OF
CHANGE
AFFECTED
AFFECTED
AFFECTED
AFFECTED
AFFECTED
̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲
̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ^ ^
^
1 ^830207 ^ All ^
Original
issue
of
document.
^ ^ ^
1.1 ^881104 ^ DCN 1 ^
Changed
in
accordance
with
Ordre
no:
^ ^ ^
8/87
and
26/88
^ ^ ^
^ ^ ^
^ ^ ^
^ ^ ^
^ ^ ^
^ ^ ^
^ ^ ^
^ ^ ^
^ ^ ^
^ ^ ^
^ ^ ^
^ ^ ^
^ ^ ^
^ ^ ^
^ ^ ^
^ ^ ^
^ ^ ^
^ ^ ^
^ ^ ^
^ ^ ^
^ ^ ^
^ ^ ^
^ ^ ^
^ ^ ^
^ ^ ^
^ ^ ^
^ ^ ^
^ ^ ^
^ ^ ^
^ ^ ^
^ ^ ^
^ ^ ^
^ ^ ^
^ ^ ^
^ ^ ^
^ ^ ^
^ ^ ^
^ ^ ^
^ ^ ^
^ ^ ^
^ ^ ^
^ ^ ^
^ ^ ^
T̲A̲B̲L̲E̲ ̲O̲F̲ ̲C̲O̲N̲T̲E̲N̲T̲S̲
Page
1 SCOPE .......................................... 1
1.1 Introduction ............................... 2
2 APPLICABLE DOCUMENTS ........................... 3
3 MODULE SPECIFICATION ........................... 4
3.1 Functional Capabilities .................... 5
3.1.1 TEP ̲MAIN Module ........................ 5
3.1.2 LON Procedure .......................... 7
3.1.3 LOF Procedure .......................... 8
3.1.4 TEP ̲INIT ̲REST Procedure ................ 9
3.1.5 DSP ̲Q ̲ST Procedure ..................... 10
3.1.6 INT TERM ............................... 11
3.1.7.1 ICREATE Procedure .................. 12
3.1.7.2 IRECREATE Procedure ................ 13
3.1.7.3 ITRANSFER Procedure ................ 14
3.1.7.4 ICONTROL Procedure ................. 15
3.1.7.5 IWAIT Procedure .................... 16
3.1.7.6 WAIT ̲TIME ̲OUT Procedure ............ 18
3.1.7.7 INIT ̲CHANNELS Procedure ............ 19
3.1.8.1 GET ̲CRITICAL ̲REGION Procedure ...... 20
3.1.8.2 GET ̲TCB Procedure .................. 21
3.1.8.3 PUT ̲TCB, Utility Procedure ......... 22
3.1.8.4 UPDATE ̲TCB Utility Procedure ....... 23
3.1.8.5 SCAN ̲CRT Utility Procedure ......... 24
3.1.8.6 GET ̲PROMPT Utility Procedure ....... 25
3.1.9.1. ITERR Procedure .................. 26
3.1.9.2 ANALYSE ̲CC, Procedure .............. 27
3.1.9.3 PSM ̲MESS Procedure ................. 28
3.1.9.4 ID PASSWORD Procedure .............. 29
3.1.9.5 USER ̲PROFILE Procedure ............. 30
3.1.9.6 EVENT ̲HANDLER Procedure ............ 31
3.1.9.7 ITREP Procedure .................... 32
3.1.9.8 SCRAMBLE ̲PASSW Procedure ........... 32
3.2. Interface Description .................... 33
3.2.1 TEP MAIN Module ...................... 33
3.2.1.1 Internal Interface ................. 33
3.2.1.2 External Interface ................. 36
3.2.2 LON Procedure .......................... 37
3.2.2.1 Internal Interface ................. 37
3.2.2.2 External Interface ................. 39
3.2.3 LOF Procedure .......................... 40
3.2.3.1 Internal Interface ................. 40
3.2.3.2 External Interface ................. 42
3.2.4 TEP ̲INIT ̲REST Procedure ................ 43
3.2.4.1 Internal Interface ................. 43
3.2.4.2 External Interface ................. 44
3.2.5 DSP ̲Q ̲ST Procedure ..................... 45
3.2.5.1 Internal Interfaces ................ 45
3.2.5.2 External Interface ................. 46
3.2.6 INT ̲TERM Procedure ..................... 47
3.2.6.1 Internal Interface ................. 47
3.2.6.2 External Interface ................. 48
3.2.7.1 ICREATE Procedure .................. 49
3.2.7.1.1 Internal Interface ............. 49
3.2.7.1.2 External Interface ............. 49
3.2.7.2 IRECREATE Procedure ................ 50
3.2.7.2.1 Internal Interface ............. 50
3.2.7.2.2 External Interface ............. 50
3.2.7.3 ITRANSFER Procedure ................ 51
3.2.7.3.1 Internal Interface ............. 51
3.2.7.3.2 External Interface ............. 55
3.2.7.4 ICONTROL Procedure ................. 56
3.2.7.4.1 Internal Interface ............. 56
3.2.7.4.2 External Interface ............. 57
3.2.7.5 IWAIT Procedure .................... 58
3.2.7.5.1 Internal Interface ............. 58
3.2.7.5.2 External Interfaces ............ 59
3.2.7.6 WAIT ̲TIME ̲OUT Procedure ............ 60
3.2.7.6.1 Internal Interface ............. 60
3.2.7.6.2 External Interface ............. 61
3.2.7.7 INIT CHANNELS ...................... 62
3.2.7.7.1 Internal Interface ............. 62
3.2.7.7.2 External Interface ............. 63
3.2.8.1 GET ̲CRITICAL ̲REGION Procedure ...... 64
3.2.8.1.1 Internal Interface ............. 64
3.2.8.1.2 External Interface ............. 64
3.2.8.2 GET ̲TCB Procedure .................. 65
3.2.8.2.1 Internal Interface ............. 65
3.2.8.2.2 External Interfaces ............ 65
3.2.8.3 PUT ̲TCB Procedure .................. 66
3.2.8.3.1 Internal Interface ............. 66
3.2.8.3.2 External Interface ............. 66
3.2.8.4 UPDATE ̲TCB Procedure ............... 67
3.2.8.4.1 Internal Interface ............. 67
3.2.8.4.2 External Interface ............. 67
3.2.8.5 SCAN ̲CRT Procedure ................. 68
3.2.8.5.1 Internal Interface ............. 68
3.2.8.5.2 External Interface ............. 68
3.2.8.6 GET ̲PROMPT Procedure ............... 69
3.2.8.6.1 Internal Interface ............. 69
3.2.8.6.2 External Interface ............. 69
3.2.9.1 ITERR Procedure .................... 70
3.2.9.1.1 Internal Interface ............. 70
3.2.9.1.2 External Interface ............. 70
3.2.9.2 ANALYSE ̲CC Procedure ............... 71
3.2.9.2.1 Internal Interface ............. 71
3.2.9.2.2 External Interface ............. 71
3.2.9.3 PSM ̲MESS Procedure ................. 72
3.2.9.3.1 Internal Interface ............. 72
3.2.9.3.2 External Interface ............. 72
3.2.9.4 ID ̲PASSWORD Procedure .............. 73
3.2.9.4.1 Internal Interface ............. 73
3.2.9.4.2 External Interface ............. 73
3.2.9.5 USER ̲PROFILE Procedure ............. 74
3.2.9.5.1 Internal Interface ............. 74
3.2.9.5.2 External Interface ............. 74
3.2.9.6 EVENT ̲HANDLER Procedure ............ 75
3.2.9.6.1 Internal Interface ............. 75
3.2.9.6.2 External Interface ............. 75
3.2.9.7 ITREP Procedure .................... 76
3.2.9.7.1 Internal Interface ............. 76
3.2.9.7.2 External Interface ............. 76
3.2.9.8 SCRAMBLE ̲PASSW Procedure ........... 76a
3.2.9.8.1 Internal Interface ............. 76a
3.2.9.8.2 External Interface ............. 76a
3.3 Processing ................................ 77
3.3.1 TEP ̲MAIN .............................. 77
3.3.2 LON ................................... 80
3.3.3 LOF ................................... 83
3.3.4 TEP ̲INIT ̲REST ......................... 85
3.3.5 DSP ̲Q ̲ST .............................. 88
3.3.6 INT ̲TERM .............................. 90
TDX ̲UTIL
3.3.7.1 ICREATE ........................... 91
3.3.7.2 IRECREATE ......................... 93
3.3.7.3 ITRANSFER ......................... 94
3.3.7.4 ICONTROL .......................... 105
3.3.7.5 IWAIT ............................. 106
3.3.7.6 WAIT ̲TIMEOUT ...................... 114
3.3.7.7 INIT ̲CHANNELS ..................... 115
3.3.8 CRIT ̲REG ̲UTIL ......................... 116
3.3.8.1 GET ̲CRIT ̲REG ...................... 117
3.3.8.2 GET ̲TCB ........................... 118
3.3.8.3 PUT ̲TCB ........................... 119
3.3.8.4 UPDATE ̲TAB ........................ 120
3.3.8.5 SCAN ̲CRT .......................... 121
3.3.8.6 GET ̲PROMPT ........................
OTHER ̲UTIL
3.3.9.1 ITERR ............................. 122
3.3.9.2 ANALYSE ̲CC ........................ 123
3.3.9.3 PSM ̲MESS .......................... 124
3.3.9.4 ID ̲PASSWORD ....................... 125
3.3.9.5 USER ̲PROFILE ...................... 127
3.3.9.6 EVENT ̲HANDLER ..................... 128
3.3.9.7 ITREP ............................. 129
3.4 Data Organization ......................... 130
3.5 Storage Allocation ........................ 131
3.6 Performance Characteristic ................ 132
3.7 Limitations ............................... 133
3.8 Error Codes/Error Locations ............... 134
3.9 Listing Reference ......................... 136
4 QUALITY ASSURANCE ............................. 137
4.1 Qualification Tests ....................... 137
4.2 Other Quality Assurance ................... 137
5 PREPARATION FOR DELIVERY ...................... 138
6 NOTES ......................................... 139
7 APPENDICES .................................... 140
1 S̲C̲O̲P̲E̲
This document describes the function of the terminal process.
The purpose of the terminal process is to support the main machine interface.
Included in this document is only the Interactive Terminal Monitor (ITM). For message entry
and supervisor subsystems please refer to:
MES SUBMODULE PSP FIX/1351/PSP/0060
SFS SUBMODULE PSP FIX/1155/PSP/0093
1.1 I̲n̲t̲r̲o̲d̲u̲c̲t̲i̲o̲n̲
The ITM subsystem implements 5 major functions:
. start-restart of terminal process
. terminal control (e.g. block of keyboard)
. terminal interface (data input/output
from/to terminal)
. system access (log on and log off at a terminal)
. invokation of message entry and supervisory procedures.
2 A̲P̲P̲L̲I̲C̲A̲B̲L̲E̲ ̲D̲O̲C̲U̲M̲E̲N̲T̲S̲
FIKS SYSTEM PSP FIX/1000/PSP/0038
FIKS DATA I/F REFERENCE FIX/0100/MAN/0004
FIKS REQUIREMENTS SPEC. FIX/0000/SPC/0002
FIKS S/W CONF.CONTROL
LIB.DESCR.DOC FIX/1000/EWP/0080
APP VDU MONITOR PSP FIX/1256/PSP/0040
CHECKP SUBSYSTEM PSP FIX/1100/PSP/0041
ESP SYSTEM PSP FIX/1105/PSP/0046
GET ̲DTG MONITOR PSP FIX/1256/PSP/0044
GET USP MONITOR PSP FIX/1256/PSP/0050
INTASC MONITOR PSP FIX/1256/PSP/0052
LCFH MONITOR SPS FIX/1256/PSP/0055
LOG ̲ACT MONITOR PSP FIX/1256/PSP/0056
LOG ̲JOUR MONITOR PSP FIX/1256/PSP/0057
MES SUBMODULE PSP FIX/1155/PSP/0060
MTCB MONITOR PSP FIX/1156/PSP/0066
PIP SUBSYSTEM PSP FIX/1156/PSP/0075
PSM PROCEDURE PSP FIX/1200/PSP/0076
QACCESS MONITOR PSP FIX/1256/PSP/0078
RDF MONITOR PSP FIX/1256/PSP/0081
SEND ̲REP MONITOR PSP FIX/1256/PSP/0092
SFS SUBMODULE PSP FIX/1155/PSP/0093
SYSTEM TEST REPORT S010 FIX/0000/TRP/0085
SYSTEM TEST REPORT S020 FIX/0000/TRP/0086
3 M̲O̲D̲U̲L̲E̲ ̲S̲P̲E̲C̲I̲F̲I̲C̲A̲T̲I̲O̲N̲
The Module spcifications are divided into 9 sections according to the source files.
Some of the sections are divided into subsection. One subsection per procedure.
Example:
3. 1. 7. 5.
1 WAIT
TDX.UTIL
Functional Capabilities
Module Specifications
3.1 F̲u̲n̲c̲t̲i̲o̲n̲a̲l̲ ̲C̲a̲p̲a̲b̲i̲l̲i̲t̲i̲e̲s̲
3.1.1 TEP ̲MAIN Module
…0e……0e… ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲…0f……0f…
F̲u̲n̲c̲t̲i̲o̲n̲a̲l̲ ̲C̲a̲p̲a̲b̲i̲l̲i̲t̲i̲e̲s̲
The TEP ̲MAIN Module has three major functions:
1. initialization of the terminal process in case of start and restart.
2. it supports the user to get access to the terminal process (LON, LOF).
3. it will allow a user to enter one of the common message entry or supervisor procedures
when he is logged on.
add 2. for LON, LOF please refer to 3.1.2. and 3.1.3.
add 3. please refer to:
MES SUB MODULE PSP FIX/1351/PSP/0060
for message entry functions and to SFS SUBMODULE PSP FIX/1155/PSP/0093
for supervisory procedures.
When the process is started up, a read on the control channel is initiated. Before operating
the terminal a system access request has to be entered (at VDU: EOM, at TP: N). The computer
response to this request is the promp 'PROC ̲'.
The terminal is now 'ON ̲LINE', and the operator can enter his commands.
The first command has to be a Logon Command (LON). …86…W …02… …02… …02… …02… …02…
When the logon sequence has been completed a new'PROC ̲' will be issued and the terminal is
ready for message entry and supervisory procedures.
If a security error occurs, the terminal will be blocked and the process will wait for a
supervisor initialed message to unblock the terminal
3.1.2 L̲O̲N̲ ̲P̲r̲o̲c̲e̲d̲u̲r̲e̲
F̲u̲n̲c̲t̲i̲o̲n̲a̲l̲ ̲C̲a̲p̲a̲b̲i̲l̲i̲t̲i̲e̲s̲
The procedure supports the check for access right to the system by prompting the operator
for:
- id
- password
- logon mode
The correct answer for the prompts id and password, must be entered within 3 attempts.
An unsuccessful logon will cause an alarm to the supervisor, a log on the logprinter and
the terminal will be blocked.
After successful logon the procedure updates the terminal control block and user security
profile in accordance to the actual user, and the action is logged ̲on the logprinter.
The logon mode can be of two types:
- Rx
- Rx/Tx
In case the Rx mode is chosen, the mode can only be changed after the terminal has been blocked
and unblocked.
3.1.3 L̲O̲F̲ ̲P̲r̲o̲c̲e̲d̲u̲r̲e̲
F̲u̲n̲c̲t̲i̲o̲n̲a̲l̲ ̲C̲a̲p̲a̲b̲i̲l̲i̲t̲i̲e̲s̲
The procedure supports the check for sign off the system by prompting the operator for:
- id
- password
The correct answer for the prompts must be enetered within 3 attempts.
An unsuccessful log off wil cause an alarm to the supervisor, a lon on the log-printer and
the terminal will be blocked.
After successful log off the procedure updates the terminal control block and user security
profile, and the action is logged on the logprinter
3.1.4 TEP ̲INIT ̲REST Procedure
…0e……0e… ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲…0f……0f…
F̲u̲n̲c̲t̲i̲o̲n̲a̲l̲ ̲C̲a̲p̲a̲b̲i̲l̲i̲t̲y̲
The procedure takes care of the initialization of the terminal process in case of start or
restart.
The file descriptor for the system volumes and the RDF file are found and saved. Data and
control channels to the terminal are created and the screen is cleared, if the terminal is
a VDU.
In case of restart the TCB and USP save are updated, the prompt 'RESTART FINISHED' is issued
and the PSM is notified whether or not the terminal is logged on.
3.1.5 DSP ̲Q ̲ST Procedure
…0e……0e… ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲…0f……0f…
F̲u̲n̲c̲t̲i̲o̲n̲a̲l̲ ̲C̲a̲p̲a̲b̲i̲l̲i̲t̲i̲e̲s̲
The procedure is called when a display/printout of the terminal queue status is requested.
The terminal number and the status type required are specified when calling the procedure.
2 different status types are available:
ENTIRE STATUS:
3 line are displayed/printed:
- queue names of actual terminal
- no. of elements in each queue
- current DTG.
SINGLE STATUS:
2 lines are displayed/printed:
- no. of elements in each queue
- current DTG.
If none of the queues have been modified since last call, and the requested type is SINGLE
STATUS the queue status is not displayed/printed.
(Changes in queue status are registered by QACESS internally)
If the operator is not a supervisor or assistent the queues AL and DT are ommitted.
3.1.6 INT ̲TERM
…0e……0e… ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲…0f……0f…
F̲u̲n̲c̲t̲i̲o̲n̲a̲l̲ ̲C̲a̲p̲a̲b̲i̲l̲i̲t̲i̲e̲s̲
The procaedure is called when a security interrogation of a terminal is requested.
The operator is asked to input user id and password.
If he fails to answer correctly on both points (3 attempts are given) the terminal is blocked
and the procedure is returned to the calling procedure.
After interrogation (successful or not) the 'interrogate flag' in the TCB is cleared.
At successful interrogation a 'LOGON' message is sent to PSM subsystem.
3.1.7.1 I̲C̲R̲E̲A̲T̲E̲ ̲P̲r̲o̲c̲e̲d̲u̲r̲e̲
F̲u̲n̲t̲i̲o̲n̲a̲l̲ ̲C̲a̲p̲a̲b̲i̲l̲i̲t̲i̲e̲s̲
The ICREATE Procedure creates the channels to the terminal associated with the process.
The channels to be created are:
. data channel
. control channel
. data channel to paper tape reader (if any)
If terminal is a VDU a buffer containing 80 null chars will be appended to the terminal on
the data channel to reset the LTU.
A read on the control channel will be initiated.
3.1.7.2 I̲R̲E̲C̲R̲E̲A̲T̲E̲ ̲P̲r̲o̲c̲e̲d̲u̲r̲e̲
F̲u̲n̲c̲t̲i̲o̲n̲a̲l̲ ̲C̲a̲p̲a̲b̲i̲l̲i̲t̲i̲e̲s̲
The procedure exchanges log line id's for VDU and PTR.
The log line id is pointer to the actual data channel
3.1.7.3 I̲T̲R̲A̲N̲S̲F̲E̲R̲ ̲P̲r̲o̲c̲e̲d̲u̲r̲e̲
F̲u̲n̲c̲t̲i̲o̲n̲a̲l̲ ̲C̲a̲p̲a̲b̲i̲l̲i̲t̲i̲e̲s̲
The procedure is used to transfer data to and from the terminal.
The procedure is called with an action code indicating one of the following I/O requests:
- write
- Read
- Initiate read
- Complete initiated read
- Prompt
- Prompt and read
- Prompt password
- Write error code
The caller has the same interface whether the terminal is of type VDU or TP.
The procedure is limited to a maximum of 2 pending readings (INIT ̲READ) on the data channel.
In case a reading is completed with input from a function key (control channel), all data
channel references are cancelled.
The prompt password branch will ensure that the operator's answer is invisible.
The write error branch will display the valves delivered in the ITRANSFER call.
The codes will be printed on the terminal as follows:
? - X: YYY
3.1.7.4 I̲C̲O̲N̲T̲R̲O̲L̲ ̲P̲r̲o̲c̲e̲d̲u̲r̲e̲
F̲u̲n̲c̲t̲i̲o̲n̲a̲l̲ ̲C̲a̲p̲a̲b̲i̲l̲i̲t̲i̲e̲s̲
The procedure is used to send control codes to the terminal.
The following commands can be sent to VDU or TP:
- block keyboard
- unblock keyboard
- carriage return
- line feed
- tabulator
The following commands are only used in case the terminal is VDU:
- clear screen
- set line mode
- set part page mode
- set protect
- protect on
- protect off
The codes are sent to the terminal by call of the monitor procedure APPVDUCON if VDU, and
IO APPENDBYTES, if TP.
3.1.7.5 I̲W̲A̲I̲T̲ ̲P̲r̲o̲c̲e̲d̲u̲r̲e̲
F̲u̲n̲c̲t̲i̲o̲n̲a̲l̲ ̲C̲a̲p̲a̲b̲i̲l̲i̲t̲i̲e̲s̲
The IWAIT Procedure is a general wait procedure where the process will wait, until a certin
event occurrs.
The procedure has two branches:
. IWAIT ̲MSG
. IWAIT ̲OPERATIONS
In the IWAIT ̲MSG branch the procedure will wait for :
- A message to unblock the terminal. An answer will be returned.
- A control code VKA (VDU Keep Alive) to be dispatched by a Receive Only VDU. When code #3C
for VKU is identified, the respective poll-bit in TCB critical region is reset and Wait Message
reentered.
- In the IWAIT ̲OPERATIONS branch the procedure will wait for an earlier initiated IO-operation
to complete. In case it is the read on the control channel which completes, it is checked
whether it is a known function key, which has been activated. Only for known function keys
a return to the calling procedure will be made. If the control code #3C for VKA is identified,
the respective poll bit in TCB critical region is reset and Wait Operations will be entered
again.
For unknown function keys a read on the control channel will be initiated and the procedure
will wait again.
When waiting for an IO-operation to complete, three other events can occur:
. a̲n̲ ̲a̲n̲s̲w̲e̲r̲ can be received. This will only result in a new wait.
. a̲ ̲m̲e̲s̲s̲a̲g̲e̲ can be received. This will require an answer and the answer will be sent.
If the message was a block terminal request the read on the data channel will be cancelled.
. a̲ ̲t̲i̲m̲e̲ ̲o̲u̲t̲ can be received. The time out will be followed by a cancel of the read on
the data channel.
3.1.7.6 WAIT ̲TIME ̲OUT Procedure
…0e……0e… ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲…0f……0f…
F̲u̲n̲c̲t̲i̲o̲n̲a̲l̲ ̲C̲a̲p̲a̲b̲i̲l̲i̲t̲i̲e̲s̲
The procedure is used to generate a delay in case of failure during normal processing (ex.
timeout from TDX).
The delay time is 1 minute.
3.1.7.7 INIT ̲CHANNELS Procedure
…0e……0e… ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲…0f……0f…
F̲u̲n̲c̲t̲i̲o̲n̲a̲l̲ ̲C̲a̲p̲a̲b̲i̲l̲i̲t̲i̲e̲s̲
The procedure is used to initiate a read on the non active channel(s) (DATA ̲CONTROL).
3.1.8.1 GET ̲CRITICAL ̲REGION Procedure
…0e……0e… ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲…0f……0f…
F̲u̲n̲c̲t̲i̲o̲n̲a̲l̲ ̲C̲a̲p̲a̲b̲i̲l̲i̲t̲i̲e̲s̲
The purpose of this utility procedure is to copy data from one of the critical retgions XTCBCR,
CRT or SSLP to local buffers.
The region accessed is specified by the calling process:
XTCBCR:
The terminal control block (TCB) of the terminal specified by the variable PROCESS
̲NO is copied to a buffer specified by the calling process.
CRT:
The critical region CRT is copied to a buffer specified by the caller.
SSLP:
The critical region SSLP is copied to a buffer specified by the caller.
In case of errors, MON ERROR is called and the process is terminated.
3.1.8.2 GET ̲TCB Procedure
…0e……0e… ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲…0f……0f…
F̲u̲n̲c̲t̲i̲o̲n̲a̲l̲ ̲C̲a̲p̲a̲b̲i̲l̲i̲t̲i̲e̲s̲
The procedure copies the TCB of a specified terminal from the ciritical region XTCBCR to
the local buffer TCB ̲SAVE.
At the exit from the procedure, the region is still entered by the process, that means that
no other processes can access the region.
(This procedure is used together with PUT ̲TCB).
3.1.8.3 PUT ̲TCB, Utility Procedure
…0e……0e… ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲…0f……0f…
F̲u̲n̲c̲t̲i̲o̲n̲a̲l̲ ̲C̲a̲p̲a̲b̲i̲l̲i̲t̲i̲e̲s̲
The buffer TCB ̲SAVE is copied to the ciritical region XTCBCR. The offset in the region is
determined by the terminal number specified by the call process.
The critical region must be entered before call of this procedure. (This is usually done
by the call of GET ̲TCB).
At the exit the region is 'returned' by the process. (That means that other processes are
allowed access).
3.1.8.4 UPDATE ̲TCB Utility Procedure
…0e……0e… ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲…0f……0f…
F̲u̲n̲c̲t̲i̲o̲n̲a̲l̲ ̲c̲a̲p̲a̲b̲i̲l̲i̲t̲i̲e̲s̲
The function of this procedure is to set or reset a single bit in the buffer TCB ̲SAVE.
The TCB a terminal (specified by calling process) is copied to the buffer TCB ̲SAVE (by call
of GET ̲TCB)
The update type (set or reset), the byte number is TCB ̲SAVE and the bit number in this byte
is specified by the calling process.
After update of the single bit the TCB ̲SAVE is copied to the ciritical region XTCBCR (by
call of PUT ̲TCB).
As the critical region XTCBCR is entered by GET ̲TCB and left by PUT ̲TCB, the TCB (which is
to be modified) is protected during the modification.
3.1.8.5 SCAN ̲CRT Utility Procedure
…0e……0e… ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲…0f……0f…
F̲u̲n̲c̲t̲i̲o̲n̲a̲l̲ ̲C̲a̲p̲a̲b̲i̲l̲i̲t̲i̲e̲s̲
The purpose of SCAN ̲CRT is to check if an operator input corresponds to a legal command.
The command is legal if it is found in CRT critical region (command reference table) and
if the user is allowed to use the actual command (i.e.: normal message preparaters are not
always to use supervisiary commands)
If the requested command is found, the parameters Submodule no. and Module no. corresponding
to this command is extracted from CRT.
In case the command is not found or it is illegal the procedure returns in error exit
3.1.8.6 GET ̲PROMPT Utility Procedure
…0e……0e… ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲…0f……0f…
F̲u̲n̲c̲t̲i̲o̲n̲a̲l̲ ̲C̲a̲p̲a̲b̲i̲l̲i̲t̲i̲e̲s̲
The procedure is called each time a prompt is displayed.
The prompt to be displayed is determined by the variables Command no. and sequence no.
In critical region PTT, (offset = command no) the offset to the prompt-table of the actual
command is fetched. In this table the offset and length of the prompt text corresponding
to the subsequence no. is fetched. The critical region is again accessed and the actual
prompt text is copied to the requested buffer.
3.1.9.1. I̲T̲E̲R̲R̲ ̲P̲r̲o̲c̲e̲d̲u̲r̲e̲
F̲u̲n̲c̲t̲i̲o̲n̲a̲l̲ ̲C̲a̲p̲a̲b̲i̲l̲i̲t̲i̲e̲s̲
This utility is called when an error code is to be delivered to the operator.
The error group and error number is set up and the error text is displayed/printed by call
of ITRANSFER.
3.1.9.2 ANALYSE ̲CC, Procedure
…0e……0e… ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲…0f……0f…
F̲u̲n̲c̲t̲i̲o̲n̲a̲l̲ ̲C̲a̲p̲a̲b̲i̲l̲i̲t̲i̲e̲s̲
The procedure is called by several procedures in case of an error situation.
The procedure analyses the error and determines the error group and error code.
Group and code are displayed on screen (or printed) by call of ITERR.
3.1.9.3 PSM ̲MESS Procedure
…0e……0e… ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲…0f……0f…
F̲u̲n̲c̲t̲i̲o̲n̲a̲l̲ ̲C̲a̲p̲a̲b̲i̲l̲i̲t̲i̲e̲s̲
The procedure is called when a change of a terminal status occurrs.
A system message containing terminal number and event type is sent to PSM subsystem
3.1.9.4 ID ̲PASSWORD Procedure
…0e……0e… ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲…0f……0f…
F̲u̲n̲c̲t̲i̲o̲n̲a̲l̲ ̲C̲a̲p̲a̲b̲i̲l̲i̲t̲i̲e̲s̲
The function of ID-PASSWORD is to prompt the user for either user id or user password (specified
by the caller)
The prompt is issued and the answer is checked. If the user id-password is not found among
the legal answers in the USP-file an error notice is displayed and the prompt is issued again.
If the operator fails to give a legal input within 3 attempts the procedure is returned to
the error-exit.
3.1.9.5 USER ̲PROFILE Procedure
…0e……0e… ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲…0f……0f…
F̲u̲n̲c̲t̲i̲o̲n̲a̲l̲ ̲C̲a̲p̲a̲b̲i̲l̲i̲t̲i̲e̲s̲
The function of this procedure is to check the operators answer on the prompt USER ID.
The user id returned by the operator is copied from the input buffer. The USP-file is accessed
and the user id searched among the legal user id's. If found, the user id is copied to the
TCB of the termial and the rest of the users security profile is copied from USP to a local
buffer USP ̲SAVE.
Return in link +0: user id is illegal (not found)
Return in line +1: user id is legal
3.1.9.6 EVENT ̲HANDLER Procedure
…0e……0e… ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲
F̲u̲n̲c̲t̲i̲o̲n̲a̲l̲ ̲C̲a̲p̲a̲b̲i̲l̲i̲t̲i̲e̲s̲
The procedure is called each time the status of the terminal is changed (i.e. logon, logoff,
interogate).
A system message containing the event type is sent to PSM-subsystem and a transacation log
on the log-printer is initiated by call of the monitor LOG ̲ACTION.
3.1.9.7 I̲T̲R̲E̲P̲ ̲P̲r̲o̲c̲e̲d̲u̲r̲e̲
F̲u̲n̲c̲t̲i̲o̲n̲a̲l̲ ̲C̲a̲p̲a̲b̲i̲l̲i̲t̲i̲e̲s̲
The function of this procedure is to set up the parameters for call of the monitor precedure
SEND ̲REP (which enters an element in the alarm-queue)
The procedure is called when an unsuccessful logon, logoff or security interrogation have
been detected.
3.1.9.8 S̲C̲R̲A̲M̲B̲L̲E̲ P̲A̲S̲S̲W̲ ̲P̲r̲o̲c̲e̲d̲u̲r̲e̲
F̲u̲n̲c̲t̲i̲o̲n̲a̲l̲ ̲C̲a̲p̲a̲b̲i̲l̲i̲t̲i̲e̲s̲
The Procedure is called when a password is entered. An AMOS-message is send for the SPA-process
(ref. FXA/SDS/008 sec. 3.3.2) containing the plain text password. The returned message buffer
contains the scrambled password.
3.2 I̲n̲t̲e̲r̲f̲a̲c̲e̲ ̲D̲e̲s̲c̲r̲i̲p̲t̲i̲o̲n̲
3.2.1 TEP ̲MAIN Module
…0e……0e… ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲…0f……0f…
3.2.1.1 I̲n̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲
The TEP ̲MAIN Module is invoked by:
ESP Module ref. PSP/0046
Input to TEP ̲MAIN Module:
N/A
Output from TEP ̲MAIN Module:
N/A
The TEP ̲MAIN Module interfaces to the following procedures:
TEP ̲INIT ̲REST ref. 3.1.4
Initialization of the process
ICONTROL ref. 3.1.7.4
Outputs control codes to terminal
ANALYSE ̲CC ref. 3.1.9.2
Analyses a bad completion code
GET ̲CRITICAL ̲REGION ref. 3.1.8.1
Reads a critical region
ITRANSFER ref. 3.1.7.3
Used for input and output on lower screen.
UPDATE ̲TCB ref. 3.1.8.4
Updates the TCT region
SCAN ̲CRT ref. 3.1.8.5
Scans the CRT region to find command.
ITERR ref. 3.1.9.1
Issues error code to operator
IWAIT ref. 3.1.7.5
Waits for message to unblock terminal
LON ref. 3.1.2
Supports the logon at a terminal
INT ̲TERM ref. 3.1.6
Issues the security interrogation
DSP ̲Q ̲ST ref. 3.1.5
Outputs the queue status line in case of TP.
LOF ref. 3.1.3
Supports the logoff at a terminal
PREPARE ref. PSP/0060
Prepares a message ona PDB file
DISPLAY ref. PSP/0060
Supports the display facilities
RELEASE ref. PSP/0060
Releases a message for distribution
DELETE ref. PSP/0060
Deletes a PDB message
EDIT ref. PSP/0060
Supports the editing of PDB message
COORDINATE ref. PSP/0060
Supports the coordination of a message
READDRESS ref. PSP/0060
Supports the preparation of a new message containing on old message as text part
RETRIEVE ref. PSP/0060
Supports the retrieval of a message from the HDB
RETRIEVE ̲DISTRIBUTE ref. PSP/0060
Supports the retrieval of a message from the HDB for local distribution
DISTRIBUTE ref. PSP/0093
Supports the supervisor distribution
SUPERVISION ref. PSP/0093
Supports the displaying and printing from supervisor queues
CONTROL ref. PSP/0093
Supports the terminal and queue control facilities
NPDN ̲CONNECTION ref. PSP/0093
Supports the NPDN and trunk handling
TABLE ̲HANDLING ref. PSP/0093
Displays and updates of ANO-on route tables. Request of data user reconfiguration
USP ̲TABLE ̲HANDLING REF: PSP/0093
Displays and updates the USP file
3.2.1.2 E̲x̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲
N/A
3.2.2 L̲O̲N̲ ̲P̲r̲o̲c̲e̲d̲u̲r̲e̲
3.2.2.1 I̲n̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲
The LON Procedure is invoked by the following procedure:
TEP ̲MAIN ref. 3.1.1
Input to LON
- PROCESS ̲NO (in a variable)
Terminal number
- TCB ̲SAVE (in an array)
Terminal Control Block
- USP ̲SAVE (in an array)
User Security Profile
Output from LON
- TCB (critical region)
Actual and special updates
- USP ̲SAVE (in an array)
Updated
The LON Procedure interfaces to the following procedures:
ID ̲PASSWORD ref. 3.1.9.4.
Prompt for Id ̲
Prompt for PASSWORD ̲
ITERR ref. 3.1.9.1.
Display error code
ITRANSFER ref. 3.1.7.3
Prompt for RX/TX
Write logged on dtg mode
GET ̲PROMPT ref. 3.1.8.6
Get logged on
Get RX or RX/TX
ANALYSE ̲CC ref. 3.1.9.2
Check completion code
GET ̲TCB ref. 3.1.8.2
Get special TCB
Get actual TCB
PUT ̲TCB ref. 3.1.8.3
Write TCB to critical region
EVENT ̲HANDLER
Log the action
3.2.2.2 E̲x̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲
The LON Procedure interfaces to the following monitor procedure:
MON GETDTG
Get actual dtg
3.2.3 L̲O̲F̲ ̲P̲r̲o̲c̲e̲d̲u̲r̲e̲
3.2.3.1 I̲n̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲
The LOF Procedure is invoked by the following procedure:
TEP ̲MAIN ref. 3.1.1
Input to LOF
- PROCESS ̲NO (in a variable)
Terminal number
- TCB ̲SAVE (in an array)
Termial Control Block
- USP ̲SAVE (in an array)
User Security Profile
Output from LOF
- TCB (critical region)
Actual and special updates
The LOF Procedure interfaces to the following procedures:
ID ̲PASSWORD ref. 3.1.9.4
Prompt for ID ̲
Prompt for PASSWORD ̲
ITRANSFER ref. 3.1.7.3
Write logged off dtg
GET ̲PROMPT ref. 3.1.8.6
Get logged off
ANALYSE ̲CC ref. 3.1.9.2
Check completion code
GET ̲TCB ref. 3.1.8.2
Get special TCB
Get actual TCB
PUT ̲TCB ref. 3.1.8.3
Write TCB to ciritical region
EVENT ̲HANDLER ref. 3.1.9.6
Log the action
GET ̲CRITICAL ̲REGION ref. 3.1.8.1
Get TCB
3.2.3.2 E̲x̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲
The LOF Procedure interfaces to the following monitor procedure:
MON GETDTG
Get actual dtg
3.2.4 TEP ̲INIT ̲REST Procedure
…0e……0e… ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲…0f……0f…
3.2.4.1 I̲n̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲
The TEP ̲INIT ̲REST Procedure is invoked by:
TEP ̲MAIN ref. 3.1.1.
Input to TEP ̲INIT ̲REST Procedure is:
- CONFIG region
- TCT region
- USP file
Output from TEP ̲INIT ̲REST Procedures is:
- file descriptors for MOVHEAD, FIXHEAD and RDF
- data and control channels to the terminal
- TCB save
- USP save
The TEP ̲INIT ̲REST Procedure interfaces to the following procedures:
GET ̲CRITICAL ̲REGION ref. 3.1.8.1
Loads the TCB into TCB-save
ICREATE ref. 3.1.7.1
Creates data and control channels to the terminal
ICONTROL ref. 3.1.7.4
Clears the screen
USER ̲PROFILE ref. 3.1.9.5
Checks the user profile incase of restart
ITRANSFER ref. 3.1.7.3
Issues prompt 'RESTART FINISHED'
ANALYSE ̲CC ref. 3.1.9.2
Analyses the completion code from ITRANSFER in case of error
PSM ̲MES ref. 3.1.9.3
Awaits the PSM process in case of restart
3.2.4.2 E̲x̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲
The TEP ̲INIT ̲REST Procedure interfaces to the following monitor procedures:
MON IDENTIFY PROCESS
Identifies the process
MON IO GETROOT
Gets the file descriptors for the system volumes
MON IO LOOKUP
Gets the file descriptpr for the RDF-file
MON MTCB INITE
Initiates the MTCB work area
MON REGION RCOPYN
Loads the CONFIG region into a buffer
MON ERROR
Terminals the process in case of an error
3.2.5 DSP ̲Q ̲ST Procedure
…0e……0e… ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲…0f……0f…
3.2.5.1 I̲n̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲s̲
DSP ̲Q ̲ST is invoked by:
- TEP ̲MAIN ref. 3.1.1
at start of each branching syustem (if the terminal is a type TP)
- SUPERVISION ref. PSP/0093
Input to DSP ̲Q ̲ST is:
- Status type (single or entire)
- Terminal no.
Output from DSP ̲Q ̲ST:
None
The procedure interfaces to the following procedures:
GET ̲CRITICAL ̲REGION ref. 3.1.8.1.
- When a terminal TCB is used to check whether the user is supervisor or not
- When the queue text line is copied from critical region SSLP
ITRANSFER (ref. 3.1.7.3)
When the queue status id displayed/printed
ANALYSG ̲CC (ref. 3.1.9.2)
When Itransfer returns in error exit
3.2.5.2 E̲x̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲
DSP ̲Q ̲ST interfaces to the following monitor procedures:
QACCESS
When the lengths of the terminals queues are required.
INTASC
When queue lengths are converted to ascii characters
GETDTG
When current DTG in ascii is required
ERROR
When a fatal error occurs
3.2.6 INT ̲TERM Procedure
…0e……0e… ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲…0f……0f…
3.2.6.1 I̲n̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲
INT ̲TERM is invoked by:
TEP ̲MAIN ref. 3.1.1
Input to INT ̲TERM:
- Terminal no (in variable PROCESS ̲NO)
Output from INT ̲TERM:
None
The following procedures are called:
ITRANSFER ref. 3.1.7.3
When displaying the text SECURITY INTERROGATION
ID ̲PASSWORD ref. 3.1.9.4
When checking user id and password
EVENT ̲HANDLER ref. 3.1.9.6
When an operator caused error occurs
GET ̲TCB ref. 3.1.8.2
PUT ̲TCB ref. 3.1.8.3
When the interrogate-bit in TCB is cleared
PSM ̲MESS ref. 3.1.9.3
When a system message is sent to PSM
3.2.6.2 E̲x̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲
None
3.2.7.1 I̲C̲R̲E̲A̲T̲E̲ ̲P̲r̲o̲c̲e̲d̲u̲r̲e̲
3.2.7.1.1 I̲n̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲
The ICREATE Procedure is invoked by:
TEP ̲INIT ̲REST ref. 3.1.4.
Input to ICREATE is:
. Process no
. TCB-save
Output from ICREATE is:
. Operations reference for control channel
3.2.7.1.2 E̲x̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲
The ICREATE Procedure interfaces to the following monitor procedures:
MON LCFH
Creates a channel to the terminal
MON IO APPENDBYTES
Resets the LTU by means of 80 null chars.
MON IO INITREADBYTES
Sets up a read on the control channel
MON ERROR
Terminates the process in case of an error
3.2.7.2 I̲R̲E̲C̲R̲E̲A̲T̲E̲ ̲P̲r̲o̲c̲e̲d̲u̲r̲e̲
3.2.7.2.1 I̲n̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲
The IRECREATE Procedure is invoked by the procedure:
PREPARE ref. PSP/0060
Input to IRECREATE
- Channel request - VDU or TP (in register)
Output from IRECREATE
- LONG ̲LINE ̲D (variable)
Data channel pointer updated
The IRECREATE procedure interfaces to no internal procedures
3.2.7.2.2 E̲x̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲
None
3.2.7.3 I̲T̲R̲A̲N̲S̲F̲E̲R̲ ̲P̲r̲o̲c̲e̲d̲u̲r̲e̲
3.2.7.3.1 I̲n̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲
The procedure is invoked by the following procedures:
TEP ̲MAIN ref. 3.1.1
LON ref. 3.1.2
LOF ref. 3.1.3
TEP ̲INIT ̲REST ref. 3.1.4
DSP ̲Q ̲ST ref. 3.1.5
INT ̲TERM ref. 3.1.6
ITERR ref. 3.1.9.1
ID ̲PASSWORD ref. 3.1.9.4
PREPARE ref. PSP/0060
READ ̲INPUT ref. PSP/0060
TP ̲MASK ̲IO ref. PSP/0060
ACC ̲NEW ̲LINE ref. PSP/0060
DISP ̲CUR ̲LINE ref. PSP/0060
COORDINATOR ̲TERM ref. PSP/0060
QUEUE ̲INDEX ref. PSP/0060
PDB ̲MSG ̲STATUS ref. PSP/0060
DISP ̲LINES ref. PSP/0060
ORIGINATOR ̲RELEASE ref. PSP/0060
RELEAE ̲TO ̲MDS ref. PSP/0060
READDRESS ref. PSP/0060
KDB ̲DATA ref. PSP/0060
MES ̲ERROR ref. PSP/0060
CR ̲NEW ̲MESSAGE ref. PSP/0060
PROMPT ̲DTG ref. PSP/0060
GET ̲PLAIN ̲ADDR ref. PSP/0060
DISP ̲MESSAGE ref. PSP/0060
ESM ref. PSP/0093
SUPERVISION ref. PSP/0093
TABLE ̲HANDLING ref. PSP/0093
USP ̲TABLE ̲HANDLING ref. PSP/0093
Input to ITRANSFER
The necessary input depends on the used branch
In general:
- not used register 0
- Transfer type (branch) register 1
- Link register 6
WRITE:
- Character position register 2
- Line position register 3
- Text buffer address register 4
- No of bytes to send register 5
READ:
- Receive buffer address register 4
- Receive buffer size register 5
- Delay time register 7
INIT ̲READ:
- Receive buffer address register 4
- Receive buffer size register 5
COMPLETE ̲INIT ̲READ:
- Delay time register 7
PROMPT ̲READ,
PROMPT ̲PASSWORD:
- Command number register 2
- Prompt sequence number register 3
- Receive buffer address register 4
- Receive buffer address register 5
- Delay time register 7
PROMPT:
- Command number register 2
- Prompt sequence number register 3
- Prompt buffer address register 4
- Prompt buffer size register 5
WRITE ̲ERROR:
- Error group register 2
- Error code register 3
Output from ITRANSFER
The output depends on the used branch:
In general:
- Register 0 gives completion code
- Register 1 unchanged
- Register 2 unchanged
- Register 3 unchanged
- Register 6 return point
- Register 7 unchanged if transfer OK otherwise IO error code
WRITE:
- Register 4 unchanged
- Register 5 no of bytes transferred
READ
PROMPT ̲READ
PROMPT ̲PASSWORD:
- Register 4 unchanged
- Register 5 no of bytes received
WRITE ̲ERROR,
INIT ̲READ:
- Register 4 unchanged
- Register 5 unchanged
COMPLETE ̲INIT ̲READ:
- Register 4 receive buffer address
- Register 5 no of received bytes
PROMPT:
- Register 4 unchanged
- Register 5 prompt size
The ITRANSFER Procedure interfaces to the following procedures:
WAIT ̲TIME ̲OUT
delay routine
INIT ̲CHANNELS
initiate read on data and control channel
IWAIT
wait IO completion
ERROR ̲HANDL
log the error
GET ̲PROMPT
get prompt from critical region
3.2.7.3.2 E̲x̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲
The ITRANSFER Interfaces to the following monitor procedures:
MON ERROR
log the error
MON APPVDUTRAN
append to VDU
MON IO APPENDBYTES
append to terminal
3.2.7.4 I̲C̲O̲N̲T̲R̲O̲L̲ ̲P̲r̲o̲c̲e̲d̲u̲r̲e̲
3.2.7.4.1 I̲n̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲
The ICONTROL Procedure is invoked by the following procedures:
TEP ̲MAIN ref. 3.1.1
TEP ̲INIT ̲REST ref. 3.1.4
IWAIT ref. 3.1.7.5
PREPARE ref. PSP/0060
READ ̲INPUT ref. PSP/0060
QUEUE ̲INDEX ref. PSP/0060
DISP ̲HDB ̲MSG ref. PSP/0060
DISP ̲LINES ref. PSP/0060
READDRESS ref. PSP/0060
CANCEL ̲FIX ̲UP ref. PSP/0060
DISP ̲MESSAGE ref. PSP/0060
KEYBOARD ̲CTRL ref. PSP/0060
Input to ICONTROL
- Ref to a workbuffer (in register)
The buffer contains the control codes
- No of control codes (in register)
- TCB ̲SAVE (in array)
Terminal status
- LOG ̲LINE ̲D (in variable)
Ref. to data channel
Output from ICONTROL
- Completion code
- Commands transmitted to terminal
The ICONTROL Procedure interfaces to the following procedure:
WAIT ̲TIME ̲OUT ref. 3.1.7.6
Delay routine
3.2.7.4.2 E̲x̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲
The ICONTROL Procedure interfaces to the following monitor procedures:
MON APPVDUCON
Append control codes to VDU
MON ERROR
log the error
MON IO APPENDBYTES
Append to terminal
3.2.7.5 I̲W̲A̲I̲T̲ ̲P̲r̲o̲c̲e̲d̲u̲r̲e̲
3.2.7.5.1 I̲n̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲
The IWAIT Procedure is invoked by:
TEP ̲MAIN ref. 3.1.1
ITRANSFER ref. 3.1.7.3
Input to IWAIT Procedure is:
- delay value (register)
- wait code (register)
- OP ̲REF ̲D (variable)
- OP ̲REF ̲C (variable)
- TCB ̲SAVE (variable)
Output from IWAIT Procedure is:
- no of bytes received (registered)
- completion code (registered)
- reset poll-bit in XTCBCR
The IWAIT Procedure interfaces to the following procedures:
ITREP ref.3.1.9.7
Sends a report in case of long line detected.
ICONTROL ref. 3.1.7.4
Issue a new line (NL) or the VDU made in case of a unknown function key
INIT ̲CHANNELS ref. 3.1.7.7
Initiates the reads on the data- and control- channels
3.2.7.5.2 E̲x̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲s̲
The IWAIT Procedure interfaces to the following monitor procedures:
MON IO CANCEL
Cancels the read on the data channel.
MON SENDANSWER
Returns an anser if a message is received
MON IO WAITOPERATIONS
Waits for IO-operations to complete, wait for a message or an answer.
MON ERROR
Terminates the process in case of a serious error
3.2.7.6 WAIT ̲TIME ̲OUT Procedure
…0e……0e… ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲…0f……0f…
3.2.7.6.1 I̲n̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲
The procedure is invoked by the following procedures:
ITRANSFER ref. 3.1.7.3
ICONTROL ref. 3.1.7.4
Input to WAIT ̲TIME ̲OUT
None
Output from WAIT ̲TIME ̲OUT
None
The WAIT ̲TIME ̲OUT Procedure interfaces to no internal procedures
3.2.7.6.2 E̲x̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲
The WAIT ̲IMTE ̲OUT Procedure interfaces to the following monitor procedure:
MON WAITEVENT
Wait for a period of time
3.2.7.7 INIT ̲CHANNELS
…0e……0e… ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲…0f……0f…
3.2.7.7.1 I̲n̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲
The procedure is invoked by the procedures:
ITRANSFER ref. 3.1.7.3
IWAIT ref. 3.1.7.5
Input to INIT ̲CHANNELS:
- Ref. to file address (in register)
Ref to actual data channel
- Ref to buffer list element (in register)
Ref to actual BLE
- OP ̲REF ̲D (in a variable)
Ref to data channel
- OP ̲REF ̲C (in a variable)
Ref to control channel
Output from INIT ̲CHANNELS:
- Read initiated on channel(s)
- OP ̲REF ̲D (in a variable)
OP ̲REF ̲C (in a variable)
channel refs updated
In case of error exit (LINK)
- Error location code (in register)
The INIT ̲CHANNELS interfaces to no internal procedures
3.2.7.7.2 E̲x̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲
The INIT ̲CHANNELS Procedure interfaces to the following monitor procedure:
MON IO INITREADBYTES
Initiate read ondata or control channel
3.2.8.1 GET ̲CRITICAL ̲REGION Procedure
…0e……0e… ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲…0f……0f…
3.2.8.1.1 I̲n̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲
The utility procedure GET ̲CRITICAL ̲REGION is invoked by the procedures:
SCAN ̲CRT ref. 3.1.8.5
DSP ̲Q ̲ST ref. 3.1.5
TEP ̲MAIN ref. 3.1.1
LOF ref. 3.1.3
TEP ̲INIT ̲REST ref. 3.1.1
Input to GET ̲CRITICAL ̲REGION:
- Region number (register)
- Address of destination
buffer (register)
Output from GET ̲CRITICAL ̲REGION:
Contents of specified critical region in the specified buffer
3.2.8.1.2 E̲x̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲
The following monitor procedures are called:
MON REGION
MON ERROR
3.2.8.2 GET ̲TCB Procedure
…0e……0e… ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲…0f……0f…
3.2.8.2.1 I̲n̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲
The procedure GET ̲TCB is called by:
LON ref. 3.1.2
LOF ref. 3.1.3
INIT ̲TERM ref. 3.1.6
UPDATE ̲TCB ref. 3.1.8.4
USER ̲PROFILE ref. 3.1.9.5
Input to GET ̲TCB:
- Terminal no (in register)
Output from GET ̲TCB:
- TCB of specified terminal in the buffer TCB ̲SAVE
3.2.8.2.2 E̲x̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲s̲
The following monitor are called:
MON REGION
MON ERROR
3.2.8.3 PUT ̲TCB Procedure
…0e……0e… ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲…0f……0f…
3.2.8.3.1 I̲n̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲
PUT ̲TCB is called by:
LON ref. 3.1.2
LOF ref. 3.1.3
INT ̲TERM ref. 3.1.6
UPDATE ̲TCB ref. 3.1.8.4
USER ̲PROFILE ref. 3.1.9.5
Input to PUT ̲TCB:
- Terminal number (in register)
- TCB (in buffer TCB ̲SAVE)
Output from PUT ̲TCB:
None
3.2.8.3.2 E̲x̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲
The following monitors are called:
MON REGION
MON ERROR
3.2.8.4 UPDATE ̲TCB Procedure
…0e……0e… ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲…0f……0f…
3.2.8.4.1 I̲n̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲
The procedure UPDATE ̲TCB is called by:
TEP ̲MAIN ref. 3.1.1
Input to UPDATE ̲TCB:
- Terminal no (variable PROCESS ̲NO)
- Update type (set/reset bit) (register)
- Byte number (register)
- bit number (register)
Output from UPDATE ̲TCB:
- The buffer TCB ̲SAVE and the critical region XTCBCR is modified
The procedure interfaces to the procedures:
SET ̲TCB
(A TCB is copied to TCB ̲SAVE)
PUT ̲TCB
(A TCB is copied to critical region XTCBCR)
3.2.8.4.2 E̲x̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲
None
3.2.8.5 SCAN ̲CRT Procedure
…0e……0e… ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲…0f……0f…
3.2.8.5.1 I̲n̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲
SCAN ̲CRT are invoked by the procedure:
TEP ̲MAIN ref. 3.1.1
Input to SCAN ̲CRT:
- address of buffer
containing operator input (register)
- operator type (MSP,
Supervisor, assistant) (register)
Output from SCAN ̲CRT:
- Command no (register)
- Module no (register)
- Submodule no (register)
The procedure GET ̲CRITICAL ̲REGION
is called ref. 3.1.8.1
3.2.8.5.2 E̲x̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲
None
3.2.8.6 GET ̲PROMPT Procedure
…0e……0e… ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲…0f……0f…
3.2.8.6.1 I̲n̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲
GET ̲PROMPT is accessed by:
LON ref. 3.1.2
LOF ref. 3.1.3
ITRANSFER ref. 3.1.7.3
Input to GET ̲PROMPT:
- Command no (in register)
- Sequence no (in register)
- Address of destination
buffer (in buffer)
Output from GET ̲PROMPT:
- No of bytes in the
text string (in register)
- the prompt text (in buffer specified at call)
3.2.8.6.2 E̲x̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲
The following monitor procedures are called:
- MON REGION
- MON ERROR
3.2.9.1 I̲T̲E̲R̲R̲ ̲P̲r̲o̲c̲e̲d̲u̲r̲e̲
3.2.9.1.1 I̲n̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲
The ITERR Procedure is invoked by:
TEP ̲MAIN ref. 3.1.1
LON ref. 3.1.2
ANALYSE ̲CC ref. 3.1.9.2
ID ̲PASSWORD ref. 3.1.9.4
Input to ITERR:
- Error Group (in register)
- Error number (in register)
Output from ITERR:
None
The procedure ITRANSFER is called (when the error text is issued).
3.2.9.1.2 E̲x̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲
None
3.2.9.2 ANALYSE ̲CC Procedure
…0e……0e… ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲…0f……0f…
3.2.9.2.1 I̲n̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲
The procedure ANALYSE ̲CC is called by:
LON ref. 3.1.2
LOF ref. 3.1.3
TEP ̲INIT ̲REST ref. 3.1.4
DSP ̲Q ̲ST ref. 3.1.5
ID ̲PASSWORD ref. 3.1.9.4
Input to ANALYSE ̲CC:
- Error Code (in register)
- Completion code (in register)
Output from ANALYSE ̲CC:
None
The utility procedure ITERR (ref. 3.1.9.1) is called by this procedure.
3.2.9.2.2 E̲x̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲
None
3.2.9.3 PSM ̲MESS Procedure
…0e……0e… ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲…0f……0f…
3.2.9.3.1 I̲n̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲
PSM ̲MESS Procedure is invoked by:
TEP ̲INIT ̲REST ref. 3.1.4
INT ̲TERM ref. 3.1.6
EVENT ̲HANDLER ref. 3.1.9.6
Input to PSM ̲MESS:
- Terminal number
- Event code
Output from PSM ̲MESS:
None
3.2.9.3.2 E̲x̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲
The following monitor procedures are called:
MON SENDMESSAGE
3.2.9.4 ID ̲PASSWORD Procedure
…0e……0e… ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲…0f……0f…
3.2.9.4.1 I̲n̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲
ID ̲PASSWORD is invoked by:
INT ̲TERM ref. 3.1.6
LON ref. 3.1.2
LOF ref. 3.1.3
Input to ID ̲PASSWORD:
- Command no (in register)
- Sequence no (in register)
- Reference to a work area (in register)
Output from ID ̲PASSWORD:
The critical region XTCB is updated
Procedures call by ID ̲PASSWORD:
ITERR ref.3.1.9.1
in case of an operator caused error
ITRANSFER ref. 3.1.7.3
when issuing a prompt
ANALYSE ̲CC ref. 3.1.9.2
when ITRANSFER returns in error exit
USER ̲PROFILE ref. 3.1.9.5
When a prompt answer is checked
SCRAMBLE ̲PASSW ref. 3.1.9.8
Scramble Passwords
3.2.9.4.2 E̲x̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲
None
3.2.9.5 USER ̲PROFILE Procedure
…0e……0e… ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲…0f……0f…
3.2.9.5.1 I̲n̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲
USER ̲PROFILE is invoked by the procedures:
ID ̲PASSWORD ref. 3.1.9.4
TEP ̲INIT ̲REST ref. 3.1.4
Input to USER ̲PROFILE:
- offset to user id
in input buffer (in register)
- offset to input buffer (in register)
- reference to work buffer
Output from USER ̲PROFILE:
- User security profile (in buffer USP ̲SAVE)
Procedures called by USER ̲PROFILE:
GET TCB ref. 3.1.8.2
PUT ̲TCB ref. 3.1.8.3
3.2.9.5.2 E̲x̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲
The following monitor procedures are called by USER ̲PROFILE:
MON GETUSP
MON ERROR
3.2.9.6 EVENT ̲HANDLER Procedure
…0e……0e… ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲…0f……0f…
3.2.9.6.1 I̲n̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲
EVENT ̲HANDLER is called by the procedures:
LON ref. 3.1.2
LOF ref. 3.1.3
INT ̲TERM ref. 3.1.6
Input to EVENT ̲HANDLER:
- Event type (in register)
Output from EVENT ̲HANDLER:
None
The following procedures are called:
ITREP ref. 3.1.9.7
When a alarm is generated
PSM ̲MESS ref. 3.1.9.3
When a system message is sent to PSM
3.2.9.6.2 E̲x̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲
The following monitor procedures are called:
MON LOG ̲ACTION
MON ERROR
3.2.9.7 I̲T̲R̲E̲P̲ ̲P̲r̲o̲c̲e̲d̲u̲r̲e̲
3.2.9.7.1 I̲n̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲
ITREP is invoked by:
IWAIT ref. 3.1.7.5
EVENT ̲HANDLER ref. 3.1.9.6
Input to ITREP:
- Report type (register)
Output from ITREP:
None
3.2.9.7.2 E̲x̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲
The following monitor procedures are called:
MON LOG ̲ACTION
MON ERROR
3.2.9.8 S̲C̲R̲A̲M̲B̲L̲E̲ P̲A̲S̲S̲W̲ ̲P̲r̲o̲c̲e̲d̲u̲r̲e̲
3̲.̲2̲.̲9̲.̲8̲.̲1̲ I̲n̲t̲e̲r̲n̲a̲l̲ ̲I̲n̲t̲e̲r̲f̲a̲c̲e̲
SCRAMBLE ̲PASSWORD is invoked by:
ID ̲PASSWORD ref. 3.1.9.4
Input to SCRAMBLE ̲PASSWORD:
Reference to password (in register)
Output from SCRAMBLE ̲PASSW:
Reference to scrambled password
3.2.9.8.2 External Interface
The following Monitor Procedures are called:
MON SENDMESSAGE
MON WAITANSWER
ins`ttes 53 sider for tegninger
3.4 D̲a̲t̲a̲ ̲O̲r̲g̲a̲n̲i̲z̲a̲t̲i̲o̲n̲
Please refer to:
Source listings and
FIKS File Generators PSP FIX/1200/PSP/0042
3.5 S̲t̲o̲r̲a̲g̲e̲ ̲A̲l̲l̲o̲c̲a̲t̲i̲o̲n̲
Please refer to:
FIKS S/W Configuration
Lib. Descr. Doc. FIX/1000/EWP/0080
3.6 P̲e̲r̲f̲o̲r̲m̲a̲n̲c̲e̲ ̲C̲h̲a̲r̲a̲c̲t̲e̲r̲i̲s̲t̲i̲c̲
N/A
3.7 L̲i̲m̲i̲t̲a̲t̲i̲o̲n̲s̲
N/A
3.8 E̲r̲r̲o̲r̲ ̲C̲o̲d̲e̲s̲/̲E̲r̲r̲o̲r̲ ̲L̲o̲c̲a̲t̲i̲o̲n̲s̲
In case of an operator error the ITM will issue an error notification to the operator.
The following format is used:
?-X: YYY
where X will identify the group of the error (e.g. syntac error, security error) and YYY
will be the error code.
ITM error codes are listed below:
ERROR ̲GROUP ̲SEM = 2
UNKNOWN ̲MODULE ̲NAME = 010
ILLEGAL ̲LON ̲REQUEST = 020
ERROR ̲GROUP ̲SECUR = 3
ILLEGAL ̲USER ̲ID = 010
ILLEGAL ̲PASSWORD = 011
When a monitor returns with an error, this error code will be reported on the console togeher
with an error label which points out the location in the ITM code. The error labels are
listed here:
D̲e̲c̲i̲m̲a̲l̲ ̲V̲a̲l̲u̲e̲ R̲a̲i̲s̲e̲d̲ ̲b̲y̲ ̲c̲a̲l̲l̲ ̲o̲f̲ L̲o̲c̲a̲t̲e̲a̲d̲ ̲i̲n̲ ̲P̲r̲o̲c̲e̲d̲u̲r̲e̲
20010 MON IO GETROOT TEP ̲INIT ̲REST
20020 MON IO GETROOT TEP ̲INIT ̲REST
20040 MON IO LOOKUP TEP ̲INIT ̲REST
20050 MON MTCB INITE TEP ̲INIT ̲REST
20070 MON REGION RCOPYN TEP ̲INIT ̲REST
20410 MON INTASC DSP ̲Q ̲ST
20610 MON LCFH ICREATE
20620 MON IO APPEND BYTES ICREATE
D̲e̲c̲i̲m̲a̲l̲ ̲V̲a̲l̲u̲e̲ R̲a̲i̲s̲e̲d̲ ̲b̲y̲ ̲c̲a̲l̲l̲ ̲o̲f̲ L̲o̲c̲a̲t̲e̲a̲d̲ ̲i̲n̲ ̲P̲r̲o̲c̲e̲d̲u̲r̲e̲
20901 INIT ̲CHANNELS ITRANSFER
20902 INIT ̲CHANNELS ITRANSFER
20911 INIT ̲CHANNELS ITRANSFER
20912 INIT ̲CHANNELS ITRANSFER
20921 INIT ̲CHANNELS ITRANSFER
20922 INIT ̲CHANNELS ITRANSFER
20931 INIT ̲CHANNELS ITRANSFER
20932 INIT ̲CHANNELS ITRANSFER
21000 MON APPVDUCON ICONTROL
21010 MON IO APPEND BYTES ICONTROL
21115 ICONTROL IWAIT
21120 MON IO WAITOPERATIONS IWAIT
21132 MON IO CANCEL IWAIT
21140 MON IO WAITOPERATIONS IWAIT
21146 INIT ̲CHANNELS IWAIT
21147 INIT ̲CHANNELS IWAIT
21400 MON SEND ̲REPORT ITREP
21700 MON REGION RENTER GET ̲CRITICAL ̲REGION
21700 MON REGION RGETN GET ̲CRITICAL ̲REGION
21700 MON REGION RECOPYN GET ̲CRITICAL ̲REGION
21700 MON REGION RLEAVE GET ̲CRITICAL ̲REGION
21800 MON REGION RENTER GET ̲TCB
21800 MON REGION RGETN GET ̲TCB
21900 MON REGION RPUTN PUT ̲TCB
21910 MON REGION RLEAVE PUT ̲TCB
21930 Illegal CC from checkpoint PUT ̲TCB
22200 MON REGION RCOPYN GET ̲PROMPT
22500 MON APPVDUTRAN ITRANSFER
22510 MON IO APPENDBYTES ITRANSFER
22500 MON LOG ̲ACTION EVENT ̲HANDLER
23200 MON GETUSP USER ̲PROFILE
3.9 L̲i̲s̲t̲i̲n̲g̲ ̲R̲e̲f̲e̲r̲e̲n̲c̲e̲
Please refer to:
FIKS S/W Configuration
Control Lib. Descr. Doc. FIX/1000/EWP/0080
4 Q̲U̲A̲L̲I̲T̲Y̲ ̲A̲S̲S̲U̲R̲A̲N̲C̲E̲
4.1 Q̲u̲a̲l̲i̲f̲i̲c̲a̲t̲i̲o̲n̲ ̲T̲e̲s̲t̲s̲
Please refer to:
System Test Report S010 FIX/0000/TRP/0085
System Test Report S020 FIX/0000/TRP/0086
4.2 O̲t̲h̲e̲r̲ ̲Q̲u̲a̲l̲i̲t̲y̲ ̲A̲s̲s̲u̲r̲a̲n̲c̲e̲
N/A
5 P̲R̲E̲P̲A̲R̲A̲T̲I̲O̲N̲ ̲F̲O̲R̲ ̲D̲E̲L̲I̲V̲E̲R̲Y̲
Please refer to:
FIKS S/W Configuraton
Control Lib. Descr. Doc. FIX/1000/EWP/0080
6 N̲O̲T̲E̲S̲
N/A
7 A̲P̲P̲E̲N̲D̲I̲C̲E̲S̲
N/A…86…W …02… …02… …02… …02… …02…
