GY30 2027 0_TCAM_Serviceability_Aids_Program_Logic_Rel_20_Mar71 0 TCAM Serviceability Aids Program Logic Rel 20 Mar71

GY30-2027-0_TCAM_Serviceability_Aids_Program_Logic_Rel_20_Mar71 GY30-2027-0_TCAM_Serviceability_Aids_Program_Logic_Rel_20_Mar71

User Manual: GY30-2027-0_TCAM_Serviceability_Aids_Program_Logic_Rel_20_Mar71

Open the PDF directly: View PDF .
Page Count: 208

Download
Open PDF In Browser	View PDF

GY30-2027-0

Systems

IBM System/360
Operating System
TeAM Serviceability Aids:
Program Logic Manual
Program Number 3605 - CO - 548
This publication describes the internal logic of the Operating
System Telecommunications Access Method Serviceability
Aids. It is intended for use by IBM Program Systems Representatives and system programmers who are altering the
program design.

Preface

This publication is divided into two major sections:
I. Telecommunications On-Line Test Executive (TOTE)

contains the internal logic for the on-line tests that operate
as part of the TCAM System. This section is further subdivided into six chapters.
1. Introduction to on-line testing explains the concept of
on-line testing used in connection with TCAM.
2. Method of Operation explains, in big-picture form, the
way in which TOTE handles on-line tests.
3. Program Organization contains descriptions of the
TOTE modules, a listing of the modules by number,
and Ii diagram showing how TOTE functions internally.
4. Data Area Layouts contains diagrams of the TOTE
control blocks.
5. Diagnostic Aids contains tables of register usage,
module cross-reference tables, tables of operator and
system messages, and a table of macros used by TOTE
modules.
6. Flowcharts contain diagrams of internal logic flow in
TOTE modules.
II. Field Engineering Service Aids contains the internal logic
for the service aids that are used as a debugging tool by
Field Engineering Program Support Representatives. This
section is further subdivided into five chapters.

1. Introduction to Service Aids explains the concept of
the FE Service Aids supplied with TCAM.
2. Service Aids Flow Diagram shows the relation of the
various service aid modules to TCAM and to each other.
3. Module Descriptions describe each service aid module
internally.
4. Diagnostic Aids contains tables of register usage by
module and tables of messages.
5. Flowcharts are diagrams of internal logic flow in the
Service Aid modules.
This publication is designed to be a reference guide to IBM
Field Engineering Program Systems Representatives and to
system programmers who may need to modify the system.
Effective use of this manual is based on an understanding
of Systemj360 machine concepts, operational knowledge of
the devices supported, and a knowledge of the following IBM
Systemj360 publications.
• IBM System/360 Telecommunications Access Method
(TCAM) Programmer's Guide and Reference Manual,
Order No. GC30-2024.
• IBM System/360 Telecommunications Access Method
(TCAM) Concepts and Facilities, Order No. GC30-2022.
• IBM System/360 Telecommunications Access Method
(TCAM) Program Logic Manual, Order No. GY30-2029.

First Edition (March 1971)

This edition is a part of Release 20.0 of the System/360 Operating System in conjunction with the Telecommunications Access Method (TCAM).
Requests for copies of IBM pUblications should be made to your IBM representative
or to the IBM branch office serving your locality.
A form is provided in the back of this publication for reader's comments. If the form
has been removed, comments may be addressed to IBM Corporation, Publications
Center, Dept. E01, P. O. Box 12275, Research Triangle Park, North Carolina 27709.

Contents

Introduction to On-Line Testing

Method of Operation

Program Organization

Data Area Layouts

41
41

On-Line Test Control Block
Diagnostic Aids .

Service Aid Flow Diagram .
STCB Trace Dump Flow
Line I/O Trace Dump Flow
Buffer Dump Flow .

169
169
170
171
172

Module Descriptions

173

Diagnostic Aids .

Introduction to Service Aids

49
49
59
74
75
76

181
181
184
184
185

Flowcharts

189

Index.

201

iii

Charts

Module

Chart 10

Chart Name

Page

IEDQWA
IEDQWB

QWA
QWB
WBA
QWC
WCA
WCl
WC2
QWD
WD2
QWE
WEA
QWF
QWH
WHA
WHB
QWI
102
WIl
WIA
IAI
WID
WI5
I5D
I5U
WI6
WI7
I7A
WI8
WI9
QWJ
WJA
JAI
WJB
WJC
WJD
WJE
WJI
JIA
JIB
JIC
JID
WJ2
J2A
QWK
QWL
WMI
QWN
WNI

TOTE RESIDENT MODULE
RESOURCE MANAGEMENT MODULE (part 1 of 2)
RESOURCE MANAGEMENT MODULE (part 2 of 2)
TRM ANALYSIS MODULE (Part 1 of 2)
TRM ANALYSIS MODULE (Part 2 of 2)
TRM ANALYSIS MODULE 1
TRM ANALYSIS MODULE 2
TOTE DISPATCHER (part 1 of2) .
TOTE DISPATCHER (part 2 of2) .
OLT TEST CONTROL MODULE 1 (part 1 of 2)
OLT TEST CONTROL MODULE 1 (part 2 of 2)
OLT TEST CONTROL MODULE 2
NUMERIC TRM HANDLER (part 1 of 3)
NUMERIC TRM HANDLER (part 2 of 3)
NUMERIC TRM HANDLER (part 3 of 3)
TOTE CONFIGURATOR SCHEDULER (part 1 of 3)
TOTE CONFIGURATOR SCHEDULER (part 2 of 3)
TOTE CONFIGURATOR SCHEDULER (part 3 of 3)
CONFIGURATOR ADD SCHEDULER MODULE (part 1 of 2)
GONFIGURATOR ADD SCHEDULER MODULE (Part 2 of 2)
CONFIGURATOR DELETE SCHEDULER .
CONFIGURATOR SUBMODULE 1
CONFIGURATOR DELETE SUBMODULE .
CONFIGURATOR CHANGE SUBMODULE
CONFIGURATOR SUBMODULE 2
CONFIGURATOR SUBMODULE 3 (part 1 of2)
CONFIGURATOR SUBMODULE 3 (part 2 of 2)
CONFIGURATOR SUBMODULE 4
CONFIGURATOR SUBMODULE 5
TRM PROMPTER MODULE 1 (part 1 of 7) .
TRM PROMPTER MODULE 1 (part 2 of 7) .
TRM PROMPTER MODULE 1 (Part 3 of 7) .
TRM PROMPTER MODULE 1 (Part 4 of 7) .
TRM PROMPTER MODULE 1 (part 5 of 7) .
TRM PROMPTER MODULE 1 (part 6 of 7) .
TRM PROMPTER MODULE 1 (part 7 of 7) .
TRM PROMPTER MODULE 2 (Part 1 of 5) .
TRM PROMPTER MODULE 2 (part 2 of 5) .
TRM PROMPTER MODULE 2 (part 3 of 5) .
TRM PROMPTER MODULE 2 (part 4 of 5) .
TRM PROMPTER MODULE 2 (part 5 of 5) .
TRM PROMPTER MODULE 3 (Part 1 of 2) .
TRM PROMPTER MODULE 3 (part 2 of 2) .
TOTE MESSAGE MODULE .
TOTE MESSAGE SUBMODULE
TOTE SERVICE MODULE
EXIO SERVICE MODULE (part 1 of 2)
EXIO SERVICE MODULE (part 2 of 2)

79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
III
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126

IEDQWC
IEDQWCl
IEDQWC2
IEDQWD
IEDQWE
IEDQWF
IEDQWH

IEDQWI

IEDQWIA
IEDQWID
IEDQWI5
IEDQWI5D
IEDQWI5U
IEDQWI6
IEDQWI7
IEDQWI8
IEDQWI9
IEDQWJ

IEDQWJI

IEDQWJ2
IEDQWK
IEDQWL
IEDQWMI
IEDQWN

Module

Chart 10

Chart Name

Page

IEDQWO
IEDQWP
IEDQWPI
IEDQWP2
IEDQWQ
IEDQWR
IEDQWS

QWO
QWP
WPI
WP2
QWQ
QWR
QWS
WSA
WSB
QWV
QWX
QWY
Q30
Q31
31A
31B
31C
31D
31E
31F
Q32
32A
Q33
33A
33B
3Bl
Q34
34A
Q35
35A
35B
Q36
36A
36B
Q37
37A
Q38
38A
38B
QC6
C62
EI0
E20
E30
FWI
FW2
FW3
QXB
XCI
XC2
None

ACCESS MANAGER
DPRINT SERVICE MODULE
DPRINT SERVICE MODULE 1 .
DPRINT SERVICE MODULE 2 .
CECOM SERVICE MODULE
PLINK SERVICE MODULE .
WAITIO SERVICE ROUTINE (part 1 of 3) .
WAITIO SERVICE ROUTINE (part 2 of 3) .
WAITIO SERVICE ROUTINE (part 3 of 3) .
GRAB SERVICE MODULE .
CONVERT SERVICE MODULE
GETCONFG SERVICE MODULE
REMOTE ACCESS ERROR MODULE
ENABLING MODULE (part 1 of 7)
ENABLING MODULE (part 2 of 7)
ENABLING MODULE (part 3 of 7)
ENABLING MODULE (part 4 of 7)
ENABLING MODULE (Part 5 of 7)
ENABLING MODULE (part 6 of 7)
ENABLING MODULE (Part 7 of 7)
BSC REMOTE PRINT MODULE (part 1 of 2)
BSC REMOTE PRINT MODULE (Part 2 of 2)
START-STOP REMOTE PRINT-2740 (Part 1 of 4)
START-STOP REMOTE PRINT-2740 (Part 2 of 4)
START-STOP REMOTE PRINT-2740 (Part 3 of 4)
START-STOP REMOTE PRINT-2740 (Part 4 of 4)
BSC REMOTE PRINT SUBMODULE (part 1 of 2)
BSC REMOTE PRINT SUBMODULE (part 2 of 2)
START -STOP REMOTE PRINT -1050 & 1060 (Part 1 of 3)
START-STOP REMOTE PRINT-1050 & 1060 (part 2 of 3)
START-STOP REMOTE PRINT-I050 & 1060 (part 3 of 3)
START -STOP REMOTE PRINT -1030 (part 1 of 3) .
START-STOP REMOTE PRINT -1030 (part 2 of 3) .
START-STOP REMOTE PRINT-1030 (Part 3 of 3) .
START-STOP REMOTE PRINT-2260 & 2265 (Part 1 of 2)
START-STOP REMOTE PRINT -2260 & 2265 (Part 2 of 2)
START-STOP REMOTE PRINT-2741 (Part 1 of 3)
START-STOP REMOTE PRINT-2741 (Part 2 of3)
START-STOP REMOTE PRINT-2741 (Part 3 of 3)
DEBUG SERVICE AID ROUTER (Part 1 of 2)
DEBUG SERVICE AID ROUTER (part 2 of 2)
SUBTASK CONTROL BLOCK TRACE DUMP .
LINE I/O TRACE DUMP .
BUFFER DUMP .
COMMON WRITE ROUTINE (part 1 of 3)
COMMON WRITE ROUTINE (part 2 of 3)
COMMON WRITE ROUTINE (part 3 of 3)
TCAM TRACE FORMAT ROUTINE .
TCAM MESSAGE QUEUE PRINT (Part 1 of 2)
TCAM MESSAGE QUEUE PRINT (part 2 of 2)
SERVICE AID ADDRESS VECTOR MODULE *

127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
189
190
191
192
193
194
195
196
197
198
199

IEDQWV
IEDQWX
IEDQWY
IEDQ30
IEDQ31

IEDQ32
IEDQ33

IEDQ34
IEDQ35

IEDQ36

IEDQ37
IEDQ38

IEDQC6
IEDQFElO
IEDQFE20
IEDQFE30
IEDQFW

IEDQXB
IEDQXC
IEDQFE

*Dummy Module
vi

Section One
Telecommunications On-Line Test Executive

Introduction to On-Line Testing

The On-Line Test (OLT) function is an optional TCAM facility. It permits either a system
console operator or a remote control station user to test transmission control units and remote stations to find out if they work properly. Uses of the OLT function are: diagnose
hardware errors; verify repairs; verify engineering changes; or check devices periodically.
The inclusion or exclusion of the On-Line Test facility and the amount of core required
for this function are specified through the OLTEST operand of the INTRO macro in the
Message Control Program (MCP) of TCAM. The operand is coded "OLTEST=O" to specify the exclusion of On-Line Testing, or "OLTEST=integer" where "integer" specifies the
amount of core in lK bytes to be reserved in the MCP region or partition for the OLT
function. The default value if this operand is not coded is "OLTEST= 10". The minimum
value that may be specified is 10. This allocates space for TOTE (Telecommunications
On-Line Test Executive) and one 4K device test section. Device test sections for display
and BSC devices will exceed 4K. The local FE Branch Office should be consulted to determine the exact requirements for these devices.
Asynchronous On-Line Testing, the running of two or more On-Line Tests during the same
time interval, is not explicitly supported by Release I of TCAM/TOTE. However, the design of module IEDQWA does allow for asynchronous testing. All that is required for implementation is the allocation of sufficient storage. See the description of module
IEDQWA for an algorithm that may be used to calculate the core requirements.

Note 1: Asynchronous testing is available only with MVT.
Note 2: It is strongly advised that the manager of the customer's system programming
department be consulted before attempting to implement the asynchronous capability.
Note 3: If the MCP is assembled with OLTEST=O in the INTRO macro, the On-Line
Test facility can still be selected by specifying 0= 10 in response to:
ENTER TCAM PARAMETERS
at TCAM initialization.

On-line Tests

The On-Line Test (OLT) facility permits either a system console operator or a remote
control station user to test transmission control units and remote stations to find out if
they work properly. Uses of the OLT function are:
Diagnose Hardware Errors
Verify Repairs
Verify Engineering Changes
Check Devices Periodically
The OLT function consists of three parts-a Telecommunications On-Line Test Executive
(TOTE) program, a configurator, and device tests.
TOTE is the interface between TCAM and the device tests. It conveys messages to the
test user about the test. It schedules and controls the tests. TOTE also prompts the user
when he requests help, when he makes an invalid request or when a test needs more data.
The Configurator obtains data that TOTE needs about stations and transmission control
units (TCUs). Data is obtained from system, TCAM control tables, and the user. If the
user wishes to re-define this data, he requests TOTE to call the Configurator. Configurator
data is recorded in TCAM's OLT Library.
Introduction to On-Line Testing

Device tests run under the control of TOTE. The test routines are transient, and reside
in either a private library or SYSI. LINKLIB. Device tests will not be discussed in detail
in this document. Detail information can be obtained from the local IBM Branch Office.
Initialization for using the On-Line Test facility is accomplished through the "OLTEST"
operand of the INTRO macro. INTRO specifies if this facility is to be included and how
many lK sections of core are to be reserved for the device tests. The OLT size value is
stored in the AVT.
The TOTE task is attached in the same partition as the MCP by the Attach routine
(IEDQOS) during the execution of the INTRO initialization functions if there is enough
core. The TOTE Resident Module (IEDQWA) is the only module that is attached as a
resident routine. The on-line test task runs at a priority one level lower than the other
tasks in the MCP partition.
The TOTE task, in the form of a control module, is activated when its ECB is posted.
This allows TOTE to vie with other tasks to be activated by OS Job Management. The
ECB is defined in the TCAM AVT. The TOTE ECB is posted whenever a Test Request
Message (TRM) or a Request For Test (RFT) Message is issued.

Method of Operation

Processing a TRM (or RFT)
from a Remote Station

When a TRM (or RFT) is entered from a remote station, it is handled just like any other
incoming message until it reaches the STARTMH macro-expansion in the INHDR Subgroup. The STARTMH macro-expansion first activates IEDQAA, which compares the
acceptable TRM prefix characters in the SCT with the first data field in the input buffer.
If the fields do not match, the buffer is not a TRM (or RFT), so it is returned to the next
instruction in the MH. If a character match is found, the TOTE Interface routine tposts
the buffer to the TOTE QCB (AVTOLTCB) by exiting to the DSPPOST entry point of
the TCAM Dispatcher.
When the element (buffer) gets to the top of the ready queue, the TCAM Dispatcher
recognizes that it is tposted to a QCB that represents an attached task (the MCPL field
of the STCB is equal to X'12'). The TeAM Dispatcher, as a result, issues an as POST
to the ECB for that task. The element that was on the ready queue, in this case the Test
Request Message, remains on the element chain of the TOTE QCB, and the TOTE task
can begin vying for control of the system.
When the On-Line Test task gains control, the TOTE resident module (IEDQWA) is activated. This module moves the TRM from the buffer to the OLTCB. Then the resident
module links to the TRM Analysis module (IEDQWC) to analyze the TRM. If TRM
input is in error, or if the user has requested prompting, control is turned over the TRM
Prompter (IEDQWJ). When all TRM input has been correctly entered, the TRM Analysis
Module calls the TOTE Dispatcher (IEDQWD). The Dispatcher sets up all the controls
necessary to execute the requested OLT, as determined by the TRM Analysis Module.
Control is then transferred to the OLT TEST Control Module (IEDQWE).
The OLT Test Control module loads the requested OLT root module and causes it to be
executed. When all test requests are satisfied, any GETMAIN areas are freed, any still
loaded modules are deleted and return is made to the TOTE Resident module.
When a Configuration request is identified by the TRM Analysis Module, the Configurator
Scheduler (IEDQWI) is called. This module prompts the user for configuration data and
records the data as Device Characteristic Block (DCHB) records. Upon completion control
is returned to the TOTE Resident Module.
If all TRM's have been processed, the resident module issues a WAIT to as. This WAIT
terminates processing by the OLT task. Figure 01 depicts the functional flow for processing a TRM.

Processing a TRM from the
System Console

The OLTEST operand of the MODIFY operator control command is used to enter TRM's
from the system console. This command is placed in a Command Input Buffer (CIB) and
chained off the low order three bytes of the first word of the Communication Parameter
List, which is pOinted to from the AVT. When the keyword OLTEST is found, the buffer
is posted to the QCB in the same way as for remote stations. Once TOTE gains control
the TRM is handled in an identical manner as a TRM from a remote station.

Method of Operation

Program Organization

On-Line Test Processing
Routines

The On-Line processing routines include the following.
• IEDQWA-TOTE Resident Module-to call in and establish the functions necessary to
execute an On-Line Test.
• IEDQWB-Resource Management Module-to determine the resources available to
TOTE and handle the setup and close-down of TOTE.
• IEDQWC-TRM Analysis Module-to analyze TRM's and turn over control to the appropriate routine for further processing.
• IEDQWC 1-TRM Analysis Module I-to analyze the test device entry in the TRM.
• IEDQWC2-TRM Analysis Module 2-to verify the Test and Option fields of the TRM.
• IEDQWD-TOTE Dispatcher-to set up all the tables and flags necessary for the correct
execution of the requested OLT as determined by the TRM Analysis module.
• IEDQWE-OLT Test Control Module I-to schedule the OLT's requested in the TRM
and to clean up after the execution of each aLT.
• IEDQWF-OLT Test Control Module 2-to free core required by IEDQWE during OLT
execution and handle control of the OLT root module.
• IEDQWH-Numeric TRM Handler-to get a TRM from a numeric entry terminal.
• IEDQWI-TOTE Configurator Scheduler-to open DCHB data set, link configurator
sub-module, link TCU Configurators, link Terminal Configurators, and write
Terminals DCHB Records.
• IEDQWIA-Configurator add scheduler module-to handle setup for adding a line to
the DCHB.
• IEDQWID-Configurator delete scheduler module-to handle setup for deleting a line
from the DCHB.
• IEDQWl5-Configurator Submodule I-to ask user if this is an initial configuration or
an update.
• IEDQWl5D-Configurator delete submodule-to find the address of the line to delete.
• IEDQWI5U- Configurator change submodule-to find the address of the line to update
or add.
• IEDQWl6-Configurator Submodule 2-to find the address of the TP line, the TCU type,
and the adapter type.
• IEDQWl7-Configurator Submodule 3-to determine line type, line translation code
and enabling sequence.
• IEDQWl8-Configurator Submodule 4-to ask the user for Terminal Name as specified
in TCAM and to verify it.
• IEDQWl9-Configurator Submodule 5-to get terminal type and special characteristics
information from SCT.
• IEDQWJ-TRM Prompter Module I-to analyze the OLTCB flag bytes to determine
why the PROMPTER was called.
• IEDQWJ1-TRM Prompter Module 2-to prompt user for TESTS and OPTION field
entries in the TRM.
• IEDQWJ2-TRM Prompter Module 3-to prompt for alternate printer (AP) location.
• IEDQWK-TOTE Message Module-to provide both input and output communication
between TOTE and the operator.
• IEDQWL-TOTE Message Submodule-to properly position messages and to process
items such as standard headers.
• IEDQWMI-TOTE SERVICE Module-To provide the ability to cancel a test and to
share a multipoint line.
• IEDQWN-EXIO Service Module-to initiate I/O operations.
• IEDQWO-Access Manager-to determine the destination output device and print if
output is SYSOUT or SYSCON.
Program Organization

• IEDQWP-DPRINT Service Module-to service DPRINT macro by formatting the output message.
• IEDQWPI-DPRINT Service Module I-to continue the servicing of the DPRINT
macro.
• IEDQWP2-DPRINT Service Module 2-to continue the servicing of the DPRINT
macro.
• IEDQWQ-CECOM Service Module-to service requests for communication with the
control terminal.
• IEDQWR-PLINK Service Module-to load or delete modules.
• IEDQWS-WAITIO Service Routine-to cause the on-line test routine to wait until the
initiated I/O Event has been completed.
• IEDQWV-GRAB Service Module-to service the GRAB macro and assign a secondary
device to the unit test.
• IEDQWX-CONVERT Service Module-to convert data from hex to EBCDIC, or from
EBCDIC to hex, as specified by the macro.
• IEDQWY-GETCONFG Service Module-to get a DCHB record for TCU or Terminal
when a GETCONFG macro is issued.
• IEDQ30-Remote Access Error Module-to notify the system operator that a terminal
failed when TOTE attempted to use it.
• IEDQ31-Enabling Module-to enable a transmission line.
• IEDQ32- BSC Remote Print Module-to service CECOM and DPRINT requests
directed to remote BSC terminals.
• IEDQ33-Start-Stop Remote Print Module-to service CECOM and DPRINT requests
directed to remote 2740 terminals.
• IEDQ34-BSC Remote Print Submodule-to read CECOM responses from remote
BSC terminals.
• IEDQ35-Start-Stop Remote Print Module-to service CECOM and DPRINT requests
directed to remote 1050 and 1060 systems.
• IEDQ36-Start-Stop Remote Print Module-to service CECOM and DPRINT requests
directed to remote 1030 systems.
• IEDQ37-Start-Stop Remote Print Module-to service CECOM and DPRINT requests
directed to 2260 and 2265 display stations.
• IEDQ38-Start-Stop Remote Print Module-to service CECOM and DPRINT requests
directed to 2741 terminals.

From
TCAM

r---------~~TCAM

Resident
(lEDQWA)

TRM
Analysis
(lEDQWC)

,
Prompter
(lEDQWJ)

Numerlc
Processor

(IEDQWH)

Configura tor
(IEDQWI)

Dispatcher
(IEDQWD)

1--________-+1 Servi ce

OlT
CONTROL

OLT's

(lEDQWE)

Module EXIO's
I+------~DPRINT, etc.

Figure 01. OLT Functional Flow

Tote Resident Module
(Chart aWA)
Module Name

IEDQWA

Entry Point

IEDQWA-Entered by TCAM at INTRa time.

Functions

The purpose of this routine is to call in and establish the functions necessary to execute
an On-Line Test.
On entry from TCAM, IEDQWB is called to initialize TOTE.
The TRM queue is scanned to determine if any On-Line Test Request needs servicing. If
yes and TOTE has enough free core, IEDQWB is called to initialize the aLT.
The On-Line Test Control Block (OLTCB) queue is scanned to determine if any active
OLTs need servicing. IEDQWB is called if any active OLTs need additional core or if any
active OLT has completed execution and should be terminated.
The TCAM Closedown bit is monitored to determine if TCAM Closedown is in progress.
If yes IEDQWB is called to clean up TOTE resources and return them to the Operating
System. IEDQWA then returns to IEDQOS.
Program Organization

The OLT Service Module Manager routine receives requests from active On-Line Tests
for various service functions. The appropriate TOTE module is then called to service the
request. If a SIO is requested on a test device, IEDQWN is called. If communication with
the On-Line Test operator is requested IEDQWP or IEDQWQ is called. If an OLT submodule is to be LOADed or DELETEd, IEDQWR is called. If the OLT wishes to WAIT
for the completion of an I/O operation, IEDQWS is called. If an additional test device
is required, IEDQWV is called. If data conversion is required, IEDQWX is called. If
configuration data is requested, IEDQWY is called.
If an invalid service request is made by an OLT, IEDQWK is called to report it to the OnLine Test Operator.
External Routines

IEDQWB-TOTE Resource Management Module
IEDQWK-TOTE Message Module
IEDQWN-EXIO Service Module
IEDQWP-DPRINT Service Module
IEDQWQ-CECOM Service Module
IEDQWR-PLINK Service Module
IEDQWS-WAITIO Service Module
IEDQWV-GRAB Service Module
IEDQWX-CONVERT Service Module
IEDQWY -GETCONFG Service Module
IEDQWE-OLT Test Control Module
IEDQWMI-TOTE Service Module

TablesIWork Areas

OLTCB,AVT

Attributes

enabled, problem program mode, resident

Note: Asynchronous testing is available with MVT only. No changes are required in this
module or any other module to implement asynchronous on-line testing. All that is required for implementation is the allocation of sufficient storage. The following is a
formula which may be used to calculate the core required for this capability. Even though
this is not an explicitly supported function of TCAM/TOTE, AP ARs will be accepted.
The formula for determining the number of IK bytes of storage to substitute for the
OLTEST operand of the INTRO macro is:
n(6 + MTS)
where: n=number of tests to be run
MTS = Maximum on-line test size. This will be 4K except for display and BSC
devices. The local FE Branch Office will provide assistance in determining
the MTS value for these devices.
Resource Management Module
(Chart aWB)
Module Name

IEDQWB

Entry Point

IEDQWB-Entered by IEDQWA

Functions

This module services requests from IEDQWA.
It initializes TOTE by setting up TOTE ECBs determining core available to TOTE, determining if the version of OS is MFT or MVT and if MVT is used, determining the number
of asynchronous tests that can be serviced.

It closes down TOTE by cleaning up any OLTs in execution and returning the buffers from
TRMs not yet serviced.
It initializes OLTCBs for newly received TRMs by allocating the core required and setting
up required control fields.
It allocates core to the OLTs as required.
It inserts and removes OLTCBs in the OLTCB queue.
It exits to IEDQWC to execute the requested OLTs.

External Routines

IGC00059

Tables/Work Areas

AVT,CVT,OLTCB

Attributes

enabled, problem program mode, transient

TRM Analysis Module 1
(Chart aWC)

Module Name

IEDQWC

Entry Point

IEDQWC-called by IEDQWA (TOTE Resident Module) when a TCAM buffer is posted
to TOTE, or by IEDQWH (Numeric Test Request Message Analysis Module) after
IEDQWH builds a Test Request Message (TRM).

Functions

The purpose of this module is to analyze TRMs and turn over control to the appropriate
routine for further processing.
This routine translates the TRM from Line code and then determines the source of the
TRM. If the requesting line is not the same as the specified Control Terminal Line, the
requesting line is returned via a STARTLINE. When there is an error in the Control
Terminal entry, the systems operator is informed that a TRM was received but ignored
because of an error. If there are any other errors in the TRM, control is transferred to
the Test Request Prompter (IEDQWJ).
If the control terminal is not the systems console, this module reads the DCHB data set and
gets the DCHB for the control terminal. The Options field of the TRM is checked for the
APterm options. If the Alternate Printer (APterm) option is specified, this module verifies
the name of the alternate printer to be SYSCON, SYSOUT, or a valid operand TCAM
terminal. If the alternate printer is a terminal this module gets the DCHB for the alternate
printer.
If the Control Terminal is not SYSCON and is on another line different from the request
line, the Control Terminal line is gotten via a STOPLINE.

External Routines

IEDQWQ-CECOM Service Module
AVTUI-TCAM Binary Search Routine
IEDQCU-TCAM Start Line Routine
IEDQCV- TCAM Stop Line Routine

TableslWork Areas

CVT, AVT, TERMNAME TABLE, Terminal Table, OLTCB, LCB, DCB, SCB, TCB, and
IEDQWC Work Area.

Attributes

enabled, problem program mode, transient
Program Organization

TRM Analysis Module 2
(Chart WC1)
Module Name

IEDQWCl

Entry Point

IEDQWCl-called by TRM Analysis Module 1 (IEDQWC)

Functions

The purpose of this module is to analyze the test device field of the Test Request Message
(TRM).
Control is passed from IEDQWC with TRM in the OLTCB. The test device field is checked
for valid symbolic names or line addresses (CUU).

If the entry is valid the line address of the entry is plugged into the OLTCB. If any entry
is invalid, the TRM Prompter (IEDQWJ) is called.
External Routine

IEDQWQ-CECOM Service Module
AVTUI-TCAM Binary Search
IEDQCV- TCAM Stop-Line Routine

Tables/Work Areas

CVT, AVT, TERMNAME Table, Terminal Table, OLTCB, LCB, QCB, DCB, SCB, TCB

Attributes

enabled, problem program mode, transient

TRM Analysis Module 3
(Chart WC2)
Module Name

IEDQWC2

Entry Point

IEDQWC2-called by IEDQWC 1 to analyze the Test and Option fields.

Functions

The purpose of this module is to verify the Test and Option fields of the Test Request
Message (TRM).
The Test field is verified for valid syntax. If an error is found, control is passed to the
prompter module (IEDQWJ).
The Option field is verified for valid syntax and requested options are set in the OLTCB.
If an error is found in the Option field, control is passed to the prompter module
(IEDQWJ).
This module also checks the Option field to see if NCM was specified. If NCM was specified, the module asks the system operator for permission to use the lines in NCM mode.
If permission is denied, the Control Terminal is notified and the TRM is rejected.

External Routine

None

Tables/Work Areas

None

Attributes

enabled, problem program mode, transient

Dispatcher (Chart aWD)
Module Name

IEDQWD

Entry Point

IEDQWD-called by the TRM Analysis module (IEDQWC)

Functions

The purpose of this module is to set up all the tables and flags necessary for the correct
execution of the requested OLT, as determined by the TRM Analysis module.
If the control terminal is the System Console, the SYSCON flag is set in OLTCB.
If the test devices are terminals, the terminal names are placed in the Terminal Name
Table in OLTCB. A Stop Terminal request is posted to TCAM Operator Control for each
terminal.
If the test devices are TCUs, the physical addresses are placed in the 'Physical Address'
Table in the OLTCB. A Stop Line request is posted for each test line.

UCB addresses are placed in UCB Address Table in OLTCB.
If routine selection is specified, the selected routine flags are set in OLTCB.
Any selected option flags are set in OLTCB.
If Test Loop is selected, the test loop count is placed in OLTCB.
If Error Loop is selected, the error loop count is placed in OLTCB.
lOBs, DEBs, and DCBs are initialized.
Any service module fields not set up by resident control are initialized and control is
transferred to the TEST CONTROL MODULE (IEDQWE).
External Routine

IGC00059

Tables/Work Areas

OLTCB, UCB, lOB, DEB, DCB.

Attributes

enabled, problem program mode, transient

OL T Test Control Module I
(Chart OWE)

Module Name

IEDQWE

Entry Point

IEDQWE called by the TOTE DISPATCHER module IEDQWD on return from IEDQWF.
IEDQWF.

Functions

The purpose of this module is to schedule the OLTs requested in the TRM and to clean up
after the execution of each.
If the section-terminate flag is set, required cleanup is done and immediate return is made
to the TOTE resident module.

Register pointers are initialized for Section, UCB and Device tables. The size of the OLT
root module is obtained by BLDL macro. If BLDL was unsuccessful, a message is sent
to the control terminal and a check made for another module requested. If successful,
module size is checked against available core. If total core is insufficient, a message is
sent to control terminal and a check made for another module requested. If allocated
core is insufficient, IEDQWA is POSTed for the assignment of additional core.
Program Organization

If core is sufficient, a section start message is sent to the control terminal and the module
XCTLs to IEDQWF. Upon return from IEDQWF, a terminate message is sent to the control
terminal and a check is made for another module requested.
When another OLT module is requested, it will be executed as described above. If a new
module is not required, a check is made for another device required. If a device is required,
tables and pointers are updated, and the OLT module is executed again.
When an OLT is finished with all requested devices, a check is made for Test Loop reo
quested. If yes, the loop count is decremented and the OLT module is re-executed until
the count is exhausted.
When the test request is satisified, any still loaded modules are DELETEd. If the test
devices are terminals, a start terminal request is POSTed to Operator control for each. If
they are TCUs, a startline request is POSTed for each. Return is made to IEDQWA.
External Routines

IEDQWK-TOTE Message Module
IGC00059
IEDQCU-TCAM STARTLINE
IEDQCV - TCAM STOPLINE

Tables/Work Areas

OLTCB, UCB

Attributes

enabled, problem program mode, transient

OL T Test Control Module II
(Chart OWF)

Module Name

IEDQWF

Entry Point

IEDQWF-called by OLT Test Control Module I-(IEDQWE).

Function

To free the core required by IEDQWE during OLT execution; to pass control to the OLT
root module, and receive control from it.

External Routines

Device Tests (OLTs)

Tables/Work Areas

OLTCB

Attributes

enabled, problem program mode, transient

Numeric TRM Handler
(Chart OWH)

Module Name

IEDQWH

Entry Point

IEDQWH-called by IEDQWC upon recognition of seven 9's.

Functions

The purpose of this module is to process a TRM from a numeric entry terminal
This module takes the initial TRM that is passed to it by IEDQWC. The initial TRM is
already translated from the line code and the seven 9's have been stripped off.
The DCHB data set is searched for a DCHB record for the requesting terminal. If none is
found, the systems operator is notified and the TRM is rejected.

The module determines the length of the message received. If it is odd, the last character
is saved. The TRM is then translated from the special numeric code to EBCDIC. The
translated TRM is searched for an End-of-TRM character (M). If an End-of-TRM is found,
control is passed back to IEDQWC for TRM validity checking.
If no End-of-TRM character is found, the program issues a read to the terminal for more
of the TRM. The new message is translated from line code to numeric and from numeric
to EBCDIC. This process is repeated until an End-of-TRM character is found.
External Routines

IEDQWQ-CECOM Service Module
AVTUI-TCAM BINARY SEARCH

Tables/Work Areas

CVT, OLTCB, AVT, DCB, TERMNAME Table

Attributes

enabled, problem program, transient

TOTE Configurator Scheduler
(Chart aWl)

Module Name

IEDQWI

Entry Point

IEDQWI-called by IEDQWC upon recognition of Configuration Request.

Functions

The purpose of this module is to link IEDQWI5 to find out what kind of configuration
is wanted. For an initial configuration request, this module remains in control. For delete
requests, this module transfers control to the Delete Scheduler (IEDQWID). For add
requests, this module transfers control to the Add Scheduler (IEDQWIA).
When this module remains in control, it opens the DCHB data set, links configuration
submodules, links TCV configurators, links terminal configurators, writes DCHB records
and closes the DCHB data set.

External Routines

IEDQWI5V-Configurator Change Sub-module
IEDQWI5-Configurator Sub-module I
IEDQWI6-Configurator Sub-module 2
IEDQWI7 -Configurator Sub-module 3
IEDQWI8-,Configurator Sub-module 4
IEDQWI9-Configurator Sub-module 5
TCV Configurators
Device Configurators

Tables/Work Areas

DCHB Workarea

Attributes

enabled, problem program, transient

Configurator Add Scheduler
Module (Chart WI A)

Module Name

IEDQWIA

Entry Point

IEDQWIA-called by IEDQWI upon recognition of an add request.

Function

The purpose of this module is to schedule the addition of a line to the DCHB data set.
The module links IEDQWI5V to find the line address to add. Then the module rewrites
the DCHB data set until an end-of-file is found. When an end-of-file is found, the module
Program Organization

links configura tor submodules and device configurator modules to build DCHB records
for the new line. The new DCHB records are written at the end of the DCHB data set.
External Routines

IEDQWI5U-Configurator Change Sub-Module
IEDQWI7-Configurator Sub-Module 3
IEDQWI8-Configurator Sub-Module 4
IEDQWI9-Configurator Sub-Module 5
Unit Configurators
IEDQWR-PLINK Service Module
IEDQWQ-CECOM Service Module

TableslWork Area

DCHB Workarea

Attributes

enabled, problem program mode, transient

Configurator Delete Scheduler
Module (Chart WID)

Module Name

IEDQWID

Entry Point

IEDQWID-called by IEDQWI upon recognition of an delete request.

Functions

The purpose of this module is to schedule the deletion of a line from the DCHB data set.
This module links IEDQWl5D to find the address of the line to delete. Then the module
rewrites the DCHB data set omitting this line address.

External Routines

IEDQWl5D-Configurator Delete Sub-Module
IEDQWR-PLINK Service Module
IEDQWQ-CECOM Service Module

TableslWork Areas

None

Attributes

enabled, problem program mode, transient

Configurator Sub-Module 1
(ChartWI5)

Module Name

IEDQWI5

Entry Point

IEDQWI5-called by Configurator Scheduler (IEDQWI)

Functions

The purpose of this module is to notify the Control Terminal that the On-Line Test
configurator is running. This module asks if it is an initial, add, or delete run and sets a
flag accordingly.

External Routine

IEDQWI5D-Configurator Delete Submodule
IEDQWQ-CECOM Service Module
IEDQWR-PLINK Service Module

Tables/Work Area

DCHB Work Area

Attributes

enabled, problem program mode, transient

Configurator Delete
Sub-Module (Chart 15D)

Module Name

IEDQWISD

Entry Point

IEDQWISD-linked by the Configurator Delete Scheduler Module (IEDQWID)

Functions

The purpose of this module is to prompt for the line address of the TP line to delete.
When the CUU is obtained, it is placed in WORKS or the DCHB workarea.

External Routines

IEDQWQ-CECOM Service Module
IEDQWR-PLINK Service Module

Tables/Work Areas

DCHB Work Area, UCB

Attributes

enabled, problem program mode, transient

Configurator Change Sub-Module
(Chart 15U)

Module Name

IEDQWISU

Entry Point

IEDQWISU-linked by IEDQWIU or IEDQWIA.

Function

The purpose of this module is to prompt for the TP line address to update, and determine
whether the address is for communication or graphic devices. Next, the module gets the
TCU adapter type. This information is placed into the DCHB and WORKS.

External Routine

IEDQWQ-CECOM Service Module
IEDQWR-PLINK Service Module

Tables/Work Areas

DCHB Work Area, UCB

Attributes

enabled, problem program mode, transient

Configurator Sub-Module 2
(Chart WIG)

Module Name

IEDQWI6

Entry Point

IEDQWI6-called by Configurator Scheduler (IEDQWI) or IEDQWIA.

Function

The purpose of this module is to prompt for the address of TP line, and determine whether
the address is for communication or graphic devices. Next, the module gets the TCU
adapter type. This information is placed in the DCHB record.

External Routine

IEDQWQ-CECOM Service Module
IEDQWR-PLINK Service Module

TableslWork Areas

UCB, DCHB Work Area

Attributes

enabled, problem program mode, transient
Program Organization

Configurator Sub-Module 3
(ChartWl7)
Module Name

IEDQWI7

Entry Point

IEDQWI7-called by Configurator Scheduler (IEDQWI) or IEDQWIA.

Function

The purpose of this module is to determine line type and line translation code for the line.

External Routines

IEDQWQ-CECOM Service Module
IEDQWR-PLINK Service Module

TableslWork Areas

UCB, DCHB Work Area

Attributes

enabled, problem program mode, transient

Configurator Sub-Module 4
(Chart W18)
Module Name

IEDQWI8

Entry Point

IEDQWI8-called by Configurator Scheduler (IEDQWI) or IEDQWIA

Function

The purpose of this module is to ask CE for Terminal Name as specified in TCAM and
verify it.
The module also obtains the polling and addressing characters from the terminal table.

External Routine

AVTUI-TCAM Binary Search
IEDQWQ-CECOM Service Module
IEDQWR-PLINK Service Module

TableslWork Areas

TERMNAME TABLE, TERMINAL TABLE, UCB, DCHB Work Area

Attributes

enabled, problem program mode, transient

Configurator Sub-Module 5
(Chart Wig)
Module Name

IEDQWI9

Entry Point

IEDQWI9-called by Configurator Scheduler (IEDQWI) or IEDQWIA.

Function

The purpose of the module is to ask the 'CE for the terminal type. If the line is BSC,
the translation code of the terminal is determined.
This module also obtains the special characteristics information from the Special Characteristics Table of the OLTCB.

External Routine

IEDQWQ-CECOM Service Module
IEDQWR-PLINK Service Module

TableslWork Areas

OLTCB, DCHB Work Area

Attributes

enabled, problem program, transient

I EOQWJ-TRM Prompter
Module 1 (Chart QWJ)
Module Name

IEDQWJ

Entry Point

IEDQWJ-Called by one of the TRM Analysis modules when a prompt request is entered,
or when an error in the TRM is detected.

Function

The purpose of this module is to analyze the OLTCB flag bytes to determine why the
PROMPTER was called.
If the IEDQWJ module is called as the result of a prompt request, the operator at the
control terminal will be prompted for the 'Test Device' field of the TRM. When a valid
'Test Device' field is entered, control is transferred to IEDQWJl.
If entry to IEDQWJ is the result of erroneous information in the TRM, the operator at
the control terminal is given the option of re-entering the TRM or being prompted. If
prompting is selected, this module will check to see if the error was in the 'Test Device'
field or the AP term option of the TRM. If the error was in neither of these fields, control
is transferred to IEDQWJI. Otherwise, this module prompts for the 'Test Device' field
and then transfers control to IEDQWJ1 to prompt for 'Tests' and 'Options' fields.
When entry is from a prompt request, the CE is prompted for each of the TRM fields
except the Control Terminal. When entry is the result of an error in trying to determine
if APTERM is specified, then the CE is prompted for each of the TRM fields except the
Control Terminal.

If the prompter is called as the result of any other error, only the remainder of the TRM
is prompted.
All validity checking performed on a normal TRM is performed by this module.
This module only prompts for the Test Device field and then transfers control to
IEDQWJ I to prompt for TESTS and OPTIONS fields.
External Routines

AVTUI-TCAM Binary Search Module
IEDQWQ-CECOM Service Module

Attributes

enabled, problem program mode, transient

TRM Prompter Module 2
(Chart WJ1)
Module Name

IEDQWJI

Entry Point

IEDQWJ1-called by TRM Prompter Module I (IEDQWJ) to Prompt Test and Options
fields.

Functions

The purpose of this module is to prompt the CE for the Test and Options fields of the
TRM.
The CE is first prompted for the test ID. The CE is then asked if he wants to select routines in this test. Ifhe answers yes, he is prompted for routine numbers. If he answers no,
he is asked if he wants to run other tests on these same devices.
All test, routines, and additional test entries are checked for syntax.
Program Organization

After prompting for the Test field the CE is then prompted for the Options field. First
the CE is told the default options, then the valid options. All options are checked for
validity.
If the AP Option is entered, a flag is set to call IEDQWJ2 to prompt for the AP location.
If at any time during Test and Option fields prompting the CE makes an error, he is given
a chance to cancel prompting and reject the TRM.
External Routines

IEDQWQ-CECOM Service Module

Tables/Work Areas

OLTCB

Attributes

enabled, problem program mode, transient

TRM Prompter Module 3
(Chart WJ2)
Module Name

IEDQWJ2

Entry Point

IEDQWJ2 called by IEDQWJl if Alternate Printer Option was specified.

Functions

The purpose of this module is to prompt for the alternate printer terminal.
The CE is prompted for the AP location. AP location can be SYSOUT, SYSCON, or any
TCAM terminal with a printer. If the entry is not SYSCON or SYSOUT, it is verified to
be a valid TCAM terminal. If it is a TCAM terminal, the DCHB data set is read for the
terminal's DCHB. If no DCHB exists, the CE is given a chance to stop_ prompting, enter
a new terminal, or enter the NAP option.
If non-concurrent mode was selected, the system operator is asked for exclusive use of the
necessary lines.

External Routines

AVTUI-TCAM Binary Search
IEDQWQ-CECOM Service Module

Tables/Work Areas

OLTCB, CVT, UCB, AVT, TERMNAME Table

Attributes

enabled, problem program mode, transient

TOTE Message Module
(Chart QWK)
Module Name

IEDQWK

Entry Point

IEDQWK-called by any TOTE 'module requiring message service.

Functions

The purpose of this module is to provide both input and output communication between
TOTE and the operator.
Upon entry, the module LINKs to IEDQWMI if any Start Line requests are outstanding.
The Module then links to the sub module IEDQWL to move messages and byte counts to
OLTCB and to insert such variable data as terminal name, section identity, etc.

Upon return from IEDQWL, the module links to the TOTE Access Method module,
IEDQWO, to print a message if output is requested. If input is expected, it will link
to IEDQWO to read a message.
Return is via register 14 to the calling module.
External Routines

IEDQWL-TOTE Message Sub-Module
IEDQWO-TOTE Access Manager
IEDQWM I-TOTE Service Module

Tables/Work Areas

OLTCB

Attributes

enabled, problem program, transient

TOTE Message Sub-Module
(Chart aWL)

Module Name

IEDQWL

Entry Points

IEDQWL called by Tote Message module IEDQWK.

Functions

The purpose of this module is to move the requested output message to the output buffer
and insert variable information such as; OLT Section I.D., test device name, etc.
Upon entry, an output message is moved to OLTCB and the message length is set in
OLTCB.
Return is to IEDQWK.

External Routines

None

Tables/Work Areas

OLTCB

Attributes

enabled, problem program mode, transient

TOTE Service Module
(Chart WM1)

Module Name

IEDQWM1

Entry Point

IEDQWMI-from IEDQWA or IEDQWK when a TOTE Service function is required.

Functions

The TRM queue is scanned to determine if a request has been made to CANCEL an OnLine Test.

If a Start Line is requested, the Start Line Request Element is built and POSTed to
Operator Control.
External Routines

IGC00059

Tables/Work Areas

OLTCB, AVT, TERMNAME Table, LCB, DCB

Attributes

enabled, problem program mode, transient
Program Organization

EXIO Service Module
(Chart OWN)
Module Name

IEDQWN

Entry Point

IEDQWN-called by OLT Service Manager Routine in IEDQWA

Functions

The purpose of this module is to initiate I/O operations. The module initially obtains the
address of the required I/O control blocks, then initializes the OLT TECB for this operation. If at this point a HIO request is recognized, the 10HALT macro is issued, and a
return code ofX'08' is returned to OLT.
A further check is made for unavailable functions requested. If there are any, a message
is printed and return is via register 14.
Next the lOB is set up. The lOB unrelated flag is set, the channel program address is
inserted, 'FF' is set in the restart address and the channel program is inspected.
Chaining flags are set as determined by CCW flag bits.
The DCB flags are set to bypass ERP's and the permanent error flag is cleared. Then the
EXCP macro is executed.
When the I/O Operation has been started, the condition code received is placed in the
TECB, registers are restored, and return is via register 14.

External Routines

IEDQWO-Access Manager
IGC00059

TableslWork Areas

OLTCB, TECB, lOB, DCB, ECB

Attributes

enabled, problem program mode, transient

Access Manager
(Chart awol
Module Name

IEDQWO

Entry Point

IEDQWO-from IEDQWN when a remote terminal line must enabled or a line must be
stopped.
IEDQWO-from IEDQWP, IEDQWP1, IEDQWP2, IEDQWQ and IEDQWK. where communication with the On-Line Test operator is required.

Functions

The purpose of this routine is to determine the destination output device.
On entry to IEDQWO a check is made to see if the entry is from EXIO, DPRINT, or
CECOM. If neither EXIO, DPRINT, nor CECOM is specified, an error message is printed
and control is returned to the calling routine.

If the entry is from EXIO and output is to a terminal device, control is passed to the
IEDQ31 module to enable the line. If the request is to a local device, the DCB is opened
if it has not been opened, and the I/O operation is performed.
With CECOM, output is directed to the system console or to the control terminal console.
If the control terminal console option is specified, control is passed to the IEDQ31 module.
28

If the entry is from DPRINT, the proper output device is selected. Control is passed to the
IEDQ31 module if a terminal device is specified, or else output is directed to the system
output device or to the system console. Control is then returned to the calling routine.
External Routine

None

Tables/Work Areas

OLTCB

Attributes

enabled, problem program mode, transient

DPRINT Service Module
(Chart OWP)
Module Name

IEDQWP

Entry Point

IEDQWP-called when a DPRINT macro is issued by TOTE or the unit test.

Functions

The purpose of this routine is to service the DPRINT macro by formatting the output
messages.
The calling routine's DPRINT parameter list is examined. If a header and/or deSCription
lines are required, the lines are formatted one at a time and IEDQWO (Access Manager)
is called to route the formatted lines to the proper output device.
If results are required, the CAW, CCW, and CC lines are formatted and passed to IEDQWO.
Control is then transferred to IEDQWPI (DPRINT Service Module I) to continue processing the DPRINT macro.
If no results lines are required, the comment lines are formatted (if required) and passed
to IEDQWO. Control is then returned to the calling routine.
At the completion of this routine register 15 will contain X'QQ' return code.

External Routines

IEDQWO-Access Manager-to route the output message line.

Tables/Work Areas

OLTCB, SECTION PREFACE.

Attributes

enabled, problem program mode, transient

DPRINT Service Module 1
(Chart WP1)
Module Name

IEDQWPI

Entry Point

IEDQWP I-called by IEDQWP

Functions

The purpose of this routine is to continue the servicing of the DPRINT macro.
The calling routine's DPRINT parameter list is examined. If expected and/or received
CSW lines are required, the lines are formatted one at a time and IEDQWO (Access
Manager) is called to route the formatted line to the proper output device.
Control is transferred to IEDQWP2 (DPRINT SERVICE MODULE 2) to continue processing the DPRINT macro.

External Routines

IEDQWO-Access Manager-to route the output message line
Program Organization

TableslWork Areas

OLTCB

Attributes

enabled, problem program mode, transient

DPRINT Service Module 2
(Chart WP2)
Module Name

IEDQWP2

Entry Point

IEDQWP2-called by IEDQWP I

Functions

The purpose of this routine is to continue servicing of the DPRINT macro.
The calling routines DPRINT parameter list is examined. If sense, data, or comment lines
are required, the lines are formatted one at a time and IEDQWO (Access Manager) is called
to route the formatted line to the proper output device.
Control is then returned to the calling program.
At the completion of this routine register 15 will contain X'QQ' return code.

External Routines

IEDQWO-Access Manager-to route the output message line.

Tables/Work Areas

OLTCB

Attributes

enabled, problem program mode, transient

CECOM Service Module
(ChartOWO)
Module Name

IEDQWQ

Entry Point

IEDQWQ-called when a CECOM macro is issued by TOTE or the unit test.

.Functions

The purpose of this module is to service requests for communication with the control
terminaL
The CECOM service module processes the calling routines parameter list and routes output
requests to the control terminal via the Access Manager Routine. If a reply to the output
message is required, the Access Manager routine moves the reply message to a buffer specified by IEDQWQ before returning controL IEDQWQ translates the reply message to upper
case and then moves it to the calling routines input buffers.
At the completion of this routine, one of the following return codes is placed in register 15:
X'QQ' -normal completion of CECOM function
X'Q4'-requested function not available

External Routines

IEDQWO-Access Manager Routine to output and input messages.
IEDQWK-Error Message Module to print 'function not available' message and place an
X'Q4' return code in register 15.

TableslWork Areas

OLTCB

Attributes

enabled, problem program mode, transient

PLINK Service Module
(Chart QWR)
Module Name

IEDQWR

Entry Point

IEDQWR-called when a PLINK macro is issued by the Configurator or unit test.

Functions

The purpose of this routine is to load or delete modules.
The PLINK macro requests modules be deleted and/or loaded.
IEDQWR examines the calling routines PLINK parameter list. If a DELETE is requested,
the module(s) is deleted via a DELETE macro. If a LOAD is requested, a BLDL macro is
issued to verify the availability of the module and core space required. The module is then
loaded via a LOAD macro. The load module entry point address is placed in the calling
program's parameter list.
As modules are loaded and deleted, IEDQWR updates memory space available to the calling
program and active module ID's.
At the completion of this routine register 15 contains a return code:
•
•
•
•

X'OO' -normal completion of the PLINK function
X'08' -I/O error during a LOAD request
X'lO'-Memory space not available for requested load module(s)
X'OC'-Requested load module not found in library

External Routine

None

Tables/Work Areas

OLTCB

Attributes

enabled, problem program mode, transient

WAITIO Service Module
(Chart QWS)
Module Name

IEDQWS

Entry Point

IEDQWS-called when a WAITIO macro is issued by an On-Line Test Routine.

Functions

The purpose of this routine is to cause the On-Line Test Routine to wait until the initiated
I/O event has been completed, at which time the final CSW and sense data (if unit check)
are stored in the TECB.
If poll is requested, an XCTL to IEDQWK is issued. IEDQWK then sends the message
"Macro Function Not Available" to the control terminal and a X'04' return code is returned to the OLT.
If poll is not requested, a wait time interval is set. The main routine then determines how
many events must be completed before continuing. If the wait times out, control will be
returned to the calling routine with an error indicator.

After the wait time has elapsed, control is passed to the Timer Completion Routine, which
determines if the ECB has been posted complete. If the ECB has been posted complete,
control is returned to the calling program.
Program Organization

At the completion of this routine, one of the following return codes is placed in register
15:
X'OO'-Normal completion ofWAITIO function
X'08' -The WAIT timed out.
External Routine

IEDQWK-to output 'Macro Function Not Available' message

Tables/Work Areas

OLTCB, IOBLOCKS, TECB, VCB

Attributes

enabled, problem program mode, transient

GRAB Service Module
(Chart aWV)
Module Name

IEDQWV

Entry Point

IEDQWV-called when a GRAB macro is issued by the unit test.

Functions

The purpose of this routine is to assign a secondary device to the unit test.
The GRAB macro requests that a secondary device meeting specified requirements be
assigned to the unit test.
The device entry list built from the Test Request Message is searched to find a device
meeting the specified requirements. If a proper device is found, it is assigned as a test
device to the unit test.
At the completion of this routine, one of the following return codes is placed in register
15:
X'OO' -normal completion of the GRAB function
X'08'-No (more) devices in the entry list meet the specified requirements.
X'OC' -Device entry list contains only one device.

External Routine

None

Tables/Work Areas

OLTCB

Attributes

enabled, problem program mode, transient

CONVERT Service Module
(Chart aWX)

Module Name

IEDQWX

Entry Point

IEDQWX-called when a CONVERT macro is issued by TOTE or the unit test.

Functions

The purpose of this routine is to convert data from hex to EBCDIC or EBCDIC to hex
as specified by the macro parameter list.
If a non-EBCDIC character is requested to be converted to hex, an error return is provided and the address of the non-EBCDIC character is loaded in R 1.
At the completion of this routine, one of the following return codes is placed in register
15:

X'OO' -normal completion of the CONVERT function
X'08' -a non-EBCDIC character was requested to be converted to hex.
External Routine

None

Tables/Work Areas

None

Attributes

enabled, problem program mode, transient

GETCONFG Service Module
(Chart OWY)
Module Name

IEDQWY

Entry Point

IEDQWY-called when GETCONFG macro is issued by a unit test.

Functions

The purpose of this routine is to read the DCHB data set to get a DCHB record for a TCU
or Terminal.
At completion of this module one of the following return codes is placed in register 15:
X'OO' -normal completion
X'08' -buffer size too small
X'OC' -DCHB not found.

External Routine

None

Tables/Work Areas

OLTCB, Program Work Area, Unit Test Parameter List

Attributes

enabled, problem program mode, transient

Remote Access Error Module
(Chart 030)
Module Name

IEDQ30

Entry Point

IEDQ30-called by IEDQ3l-IEDQ38 when an error has occurred in the remote access
module

Functions

The purpose of this routine is to notify the system operator that a terminal failed when
TOTE attempted to use it.
The failing terminal is identified in a message at the system console and the On-Line Test
is canceled.

External Routines

None

Tables/Work Areas

OLTCB

Attributes

enabled, problem program mode, transient

Enabling Module
(Chart 031)
Module Name

IEDQ3l

Entry Point

IEDQ3l-caIled by the Access Manager Routine when a line has been enabled.
Program Organization

Functions

The purpose of this routine is to enable the transmission line.
The appropriate DCHB is selected and base registers are set up for the DCHB and the
OLTCB DSECTS. The terminal name is obtained and control is passed to "TABLE"
which determines the addresses of the AVT and of the user routine table. On return
from "TABLE" the length of the terminal name is determined and placed in a parameter
list which also contains the terminal name. Then control is passed to "NAMESRCH"
which uses the parameter list to get the terminal table entry. If the line is enabled,
control is returned to the calling routine.
If the line is not enabled, preparations are made to enable the line. An IOB is constructed.
If this is an auto dial line, a dial command is built in the lOB and control is passed to
"STARTLIN" to dial the terminal. Control is then returned to the calling routine.
If the line is not an auto dial line and the TCU is a 2702, a SAD command is built. The
line is enabled and control is returned to the calling routine. If the TCU is a 2701 with
an IBM Type III Adapter, control is returned to the calling module. If the device is SDA
the channel program for the BSC device is built. The line is enabled and control is returned to the calling routine.
If the device is a 2260 Local, no channel program is built.

At the completion of this routine register 15 contains a return code:
X'OO'-Normal completion of the line enabling function
X'04'-A hardware error has occurred.
X'08'-An I/O error has occurred.
If an error has occurred and the return code is not X'OO', return is to IEDQ30 via XCTL.
External Routine

IEDQUI
IEDTNT

Tables/Work Areas

OLTCB,DCHBWRK,AVT,CVT,DCB,DEB,UCB,QCB

Attributes

enabled, problem program mode, transient

Bse Remote Print Module
(Chart Q32)
Module Name

IEDQ32

Entry Point

IEDQ32-called by the enabling module to communicate with remote terminals on binary
synchronous lines.

Functions

The purpose of this module is to service CECOM and DPRINT requests directed to remote
BSC terminals.
Base registers are set up for the OLTCB and DCHB control blocks. The text to be transmitted is obtained from the OLTCB control block. If the text is not EBCDIC, it is translated using TCAM's translation tables.
If point-to-point line control is used, an ENQ is transmitted first. If multipoint line control
is used, the select address is transmitted first. The ACKO I response is received, the text
is transmitted, ACKI is received, and finally EOT is transmitted. Line control and error
recovery are in accordance with Document CP-AR-000658-00-RAL, Binary Synchronous
Communication Specification, dated June 17, 1968.

If a reply is expected and no error has occurred, control is transferred via XCTL to
IEDQ34; if no reply is expected, return is to the calling module. If an error has occurred,
control is transferred via XCTL to IEDQ30.
At completion, register 15 contains one of the following return codes:
X'OO' - Normal completion of the BSC Remote Print function
X'04' -A hardware problem was detected during routine execution.
X'08'-A control or data error has occurred while trying to communicate with a
remote terminal.
External Routine

None

Table/Work Areas

TCAM Translation Tables, DCHB, OLTCB, AVT, CVT

Attributes

enabled, problem program mode, transient

Start-Stop Remote Print-2740
(Chart Q33)
Module Name

IEDQ33

Entry Point

IEDQ33-called by the enabling module to communicate with remote 2740 terminals.

Functions

The purpose of this module is to handle CECOM and DPRINT request directed to remote
2740 terminals.
Base registers are set up for the OLTCB and DCHB control blocks. The text to be transmitted and addressing characters are obtained from the OLTCB control block. If the text
is not EBCDIC, it is translated using TCAM's translation tables.
Depending upon whether the remote device has record checking or not, appropriate line
control characters are set up for the particular device. CCW lists are built to handle the
transmitting of text. If an error is detected, the I/O operation is repeated a fixed number
of times. If the error persists, a return code indicating an error has occurred is returned
to the calling module.
If a reply is expected, a CCW list is constructed to receive the incoming text. The text is
translated if necessary.

At the completion of this routine, one of the following return codes is placed in register
15:
X'OQ'-Normal completion of the Start-Stop Remote Print function
X'08'-An I/O error has occurred.
X'04'-A hardware error has occurred.
If an error has occurred and the return code is not X'OO' , return is to IEDQ30 via XCTL.
External Routine

None

TableslWork Areas

TCAM translation tables, DCHB, OLTCB, AVT, CVT

Attributes

enabled, problem program mode, transient
Program Organization

BSC Remote Print Sub-Module
(Chart 034)
Module Name

IEDQ34

Entry Point

IEDQ34-called by the Bisync Remote Print Module (IEDQ32) to read an expected
CECOM response.

Functions

The purpose of this submodule is to read an expected CECOM response from remote
BSC terminals.
Base registers are set up for the OLTCB and DCHB control blocks. Up to ten attempts to
read the response are initiated. With point-to-point line control, an ENG is read first,
ACKO is transmitted and text is read. With multipoint line control, the terminal is polled
until text is received in response. ACK1 is transmitted in response to the text and EOT
read. If EOT is not received from the terminal, and EOT will be transmitted. The
received text will be translated, if necessary, to EBCDIC. Line control and error recovery
are in accordance with Document CP-AR-000658-00-RAL, Binary Synchronous Communications Specification, dated June 17, 1968.
If no error has occurred, return is to the calling module. If an error has occurred, control
is transferred via XCTL to IEDQ30. At completion, register 15 contains one of the
following return codes:
X'OO' -Normal completion of the BSC Remote Print and reply function
X'08'-A control or data error has occurred while trying to read a response from a
remote terminal.

External Routines

None

Table/Work Areas

TCAM translation tables, DCHB, OLTCB, AVT, CVT

Attributes

enabled, problem program mode, transient

Start-Stop Remote Print-1050
and 1060 (Chart Q35)
Module Name
Entry Point

IEDQ35-called by the Enabling module to communicate with remote 1050 and 1060
systems.

Functions

The purpose of this module is to handle CECOM and DPRINT requests directed to remote
1050 and 1060 systems.
Base registers are set up for the OLTCB and DCHB control blocks. The text to be transmitted and addressing characters are obtained from the OLTCB control block. If the text
is not EBCDIC, it is translated using TCAM's translation tables.
Appropriate line control characters are set up for the particular device. CCW lists are built
to handle the transmitting of text. If an error is detected, the I/O operation is repeated
a fixed number of times. If the error persists, a return code indicating an error has occurred
is returned to the calling module.
At the completion of this routine, one of the following return codes is placed in register 15:
X'OO'-Normal completion of IEDQ35 function

X'08' -An I/O error has occurred.
X'04' -A hardware error has occurred.
If an error has occurred and the return code is not X'OO', return it to IEDQ30 via XCTL.
External Routine

None

Table/Work Areas

TCAM translation tables, DCHB, OLTCB, AVT, CVT

Attributes

enabled, problem program mode, transient

Start-Stop Remote Print-1030
(Chart 036)
Module Name

IEDQ36

Entry Point

IEDQ36-called by the Enabling module to communicate with a remote 1030 system.

Function

The purpose of this module is to handle CECOM and DPRINT requests directed to remote
1030 systems.
Base registers are set up for the OLTCB and DCHB control blocks. The text to be transmitted and addressing characters are obtained from the OLTCB control block. If the text
is not ECBDIC, it is translated using TCAM's translation tables. Then idle characters are
inserted between each character of text.
Appropriate line control is set up for the device. CCW lists are built to handle the transmitting and receiving of text. If an error is detected, the I/O operation is repeated a fixed
number of times. If the error persists, a return code indicating an error has occurred is
returned to the calling module.
At the completion of this routine, one of the following return codes is placed in register 15:
X'OO'-Normal completion ofIEDQ36 function
X'08'-An I/O Error has occurred.
X'04'-A hardware error has occurred.
If an error has occurred and the return code is not X'OO', return is to IEDQ30 via XCTL.

External Routine

None

Table/Work Areas

TCAM Translation Tables, DCHB, OLTCB, AVT, CVT

Attributes

enabled, problem program mode, transient

Start-Stop Remote Print-2260
and 2265 (Chart 037)
Module Name

IEDQ37

Entry Point

IEDQ37-called by the Enabling module to communicate with a remote 2260, a local
2260, or a 2265 display.

Functions

The purpose of this module is to handle CECOM and DPRINT requests directed to 2260
and 2265 display stations.
Program Organization

Base registers are set up for the OLTCB and DCHB control blocks. The text to be transmitted and addressing characters are obtained from the OLTCB control block. If the text
is not EBCDIC, it is translated using TCAM's translation tables.
If necessary, the appropriate line control is set up for the display. CCW lists are built to
handle the transmitting and receiving of text. If an error is detected, the I/O operation
is repeated a fixed number of times. If the error persists, a return code indicating an error
has occurred is returned to the calling module.

At the completion of this routine, one of the following return codes is placed in register
15:
X'OO' -Normal completion of IEDQ37 function
X'08'-An I/O error has occurred.
X'04'-A hardware error has occurred.
If an error has occurred and the return code is not X'OO', return is to IEDQ30 via XCTL.
External Routine

None

Table/Work Area

TCAM Translation Tables, DCHB, OLTCB, AVT, CVT

Attributes

enabled, problem program mode, transient

Start-Stop Remote Print-2741
(Chart 038)
Module Name

IEDQ38

Entry Point

IEDQ38-called by the enabling to communicate with remote 2741 terminal.

Functions

The purpose of this module is to handle CECOM and DPRINT request directed to remote
2741 terminals.
Base registers are set up for the OLTCB and DCHB control blocks. The text, if any, to be
transmitted is obtained from the OLTCB control block. If the text is not EBCDIC, it is
translated using TCAM's translation tables.
A test is made to determine whether or not the terminal is in receive mode. If the
terminal is not in receive mode, and the function to be performed is a read only operation, then the text is read. Control is then returned to the calling module.
If the terminal is in receive mode and the function to be performed is a read only operation, an EOT character is written to the terminal to place it in text mode. The text is
then read. Control is then returned to the calling module.

If there is text to be transmitted to the terminal, a read operation is performed. If the
read times out, a Halt I/O is issued, and an attempt is made to write the text. If a timeout
does not occur, a check is made to see if an EOT character has been read. If no EOT has
been read, the read operation is repeated a fixed number of times. IEDQ38 aborts after
finding no EOT character.
If a reply is expected the text is read and control is returned to the calling program. If a
reply is not expected, the operator is notified to depress the Carriage Return after the text
has been written. A read operation is repeated until an EOT character is read. If an EOT
character is not detected after several tries, the section is aborted.
38

All received text is translated if necessary, and placed in the OLTCB. Control is then returned to the calling module. At the completion of this routine, one of the following
return codes is placed in register 15:
X'OO'-Normal completion of the Start-Stop Remote Print function
X'08'-An I/O error has occurred.
X'04'-A hardware error has occurred.
If an error has occurred and the return code is not X'OO', return is to IEDQ30 via XCTL.
External Routines

None

Table/Work Areas

TCAM translation tables, DCHB, OLTCB, AVT, CVT

Attributes

enabled, problem program mode, transient

Program Organization

Data Area Layouts
This section contains a description of the two major control blocks used by the Terminal
On-Line Test Executive, the OLTCB and the DCHB.

On-Line Test Control
Block

The On-Line Test Control Block (OLTCB) contains those buffers, pointers, flags, parameter
lists and data fields which must be preserved after the modules that set them up have been
deleted. It also contains control fields and queue pointers to allow the TOTE parent task
to communicate with and control the On-Line Tests sub tasks.

No. of
Bytes

Offset
Dec.

Hex

0
2

2
I

Field
Name

Field Description

CECOUNT
TESTOPI

Loop Count-Specified by C. E.
I st Byte of Option Bits

ERRFLG
SPLATFLG
CATFLG
ALTPFLG
NCPFLG
NEPFLG
ELOOPFLG
TLOOPFLG
TESTOP2

X'80' Error Bit for Loop on Error
X'40' Error Bit for * in Terminate Msg
X'20' Catastrophic Failure Bit
X'IO' Alternate Printer Selected Flag
X'08' No Control Print Flag
X'04' No Error Print Flag
X'02' Loop on Error Flag
X'OI' Testing Loop Flag
2nd Byte of Option Bits

TESTOP1 Bit Meanings

TESTOP2 Bit Meanings
(None Assigned)
4
6
8
8
10
11
12
16
20
20
22
23
24
28
32
33

4
6
8
8
A
B
C
10
14
14
16
17
18
lC
20
21

2
2

ROUTRUN
PRIMDEV

2
1
4
4

PRFLGS
PRADDR
PRDESC
SECDEV

2
SEFLGS
4
4
1
1

SEADDR
SEDESC
TOTEFLGS

Routine Run Flags (1-16)
SPARE
Primary Device Area
SPARE
Primary Device Flags
SPARE
Primary Device Physical Address
Primary Device Descriptors
Secondary Device Area
SPARE
Secondary Device Flags
SPARE
Secondary Device Physical Address
Secondary Device Descriptors
SPARE
TOTE FLAGS
TOTE FLAG Bit Meanings

OurWTOR
MULTDEV
ROUTSEL

X'80' Outstanding WTOR Flag
X'40' Operator Entered More Than One Test Device
X'20' OPERATOR Made Routine Selection
Data Area Layouts

No. of
Bytes

Offset
Dec.

Field
Name

Field Description

Hex

34
36

22
24

37
38
39
40
70
72
144
216
288
288
288
292
296
328
358
364
400
472
472
476
480
512
516
524
532
535
536
540
543
544
548
584
656
792
792
880
900
928

25
26
27
28
46
48
90
D8
120
120
120
124
128
148
166
16C
190
ID8
ID8
IDC
lEO
200
204
20C
214
217
218
21C
21F
220
224
248
290
318
318
370
384
3AO

30
2
72
72
72

4
4
32
30
6
36
72
4
4
32
4
16
8
8
4
3
1
4
36
72
136
136
88
20
28
128

ERRLOOP
FINAL
CLEANUP
OLTCORE
FUNFLG1
FUNMINT
FUNCLEAN
FUNFLG2
FUNFLG3
FUNFLG4
EXTROUT
SAVEl
SAVE2
SAVE3
SAVEND
CBPRIOBK
CBPRIECB
CBPTECBA
PRlIOB
CBDEVTBL
PRIDEB
PRIDCB
CBSCIOBK
CBSECECB
CBSTECBA
SECIOB
CBACDEBA
CBSMLINK
CBLINKNM
CBNAMSPL
CBNAMLNT
CBNAMPTR
CBREQRLN
CBRQUCBA
SECDEB
SECDCB
CTDCHB
PRDCHB
MYDCB
CBPECB
OLTTRM

X'10' Operator Indicated Loop on Error
X'08' Final Device Flag
X'04' Clean Up Flag
Amount of Core Available for OLT
Functional Flags 1 Bit Meanings
X'80' Manual Intervention
X'40'
Functional Flag 2
Functional Flag 3
Functional Flag 4
Extended Routine Mask
UNUSED
First Save Area
Second Save Area
Third Save Area
End of OLTCB Save Areas
Primary I/O Control Blocks
Primary Event Control Block
Pointer to Primary TECB
Primary Device lOB
Device Address Table
SPARE
Primary Device DEB
Primary Device DCB
Secondary I/O Control Blocks
Secondary Event Control Block
Pointer to Secondary TECB
Secondary Device lOB
Address of Access Method DEB
Service Manager LINK Parameter List
Entry Point Name
Parameter List for Binary Search Routine
Length of Symbolic Name
Pointer to Symbolic Name
SPARE
Request Line Relative Line Number
Request Line UCB Address
Secondary Device DEB
Secondary Device DCB
Control Terminal DCHB
Alternate Printer DCHB
Alternate Printer DCB
DCB for Printer = SYSOUT
RESERVED
Test Request Message Buffer
EQUATES

1056
1057
42

420
421

1
3

TRMPREF
TRMBUF
MSGCNT

EQU OLTTRM TRM Prefix
EQU OLTTRM + X'2A' TRM Buffer
Length of Text in TRM
SPARE

No. of
Bytes

Offset
Dec.

Hex

1060
1062
1064
1066
1067

424
426
428
42A
42B

2
2
2

1068
1072
1080
1083

42C
430
438
43B

4
110

1182
1184
1246
1248
1256
1260
1264
1265
1266

49E
4AO
4DE
4EO
4E8
4EC
4FO
4Fl
4F2

Field
Names

BLKSASSN
BLKSREQD
CBTSTCNT
CBDPCNT
CBDPFLG
FRSPASS
MEMSPACE
MODINDX

3
99
MODINDXE
2
62
2
8
4
4
1

BLDLLlST
CBWAITIN
CBPRECBA
CBSCECBA
CBRTCODE
CBMSGCD
CBSTLFLG

Field Description

Core Blocks Assigned to this OLT
Core Blocks Required by this OLT
Test Loop Count
Display Count
Display Flags
EQU X'80' Past First Flag
Memory Space Currently Available
Table of Loaded OLT Modules
Module Length
Space for 9 Additional Modules
EQU*
SPARE
Parm List for BLDL Macro
SPARE
Wait Interval (HHMMSSTH)
Pointer to Primary ECB
Pointer to Secondary ECB
Return Code Buffer
Error Message Code
Start/Stop Line Flags
FLAG Bit Meanings

1267
1268
1272
1308
1312
1320
1324
1404
1484
1488
1500
1504
1508
1512
1584
1712

4F3
4F4
4F8
SIC
520
528
52C
57C
5CC
5DO
5DC
5EO
5E4
5E8
630
6BO

4
36
4
8
4
80
80
4
16
4
4
4
72
128

PTSTSTRT
STSTSTRT
CHKSIZE
OUTOPTS
CTSTART
PRSTART
CHKTRM

X'80' Primary Line Start Flag
X'40' Secondary Line Start Flag
X'20' Core Size Check Requested
X'lO' Check Output Options Flag
X'08' Control Terminal Start Flag
X'04' Printer Terminal Start Flag
X'02' Check TRM Queue Flag

STOPCNT
STOPPRNT
STOPTPRI
STOPSEC
STOPREQ
CBOLTSVI
TUCBADI
CBUCBTBL
TUCBAD2
CBWTORPL
CBWTOPL
CBOTBUF
CBINBUF
CBECBl
CBPRGLST
GRABPTR
CBSMNAME
OLTCBECB
CBSMNTBL
WORKAREA
TRMFLGSI

X'80' Control Terminal Stopped Flag
X'40' Alt. Printer Stopped Flag
X'20' Primary Test Device Stopped Flag
X'lO' Secondary Test Device Stopped Flag
X'08' Request Line Stopped Flag
Service Module Flags
Active UCB Address
List of UCB Addresses
Secondary UCB Address
Parm List for WTOR
Parm List for WTO
Out Message Buffer
In Message Buffer
Event Control Block
Purge Parm List for SCV
Pointer to Current Secondary Device
Pointer to Current Symbolic Name
OLT Event Control Block
Symbolic Name Table
Executive Work Area

Data Area Layouts

No. of
Bytes

Offset
Dec.

Field

Name

Field Description

Hex
EQUATES

APERROR
TDERROR
TERROR
OPTERROR
1713

6Bl

EQU X'80' AP Error Flag
EQU X'40' Test Device Error Flag
EQU X'20' Test ID Error Flag
EQU X'lO' Option Field Error Flag

TRMFLGS2
EQUATES

NUM
CTDIAL
RTDIAL
CANCELRQ
TTDIAL
1714

6B2

EQU X'80'
EQU X'08'
EQU X'04'
EQU X'02'
EQU X'Ol'

Numeric Entry Flag
CT Switched Flag
Req Line Switched Flag
Cancel Request Message Flag
Switched Test Terminal Flag

OLTFLGSI
EQUATES

PRINT
CECOM
REPLY
NOTAVL
TDEVSTRT
TIMEOUT
EXIO
ENDMSGOK
1715

6B3

EQU X'80' Access Method Print Flag
EQU X'40' Access Method CECOM Flag
EQU X'20' Access Method CECOM with Reply Flag
EQU X'1O' Function Not Available Flag
EQU X'08' Start Test Devices Flag
EQU X'04' Wait Timeout Flag
EQU X'02' Access Method EXIO Flag
EQU X'O l' Send Cancel or Terminate Message

OLTFLGS2
EQUATES

SECTTERM
SECTSTRT
SECT4KMX
SECTNCMF
TRMXLATD
CANCEL
OLTACT
NPERMERR
1716

6B4

EQU X'80' Section Terminate Flag
EQU X'40' Section RESTART Flag
EQU X'20' 4K Maximum Size Flag
EQU X'10' Non-Concurrent Mode Flag
EQU X'08' TRM Translated Flag
EQU X'04' Cancel Testing Flag
EQU X'02' OLT Active Flag
EQU X'Ol' No Permanent Error Flag

OLTFLGS3
EQUATES

PRIMARY
SECOND
TERMNAME
DCBOPEN
MSGCEC
MSGREP

EQU X'80' Primary Flag for EXIO and WAITIO
EQU X'40' Secondary Flag for EXIO and WAITIO
EQU X'20' Terminal Name Flag
EQU X'1O' Output Writer DCB Open Flag
EQU X'08' TOTE MSG Source Flag CECOM
EQU X'04' TOTE MSG Source Flag Reply

No. of
Bytes

Offset
Dec.

1717
1718

Field
Name

Field Description

Hex

MSGPRT
APENBLD
OLTFLGS4
CBACFLGS

6B5
6B6

EQU X'02' TOTE MSG Source Flag DPRINT
EQU X'Ol' Alt. Printer Enabled Flag

EQUATES

1719

PRSYSCON
PRSYSOUT
CTSYSCON
PRTTERM
PRIENBLD
SECENBLD
PREQCT
CTENBLD
CBTCNTF1

6B7

EQU X'80' Printer = System Console
EQU X'40' Printer = System Output
EQU X'20' CNTL Term = System Console
EQU X'lO' Printer = Remote Terminal (Not CT)
X'08' Primary Line Enabled Flag
X'04' Secondary Line Enabled Flag
X'02' Printer Equals Control Terminal Flag
X'O l' Control Terminal Enabled Flag
Test Control Flags
EQUATES

1720
1724
1804
1805
1806
1808
1880
1952
1956
1960
1972
1984
2008
2012
2016
2024
2028

6B8
6BC
70C
70D
70E
710
758
7AO
7A4
7A8
7B4
7CO
7D8
7DC
7EO
7E8
7EC

4
80
1
1
2
72
72
4
4
12
12
24
4
4
8
4

TERMFLG
FIRSTUCB
INCLENT
FREEDEB
ACCDEB
OLTENDED
OLTWAIT
OLTRSTRT
CBLDPNTR
CBOLTTBL
CBOLTEND
CBTNMLEN
TOTESAVI
TCNTSAVE
RESRSAVE
CBCURDEV
PARMLIST
DIAGLIST
CBRQELE
CBCTUCBA
CBAPUCBA
CBSLPL
CBRESPL
OCTCBEND

EQU X'80' Test Devices = Terminals
EQU X'40' First Device in TRM Flag
X'20' Inclusive Entry Flag
X'lO' Free DEB on Terminate Flag
X'08' Free Access Method DEB Flag
X'04' On-Line Test Ended Flag
X'02' On-Line Test Waiting Flag
X'Ol' On-Line Test Restart Flag
Pointer to Active Section
Table ofOLT Sections
END OF TABLE
SPARE
Length of TERMNAME Table of Entries
TOTE Save Area
Test Control Register Save Area
Resident Save Area Pointer
Pointer to Active Device
OLT Parameter List
Parameter List for SVC 59
Operator Control Request Element
Address of Control Terminal UCB
Address of Alternate Printer UCB
Parameter List for Start/Stop Line
Address of Resident Parameters
End ofOLTCB

Data Area Layouts

DCHB
No. of
Bytes

Offset

Field
Name

Field Description

Dec.

Hex

0
2

DCHBCUU
DCHBDESC

Line Address in Hex
DCHB Descriptor
X'OO' TCU DCHB
X'OI' First Terminal DCHB
X'FF' Last Terminal DCHB

DCHBTCU

TCU Type in EBCDIC

DCHBNAME

Symbolic Name in EBCDIC

DCHBTTYP

Terminal Type in EBCDIC

DCHBADAP

TCU Adapter Type
X'10' IBM I
X'20' IBM II
X'30' IBM TTY
X'40' TTY I
X'50' TTY II
X'60' WTCTTY
X'70' SDA I
X'80' IBM III
X'90' SDA II

DCHBTYPE

Line Type
X'OI' Leased Point to Point
X'02' Leased Multipoint
X'03' Switched No AUTODIAL
X'04' Switched AUTODIAL
X'05' Local

DCHBCODE

Line Code
X'OI' 6 Bit BCD
X'02' INT TEL Alphabet 2
X'03' Code Shifted BAUDOT
X'04' 8 Level TWX
X'05' USASCII 8
X'06' Four Out of Eight
X'07' EBCDIC
X'08' TRANSCODE

DCHBPOLL

DCHBC

SPARE
DCHBPOL

Hex Number of Poll Characters
Poll Characters in Line Code
Hex Number of Adressing Characters

No. of
Bytes

Offset

Field
Name

Field Description

Dec.

Hex

DCHBDIAL

Dial Digits. First 4 Bits of Each Byte Equal Zero.

DCHBCONT

Line Control Characters. First 8 Bytes are Offset to Byte
Count of Number of Characters. Control Characters
Follow the Byte Count.

DCHBCOMP

DCHBD

Addressing Characters in Line Code. Escape Sequence
(Framed by STX ... ETB) for BSC Contention Devices.
Hex Number of Dial Digits

Byte
Byte
Byte
Byte
Byte
Byte
Byte
Byte
DCHBBS

113

121

DCHBBSID

1 Offset to EOT SEQ
2 Offset to EOA SEQ
3 Offset to Even ACK SEQ
4 Offset to Odd ACK SEQ
5 Offset to NAK SEQ
6 Offset to PAD CHARS
7 RESERVED
8 RESERVED

Hex Number of CPU I.D. Characters
I.D. Characters in Line Code of Host CPU
SPARE

DCHBDEV

Device Configurator Bytes. Defined by Unit Configurator
Sections.

Data Area Layouts

Diagnostic Aids

The following section contains information designed to aid the Program Systems Representative or system programmer in cross-referencing modules in the Terminal On-Line
Test Executive. The chapter is divided into tables of register usage by module, crossreferencing tables between modules, messages generated, and a table of macro usage by
module.

Table of Register Usage by ModuleModule

Name
IEDQWA

Entry
Point

IEDQWA

I,W,
Register

orO*

0
W

2
3
4
5
6
7
8
9
10
11

12
13
14
15
IEDQWB

IEDQWB

0
0

W
W
W
W
W

2
3
4
5
6
7
8
9
10
11

12
13

14
15

W
I
W
I
W
W
W
W
W
W
W
W
I
I

Use

Not Used
Work Register
Parameter List Address
OLTCB Pointer
Not Used
Not Used
Not Used
Work Register
Not Used
Work Register
Work Register
Not Used
Base Register
Work Register
Save Area Address
Return Address
Entry Point Address
Parameter Register
Parameter List Address
Working Register
OLTCB Pointer
Work Register
AVT Address
Work Register
Work Register
Work Register
Work Register
Work Register
Work Register
Base Register
Link Reg., Work Register
Save Area Address
Return Address
Entry Point Address
Return Code

*lnput, Work, or Output Register
Diagnostic Aids

Module
Name

Entry
Point

IEDQWC

0
1
2

3
4
5

6
7
8
9
10
11
12

13
14
15
IEDQWCl

IEDQWCl

3
4
5

6
7
8
9
10
11
12

13
14
15
IEDQWC2

W
I
I
W
W
W
W
W
W
W
W
W

I
I
W
I
W

0
1

IEDQWC2

I,W,
or 0

W
I
I
W
W
W
W
W
W
W
W
W

I
I
I

0
1
2

3
4
5

6
7
8
9
10

I
W
I
W
W
W
W
W

11
12

13
14
15
50

I
I
I

Use

Not Used
Work Register
Parameter List Address
OLTCB Pointer
Work Register
Work Register
Work Register
Base Register
Work Register
Work Register
Work Register
Work Register
OLT-TRM ADDRESS-PRF-BASE
Not Used
Save Area Address
Return Address
Work Register
Entry Point Address
Work Register
Not Used
Work Register
Parameter List Address
OLTCB Pointer
Work Register
Work Register
Work Register
Base Register
Work Register
Work Register
Work Register
Work Register
Work Register
Not Used
Save Area Address
Return Address
Entry Point Address
Not Used
Parameter List Address
Work Register
OLTCB Pointer
Work Register
Work Register
Work Register
Base Register
Work Register
Not Used
Not Used
Work Register
Not Used
Not Used
Save Area Address
Return Address
Entry Point Address

Module
Name

Entry
Point

IEDQWD

I, W,

or 0
W

0
0

2
3
4
5
6
7
8
9
10

11
12
13

14
15
IEDQWE

IEDQWE

1
2
3
4
5
6
7
8
9
10

11
12

I
W
W
W
W
W
W
W
W
W
W
I
I

0
0
I
W
W
W
W
W
W
W
W
W
W

14
15
IEDQWF

IEDQWF

1
2
3
4
5

6
7
8
9
10

11
12
13
14
15

Use
Work Register
Parameter
Parameter List Address
OLTCB Pointer
TRM Pointer
Base Register
Work Register
Work Register
Work Register
Work Register
Work Register
Work Register
Work Register
Link Register
Save Area Address
Return Address
Entry Point Address
Parameter Register
Parameter List Address
OLTCB Pointer
AVT Address
Base Register
Test Device Address Table Pointer
Test Table Pointer
Work Register
Work Register
UCB Table Pointer
Test Device Name Table Pointer
Work Register
Link Register
Save Area Address
Return Address
Entry Point Address
Not Used
Parameter List Address
OLTCB Pointer
Not Used
Base Register
Not Used
Not Used
Not Used
Not Used
Not Used
Not Used
Not Used
Work Register
Save Area Address
Return Address
Entry Point Address
Return Code:
X'OO'-No Errors
X'O l' -Errors Detected
Diagnostic Aids

Module
Name

Entry
Point

IEDQWH

0
1

I, W,
or 0

0
W

2
3
4
5

IEDQWI

6
7
8
9
10

W
W
W
W
W
W
W
W

11
12
13
14
15

I
I

0
1
2
3
4
5
6
7
8
9

IEDQWIA

0
I

W
W
W
W
W

12
13
14
15

0
0
W

2
3
4
5
6
7
8
9
10

W
W
W
W

12
13
14
15
52

Use

Not Used
Parameter List Address
Work Register
OLTCB Pointer
Work Register
Work Register
Work Register
Base Register
Work Register
Work Register
Work Register
Work Register
Not Used
Not Used
Save Area Address
Return Address
Entry Point Address
Not Used
Parameter List Address
OLTCB Pointer
Parameter Register for Device Configurators
Not Used
Not Used
Work Register
Work Register
Work Register
Work Register
Work Register
Work Area Address
Work Register
Save Area Address
Return Address
Entry Point Address
Not Used
Parameter List Address
Work Register
OLTCB Pointer
Not Used
Not Used
Not Used
Work Register
Work Register
Work Register
Not Used
Work Register
Not Used
Work Register
Save Area Address
Return Address
Entry Point Address

Module
Name

IEDQWID

Entry
Point

IEDQWID

I, W,
orO

0
W
2
3
4
5
6
7
8
9
10
11
12
13
14
15
IEDQWIU

IEDQWIU

W
W

0
2
3
4
5
6
7
8
9
10
11
12
13
14
15
IEDQWI5

IEDQWI5

W
I

0
W
W
W

W
W

0
2
3
4
5
6
7
8
9
10
11
12
13
14
15

W
W

Use

Not Used
Parameter List Address
Work Register
OLTCB Pointer
Not Used
Not Used
Work Register
Not Used
Work Register
Not Used
Not Used
Work Register
Not Used
Work Register
Save Area Address
Return Address
Entry Point Address
Not Used
Parameter List Address
Work Register
OLTCB Pointer
Pointer to No. Table for Device Configurator
Not Used
Work Register
Work Register
Work Register
Not Used
Not Used
Work Register
Not Used
Work Register
Save Area Address
Return Address
Entry Point Address
Not Used
Parameter List Address
OLTCB Pointer
Base Register
Not Used
Not Used
Not Used
Not Used
Not Used
Work Register
Not Used
DCHB and Work Area Base
Not Used
Save Area Address
Return Address
Entry Point Address
Diagnostic Aids

Module
Name

Entry
Point

IEDQWI5D

I.W,
Register

0
1

orO

0
W

2
3
4
5
6
7
8
9
10
11
12
13
14
15
IEDQWI5U

IEDQWI5U

0
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

IEDQWI6

W
W

W
I
I
I

0
W
I

W
W

W
I
I
I

0
2
3
4
5
6
7
8
9
10
11
12
13
14
15

I
W
W

0
W

W
I
I
I
I
I

Use

Not Used
Parameter List Address
Work Register
OLTCB Pointer
Not Used
Not Used
Work Register
Work Register
Not Used
Not Used
Not Used
Not Used
DCHB Base Register
Not Used
Save Area Address
Return Address
Entry Point Address
Not Used
Parameter List Address
Work Register
OLTCB Pointer
Not Used
Not Used
Work Register
Work Register
Not Used
Not Used
Not Used
Not Used
DCHB Base Register
Not Used
Save Area Address
Return Address
Entry Point Address
Not Used
Parameter List Address
OLTCB Pointer
Work Register
Work Register
UCB Address
Work Register
Not Used
Not Used
Work Register
Not Used
DCHB and Work Area Base
Not Used
Save Area Address
Return Address
Entry Point Address

Module
Name
IEDQWI7

Entry
Point
IEDQWI7

I,W,

orO

1
2
3
4
5

0
W

7
8
9
10
11

13
14
15
IEDQWI8

IEDQWI8

W
I
I
I
I

0
W

2
3
4
5

I
W
W

6
7
8
9
10
11

W
W
W
W
I

12
13

W
I

0
0
I

IEDQWI9

1
2
3
4
5

0
W
I
W
W

6
7
8
9
10

W
W
W
W

11
12

W
I
W
I

14
15

Use
Not Used
Parameter List Address
OLTCB Pointer
Work Register
Not Used
UCB Address
Not Used
Not Used
Not Used
Work Register
Not Used
Calling Routine Work Area
Save Area Address
Return Address
Entry Point Address
Not Used
Work Register
Parameter List Address
OLTCB Pointer
Work Register
Work Register
UCB Address
Work Register
Work Register
Work Register
Work Register
Not Used
Calling Routine Work Area
Not Used
Save Area Address
Return Address
Return from AVTUI
AVTUI Address
Entry Point Address
Not Used
Parameter List Address
Work Register
OLTCB Pointer
Work Register
Work Register
Not Used
Work Register
Work Register
Work Register
Work Register
Not Used
Calling Routine Work Area
Not Used
Save Area Address
Return Address
Work Register
Entry Point Address
Diagnostic Aids

Module
Name
IEDQWJ

Entry
Point
IEDQWJ

I, W,
orO

0
2

3
4
5

IEDQWJl

W
I
W
W
W
I
W
W
W

6
7
8
9
10

11
12
13
14
15

I
W

0
2
3
4
5

6
7
8
9
10

W
I
W
W
W
I
W
W
W
W

11
12

13
14
15
IEDQWJ2

IEDQWJ2

0
W
2
3
4
5

6
7
8
9
10

W
W
W
W
W
W
W

11
12

13
14
15

Use
Not Used
Parameter List Address
Work Register
OLTeB Pointer
Work Register
Work Register
Work Register
Base Register
Work Register
Work Register
Work Register
Work Register
Not Used
Not Used
Save Area Address
Return Address
Work Register
Entry Point Address
Not Used
Parameter List Address
Work Register
OLTeB Pointer
Work Register
Work Register
Work Register
Base Register
Work Register
Work Register
Work Register
Work Register
Not Used
Not Used
Save Area Address
Return Address
Entry Point Address
Not Used
Parameter List Address
Work Register
OLTeB Pointer
Work Register
Work Register
Work Register
Base Register
Work Register
Not Used
Work Register
Work Register
Not Used
Not Used
Save Area Address
Return Address
Work Register
Entry Point Address

Module
Name

IEDQWK

Entry
Point

IEDQWK

I, W,
Register

0
1
2
3
4

or 0

5
6
7
8

9
10
11
12
13
14
15

IEDQWL

0
2
3
4
5

6
7
8

9
10

W
W
W
W
W
W

11
12

13
14
15

Use

Not Used
Parameter List Address
OLTCB Pointer
Not Used
Base Register
Not Used
Not Used
Not Used
Not Used
Not Used
Not Used
Not Used
Not Used
Save Area Address
Return Address
Entry Point Address
Return Code:
X'OO' -Normal Completion
X'04' -Unavailable Function

Not Used
Not Used
OLTCB Pointer
Not Used
Base Register
Work Register
Work Register
Work Register
Test Table Pointer
Test Device Name Table Pointer
Not Used
Not Used
Not Used
Save Area Address
Return Address
Entry Point Address
Return Code:
X'OO'-Normal Return Code
X'08'-Error Return Code

Diagnostic Aids

Module
Name

Entry
Point

IEDQWMI

2
3
4
5
6
7
8
9
10
11
12
13
14
15

IEDQWN

0
1
2

3
4
5
6
7
8
9
10
11
12
13
14
15

I,W.
orO
0
0
W
I
W
W
W
W
W
W
W
W
W
W
1-0
1-0
I

0
I
I
I
W
W
W
W
W
W
W
W
I
I
I

Use
Parameter Register
Parameter List Address
Work Register
OLTCB Pointer
Work Register
Base Register
Work Register
Work Register
Work Register
Work Register
Work Register
Work Register
Work Register
Link Register
Save Area Address
Return Address
Entry Point Address

Parameter Register
Parameter List Address
OLTCB Pointer
Test Module Base Address
Base Register
Test Event Control Block Address
Work Register
I/O Blocks Address
Work Register
Work Register
Work Register
Not Used
Work Register
Save Area Address
Return Address
Entry Point Address
Return Code:
X'OO' -Normal Completion
X'04' -Function Not Available
X'08' -Error

Module
Name

Entry
Point

IEDQWO

I,W,

or 0

2
3

4
5
6

7
8

9
10
11

12
13

14
15

W
I
W
W
W
W
W
W
W
W
W
W
I
I
I

IEDQWP

1
2
3

4
5
6

7
8

9
10
11

12
13

14
15

I
I
W
W
W
W
W
W
W
I
W
I
I
W
I
W

Use
Not Used
Parameter List Address
Work Register
OLTCB Pointer
Work Register
Base Register
Work Register
Work Register
Work Register
Work Register
Work Register
Work Register
Work Register
Work Register
Save Area Address
Return Address
Entry Point Address
Return Code:
X'OO' -Normal Completion
X'08'-Error in Enabling
X'OC'-Stop Line Failed
Not Used
DPRINT Parameter List Address
OLTCB Pointer
Section Preface Address
Base Register
Work Register
Work Register
Work Register
Work Register
Work Register
Work Register
Work Register
Address or Parameter List Control Word
Save Area Address
Return Address
Work Register
Entry Point Address
Work Register
Return Code:
X'OO' - Normal Completion

Diagnostic Aids

Module
Name

IEDQWPI

Entry
Point

IEDQWPI

I,W,

0
1
2
3
4
5
6

8
9
10
11

12
13

orO

I
I
I
W
W
W
W
W
W
W
W
W
W

14
15

IEDQWP2

0
1
2
3
4
5
6

7
8
9
10
11

12
13

W
I
W
0

I
I
I
W
W
W
W
W
W
W
W
W
I

W
14

W
15

W
0

Use

Not Used
DPRINT Parameter List Address
OLTCB Pointer
Section Preface Address
Base Register
Work Register
Work Register
Work Register
Work Register
Work Register
Work Register
Work Register
Address of Parameter List Control Word
Save Area Address
Work Register
Return Address
Work Register
Entry Point Address
Work Register
Return Code:
X'OO' -Normal Completion
Not Used
DPRINT Parameter List Address
OLTCB Pointer
Section Preface Address
Base Register
Work Register
Work Register
Work Register
Work Register
Work Register
Work Register
Work Register
Address of Parameter List Control Word
Save Area Address
Work Register
Return Address
Work Register
Entry Point Address
Work Register
Return Code:
X'OO'-Normal Completion

Module
Name

IEDQWQ

Entry
Point

IEDQWQ

I,W,
Register

0
1
2
3
4
5
6

7
8
9
10
11

12
13
14
15

or 0

I
I
W
W
W

W
W
W

IEDQWR

0
1
2
3
4
5
6

7
8
9
10
11
12
13
14
15

W
W
W
W
W
W
W
W
W
I
I
I

Use

Not Used
CECOM Parameter List Address
OLTCB Pointer
Not Used
Base Register
Work Register
Work Register'
Not Used
Not Used
Output Message Count
Output Message Address
Work Register
Not Used
Save Area Address
Return Address
Entry Point Address
Return Code:
X'OO'-Normal Completion
X'04'-Requested Function Not Available
Entry Point Address of Module Loaded
PLINK Parameter
OLTCB Pointer
Not Used
Base Register
Address of PLINK Control Word
Work Register
Work Register
Address of Entry Point List
Work Register
Work Register
Save Register for Register I
Work Register
Save Area Address
Return Address
Entry Point Address
Return Code:
X'OO' -Normal Completion
X'08'-I/O Error During
X'10'-Memory Space Not Available for
Requested Load Module(s)
X'OC'-Requested Load Module Not Found
in Library

Diagnostic Aids

Module
Name

Entry
Point

IEDQWS

I,W,

or 0

"3'"
4
5

I
I
W
W
W

7
8
9

11
12
13

14
15

W
W
W
W
W
W
I
I
I

IEDQWV

2
3

4
5
6

7
8
9
10

11
12
13

14
15

W
W
W
W
W
W
W
W
I
I
I

Use
Not Used
Parameter List Address
OLTCB Pointer
Work Register
Base Register
TECB Address
Not Used
I/O Blocks Address
Work Register
Work Register
Work Register
Work Register
Work Register
Save Area Address
Return Address Register
Entry Point Address
Return Code:
X'OO'-Normal Completion
X'08' -Timeout
Not Used
GRAB Parameter List Address
OLTCB Pointer
Not Used
Base Register
Work Register
Work Register
Work Register
Work Register
UCB Address of Secondary Device
UCB Address of Primary Device
Address of GRAB Flags
Not Used
Save Area Address
Return Address
Entry Point Address
Return Code:
X'OO' -Normal Completion
X'08' -No (More) Devices in the Entry List
Meet the Specified Requirements
X'OC' -Device Entry List Contains Only
One Device

Module
Name
IEDQWX

Entry
Point
IEDQWX

I,W,

orO

0
I

0
2
3
4
5
6

7
8
9

10
11
12
13
14
15

I
W
W
W
W
W
W
W
W
W
I
I

IEDQWY

0
1

0
2
3
4
5
6

I
W
W
W
I
W

8
9

W
W

II
12
13
14
15

W
W
I
I

Use
Not Used
CONVERT Parameter List Address
Address of Non-EBCDIC Character
OLTCB Pointer
Not Used
Base Register
Address of Input Data
Address of Output Data
Data Count
Address of Parameter List Flags and Count
Work Register
First or Second Byte Indicator
Work Register
Work Register
Save Area Address
Return Address
Entry Point Address
Return Code:
X'OO'-Normal Completion
X'08'-Requested Conversion of NonEBCDIC Character
Not Used
Work Register
Parameter List Address
OLTCB Pointer
Work Register
Work Register
Work Register
Base Register
Work Register
Not Used
Work Register
Work Register
Not Used
Work Register
Save Area Address
Return Address
Entry Point Address
Return Code:
X'OO'-Normal Completion
X'08'-Buffer Size Too Small
X'OC'-DCHB Not Found or DCHB Data
Set Could Not be Opened

Diagnostic Aids

Module
Name

Entry
Point

IEDQ30

0
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

I,W,
or 0

I
W

IEDQ31

0
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

I
W
W
W
W
W
W
W
W

Use

Not Used
Not Used
OLTCB Pointer
Not Used
Base Register
Not Used
Not Used
Not Used
Not Used
Not Used
Not Used
Not Used
DCHB Pointer
Save Area Address
Return Address
Work Register
Return Code:
X'OO' -Normal Return
Not Used
Not Used
OLTCB Pointer
Work Register
Work Register
AVT Dsect Base Register
Work Register
Work Register
Work Register
Work Register
Work Register
Base Register for IEDQ31 CSECT
DCHB Base Register
Save Area Address
Return Address
Return Code:
X'OO' -Normal Completion
X'04' -Hardware Problem
X'08'- Invalid Terminal Table Entry, Line
Not Open, or Invalid Line Address

Module
Name

IEDQ32

I,W,

Entry
Point

IEDQ32

W
W
I
W
W
W
W
W
W
W
W

11
12
13
14
15

0
1

2
3
4
5
6
7
8

IEDQ33

or 0

0
2
3
4
5
6

7
8
9
10

11
12
13
14
15

I
W
W
W
W
W
W
W
W
I
W
I

Use

Not Used
Not Used
OL TCB Pointer
Work Register
Work Register
Work Register
Work Register
Work Register
Work Register
Work Register
Wark Register
Base Register
DCHB Pointer
Save Area Address
Return Address
Return Code:
X'OO'-Normal Completion
X'04' -Hardware Error
X'08' -I/O Error

Diagnostic Aids

Module
Name

Entry
Point

IEDQ34

0
2
3
4
5
6
7
8
9
10
11
12
13
14
15

IEDQ35

0
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

I,W,
orO

W
W
I
W
W
W
W
W
W
W
W

W
W
W
W
W
W
W
W
I
W
I

Use

Work Register
Work Register
OLTCB Pointer
Work Register
Work Register
Work Register
Work Register
Work Register
Work Register
Work Register
Work Register
Base Register
DCHB Pointer
Save Area Address
Return Address
Return Code:
X'OO'-Normal Completion
X'04' -Hardware Problem
X'08'-Control or Data Error Occurred
Not Used
Not Used
OLTCB Pointer
Work Register
Work Register
Work Register
Work Register
Work Register
Work Register
Work Register
Work Register
Base Register
DCHB Pointer
Save Area Address
Return Address
Return Code:
X'OO'-Normal Completion
X'04' -Hardware Error
X'08'-I/O Error

Module
Name

IEDQ36

Entry
Point

IEDQ36

I,W,
Register

a
1
2
3
4
5
6
7
8
9
10
11

12
13
14
15

IEDQ37

0
1
2
3
4
5

6
7
8
9
10
11
12
13
14
15

orO

W
W
I
W
W
W
W
W
W
W
W
I
I
I
I

I
W
W
W
W
W
W
W
W
I
I
W
I

Use

Work Register
Work Register
OLTCB Pointer
Work Register
Work Register
Work Register
Work Register
Work Register
Work Register
Work Register
Work Register
Base Register
DCHB Pointer
Save Area Address
Return Address
Return Code:
X'OO' -Normal Completion
X'04' -Hardware Problem
X'08' -Control or Data Error Occurred
Not Used
Not Used
OLTCB Pointer
Work Register
Work Register
Work Register
Work Register
Work Register
Work Register
Work Register
Work Register
Base Register
DCHB Pointer
Save Area Address
Return Address
Return Code:
X'OO' -Normal Completion
X'04' -Hardware Error
X'08'-I/O Error

Diagnostic Aids

Module
Name

IEDQ38

Entry
Point

IEDQ38

I, W,
or 0

Q
1
2

3
4
5
6
7

8
9
10

W
I
W
W
W
W
W
W
W
W

11
12

13
14
15

Use

Not Used
Work Register
OLTCB Pointer
Work Register
Work Register
Work Register
Work Register
Work Register
Work Register
Work Register
Work Register
Base Register
DCHB Pointer
Save Area Pointer
Return Address
Return Code:
X'QQ'-Normal Completion
X'04'-Hardware Error
X'08'-I/O Error

Tables of Cross References Between TOTE Modules
Module
Name

Entry
Point

Entered
From

lEDQWA

lEDQOS

IEDQWB

Br after 'RESOIA'

IEDQOS

SMGR

OLT'S

IEDQWN
IEDQWP
IEDQWQ
IEDQWR
IEDQWS
lEDQWV
IEDQWX
IEDQWY
lEDQWK
lEDQWMI
IEDQWE

Br after 'RETURN'

OLT'S

IEDQWB

IEDQWA

IGCOOO59

Br after 'RETURN 1'
XCTL aft~r 'RES052'

IEDQWA
IEDQWC

IEDQWC

IEDQWA
IEDQWH

IEDQWQ
AVTUI
IEDQCU
IEDQCV

XCTL after 'TRM090'

IEDQWCI

XCTL after 'TRMERR3'

IEDQWE

XCTL
XCTL
XCTL
XCTL

IEDQWH
IEDQWI
IEDQWJ
IEDQWD

IEDQWCI

IEDQWC

Call

Exit Points

after 'TRMCHKT
after 'TRMIICA'
after 'TRMPT'
after 'RFTEST 1'

Exits To

IEDQWQ
AVTUI
IEDQCV

XCTL after 'TDERR'

IEDQWJ

XCTL after 'TRMI099'
XCTL after 'GETOUT'

IEDQWC2
IEDQWE

IEDQWC2

IEDQWCI

None

XCTL after 'TRM259'
XCTL after 'GETOUT'
XCTL after 'TEST I A'

IEDQWD
IEDQWE
IEDQWJ

IEDQWD

IEDQWC
IEDQWJI
IEDQWJ2

IGCOOO59

XCTL after 'DISPEXIT'
XCTL after 'DISP21 A'

IEDQWE
IEDQWK

IEDQWE

IEDQWA

IEDQWK
lEDQCU
IEDQCV

XCTL after 'TCNTL06'

IEDQWF

IEDQWK
IGCOOO59

Br after 'RETURN4'

IEDQWA

IEDQWC
IEDQWD
IEDQWH
IEDQWJ
IEDQWJI
IEDQWJ2
IEDQWEI

IEDQWF

Diagnostic Aids

Module
Name

Entry
Point

Entered
From

IEDQWF

IEDQWE

OLT's

Br after 'ESUBOO'

IEDQWEI

IEDQWH

IEDQWC

IEDQWQ
AVTUI

XCTL after 'EXIT'

IEDQWC

XCTL after 'TRMERR'

IEDQWE

IEDQWIS
IEDQWISU
IEDQWI6
IEDQWI7
IEDQWI8
IEDQWI9
TCU Configura tors
Device Configurators

XCTL after 'DONE2'

IEDQWE

XCTL after 'ADDON'

IEDQWIA

XCTL after 'DELETE'

IEDQWID

IEDQWQ
IEDQWR
IEDQWISU
IEDQWI7
IEDQWI8
IEDQWI9
Unit Configurators

XCTL after 'DONE4'

IEDQWE

XCTL after 'AGAIN'

IEDQWI

IEDQWISD
IEDQWR
IEDQWQ

XCTL after 'DONE4'

IEDQWE

XCTL after 'AGAIN'

IEDQWI

IEDQWIA

IEDQWID

IEDQWI

IEDQWIA

IEDQWID

IEDQWC

IEDQWI

Call

Exit Points

Exits To

IEDQWIS

IEDQWI

IEDQWQ
IEDQWISD
IEDQWR

Br after 'OPEN'

IEDQWI

IEDQWISD

IEDQWIS

IEDQWQ
IEDQWR

PLINK at 'ADAPTER'

IEDQWIS

IEDQWISU

IEDQWIU
IEDQWIA

IEDQWQ
IEDQWR
PLINK at 'ADAPTER'

IEDQWIA

IEDQWI6

IEDQWI
IEDQWIA

IEDQWQ
IEDQWC

Br after 'ADAPTER'

IEDQWI

IEDQWI7

IEDQWI
IEDQWIA

IEDQWQ
IEDQWR

Brmfter 'ENABENE'

IEDQWI

IEDQWI8

IEDQWI
IEDQWIA

IEDQWQ
IEDQWR
AVTUI

Br after 'PLRET'

IEDQWI

IEDQWI9

IEDQWI
IEDQWIA

IEDQWQ
IEDQWR

Br after 'PLRET'

IEDQWI

Module
Name

IEDQWJ

IEDQWJl

IEDQWJ2

Entry
Point

IEDQWJ

IEDQWJl

IEDQWJ2

Entered
From

Call

Exit Points

Exits To

IEDQWC
IEDQWCl
IEDQWC2

IEDQWQ

XCTL after 'GETOUT'

IEDQWE

AVTUI

XCTL after 'TDDONE l'

IEDQWJI

IEDQWJ

IEDQWQ
XCTL after 'GETOUT'
XCTL after 'APROUT'
XCTL after 'TOOLONG2'

IEDQWE
IEDQWJ2
IEDQWJ

XCTL after 'PMT259'

IEDQWD

XCTL after 'GETOUT'

IEDQWE

IEDQWJl

IEDQWQ
AVTUI

IEDQWK

IEDQWD
IEDQWE
IEDQWA
IEDQWN
IEDQWQ
IEDQWS
IEDQ31

IEDQWL
IEDQWO
IEDQWMI

Bf after 'EMSG03'

IEDQWN
IEDQWS
IEDQWP
IEDQWQ
IEDQWR
IEDQWV
IEDQWX
IEDQWY
IEDQWD
IEDQWE
IEDQWA

IEDQWL

IEDQWK

None

Br after 'STMSGRl'

IEDQWK

IEDQWMI

IEDQWA
IEDQWK

IGCOO059

Br after 'RETURN 1'

IEDQWA
IEDQWK

IEDQWN

IEDQWA

IEDQWO
IGCOO059

Br after 'XIOO 11 '

IEDQWA

XCTL after 'XIOO07F'
XCTL after 'XIOOI5'

IEDQWK
IEDQWK

XCTL after 'ACCESS02'

IEDQ31
IEDQWK
IEDQWN
IEDQWQ
IEDQWP
IEDQWPI
IEDQWP2

IEDQWO

IEDQWN
IEDQWQ
IEDQWP
IEDQWK
IEDQWPI
IEDQWP2

None

Br after 'RETURN'

IEDQWP

IEDQWA

IEDQWO

XCTL after 'DPR085'
Br after 'DPR500'

IEDQWPI
IEDQWK

IEDQWPI

IEDQWP

IEDQWO

XCTL after 'DPRI70'

IEDQWP2

IEDQWPI

IEDQWO

Br after 'DPR500'

IEDQWA

IEDQWQ

IEDQWA

IEDQWO

Br after 'CEC050'
XCTL at 'CEC002'

IEDQWA
IEDQWK
Diagnostic Aids

Module
Name

Entry
Point

Entered
From

Call

Exit Points

Exits To

IEDQWR

IEDQWA

None

Br after 'PLK050'

IEDQWA

IEDQWS

IEDQWA

IEDQWK

Br after 'NOPECB4'

IEDQWA

IEDQWV

II?DQWA

None

Br after 'GRB070'

IEDQWA

IEDQWX

IEDQWA

None

Br after 'CNV018'

IEDQWA

IEDQWY

IEDQWA

None

Br after 'NOPEN'
or 'GC003' or 'GCOO9'

IEDQWA

IEDQ30

IEDQ31
IEDQ32
IEDQ33
IEDQ34
IEDQ35
IEDQ36
IEDQ37
IEDQ38

None

Br after 'ERR024'

IEDQWK
IEDQWN
IEDQWP
IEDQWPI
IEDQWP2
IEDQWQ

IEDQ31

IEDQWO

IEDQUI
IEDQTNT

Br after 'OUT'

IEDQWK
IEDQWP
IEDQWQ
IEDQ32
IEDQ33
IEDQ35
IEDQ36
IEDQ37
IEDQ30
IEDQ38

XCTL after 'REMOTE'
XCTL after
XCTL after
XCTL after
XCTL after
XCTL after
XCTL after

'REM I '
'REM2'
'STSTOP'
'REM3'
'OUTERR'
'REMIA\,

IEDQ32

IEDQ31

None

XCTL after 'XMITD'
XCTL after 'ERTN'
Br after 'RETURN l'

IEDQ34
IEDQ30
IEDQWK
IEDQWN
IEDQWP
IEDQWPI
IEDQWP2
IEDQWQ

IEDQ33

IEDQ31

None

Br after 'RETURN I'

IEDQWK
IEDQWN
IEDQWP
IEDQWPI
IEDQWP2
IEDQWQ
IEDQ30

XCTL after 'OUTERR'
IEDQ34

lEDQ34

IEDQ32

None

XCTL after 'ERTN'
Br after 'RETURN I '

IEDQ30
IEDQWK
IEDQWN
IEDQWP
IEDQWPI
IEDQWP2
IEDQWQ

Module
Name

IEDQ35

Entry
Point

IEDQ35

Entered
From

IEDQ31

Call

None

Exit Points

Br after 'RETURN l'

XCTL after 'OUTERR'
IEDQ36

IEDQ36

IEDQ31

None

Br after 'RETURN l'

XCTL after 'OUTERR'
IEDQ37

IEDQ37

IEDQ31

None

Br after 'RETURN 1'

XCTL after 'OUTERR'
IEDQ38

IEDQ38

IEDQ31

None

Br after 'RETURN 1'

XCTL after 'OUTERR'

Exits To

IEDQWK
IEDQWN
IEDQWP
IEDQWPI
IEDQWP2
IEDQWQ
IEDQ30
IEDQWK
IEDQWN
IEDQWP
IEDQWPI
IEDQWP2
IEDQWQ
IEDQ30
IEDQWK
IEDQWN
IEDQWP
IEDQWPI
IEDQWP2
IEDQWQ
IEDQ30
IEDQWK
IEDQWN
IEDQWP
IEDQWPI
IEDQWP2
IEDQWQ
IEDQ30

Diagnostic Aids

Messages
System Messages

Origin

Destination

IED1261

OLT Request Rejected, No DCHB for Control Terminal

IEDQWC
IEDQWH

System Console

IED1271

OLT Request Rejected, Control Terminal Unidentified

IEDQWC

System Console

IED1281

Alternate Printer Requested by OLT Already in Use

IEDQWC

System Console

IED1291

OLT Request Rejected, C. T. Line cannot be Started

IEDQWC

System Console

lED 1301

OLT Request Rejected, Control Terminal Not Open

IEDQWC

System Console

lED 1311

TRM Canceled, Not Entered From Switched C.T.

IEDQWC

System Console

IED132D

Can OLT Use for Non-Concurrent Mode-Lines XXX

IEDQWCZ
IEDQWJ2

System Console

lED 1341

XXXXXXXX Terminal Failed, OLT Cancelled

IEDQ30

System Console

lED 1351

message *

TOTE
OLT's

Control Terminal

,IED136D

message *

TOTE
OLT's

Control Terminal

IED1351
lED 1351
lED 1351
lED 1351
lED 1351
IED1351
lED 1351
lED 1351
lED 1351
lED 1351
IEDl35I
IED135I
lED 1351
IED135I
lED 1351
IED135I
lED 1351
lED 1351
IED1351
lED 1351
IED1351
IED1351
IED136D
lED 1351
lED 1351

Macro Function Not Supported
Macro Not Supported
On-Line Testing Active
OLT Module XXXXXXXX Not Loadable
S XXXXXXXX Unit YYYYYYYY
T XXXXXXXX Unit YYYYYYYY
Dev Class/Type Unequal to Sect
No UCB for Device XXXXXXXX
Error in Enabling
Invalid TRM-Re-enter
Line XXXXXXXX cannot be Started
Not Enough Core for Section XXXXXXXX
On-Line Testing Terminated
Section cannot be Executed
Start or Stop Line Failed-Abort
Too Many Tests Selected, Only 10 will be Run
I/O Path Busy. SIO Request Rejected
1060 cannot be Control Terminal for Prompt or Config
D1AGMSG DD Card Missing from JCL
XXXXXXXX Not Opened
TRM must be Entered from Test Device if Switched
Only One Switched Test Device can be Entered in TRM
Enter Next Message Segment
Prompting Not Allowed on 1060, Re-enter TRM
TRM Prompter Running

IEDQWK
IEDQWK
IEDQWK
IEDQWK
IEDQWK
IEDQWK
IEDQWK
IEDQWK
IEDQWK
IEDQWK
IEDQWK
IEDQWK
IEDQWK
IEDQWK
IEDQWK
IEDQWK
IEDQWN
IEDQWC
IEDQWC
IEDQWCl
IEDQWCl
IEDQWCl
IEDQWH
IEDQWJ
IEDQWJ

Control Terminal
Control Terminal
Control Terminal
Control Terminal
Control Terminal
Control Terminal
Control Terminal
Control Terminal
Control Terminal
Control Terminal
Control Terminal
Control Terminal
Control Terminal
Control Terminal
Control Terminal
Control Terminal
Control Terminal
Control Terminal
Control Terminal
Control Terminal
Control Terminal
Control Terminal
Control Terminal
Control Terminal
Control Terminal

*Listed below are the possible messages associated with either the
IED1351 or the IED136D message identifier.

System Messages
lED 1351
IED135I
IED135I
IEDl35I
IED136D
IED136D
IEDl35I
IED135I
IED135I
IED136D
IED135I
lED 1351
IED135I
IEDl36D
IED136D
IEDl35I
IEDl36D
IED136D
IED136D
IEDl36D
IED136D
IEDl35I
IED1351
IED135I
IED135I

lED 1351
IED135I
IED136D
IED135I
IED136D
IED136D
IED135I
IED136D
IED136D
lED 1351
lED 1351
lED 1351
IED136D
IED136D
IED135I

Error in Test Device Field
Error in Test Field
Error in Option Field
Error in TRM
Enter Symbolic Name of Terminal or CUU ofTCU to be Tested
Are There Any More Test Devices? Answer Yes or No
Invalid Response Please Enter Yes or No
Already Have 9 Test Devices-Test Device Prompting Finished
Invalid Test Device Entry
Do You Want to Continue Prompting-Answer Yes or No
Invalid Response
TRM must be Entered from Test Device if Switched
Dial Test Terminal Not Allowed with Leased Ones
Do You Want to be Prompted? Answer Yes or No
TRM Rejected, Please Re-enter
XXXXXXXX Not Opened
Enter Test to be Run-FormatNNNA-Example 2700A
Do You Want to Select Routines in this Test? Answer Yes or No
Enter Routine Numbers Separated by Commas
Do You Want Other Test Sections Run on this Device?
Answer Yes or No
Enter Alpha Characters Separated by Commas for Other Sections
Invalid Test Name
Invalid Routine Entry
Invalid Entry for Additional Tests-Valid Entries are A-ZZZ
Default Options are CP, NTL, NEL, CM, NAP, NMI, and EP
Valid Options are TLNNNN, NIL, ELNNNN, NEL, CP, NCP,
NMI, MI, CM, NCM, NEP, AP, NAP-NNNN is a 4-Digit
Decimal Number
EPN-Where N is Level of Printed Output Wanted Enter One
Option or None
Option Entry Invalid
Error in Test Loop or Error Loop Number
Invalid EP Level-Enter 1,2,3, or 4
TRM Buffer Too Small for Last Entry
You Can Re-enter (R), Cancel (C), or Use IRM as is (CO)
Make Entry from Appropriate Parentheses
Invalid Response
Do You Want to Continue Prompting? Answer Yes or No
Enter Alternate Printer Location. Valid Entries are SYSOUTSYSCON-Symbolic Terminal Name
Terminal Assigned to Another OLI
Invalid Terminal Name for Alternate Printer
Alternate Printer Terminal Has Not Been Configured
Enter Different Terminal, SYSOUT, SYSCON or NAP
Do You Want to Continue Prompting? Answer Yes or No
Invalid Response

Origin

Destination

IEDQWJ
IEDQWJ
IEDQWJ
IEDQWJ
IEDQWJ
IEDQWJ
IEDQWJ
IEDQWJ
IEDQWJ
IEDQWJ
IEDQWJ
IEDQWJ
IEDQWJ
IEDQWJ
IEDQWJ
IEDQWJ
IEDQWJ1
IEDQWJ1
IEDQWJl

IEDQWJ1
IEDQWJ1
IEDQWJ1
IEDQWJ1
IEDQWJ1

Control Terminal
Control Terminal
Control Terminal
Control Terminal
Control Terminal

IEDQWJ1
IEDQWJ1
IEDQWJJ
IEDQWJl
IEDQWJ1
IEDQWJ1
IEDQWJ1
IEDQWJ1
IEDQWJl

Control Terminal
Control Terminal
Control Terminal
Control Terminal
Control Terminal
Control Terminal
Control Terminal
Control Terminal
Control Terminal

IEDQWJ2
IEDQWJ2
IEDQWJ2
IEDQWJ2
IEDQWJ2
IEDQWJ2
IEDQWJ2

Control Terminal
Control Terminal
Control Terminal
Control Terminal
Control Terminal
Control Terminal
Control Terminal

Diagnostic Aids

Operator Messages

Description Codes
1

Routing Codes

OPERATOR MESSAGES
lED

IED1261

OlT Request Rejected, No DCHB For Control
Terminal

IED1271

OlT Request Rejected, Control Terminal
Unidentified

IED1281

Alternate Printer Requested by OlT Already
In Use

IED1291

OlT Request Rejected, C. T. line Cannot Be
Started

IED1301

Oll R~quest Rejected, Control Terminal Not
Open

IED1311

TRM Cancelled, Not Entered From Switched
C.T.

IED132D

Can OlT Use For Non-Concurrent Mode lines XXX

IED1341

XXXXXXXX Terminal Failed, OlT Cancelled

IED1351

message

IED136D

message

Table of Macro References in On-Line Test Facility Modules

~
V
u.J

IEDQWA
IEDQWB
IEDQWC
IEDQWCl
IEDQWC2
IEDQWD
IEDQWE
IEDQWF
IEDQWH
IEDQWI
IEDQWIA
IEDQWID
IEDQWI5
IEDQWI5D
IEDQWI5U
IEDQWI6
IEDQWI7
IEDQWI8
IEDQWI9
IEDQWJ
IEDQWJl
IEDQWJ2
IEDQWK
IEDQWL
IEDQWMl
IEDQWN
IEDQWO
IEDQWP
IEDQWPl
IEDQWP2
IEDQWQ
IEDQWR
IEDQWS
IEDQWV
IEDQWX
IEDQWY
IEDQW9
IEDQ30
IEDQ31
:EDQ32
IEDQ33
IEDQ34
IEDQ35
IEDQ36
IEDQ37
IEDQ38

I--

>
V

«
i5

v""

::J

..J

co
V

iJ.

X
X

X
X
X
X
X

X
X
X
X
X
X
X
X

X
X
X

u.J

'"
X
X

X
X
X

X
X

I--

~
I--

>
Z

vI--

X
X
X
X
X
X

X
X
X
X
X

I--

Cl
I--

I--

u.J

X
X
X

co
V
..J

X
X

Ii.

I--

co
V

I--

co
V

I--

V>
I--

I-I--

co
V

u.J

I-I--

X
X
X

X
X

X
X
X

X
X

X
X
X

..J

X
X
X

X
X

..J

""Z
::;

X
X
X

I--

X
X

co
V

X
X

X
X
X

X
X

X
X
X
X

x
X

X
X
X

X
X

X
X
X

X
X
X
X
X
X
X

x
X
X
X

X
X
X

X
X
X
X
X
X
X
X

Diagnostic Aids

Chart QWA

TOTE RESIDENT MODULE

•

ABEND

•

•
YES

•

..J

•

Flowcharts

Chart QWB

RESOURCE MANAGEMENT MODULE (PART 1 OF 2)

•

IEDQWB

•

•
o

•

FUNCT I I FUNCT2.
FUNCT3, FUNCT4.
FUNCT5

BRANCH TO
REQUESTED
ROUTINE

QWB
DI

WBA-AI

WBA-A3

WBA-A5

WBA-F2

WBA-F4

•
F

QWB
FI

.
.

•

•
(

RETURN

)
•

.
80

Chart WBA

RESOURCE MANAGEMENT MODULE (PART 2 OF 2)

•

•
B

•

cr
CLEAN UP ENDED
ON-LINE TEST

CLEAN UP ENDED
ON-LI NE TESTS

GET TOTE SIZE

..
B

.
C

DETERMINE
OPERATING
SYSTEM TYPE

CANCEL ALL
INCOMPLETE
ON-LINE TESTS

RETURN ANY
ELEMENTS IN TRM
QUEUE

•
E

•

..
ASS I GN REQUIRED
CORE TO OLT

•

REMOVE TRM FROM

QUEUE

1
SET UP LI NLAGE
PARAMETER LIST
FOR RESTART OR

INI T I ALI ZAT ION
AS REQUIRED

IN I TI AL I ZE

OLTce

•
r;;;l

•

'V
~

MOVE TRM TO

OLTCB

•
RETURN TRM
BUFFER

•

Flowcharts

Chart QWC

TRM ANALYSIS MODULE (PART 1 OF 2)

•
NO

YES

•
TRANSLATE TRM
FROM U NE CODE

OPEN DCH8 OAT A
SET

•

READ CORRECT

OCHB RECORD FOR

(

CONTROL
TERMINAL

XCTL

I EDQWE )

•
F

SEND ALTERNATE
PRINTER IN USE
MESSAGE TO
SYSTEM CONSOLE

CLOSE DCH8 DATA
SET

.
NO

OPEN DIAGMSG
OC8

OPEN OCHB OAT A

SET

•
H

SET CANCEL FLAG
IN ALL OLTes's
WITH SAME

READ CORRECT
RECORD FOR

ALTERNATE

PRINTER

CONTROL

TERMINAL

•
CLOSE DCH8 DATA
SET

•
K

WCA
81

Chart WCA

TRM ANALYSIS MODULE (PART 2 OF 2)

•

•
NO

•

TRM090

SEND CONTROL

INDICATE

1060

CAN'T BE
CONTROL

TERMONAL IN UES
MESSAGE TO
SYSTEM CONSOLE

TERMINAL

•
~

'\}'

•
F

STOP CONTROL

TERMINAL LINE

•
G

•
H

•
START LINE ON
WHICH TRM WAS
ENTERED

•

Flowcharts

Chart WCI

TRM ANALYSIS MODULE I

•

•
NO

YES

•
SEND MSG THAT
SW ITCHED TEST
TERM MU~T BE
REQUEST TERM

FINO TEST
DEVICE FIELD OF
TRM

•

TRM 1096

YES

•
ASSUME TEST

TERMINAL

SEND TERM 1 NAL

REQUEST

NOT OPENED
MESSAGE

TERMINAL

SEND MSG

THAT

ONL Y ONE
SW ITCHED TEST

TERM CAN BE
ENTERED

•

INDICATE ERROR
IN TEST DEVICE
FIELD

•
(XCTL

I EDQWJ )

•
d

•

•
84

Chart WC2

TRM ANALYSIS MODULE 2

•

TE5T4

MSG TO ClJNTROL
TERMINAL THAT
ALT PRINTER

CAN'T

SW ITCHED

.
FIND TESi FJELD
OF TRM

.
o

•
! NO I CATE ERROR
IN TEST FIELD

REQUES T USE OF
NECESSARY LINES

I NO I CATE ERROR

IN NCM AT

IN OPTION FIELD

SYSTEM CONSOLE

•
YES

.
INDICATE

TRM

REJECTED

•
(

XCTL

lEOQWE)

•

Flowcharts

Chart QWD

TOTE DISPATCHER (PART 1 OF 2)

•
8

•

•
D

SEND MSG

'ON-LINE
TESTING ACTIVE'

•
E

BUILD SYMBOLIC
NAME TABLE

•
F

I EDQWK

SET UP OLTCB
PO I NTERS AND
DEV ICE
ADDRESSES

SEND MESSAGE
• INVALID TRM'

•

•
~

•

.
86

Chart WD2

TOTE DISPATCHER (PART 2 OF 2)

•

•
Flowcharts

Chart QWE

OLT TEST CONTROL MODULE 1 (PART 1 OF 2)

•

IEDQWE

•

YES

PUT ADDRESS OF
OL T PARAMETER
LIST IN Rl

•

INIT REGISTER

SEND SECT I ON
START MESSAGE

•

POINTERS TO

SECT ION I

UCB

AND DEVICE
TABLES

0
IEDQWF

•
E

-I

LINK TO OLT
ROOT MODULE

GET 5 I ZE OF OL T
ROOT MODULE
US I NG BLOL
MACRO

c~~
I

•
F

•
G

SUBTRACT MODULE
SIZE FROM CORE

START TEST LINE
I F NOT ALREADY
STARTED

YES

AVA ILABLE

.
E

..
F

.
G

•
H

UPDATE CORE
AVAILABLE TO
REFLECT DELETED
OLT

..
IEDQWK
UPDATE CORE

AVA lLABLE LOAD
OL T ROOT MODULE

RESTORE GRAB
POINTER

SEND MESSAGE

'OLT NOT

LOADABLEt

•
K

SEND SECT I ON
TERMINATE
MESSAGE

•
88

•

'V
4

•

Flowcharts

Chart QWF

OLT TEST CONTROL MODULE 2

•

•
B

•
ON-LINE TEST
ROOT

BRANCH TO OLT
ROOT ROUTINE

•

•
E

(

XCTL IEDQWE)

•
F

•
G

•

•
K

ill

Chart QWH

NUMERIC TRM HANDLER (PART 1 OF 3)

IEDQWH
QWH
85
READ DCH8 DATA
SET

•
TURN OFF START
FLAG

LINK TO IEDQWO

WHA,E3

ENDSRCH
CLOSE DCH8 FLAG

FIND LENGTH OF
MSG

•

MOVE SAVED
CHARACTER TO
WORK AREA

GO F I NO LENGTH
OF MSG

.
NO

.
TURN ON ODD
FLAG

NUMTRAN

WHB,AI

GO TRANSLATE

FROM NUMERIC
CODE

•
MOVE LAST
CHARACTER TO

ODDSAVE

MOVE TO TRM
AREA IN OLTCB

•
r-----~~-----,.HB.F2
K

ENDHUNT

TURN ON
TERMINATE FLAG

FIND

IF LAST OF
TRM

Flowcharts

Chart WHA

NUMERIC TRM HANDLER (PART 2 OF 3)

•

~
8

•

NIIM' n

<7'"

MOVE SAvED CHAR
TO WORK AREA

TO 000 SAVE

MovE LAST CHAR
TO ODOSAVE

MOVE MSG TO
WORK AREA

WH8 9 AI

AREA

M0031

MOVE RE'ST OF
MSG TO WORK

WORK AREA

NUMER I C CODE

FLAG

MOVE MSG TO

TRANSLATE FROM

T'JRN ON ODD

MOVE LAST CHAP

n.,

11M' n?

CLEAR ODD FLAG

NUMTRAN

•

LAST MSG ODD

AREA

NUM 100

MSG TO WORK

•

MOVE REST OF

•

HA
A2

•

MOVE TO TRM
AREA IN OLTCB

.
E

~WHB'F2

•

'V'

GET MESSAGE
ADDRESS

•
YES

•

)

INCREMENT

COUNTERS

•

Chart WHB

NUMERIC TRM HANDLER (PART 3 OF 3)

•

•
NUMTRAN

•

RETURN

)

YES

•

CLEAR WORK AREA

PACK 2 8YTES

•
F

REMOVE SIGN

•
G

STORE

IN WORK

AREA

•
H

BUMP POINTERS

DECREMENT COUNT

SET UP PO INTERS

..
>=_..... CLOSE

~~~8 DATA

.
TRANSLATE WORK
K

AREA

RESTORE
REGISTERS

•

Flowcharts

Chart QWI

TOTE CONFIGURATOR SCHEDULER (PART 1 OF 3)

•

QWI

•
B

CECOM 'ERROR
OPEN'

PLlNL IEOQWI.

PLINK

IEDQWI8

•
C

I S SUE €NQ MACRO
TO REQUEST
EXCLUS I VE USE
OF DCHB

DELETE

DELETE I EDQW I 8

I EDQW I.

•

•
CECOM 'CONFIG
BUSY REQUEST

PLINK

LATER'

IEDQWI1

•
~
E

PLINK

IEDQWI5

PLINK

DELETE I EDQW 11

IEDQWI9

•
F

OELETE

I EDQW I

•
PLINK TCU
CDNFIG

.
NO

•
DELETE TCU
CONFIG

CECOM 'UNABLE
TO LOAD'

•
K

~
OPEN DCHB DA T A
SET

•
94

'V'

WR I TE TCU DCHB
RECORD

•

Chart 102

TOTE CONFIGURA TOR SCHEDULER (PART 2 OF 3)

•

CLEAR aCHe

DELETE IEDQWI9

TERMINAL FIELDS

•

'V'

YES

•

~gjJ

•
0

WRITE TERMINAL
DCH8

PLINK TERMINAL
CONFIG

CECOM 'MDRE TP
LINES'

CECDM

• UNABLE

TO LOAD'

ISSUE DEQ MACRO
TO REKEASE USE
OF aCHB

CECOM

CECQM 'MORE
TERM I NAL 5 ON

• CQNF I G

FINISHED'

~INE'

•

CLOSE DCH8 DATA

ADD 1 TO aCHB
NUMBER FOR LINE

SET

•
K

SET AND RESET
FLAGS

WR I TE TERM I NAL
aCHB

•

Flowcharts

Chan WIl

TOTE CONFIGURATOR SCHEDULER (PART 3 OF 3)

•

•
B

•

•
o

•

•
E

•
F

•

•
~

•

•
96

•

Chart WIA

CONFIGURATOR ADD SCHEDULER MODULE (PART 1 OF 2)

•

C?
YES

SET DUPLICATE
FLAG

..
B

.
PL I NK

IEDQWI5U

WRITE DCHB2

PLINK

CECDM 'LINE
ALREADY IN
DCHB'

JEOQWI7

.
C

DELETE

I EDQW 15U

Q;J

DELETE

I EDQW I 7

.
D

OPEN DCHBI

..
NO

PLINK TCU

CONFIG

.
F

OPEN DCHB2

.
F

.
NO

CECDM

DELETE TCU
CONFIG

• UNABLE

TO LOAD'

.
H

Q;J
C4

WRITE Teu DCHB

REAO aCHBI

..
WIA
K4

CECOM 'CANNOT
OPEN DCHe'

•

YES
J

Q;J

Q;J
C4

PLINK

IEDQWI8

Flowcharts

Chan [Ai

CONFIGURATOR ADD SCHEDULER MODULE (PART 2 OF 2)

•

GLJ

•

DELETE

IEDQWI8

..
YES

WR ITE TERM I NAL
DCHB

ADD I TO DCHB
LINE NUMBER

•
C

PLINK

CLOSE DCHBI AND
DCHB2 DATA SETS

WRITE TERMINAL
DCHB

IEDQWI9

•
o

DELETE

ISSUE DEQ MACRO

CLEAR TERM I NAL
DCHB FIELDS

I EOQW I 9

TO RELEASE USE
OF DCHB

.
YES

YES

•
F

PLINK TERMINAL
CDNF I GURA TOR

RESTORE
REGISTERS

CECOM 'CONF I G
FINISHED'

•
SET AND RESET

FLAGS

•
DELETE TERM I NAL

(

CONF I GURATOR

XCTL

(

IEDQWE)

XCTL

IEDQWI )

•
J

CECOM 'MORE
TERMINALS'

•

.
98

Chart WID

CONFIGURATOR DELETE SCHEDULER

C?
YES

cr
SET LINE FOUND
FLAG

•
C

FINISHED'

SET AND RESET
FLAGS

WR ITE DCHB2

0
PLINK

CECOM 'CQNFIG

RESTORE REGS

IEDQWI50

RESTORE REGS

•
(

DELETE IEOQW15D
0

XCTL

IEDQWE)
D

.
OPEN aCH8 t

•

OPEN DCH82

YES

CECOM 'OPEN
ERROR'

CECOM 'LINE NOT
FOUND'

.
H

•

READ A RECORD
DCHB!

CLOSE DCHB
AND 2

ISSUE OEQ MACRO

•

TO RELEASE USE
OF DCHB

G
.

Flowcharts

Chart WI5

CONFIGURATOR SUBMODULE 1

•

CECOM 'CONFIG
RUNNING'

CECOM 'I S THI S
AN INITIAL RUN'

•

CLEAP UPDATE
FLAGS

CECOM 'ADD? •

•
F

TURN ON ADDON

YES

FLAG

•

CECOM 'DELETE'

RESTORE REGS

SET NO OPTION

•

FLAG

(

RETURN

•
100

•

)

Chart [50

CONFIGURA TOR DELETE SUBMOOULE
4

IEDQW 150

.
B

.
CECDM 'ENTER
LINE TO DELETE'

..
GET ADDRESS OF

INDEX TABLE

.
E

.
SAVE CUU IN
WORK5

CECQM

• INVALID,

ENTER AGA IN'

.
RESTORE REGS

)

.
J

•

Flowcharts

101

Chart 15U

CONFIGURATOR CHANGE SUB MODULE

•

..
CECOM
'UNSUPPORTED
DEVICE'

SET FLAG MOVE
2702 TO DCHB

SET FLAG MOVE
270 I

TO DCHB

.
c

.
CECDM 'ENTER
LINE TO UPDATE'

GET ADAPTER

TYPE

.
o

.
GET ADDRESS OF
[NDEX TABLE

PUT ADAPTER
TYPE IN DCHB

RESTORE REGS

..
F

.
(

SAVE UCB REG

RETURN

)

.
G

.
PUT CUU IN

CECQM

WORK5

• 7770

..
YES

MOVE 2848 TO

DCH8 SET FLAG

'-----8

.
102

Chart Wl6

CONFIGURATOR SUBMODULE 2

•

•
CECOM

'UNSUPPORTED
DEVICE'

•

•
CECOM 'ENTER

LINE ADDRESS'

•

•
GET ADDRESS OF

•
E

INDEX TABLE

•
NO
CECOM 'INVALID
>-"'---1
REENTER'

CECQM '7;70 ?'

•
F

•

SET FLAG MOVE
7770 TO DCH8

•
YES

SET FLAG MOVE
2848 TO DCH8

SET FLAG MOVE
2703 TO DCHB

•

•
AI""''"'''''............- - ,
SET FLAG MOVE

2101

TO DCHB

GET ADAPTER

YES

TYPE

•

•
SET FLAG MOVE
2702 TO aCHB

)

YES

•

Flowcharts

103

Chan WI7

CONFIGURATOR SUBMODULE 3 (PART 1 OF 2)

IEDQWI7

•

•
L

SET TO LOCAL

CECDM 'I S LINE

SWITCHED'

•

•
YES

YES

•
CECD~

'IS LINE

SET SW I TCHED NO
AUTO

MULTIPOINT'

SET

SW ITCHED

AUTO

•
YES

SET TO LEASED

MULTIDROP

•
J

SET LEASED
POINT TO POINT

•
K

MOVE LI NE FLAG
TO DCHB

104

Chart 17A

CONFIGURATOR SUBMODULE 3 (PART 2 OF 2)

•

YES

<$>
<$>

•

YES

•

~~------------------------------------------------------------------·I

IBM TTY

YES

~~------------------------------------------------------------------·I

IBMII

•

MOVE BCD LINE
CODE TO aCHB

YES

•

MOVE USAC I 18

C.C.

•

TO OCHB

"'0''"

•

MOVE JTA2 L.C.

TT~~~~

TO DCHB

•

______,

MOVE BAUDOT

L.C. TO OCH8

•

YES

YES
H

•

SO/'-'-...........-'-____- ,
MOVE TWX

L.C.

MOVE FOUR8 TO

L.C. TO DCH8

DCH8

•

(

RETURN)

Flowcharts

105

Chart WI8

CONFIGURATOR SUBMODULE 4

•

•
CECOM • TERM I NAL

NAME'

•
c

.
MOVE NAME TO

QCHB

CECOM

• TERM I NAL

BYPASSED'

'INVALID,

REENTER'

.
E
SET ERROR

FLAG

.
MOVE DIAL

DIGITS TO DCHB

..
G

.
MOVE ADDRESS I NG
CHARACTERS TO

DCHB

YES

1....--=-<

..
RESTORE REGS

.
106

Chart WI9

CONFIGURATOR SUBMODULE 5

•

CECOM 'TERMINAL
BYPASSED'

CECQM "INVALID.

REENTER'

.
GET SCT ADDR
AND MOVE TO

SET ERROR FLAG

aCHB

.
o

FIND INVITATION

MOVE CPU [D TO
aCHB

LIST ADDRESS

RESTORE REGS

.
Pjollol..!ll.l.l~...l....

_ _....,

MOVE POLL
E

CHARACTERS

DCHB

.
F

(

CHECK SOHr.

MOVE TO aCHB

EBCDIC

RETURN

)

..
YES

~~--------------------------------,

MOVE EBeD I C TO
L.C. TO aCHB

YES

MOVE TO aCHB

------,--,l.s

SET LC TO
H

MOVE

TO aCHB

USASC I I

MOVE TRANCODE

MOVE TO

TO L

aCHB

TO aCH8

L---

CECOM • WHAT
TYPE OF
TERM INAL'

MOVE TO aCHB

.
MOVE TO DCH8

•

Flowcharts

107

Chart QWJ

TRM PROMPTER MODULE 1 (PART 1 OF 7)

•

9P
FIND TEST

DEVICE FIELD

•
8

•
CECQM
YES

'PROMPT! NG NOT
ALLOWED ON

1060, REENTER
TRM'

QWJ

•

>Y.::E,:,S_-I CECOMT~~~ROR

PRMCONT
IN

FINO IF
PROMPTER WANTED

CECOM • ALREADY
NINE DEVICES'

•
YES

>-':":'--+1

CECOM 'ERROR
TO FIELD'

MOVE TRM TO
OLTCB

•
.>Y.::E,:,S_-I

CE~~~T '~m§,

1-------,

•
G

•
CECOM
H

PRMCONT

'PROMPTER

RUNNING'

FINO

PROMPTER WANTED

•
J

MOVE TRM TO
WORK AREA

•

.
108

Chart WJA

TRM PROMPTER MODULE 1 (PART 2 OF 7)

•

CECOM 'ENTER

NAME OR CCU'

•

•
B

SAVE TERM I NAL
NAME

•

TABLE
C

SET UP BINARY
SEARCH

YES

•

31B
AI
D

DETERMINE
LENGTH OF
TERM I NAL NAME

YES

•

TNTSRCH
E

PUT DIAL COUNT
IN CCW

GET TERM I NAL
TABLE ENTRY

~
F3

•

PUT DCB AND UCB
ADDR IN DEB

PUT AOOR OF
DIAL DIGITS IN
CCW

•

MOVE DEB TO

PUT DIAL

PROTECTED CORE

COMMAND

ecw

•

GET DCB ADOR

•

INITIIALIZE
CHAN PROG
POINTER lCPAI

WITH 'DISABLE'

(0
•

•

Flowcharts

141

Chart 31B

ENABLING MODULE (PART 3 OF 7)

•

GET CONTROL
UNIT BITS FROM
UCB

•

GET FEATURE
BYTE FROM UCB

•

D
31B
F3
PUT SAD COMMAND
IN CCW

•

YES

BUILD REST OF
SAD COMMAND

•

•
BU I LD ENABLE

ee.

BU I LD SETMDOE

cew

INCREMENT CPA
POINTER

•

YES

•

YES

SW AUTD-DIAL

•

310
AI

H
BU I LO ENABLE

ccw

31A
C3

•

310
C2

•

142

Chart 31C

•

ENABLING MODULE (PART 4 OF 7)

•

31C
C2

•

SET LOOP COUNT
OF 32 IF BAO
STATUS IS
RETURNED

..
0

.
WTO 'WAITING
FOR LINE

CONNECTION WITH

TERM I NAL XX'

•
EXECUTE CHANNEL
F

PROGRAM

•

YES

•

SET RETURN CODE

•

X'oa'

RETURN

DECREMENT LOOP
COUNT

Flowcharts

143

Chart 31D

ENABLING MODULE (PART 5 OF 7)

•

31D
82

I,,,,"

•

DIAL CCW

•

~
C2

EXCP

•

ENABLE LINE

•

•
(

XCTL

IEDQ30 )

~
F2

•

YES

RETURN

•
(

XCTL

IEDQ32 )

•

144

•

Chart 31E

ENABLING MODULE (PART 6 OF 7)

•

TABLE

•

•
B

•

GET CVT ADDR

•

GET TCAM

DISPATCHER ADOR

PUT AoDR OF
USER RoUTI NE
TABLE IN REG 15

•
D

BRANCH R15

•

GET AVT ADOR

•

GO GET TERMNAME
INDEX

•

GET TERM NAME
TALBE ADDR

•

GET OFFSET TO
BINARY SEARCH
ADDR

SET RETURN CODE

PUT TERMNAME
TALBE ADoR IN
REG 15

TO X'OB'

•
G

RETURN

)

BRANCH RI5

GO GET TERMNAME
TABLE ENTRY

•
H

•

SAVE ENTRY

•

•
Flowcharts

145

Chart 31F

ENABLING MODULE (PART 7 OF 7)

•

~
A

•

YES

•

YES

•

YES

•
F

YES

•

YES

•

YES

•

146

•

Chart Q32

BSC REMOTE PRINT MODULE (PART 1 OF 2)

Q32
94

..
R
INIT BASE REGS,
lOB, LINE
CONTROL
CHARACTERS

SET RETURN CODE
TO 08

..
01
SET UP CHAN PGM
TO WR 1TE SELECT
ADDR AND READ
ACK

YES
C

.
0

SET UP CHANNEL
PROGRAM FOR
WR ITE AND READ

.
E

EXCP

..
NO

.
G

ENQD

READ TO CLEAR

TCU RECEIVING
CONTROL BIT

WRITE EOT

.
Flowcharts

147

Chart 32A

BSC REMOTE PRINT MODULE (PART 2 OF 2)

•

Y
A

•
B

SET UP CHAN PGM
TO WR ITE ENQ
AND READ ACK

•

TRANSMIT EOT

.
NO
E

•

..
(

XCTL

..
G

•

'V
It

148

Chart Q33

START-STOP REMOTE PRINT - 2740 (PART 1 OF 4)

,.
GET AND SAVE
TeAM DCB

IN [T I AL [ZE CPA

TO SEND THREE
EDT'S

ADDRESS

BUILD CCW TO
SEND TEXT

PUT
C

UCB ADDRESS
IN DEB

GET TEXT TO 8E
TRANSM I TTED

EXCP
SEND TEXT

GET ADDRESS OF
PRINTER aCHB

YES
D

SET FLAG IN DEB
NOT TO USE

SYSTEM ERP

GET

uee

ADDRESS

PUT TeAM DUMMY

VECTOR TABLE
ADDRESS IN DEB

GET ADDRESS OF
TeAM

TRANSLATION

SET UP ERROR

LOOP COUNTS

SET RETURN CODE

TO X'OB'

TESREPLY

MOVE DEB TO
PROTECTED CORE

TRANSLATE TEXT

SET UP CCW LIST

TO RECE I VE TEXT

,.
G

TURN ON

READ-ONLY FLAG

EXCP

GET DCB ADDRESS

READ TEXT

GET

ADDR

PUT DCB AGOR
lOB

CONTROL

TERM [NAL aCHB

~
AI

GET

uee

GET ADDRESS OF

ADOR

TEXT TO 8E SENT

,.
K

G
M

•

BUILD CCW TO
SEND IDLE

CHARACTERS
4

Flowcharts

149

Chart 33A

START-STOP REMOTE PRINT - 2740 (PART 2 OF 4)

•

YES

•
B

GET ADDRESSING
CHARACTER

GET ADDRESS OF
CONTROL
CHARACTERS

GET CCW TO READ
RESPONSE

•
C

BUILD CCW TO
SEND ADDRESS I NG
CHAR

BUILD CCW TD
SEND CONTROL
CHARACTERS

•

EXEC CHANNEL
PROGRAM

33A
E5

BUILD CCW TO
READ RESPONSE

•

EXCP

GET ADDRESS OF
CONTROL
CHARACTERS

EXEC CHANNEL
PROGRAM

•

BUILD CCW LIST
TO RECEIVE TEXT

EXCP

BUILD CCW TO
SEND CONTROL
CHARACTERS

YES

•

EXEC CHANNEL
PROGRAM

BUILD CCW TO
RESPOND TO TEXT

BUILD CCW TO
READ RESPONS,"

YES

•
H

EXCP

EXEC CHANNEL
PROGRAM

•
J

•

YES

GET CCW TO SEND

IDLE CHAR

GET CCW TO SEND
TEXT

150

Chart 33B

START-STOP REMOTE PRINT - 2740 (PART 3 OF 4)

GET CCW TO SEND
EDT SEQUENCE

•
EXCP
B

CLEAR ECB AND
CSW

EXEC CHANNEL
PROGRAM

•
EXECUTE CHANNEL
PROGRAM

•
WAIT FOR I/O
COMPLETION

•
YES

BUILD CCW LIST
FOR TRANSM IT
CONTROL

•
F

GET ADDRESS OF
TCAM
TRANSLA TI ON
TABLE

YES

.
G

BUILD PREPARE
CCW

TRANSLATE TEXT

GET POLLING
CHARACTERS

•
H

•
DELETE CONTROL
CHARACTERS

8UILD CCW TO
READ TEXT

BUILD CCW LIST
TO READ TEXT

•

.
RESTORE

REGISTERS

Flowcharts

151

Chart3Bl

START-STOP REMOTE PRINT - 2740 (PART 4 OF 4)

•

r;;l

'
tS

2740 DEVICE

.
YES

YES

.
o

TURN OFF

DECREMENT ERROR

LOOP COUNT BY 1

ADDRESSING FLAG

.
r;;l
E

(XCTL

YES

'EOQ30 )

.
YES

.
RETURN

152

Chart Q34

BSC REMOTE PRINT SUBMODULE (PART 1 OF 2)

•

.
B

INITIALIZE
ROUTINE

•
YES
SET UP CHAN PGM
'-",-,-_ _ I
TO POLL AND
READ TEXT

1-------,

•
o

SET UP CHAN PGM

AND READ ENQ

34A
AI

.
NO

.
SET UP CHAN PGM

WRITE ACKO AND
READ TEXT

WR I TE NAK

.
r;;l

•
J

•

Flowcharts

153

Chart 34A

BSC REMOTE PRINT SUBMODULE (PART 2 OF 2)

•

34A
AI

EXECUTE CHANNEL

•

PROGRAM

34A
CI

•

SET UP CHAN PGM
TO WR I TE

•

ACK 1

AND READ EDT

•

SET 'NO EDT'
INDICATDR

•

WRITE NAK

TRANSLATE IF

•

RT~¥bRT~pu~UT

•

BUFFER

34A
HI

•

SET RETURN CODE

TRANSM I T EDT

•

X' 08'

•

YES

•

154

•

Chart Q35

START-STOP REMOTE PRINT - 1050 AND 1060 (PART 1 OF 3)

•

IN IT I AL I ZE CPA
TO SEND I
CIRCLE 0 AND 3
EDT'S

GET AND SAVE
TCAM DCB ADOR

.
PUT UCB AOOR IN

GET TEXT TO BE

DEB

TRANSM I TTEO

..
SET FLAG I N DEB
NOT USE SYSTEM
ERP

.
GET AOOR OF
TCAM
TRANSLAT I ON
TABLE

PUT TCAM DUMMY

VECTOR TABLE

AOOR IN DEB

35A
A1

.
MOVE DEB TO
PROTECTED CORE

TRANSLATE TEXT

.
F

GET DCB AOOR

•
TURN ON

REAO-ONL Y FLAG

PUT DCB AOOR

SET RETURN CODE

x'oa'

lOB

•
GET ADDR OF

PRINTER DCHB

GET AODR OF

CONTROL

TERM I NAL OCHB

•
GET UCB ADDR

GET UCB ADDR

•

•
Flowcharts

155

Chart 35A

START-STOP REMOTE PRINT - 1050 AND 1060 (PART 2 OF 3)

•

GET CCW TO READ
RESPONSE

•

EXCP

•

waITE TEXT

GET ADDRESS I NG
CHAR

•
BUILD CCW LIST
TO ADDRESS
DEVICE

GET CCW LI ST TO
SEND IDLE CHAR

•

BUILD CCW LIST
TO READ TEXT

BUILD CCW TO
READ RESPONSE

r;;J

GET CCW TO SEND
EDT SEQ

EXCP

•

READ TEXT
EXCP

ADDRESS DEV I CE

BUILD CCW TO
RESPOND TO TEXT

•

EXCP

•

WR I TE RESPONSE

GET CCW TO SEN
IDLE CHAR

r;;J

•

..J

GET CCW TO SEND
TEXT

•

ill

156

ill

Chart 358

START-STOP REMOTE PRINT - 1050 AND 1060 (PART 3 OF 3)

•

~
AI

A
B4

GET CCW TO SEND
EOT SEQ

•

EXCP

CLEAR ECB AND
CSW

WRITE EDT'S

•

EXECUTE CHANNEL
PROGRAM

WAIT FOR

I/O

•

COMPLETION

DECREMENT ERROR
LOOP COUNT BY I

GET ADDR OF
TCAM
TRANSLATION
TALBE

BUILD PREPARE
CCW

•

BUILD CCW TO
READ TEXT

TRANSLATE TEXT

•

DELETE CNTLL
CHARS

(

•

RETURN)

MOVE TEXT TO
TOTE'S INPUT

DECREMENT ERROR
LOOP COUNT BY 1

GET POLLING
CHAR

BUFFER

•
~

INITIALIZE CPA

BUILD CCW LIST
TO READ TEXT

POINTER

•

RETURN

(

RETURN

)

IEDQ30)

•

Flowcharts

157

Chart Q36

START-STOP REMOTE PRINT - 1030 (PART 1 OF 3)

•

Immo

START

•

I
INITIALIZE CPA

GET AND SAVE
TeAM DCB
ADDRESS

•
SATISFY

PUT

LINKAGE

CONVENTIONS

SEND THREE
EDT'S

uee ADDRESS

GET TEXT TO BE
TRANSMITTED

IN DEB

•

SET FLAG IN DEB
NOT TO USE

ESTABL I SH

BASE REG FOR
OlTce

•
o

YES

PUT TeAM DUMMY
VECTOR ADDRESS

OPRINT

IN DEB

E
GET ADDRESS OF
PH INTER QCHB

YES

CECOM

GET

uee

READ ONLY

OPERATION

ADDRESS

•
G

YES

TURN ON
READ-ONLY FLAG

•
H

GET ADDRESS OF
CONTROL
TERM J NAL aCHB

TO X'OBo

READ ONLY

SAVE RETURN
ADDRESS

SET UP CCW LIST
TO POLL DEVICE

OPERAT ION

EXEC CHANNEL

1
~NITIALIZE

POINTER

1
EXCP
CPA

f---

SEND RESPONSE
TO TEXT

158

.
J

PROGRAM

EXCP

LOOP COUNTS

I
ESTABLISH
BASE REG FOR
DCHB

TESREPLY

SET UP ERROR

•
K

lOB

YES

GET UCB ADDRESS

•
J

INSERT IDLE
CHAR

PUT DCB ADDRESS
IN

1
SET RETURN CODE

TRANSLATE TEXT

GET DCB ADDRESS

TeAM

TRANSLATION
TABLE

MOVE DEB TO
PROTECTED CORE

ENTRY FROM

•

GET ADDRESS OF

ENTRY FROM

•

EBeD CHAR

SYSTEM ERP

Chart 36A

START-STOP REMOTE PRINT - 1030 (PART 2 OF 3)

•

YES

GET ADDRESSING

YES

•

CHAR

GET CCW TO SEND

IDLE CHAR

BUILD CCW TO

•

SEND ADDRESSING
CHAR

o
GET CCW TO SEND

TEXT

BUILD CCW TO
SEND A "1"
1033

•

BUILD CCW TO

GET CCW TO READ

SEND RE5PON=E

RESPONSE

TO TEXT

EXCP

•

ADDRESS DEVICE

•

EXCP

WR I TE RESPONSE

WR ITE TEXT

•

•
H

•

BUILD CCW LIST
TO POLL AND

READ TEXT

'EXCP

•

READ TEXT

•

Flowcharts

159

Chart 36B

START-STOP REMOTE PRINT - 1030 (PART 3 OF 3)

•

GET CCW TO SEND
EDT SEQ

..
EXCP
B

CLEAR ECB AND
CSW

SEND EDT'S

•
EXECUTE CHANNEL
PROGRAM

BU I LD PREPARE
CCW

•
BUILD CCW TO
READ TEXT

WAIT FOR I/O
COMPLETION

•
E

GET ADDR OF
TCAM
TRANSLATION
TABLE

•
F

DELETE CONTROL
CHAR

•
G

au I LD

TRANSLATE TEXT

POLL

ecw

DECREMENT ERROR
LOOP COUNT BY 1

•
H

MovE TEXT TO
TOTE' 5 INPUT
BUFFER

BUILD CCW TO

READ TEXT

•
J

RESTORE
REGISTERS

INITIALIZE CPA
POINTER

•

160

•

Chart Q37

START-STOP REMOTE PRINT - 2260 AND 2265 (PART 1 OF 2)

•

~
GET AND SAVE
TeAM DCB
ADDRESS

INITIALIZE CPA
TO SEND THREE
EDT'S

ADDRESS DEY I CE

I
GET ADDRESS OF
PR J NTER DCHB

PUT UCB ADDRESS
IN DEB

GET TEST TO BE

TRANSM I TTED

GET UC8 ADDRESS

SET FLAG

IN DEB

NOT TO USE
SYSTEM ERP

GET AODR OF
TeAM
TRANSLAT I ON

TABLE

BUILD CCW TO
ERASE/ WR I TE

PUT TeAM DUMMY
VECTOR TABLE
ADDRESS IN DEB

GET ADDR OF
TeAM
TRANSLA TJ ON

BUILD CCW TO
WRITE TEXT

I
MOVE OED TO
PROTECTED CORE

GET ADDRESS I NG

CHAR

BUILD CCW TO
READ RESPONSE

GET DCB ADDRESS

au I LD

CCW LIST

TO SEND
ADDRESS ING CHAR

EXCP

WRITE TEXT

TURN ON

PUT DCB ADDRESS

READ-ONLY FLAG

37 A

lOB

BUILD CCW TO

READ

I
G

!
SET RETURN CODE
TO X'08'

TABLE

RESPONSE

GET ADDRESS OF
H

CONTROL
TERMINAL aCHB

BUILD CCW LIST
TO POLL AND

READ TEXT

.
EXCP

READ TEXT

..
BUILD CCW TO

SEND RESPONSE

•

•
Flowcharts

161

Chart 37A

START-STOP REMOTE PRINT - 2260 AND 2265 (PART 2 OF 2)

•

~
A

GET TEXT TO BE
TRANSM I TTED

•
B

B
C4

•

BUILD CCW TO
SEND EOT SEQ

CLEAR ECB AND
CSW

TRANSLATE TEXT

EXCP

•

EXECUTE CHANNEL
PROGRAM

WRITE EOT SEQ

0
EXCP
WAIT FDR I/O
COMPLETION

BUILD CCW TO
ERASE SCREEN

•

WR I TE RESPONSE

•

GET ADDR OF
TCAM
TRANSLATION
TABLE

BUILD CCW TO
WRITE TEXT

•

DELETE CONTROL
CHAR

WRITE TEXT

•

TRANSLATE TEXT

DECREMENT COUNT
BY
BUILD CCW TO
READ TEXT

•

..
~

EXCP

•

RESTORE REG

INITIALIZE CPA
POINTER

READ TEXT

•
162

•

Chart Q38

START-STOP REMOTE PRINT - 2741 (PART 1 OF 3)

•

IN DEB

PUT ueB ADDRESS

.
SET FLAG IN DEB

GET ADDRESS OF
PR INTER QCHB

NOT TO USE

SYSTEM ERP

GET

uee

PUT TeAM DUMMY

ADDRESS

VECTOR TABLE
ADDRESS [N DEB

..
MOVE DEB TO

PROTECTED CORE

.
GET DCS ADDRESS

.
PUT DCB ADDRESS

TURN ON

READ-ONLY FLAG

108

.
GET AODR OF
H

CONTROL

TERMINAL aCHB

.
J

.
K

0r::

~ADDRE5S

Flowcharts

163

Chart 38A

START-STOP REMOTE PRINT - 274l (PART 2 OF 3)

r;;:l

BUILD TEST LINE

EOA.

TEXT.

CR/LF

BUILD MSG LINE

•

YES

'HIT

CARR I AGE RETURN

KEY'. CR/LF,

EDT

1
•

EXCP

DECREMENT LOOP
COUNT

WR I TE TEXT

SET LOOP COUNT

·1

•

r;;l

•

DECREMENT LOOP
COUNT

•

BU I LD TEST LI NE
-- EOA, TEST,

CRLF, EDT

-J

EXCP

•

WRITE TEXT

EXCP

READ TEXT

~
•

~
H5

164

Chart 38B

START-STOP REMOTE PRINT - 2741 (PART 3 OF 3)

~
~
AI

•
8

r;;]

SET LOOP COUNT

EXCP

•

READ TEXT

•

YES

~";

o
GET

SET LOOP COUNT

ADDRESS OF
TeAM
TRANSLAT I ON
TAL8E

DECREMENT LOOP

COUNT

EXCP

•

READ TEXT

TRANSLATE TEXT

..
F

(0
G

DELETE CONTROL
CHAR

CECREMENT LOOP
COUNT

r;;;]

MOVE TEXT TO
OL TCB

I
RESTORE
REGISTERS

PROGRAM

YES

.
J

WAIT FOR I/O
COMPlET ION

•

(

•

.
H

EXECUTE CHANNEL

•

RETURN

)

RETURN

•

Flowcharts

165

Section Two
Field Engineering Programming Service Aids

Introduction to Service Aids

The Service Aids Programs are an optional TCAM facility. They provide the Customer
Engineer and customer programming personnel with the ability to save portions or all of
the following TCAM tables and buffers:
• Sub task Control Block Trace Table
• Line I/O Trace Table
• Message Buffers (Main Storage and Secondary Storage)
These areas are stored, using programs from the Service Aids, on either tape or direct
access devices and may be edited and printed in a formatted form to be used as a debug
tool.
Service Aids Flow

Operator
Control

DEBUG =

SERVICE
AID
ROUTER

INIT OPERATION
STCB TRACE DUMP
I
I

-"'

:
I/o TRACE

DISPATCHER

LINE

DUMP

I
I
I

BUFFER DUMP

-"'

I/o TRACE

STARTMH

II
l

IEDQAA

IEDQFW

O------------ -Processing

__ --

COMWRITE

'I'lp..~---

Introduction to Service Aids

169

IEDQFE10 Subtask Control Block Trace Table Dump Flow
IEDQC6
Operator Control
Modify DEBUG =

FEROUTER
Check COMWRITE
active (AVTQWFL2)
Get Module Name
Check if already
active (CDE CHAIN)
Load routine
BALR 14,15

SUBTASK DUMP

Set up module is
loaded OP cn msg
Handle OP cn
Msgs

RETURN to OP

Chk for load
or Delete

SET flag in
AVTAFE10
BR 14

POST MCP EDB
IGG019RO

WRITE

_._OS

Set up table
ident

DISPATCHER

RETURN

Dispatch RCB
WRitE table entry

Chk for table
filled

TEST IEDQFEIO
active (AVTAFE10)

build COMWRITE
RCB

BR to routine
1. Dispent
2. Bypass

bui Id data area
parm for COMWRITE
Issue SVC 102
to POST ECB

POST COMWRITE
ECB Complete
VIA SVC 102

BR 14

WAIT on MCP ECB

~"-.OS

_ _~

COMWRITE
Get Blocksize
WRITE Record
WAIT on

I/o done

WAIT on ECB

TCAM

170

D~SPATCHER

r.t---~

OS . . . . . . . .

IEDQFE20 I/O Trace Dump Flow

IEDQC6
Operator
Control

LINK

IEDQFE20
LINE I/O TRC DMP

FEROUTER

Modify
DEBUG =

Finish
msg handle

Chk COMWRITE
active (AVTCWFL2)

Chk for load
or delete

Get module name

Set AVTAFE20
EP = SET

Chk if active
(CDE CHAIN)

BR 14

load routine

Split Trace Table

BALR 14,15

I/O OP INST
to fall through

First Time Only

Set OP cn msg
"RTN LOADED"

Get COMWRITE ECB

BR 14

POST ECB

Succeeding Entries

BR
POST MCP
WAIT
IGG019

lOS

MCP
Dispatch RCB's

LINE

Handle

i/o TRACE

interrupt

WRITE table

Process rns9
EOT (CE, DE)
EOT on last
BUFFER

Test end of
table

LINE END
APPENDAGE BR

Test AVTAFE20

AVTREADYen'lpty

BALR 14,15
OS

BR lOS

~"oo~
COMWRITE

Introduction to Service Aids

171

IEDQFE30 Buffer

Tra~e

Dump Flow
IEDQC6

Operator
Control
Modify
DEBUG=

FEROUTER
Process Command
Load routi ne

LINK

BALR 14, 15
Get Op Ctl RTN
RETURN

IEDQFE30
BFRDUMP
Chk for load
or delete
Set AVTAFE30
EP = ENTRY

MCP
DISPATCHER
• Process RCB
IEDQAA
STARTMH
Test AVTAFE30
BR
Handle buffer

BR
Line being traced
Move 96 bytes into
buffer
5 full buffers
Build COMWRITE RCB
Build data parm list
TPOST COMWRITE ECB
VIA SVC 102

COMWRITE
BR

AVTREADYempty
WAIT MCP ECB
OS

172

Module Descriptions

DEBUG Service Aid Router
(Charts aC6 and C62)

Module Name

IEDQC6

Entry Point

IEDQC6-activated by the Operator Control Module (lGCOIIOD) to process operator
control commands that request a service aid processing function. The command that
caused this routine to be activated is as follows:

~ontrol Chars] fMO~IFY
Functions

ident, DEBUG = data

The purpose of this module is to process operator control commands that request the
handling of service aid modules. If the operator control command is valid, the DEBUG
Service Aid Router returns a response message after executing the initialization or deactivation section of the service aid routine that was either loaded or is to be deleted.
The DEBUG Service Aid Router determines whether the COM WRITE routine is present
in the system. IfCOMWRITE is not in the system or if a restart is in process, the Router
generates a message (lED I 071) and returns control to the calling routine. If COMWRITE
is in the system and a restart is not in process, the Router uses the Scan Function of
operator control to obtain the first DEBUG operand. If this is not a load or delete request, the Router generates a message (lED 1071) and returns to the calling routine. If the
operand is a load or delete request, the Router again uses the Scan Function of operator
control to obtain the second DEBUG operand. This operand is checked to see if it is a
valid name and executes the requested function. This is done by checking the first six
characters of the second DEBUG operand for IEDQFE. If the operand is not a valid
name, the Router generates an error message (lED 1071) and returns to the calling routine.
When the operator control command requests that a service aid routine be loaded, the
DEBUG Service Aid Router checks the load list to determine the current status of the
requested service aid routine; that is, whether the routine is active or inactive in the
system. If the routine is already active, the DEBUG Service Aid Router returns control
to the calling routine with a response message (lED 1031). If the requested routine is
not currently active, a BLDL is performed on LINKLIB and JOB/STEP LIBS to determine
if the service aid exits; if not, message IEDI021 is issued. The DEBUG Service Aid Router
then issues a GETMAIN to determine whether there is enough main storage to load the
routine. If main storage is not available, the Router tests to determine how much more
storage is needed to load the requested routine and prepares a message to inform the
operator of the problem. If main storage is available, the Router loads and gives control
to the service aid routine. Upon return from the service aid routine, the DEBUG Service
Aid Router checks the return code. If the code indicates good initialization of the service
aid, the Router returns control to the calling routine with an appropriate response message
(IED0991). If the return code indicates an unsuccessful load, the DEBUG Service Aid
Router prepares a message (IEDl05I or IEDI06I), deletes the service aid, and passes
control to the calling routine.
When the operator control command requests the deletion of a service aid routine, again
the DEBUG Service Aid Router checks the load list for the status of the service aid. If
that routine is active in the system, the DEBUG Service Aid Router passes control to the
service aid routine. Upon return, the DEBUG Service Aid Router checks the return code;
if the code is good, the Router prepares a deactivation message (lED 1001), deletes the
Module Descriptions

173

service aid routine, and passes control to the calling routine. If the load list shows that
the service aid routine is not active, the DEBUG Service Aid Router prepares a message
(IEDIC4I) and returns control to the calling routine.
External Routines

IGCOO100-0perator Control control module-The Operator Control Scan subroutine, to
serially search the input command for the requested FE Service Aid to cause activation or
deactivation.

Tables/Work Areas

AVT, Operator Control AVT, work areas that contain the fixed portion of each response
message and space for insertion of the variable data.

Attributes

problem program mode

Exits

Normal-To IGC0110D (Operator Control) with a good message
Error-To IGC0110D with an error message

Subtask Control Block Trace
Dump

Module Name

IEDQFE10

Entry Points

IEDQFE1O-To initialize a Load operation or to deactivate the routine if a Delete operation is requested
DISPENT -From Dispatcher to complete initialization
BYPASS-From Dispatcher to write current trace table

Functions

This module writes the STCB trace table to a sequential data set using the COMWRITE
routine (IEDQFW). At entry from IEDQC6, a test is made to determine whether this is
a Load or Delete request.
On a Load operation, if at least four entries are not found in the trace table, an error
mcssagc{IEDI101) is prepared -a~is returned to the calling- rcutiRe.-lf thereis no trace table in the system, an error message (lED 1111) is prepared and control is
returned to the calling routine. The flags at AVTAFE 10 are tested for X'FF'. If these
flags are already set, return is to the calling routine with a return code of four. After the
above tests are completed successfully, the Subtask Control Block Trace Dump routine
divides the trace table in half, with separate current pointers to the first and last entries
in each half, stores its entry point address in AVT AFE 10 and turns the flags on to indicate that the routine is active. The routine then returns to the calling routine with a
return code of zero.
If a delete function is requested, the flags in AVT AFE 10 are turned off to indicate that
the routine is not active, and the trace table pointers are restored to their original condition and control is passed to the calling routine.
The Sub task Control Block Dump routine is entered from the Dispatcher at DISPENT, at
which time the two trace tables are set up with identifying headers. All subsequent entries
to this routine from the Dispatcher will be at BYPASS where a count of the number of
tables filled is updated. A test is made to determine if the previous table has been written.
If not, return is made to the Dispatcher and the current table will be used again. A test is
then made to determine if the parameter pointers in the AVT are free. If one is found
available, header information is completed at the beginning of the current table. The
parameter list for COMWRITE is completed to print the current table and control is
returned to the Dispatcher. When no parameters are available, control is passed to the
Dispatcher, and the current table is reused.

174

External Routines

SVC 102

Tables/Work Areas

Parameter list used by COM WRITE (IEDQFW); parameter list used by AQCTL (SVC 102);
dsects of the AVT.

Exits

(For entry at IEDQFElO)
Normal-Return to the calling routine with a return code of zero.
Error-Return to the calling routine with a return code of four and an error message
(lED 1101) indicating that there were less than four entries in the trace table or
(lED 1111) indicating that there was no trace table.
For entry at DISPENT or BYPASS return to the Dispatcher.

Line I/O Trace Table
Module Name

IEDQFE20

Entry Points

IEDQFE20 from IEDQC6
SET from IGG0190

Functions

IEDQFE20 is used to write the TCAM Line I/O trace table onto a sequential data set using
the COMWRITE routine.
At entry from IEDQC6, this routine checks to determine if a Load or Delete function is
requested and checks the flags in AVT AFE20. If a load is requested and the flags are off,
this routine stores its entry point address in AVT AFE20 and turns the flags on to indicate
that the routine is active. The routine then returns to IEDQC6 with a return code of zero.
If the flags are already on, the return code is four. If a delete function is requested, the
flags in AVTAFE20 are turned off to indicate that the routine is not active.
Module IGGO 19QO tests the flags at AVT AFE20 each time the I/O trace table is half-full
and full. If the flags are on, IGG019QO branches to this routine. On entry from
IGGO 19QO, registers are saved, a block count is updated and stored in the third and
fourth bytes of the first entry in the I/O trace table, and the Comwrite flags are tested
to determine if COMWRITE has written the table for any previous request. If the
previous request has not been satisfied, the current table is reused and control is returned
to the calling routine. The ID characters I and 0 are put into bytes two and ten, respectively, of the first entry of the trace table. The parameter list is set to point to the
proper half of the table, and the Comwrite ECB is posted via SVC 102 to write the table
to the COMWRITE data set. The routine then returns to the calling routine.

External Routines

Supervisor branch to post Comwrite ECB

Tables/Work Areas

I/O trace table

Exits

Normal-Go to IEDQC6 with zero in register 15.
Error--Go to IEDQC6 with four in register 15.

Attributes

serially reusable

Buffer Dump
Module Name

IEDQFE30

Entry Points

ENTER-from IEDQC6 for initialization
ENTRY-from IEDQAA
Module Descriptions

175

Functions

IEDQFE30 is used to accumulate buffer information for a line being traced by the line
I/O trace facility (IEDQFE20) and to print the buffers and selected status information to
a sequential tape or disk data set using the COMWRITE facility (IEDQFW).
On entry from IEDQC6, this routine checks to determine if this is a Load or Delete request. If it is a load, the flags at AVTAFE30 are tested; if they are off, this routine stored
its entry point address in AVTAFE30 and turns the flags on to indicate that the routine
is active. The routine then returns to IEDQC6 with a return code of zero. If the flags are
already on, return is to IEDQC6 with a return code of four. If the request is for a delete,
the flags in AVT AFE30 are turned off to indicate that the routine is not active.
Each time module IEDQAA is entered, the flags at AVTAFE30 are tested. If they are on
a branch is taken to this routine. On entry from IEDQAA, the LCB and SCB are found.
A test is made on LCBTRACE to determine if the line is being traced. If the line is not
being traced, appropriate data is moved into the internal trace table and return is made to
IEDQAA. When five buffers have been collected in the internal trace table, the Comwrite
ECB is posted via and SVC 102 to have the table written to the COMWRITE data set.

External Routines

branch to entry of POST

Tables/Work Areas

Buffer trace table

o
Buffer address

4
Error bits in SCB

8
Last half of CSW
12

Sense
b ......
-"
......

Flag 1

Flag 3

<>flO!!

el~OB

status of LCB

Exits

Buffer prefix and part
of buffer

At entry point ENTER
Normal-R15=0
Error-R15=4
At entry point ENTRY
Return to IEDQAA

Attributes
176

serially reusable

Status of
!;~1!;'" lCB

UCB (Channel
unit address)

Common Write Routine

Module Name

IEDQFW

Entry Points

IEDQFW

Functions

COMWRITE is designed to write data to the COMWRITE data set. This output may be
any combination of entries from the STCB trace table, the I/O interrupt trace table. and
buffer and status information.
On entry a DEVTYPE macro is issued to obtain the maximum block size for the output
device. The output DCB is opened and tested for a successful open. Comwrite flags in
the AVT are initialized and the DECBs are marked as inactive. COMWRITE then goes
into a wait state to await the posting of either of the two ECBs in COMWRITE.
When an ECB is posted, the parameter list is checked to determine if it is on the required
fullword boundary. If it is not, a message (IEDI16I) is written to the COMWRITE data
set. If the boundary alignment is correct, a flag in the parameter list is tested for closedown. If close is requested, COMWRITE closes; if not, a test is made to determine if the
data to be written will exceed the maximum block size of the device. If the block size
is too large, message (lED 1151) is written to the COMWRITE data set. A test is then
made to determine whether the block to be written will exceed main storage. If true, a
message (lED 1151) is written to the COMWRITE data set. If all the tests meet requirements, the record is written and COMWRITE issues a WAIT for either ECB.
A further test is made to see if the record provided has a prefix space reserved for a time
stamp. This is indicated by a flag being off in the parameter list. If a prefix does exit,
the record will be time stamped, and a timer interval will be set for 15 seconds. If another
record is written before the IS-second interval, the time-stamp area will be cleared to
binary zeros.

External Routines

None

Tables/Work Areas

Parameter list

o
4

Address of Data
Test
and Set

Flags

Record Count

Parameter ID

Bytes 0-3
4-7

address of data to be logged
test and set flags for use of caller
Bit 0
Bit 1

Bit 2
Bit 3

1=terminate COMWRITE after specified record count has expired
1=parmlist complete (set by COMWRITE when parmlist functions
are completed)
O=parmlist in use by COMWRITE
1=request immediate termination of COMWRITE
l=output data is mandatory. If data cannot be written as specified,
terminate COMWRITE with a S044 ABEND with a return code of
three in register 3.
O=output data not mandatory. If data cannot be written as specified,
write error message in output.
Module Descriptions

177

Bytes 6-7

must be between 18 and 32,760 decimal and must not exceed the maximum
block size of the output device.

AVT
AVTCWFL2
Bit 0
I=COMWRITE active (set by COMWRITE)
Bit 1-5 Not used
Bit 6
O=reuse of same volume allowed
l=reuse of same volume not allowed (invokes volume switching,
which requires operator intervention)
Bit 7
1=COMWRITE closedown requested by user in parmlist or TCAM
clo,sedown (set by COMWRITE)
Exits

Normal-SVC-invoked by TCAM closed own or requested by user in parameter list
Error-System ABEND 044 with register 3 containing a code indicating the reason for
the abend
Register 3 = 1 permanent I/O error on output device. Message IEDl131 also sent.
Register 7 contains user ID; register 8 contains address of failing DECB.
2 STAE routine failed. Register 15 contains the return code.
3 user parameter list incorrect and output required was specified in
parmflag. Register 7 contains address of parameter list saved in
COMWRITE. Register 11 contains address of error message.
4 DEVTYPE SVC failed. Register 15 contains the return code.
5 open failed on the output DCB
Messages returned are:
IEDl121
IEDl131
lED 1141
IEDl151
IEDl161
IEDl171

Attributes

resident, problem program mode

TeAM Trace Format Routine

Module Name

IEDQXB

Entry Points

IEDQXB

Functions

IEDQXB runs as'a job step in the batch environment of System/36D Operating System
as a utility program independent of TCAM. The purpose of the IEDQXB routine is to
format the output of the COMWRITE routine. If the output is residing on magnetic
tape, this routine optionally searches the tape by time and date to reduce the amount of
output. The BLOCK keyword in the PARM field of the EXEC statement specifies the
location where the search is to begin. The format of the PARM field is as follows:
PARM = '(OPTIONS),
where the options available are:

178

STCB

provides a formatted printout of the control blocks

10TR

provides a formatted printout of the 1/0 trace entries

BUFF

provides a hexadecimal and EBCDIC formatted printout of buffers and any
trace records other than STCB and I/O, found in the trace data set.

[PEFAULl]

The default will format all blocks and provide an hex dump of
unknown records

BLOCK=HHMMDDD

defines the starting point for the formatting action. A search
will be initiated on the trace data set, until a date and time
higher than the one specified are found. This keyword is
valid only for a tape data set.
Where: HH-hour of day in continental time
MM-minutes of the hour in one minute intervals
DDD-day of the year in Julian days

LINECNT=XX

specifies the number of lines per page to be printed. The default
is 60.

The parameters may be coded in any order and as often as desired. If keyword parameters
are specified more than once, only the last duplicate parameter will be honored. If a
parameter is coded incorrectly, the entire parameter list will be printed on the SYSPRINT
data set and the location of the parm scan pointer will be shown, indicating the approximate location of the erroneous parameter.
If the unit is a tape device, the routine checks the PARM field in an EXEC statement for
correct format. If no PARM field exists, the routine begins the edit operation at the first
record. If a valid PARM field is specified, the routine searches for the record pOinted to by
the P ARM field. When the required record is found, the record is examined for the characters 10TR, STCB, and BUFF (this also determines whether the record has a time stamp
area). If a time stamp area exists, it is tested for non zero. A non zero value is unpacked
and moved to the current time area. By use of a branch table, the proper formatting
routine is entered.
External Routines

None

Tables/Work Areas

A VT expanded from T AVTD macro
DSECT of input record

Exits

Normal-EOF
Error-Return to calling routine with a console and/or SYSPRINT error message.

Attributes

serially reusable, problem program mode

TeAM Message Queue Print
Routine

Module Name

IEDQXC

Entry Points

IEDQXC

Functions

IEDQXC runs as a job step in the batch environment of OS/360 as a utility program
independent of TCAM. The message queue data set can be directed to a printer, tape,
or disk for later printing.
On entry, the PARM field of the EXEC statement is checked for validity and for the type
of output desired. The options available are:
Q=DMP

dump messages sequentially
Module Descriptions

179

xxx, DMP

where xxx is the number of logical queues on the message queues
data set

xxx, ALL

list number of queues specified in xxx

xxx, AAA, BBB, CCC, DDD, EEE
series of three-digit queue numbers, up to 5, separated by commas.
Omission of the PARM field on the EXEC card will result in a default to PARM=Q=DMP.
The type of device the queue resides on is determined and the data set is opened. The
output data set is opened and a header line is written denoting the meaning of the special
characters. The proper queue is determined and the next header line is written.
After the record is read, the prefix is checked and formatted before printing. The program
uses the header prefix to chain each message so that the message will be printed in its
proper sequence, even though it may extend over more than one volume. This is not done
if the default is taken or PARM=Q=DMP is coded.
External Routines

None

Tables/Work Areas

Header prefix expanded from TPRFD macro.

Exits

Normal-at completion of processing parameters
Error-return to calling routine with message sent to console indicating reason for
termination.

Attributes

serially reusable

180

Diagnostic Aids
The following chapter contains a table of register usage by module, a record prefix example,
and messages generated by the Field Engineering Service Aids.

Table of Register Usage by Module
Module
Name

IEDQC6

Entry
Point

IEDQC6

I,W,
Register

or 0*

1
2

0
1-0
W

4
5
6
7
8
9
10

11
12
13

W
W
W

W
W

14
15
IEDQFElO

IEDQFEI0

0
1

2
3

W
I
W

4
5
6
7
8
9
10
11

12
13

W
W
W
W
W
I

14
15

1-0

Use

Function Register
Parameter Pointer
Operator Control
AVT Base Register
Input Base
AVT Base Register
Work Register
Local Return Register
Work Register
Index Register
Not Used
Not Used
Not Used
Base Register
Save Area Pointer
Return Register
Entry Point Register
Function Register
Parameter Pointer
AVT Base Register
Work Register
Address of AVT
Address of Trace Table Pointers
Not Used
Work Register
Work Register
Work Register
Entry Point from IGG019RO
Not Used
Base Register
Save Area Pointer
Return Register
Return Code Register
Entry Point Register

*Input, Work, or Output Register
Diagnostic Aids

181

Module
Name

Entry
Point

IEDQFE20

0
2
3
4
5
6
7
8
9
10
11
12
13
14
15

IEDQFE30

0
2
3
4
5
6
7
8
9
10
11
12
13
14
15

182

I,W,
orO

W
W

W
W
W
W
W
W
I
I
1-0

I
I
W
W
W
W
W
W
W

W
I
1-0

Use

Function Register
Not Used
Trace Table Count
Table Pointer
Not Used
Not Used
I/O Trace Pointer
Work Register
Not Used
Internal Base Register
Work Register/Parm Post
Address of AVT
Base Register
Save Area Pointer
Return Register
Entry Point Register
Return Code Register
Function Register
Buffer Pointer
Trace Table Ctr/Base Register
Int. Base Reg/ Addr of SCB
AVT Addr/Addr ofLCB
Addr of Current Trace Entry
Buffer Address Register
Work Register
Work Register
Not Used
Pointer to IEDQAA
Not Used
Base Register
Save Area Pointer
Return Register
Entry Point Register
Return Code Register

Module
Name
IEDQFW

Entry
Point
IEDQFW

0
1

W
I-W

2
3
4
5

W
W
W
W
W
W

6
7
8
9
10
11

12
13
14
15
IEDQXB

IEDQXB

0
1
2
3
4
5
6
7
8
9
10

11
12
13
14
15
IEDQXC

IEDQXC

I,W,
or 0

0
2
3
4
5
6
7
8
9

10
11

12
13
14
15

W
W
W
W

I-W

Use
Parm Reg/STAE Work Reg
AVT Register
Work Register
Work Register
CVT Register
AVT Register
Base Register
Internal Return Register
Index Register
ECB Register
DECB Pointer
Not Used
Parameter Register
Area Address Register
Length Register
Save Area Register
Return Register
Return Code Register

W
I-W
W
W
W
W
W
W
W
W
W
W
W

Work Register
Parm Reg/Work Reg
Pointer to Field
Record Length Register
Work Register
Work Register
Index Register
Current Record Register
Work Register
Work Register
Work Register
Secondary Base Register
Base Register
Save Area Pointer
Return Register
Entry Point Register

W
I-W
W
W
W
W
W
W
W
W
W
W
W
I-W
I-W
I-W

Work Register
Parm Reg/Work Reg
Work Register
Work Register
Internal Return Register
Base Register
Data Block Pointer
Absolute Record Number Register
Base Register for Buffer Prefix
Record and Track Number
Cylinder Number
Work Register
Work Register
Save Area Pointer
Return Register
Entry Point Register

Diagnostic Aids

183

Table of Message Origins and Codes for TCAM Serviceability Aids

Message

I
IEDIOll
IEDlO21
IEDlO31
IEDI041
IEDlO51
IEDlO71
IEDlO91
IEDlIOI
IEDllll
IEDl121
IEDl131

IEDl181
IEDl191

RESTART IN PROGRESS
INVALID OPERAND
ROUTINE ALREADY ACTIVE
ROUTINE NOT ACTIVE
RETURN CODE - xx
COMWRITE NOT ACTIVE
ROUTINE NOT DELETED
LESS THAN 4 ENTRIES
NO TRACE TABLE
TCAM REQUESTED COMWRITE CLOSEDOWN
I/O ERROR, addr, statsens, record
type COMWRITE CLOSING
Sxxx ABEND COMWRITE CLOSING
userid DATA AREA EXCEEDS CORE
userid PARMLIST NOT ON FULLWORD
BOUNDARY
tablename BLKSIZE EXCEEDS DEVICE
SPECS
PERMANENT I/O ERROR ON TRACE UNIT
UNABLE TO OPEN ddname

IEDl201
IEDl211
IEDl221
IEDl231

'BLOCKS' PARM REQUIRES TAPE INPUT
REQUESTED TIME NOT FOUND
INVALID MESSAGE CHAIN
INVALID PARAMETERS

IEDl241
IEDl251
IED0991
IEDIOOI

QUEUE HAS BEEN WRAPPED
xxxx BYTES NEEDED
ROUTINE LOADED
ROUTINE DEACTIVATED

IEDl141
IEDl151
IEDl161
IEDl171

IEDQC6
IEDQC6
IEDQC6
IEDQC6
IEDQC6
IEDQC6
IEDQC6
IEDQFEIO
IEDQFW
IEDQFW

IEDQXB
IEDQXB
IEDQXC
IEDQXB
IEDQXB
IEDQXB
IEDQXB
IEDQXC
IEDQXC
IEDQC6
IEDQC6
IEDQC6

entry count

IOTR

Ixxxxxxxx
4

Lentry count
1

4
4

184

jJr---buff identifer (X'Fl' or X'F2')

110 Ixxxxxx

BUFF

~entry

BUFF
count

X
X
X
X
X
X
X
X
X

1
I

IOTR

X
X
X
X
X
X
X
X
X
X
X

X
X

IEDQFW

STCB

IxxlAAAAAA
4

I I
2 3 4 5 6 7 8 9 0 I

X
X
X

r a v t address

STCB

X
X
X

TIME STAMP
DATE

2 3 4 5 6 7

IEDQFW
IEDQFW
IEDQFW

Record Prefix

TIME

Routing Codes

Descriptor
Codes

Issued
by

X
X

X
X
X
X

X
X
X

Messages

This section contains messages issued by modules in the service aids portion of TCAM. For
a more complete listing of the message meanings, refer to IBM System/360 Operating
System: Messages and Codes, GC28-6631.

IED0991

ROUTINE LOADED
Explanation: The routine called by the DEBUG operator command has been loaded and
initialized.

IED1001

ROUTINE DEACTIVATED
Explanation: The routine designated in the DEBUG operator command has been deactivated and deleted.

IED10l1

RESTART IN PROGRESS
Explanation: The requested operation can not be processed because TCAM is being restarted by either a checkpoint warm or cold restart.

IED1021

INVALID OPERAND
Explanation: The DEBUG operator command is incorrect as entered and was not processed. It is unacceptable for one or both of the following reasons:

1. A value other than 'L' or 'D' was specified as the DEBUG parameter, or
2. The routine name specified is not valid for the DEBUG command.
A. First six characters were not IEDQFE.
B. Name was not found in LINKLIB or TAB/STEP LIB.
IED1031

ROUTINE ALREADY ACTIVE
Explanation: A request was made to activate a serviceability aid routine which is already
active in the system.

IED1041

ROUTINE NOT ACTIVE
Explanation: A request was made to deactivate a serviceability aid routine which is not
active in the system.

IED1051

RETURN CODE = xx
Explanation: A user-written routine has probably encountered an exceptional condition.
This condition is noted by the routine passing a return code to the COMWRITE task.

IED1061

MULTIPLE REQUEST
Explanation: The service aid returned a code of four. The AVT flag was already set.

Diagnostic Aids

185

IED1071

COMWRITE NOT ACTIVE
Explanation: A request was made to activate a serviceability aid which requires the
COMWRITE routine when it is not active in the system (COMWRITE=YES was not
specified at INTRO time).

IED1091

ROUTINE NOT DELETED
Explanation: A request was made to deactivate a serviceability aid and the SVC 9 (delete)
function failed.

IEDll01

LESS THAN 4 ENTRIES
Explanation: An attempt was made to activate the STCB trace, but there are less than
4 STCB trace entry slots in the STCB trace table.

IEDll11

NO TRACE TABLE
Explanation: An attempt was made to activate the STCB trace, but there is no STCB
trace table.

IEDll21

TCAM REQUESTED COMWRITE CLOSEDOWN
Explanation: TCAM is in a closedown status and is closing the Comwrite sub task.

IEDll31

I/O ERROR, addr, statsens, recordtype, COMWRITE CLOSING
Explanation: A permanent error has been detected on the indicated device. This will
also result in the Comwrite task abending with a system code of 004.
ad dr-hardware line address
statsens-CSW sense and status bytes
recordtype-type of record being written when the I/O error occurred
-BUFFER, IOTR, STCB-

IEDll41

Sxxx ABEND, COMWRITE CLOSING
Explanation: The Comwrite task has abended with the code indicated by xxx.

IEDl151

userid DATA AREA EXCEEDS CORE
Explanation: Probable program error in service aid using COMWRITE.

IEDl161

userid PARMLIST NOT ON FULLWORD BOUNDARY
Explanation: Probable program error in service aid using COMWRITE.

IEDl171

tablename BLKSIZE EXCEEDS DEVICE SPECS
Explanation: A parameter list passed to the Comwrite task describes a block of data
whose length exceeds the maximum that the device containing the Comwrite data sets
can handle.

IEDl181

PERMANENT I/O ERROR ON TRACE UNIT
Explanation: A permanent I/O error has occurred while reading the SYSUTl data set.

186

IEDl191

UNABLE TO OPEN ddname
Explanation: The system was unable to open the data set ddname.

IED1201

BLOCK=PARM REQUIRES TAPE INPUT
Explanation: The BLOCK keyword parameter was specified in the EXEC card for the
IEDQXB routine, but the SYSUTl DD card specified a direct access device.

IED1211

REQUESTED TIME NOT FOUND
Explanation: The time specified in the BLOCK=parameter was not found on the tape
data set described by the SYSUTI DD card. Two conditions may cause this error.

1. There were no STCBs on the trace data set.
2. The time specified i~ later than the latest time recorded in the trace data set. No
printout is provided.
IED1221

INVALID MESSAGE CHAIN
Explanation: The chaining sequence of the message queues data sets has been found to be
invalid.

IED1231

INVALID PARAMETERS
Explanation: While scanning the EXEC card parameters an error has been detected. If
the IEDQXB utility program is being used, the error is noted on the SYSPRINT data
set.

IED1241

QUEUE HAS BEEN WRAPPED
Explanation: The message queue data set has been wrapped. Formatting is unreliable.
The IEDQXC utility program will terminate.

IED1251

xxx BYTES NEEDED
Explanation: Insufficient main storage exists to load the requested service aid.

Diagnostic Aids

187

Chart QC6 DEBUG SERVICE AID ROUTER

•

Z2,F"2

•

.
c

•

.
SET UP
'CO"WR ITE NOT
ACTIVE' MESSAGE

.
E

GET THE F" IRST
OPERANO

•

.
G

LOAO RETREG
WITH THE
AOORESS OF" THE
OELETE ENTRY
POINT

LOAD RETREG
WI TH THE
ADORE 5S OF" THE
LOAO ENTRY
POINT

•
H

GET THE SECOND
OPERAND

..
YES

LOAO REGISTER
15 WITH THE
ENTRY POINT
ADORESS

BRANCH TO THE
AODRESS IN
RETREG

•
K

LOAD A ZERO IN
REGISTER 15

•

BRANCH TO THE
AOORESS IN
RETREG'4

•

•
Flowcharts

189

Chart C62

DEBUG SERVICE AID ROUTER

•

SET UP 'ROUTINE
ALREADY ACTIVE'
MESSAGE

SET REGISTER 0
TO A POSITIVE
VALUE

SET UP 'ROUT I NE
NOT ACTIVE'
MESSAGE

•

•
BALR TO THE
SERVICE AIO
ROUTINE

•

•
SET UP THE
'RETURN CODE •
XXX' MESSAGE

•
E

•
LOAD - THE
ROUTINE

DELETE THE ROUTINE

SET UP THE
'MULTIPLE
REQUEST'
MESSAGE

MOVE IN THE
USER MESSAGE

•
F

•
SET UP THE
'ROUTINE NOT
DELETED'
MESSAGE

SET REGISTER
TO ZERO

•
G

•
BALR TO THE
SERVICE AIO
ROUTINE

•

•
SET UP THE
ADDRESS OF THE
MESSAGE IN
REGISTER I

•
~

•
SET UP 'ROUTINE
LOADED' MESSAGE

•

•
K

•
190

•

Chart E I 0

SUBT ASK CONTROL BLOCK TRACE DUMP

•

•
B

•

•
UPDATE POINTERS
TO USE TABLE
AGAIN

RESET LOADED
FLAG

YES

•

•
MOVE IN OLD
TRACE PO INTERS

•

•
POINT PARM2 TO
PARM AREA

SET UP PARM FOR

AQCTL

(SVC)

•

•
F

POINT PARMI TO
PARM AREA

DIVIDE TABLE

GET TIME AND
DATE

•
STORE LENGTH
G

POST CQMWR I TE
ECB

UPDATE CURRENT
POINTERS

PARM LI ST FOR
COMWRITE

•

•
FIRST

SAVE NEW ENTRY
PO I NT FROM THE
01 SPATCHER

SET UP FIRST

AND LAST PTRS

FOR EACH TABLE

•

•
SET LOADED FLAG
J

MOVE IN
POINTERS TO USE
FIRST TABLE

COMPLETE HEADER
ENTRIES

IN AVT

MOVE

POINTERS TO USE

SECOND TABLE

•

•
K

SET UP HEADER
ENTRY IN EACH
TABLE

Flowcharts

191

Chart E20

LINE I/O TRACE DUMP

"':f5
SET

•

FIND MIDDLE OF

gS~~fT~U~~~M

LI ST

•

LOAD CURRENT
PARMS WITH HALF

REUSE CURRENT
HALF OF TABLE

HltN6ROt~X~E

•

MOVE IN COUNT

AND 10
CHARACTERS

•

POST COMWR ITE

ECB

•
G

(

RETURN

)

•

•
192

•

Chart E30

BUFFER DUMP

ENT~

'/'

.
IEOQAA WILL NOW

YES

BRANCH TO TH I 5

ENTRY EACH TIME
IT GETS CONTROL

PLACE TRACE
TABLE DUMP RTN
AOOR IN AVT,

SET LOADED FLAG

SET RETURN CODE
X'04'

.
MOVE
INFORMATION
INTO TRACE AREA

•
SET CQMWR I TE

PARMS TO POINT
TO AREA

.
SVC

102

•

.
(

RETURN

)

.
H

•

•
K

Flowcharts

193

Chart FWl

COMMON WRITE ROUTINE (PART 1 OF 3)

•

..
YES

..
INSERT BLKSIZE,

ISSUE STAE

YES

~C~~St g~~N

SET RETURN

FW3
BI

REGI STER TO
AOOR OF NEXT
INSTRUCTION

FWI
F2
SET AVT CWFL2

SET RETURN
REGISTER TO
ADDRESS OF NEXT
INSTRUCTION

c*~~~~~t ~6t

ACTIVE

FWI
G5

ONE

NEITHER

.
G

FW2
A3

PUT ACTI VE OECB

AND ALT AVTCWE:C

PUT AVTC WEC I

PUT tN WAITLIST

IN WAlTLiST

AND AVTCWEC2

FWI
H5

WTO 'I/O ERROR
MESSAGE'

WAITL! ST

..
SET UP FOR
ABEND

YES

.
FW3
BI

ISSUE SINGLE
WA I T ON
WA I TLI ST

(

ISSUE

ABEND)

.
194

Chart FW2

COMMON WRITE ROUTINE (PART 2 OF 3)

•

5v
,'[

•

RESET ACTIVE
DECB

•

CLEAR AVTCWEC

•

SET IN ERROR

MESSAGE

•

•
SET PARMFLAG
NOT COMPLETE

YES

•

•
YES

SET IN ERROR
MESSAGE

•

•
F

•

ABEND

SET IN ERROR

SET RETURN
REG I STER TO
ADOR OF CLOSE

I F ERROR

NOTE

FW2
HI

MESSAGE

•

ISSUE A WR1TE

•

•
RESET DCB AND

~
H5

SET DEC8 ACT I vE

108 ERROR FLAGS

•

•
P
SET PARMFLAG

COMPLETE. CLEAR
DECB EC8. RESET
DECB ACTIVE

YES

•

~
CI

NOTE

I: CLOSE

FW3.01

IS LOCATED AT CHART

Flowcharts

195

Chart FW3

COMMON WRITE ROUTINE (PART 3 OF 3)

•

WTO TCAM
REQUEST
COMWRITE
CLOSEDOWN

•

•
C

•

SET AVTCWFL2 TO
CLOSEDOWN
REQUESTED

•
NOTE: ENTRY TO CLOSE MAY BE FROM FW2 I F2

RESET ERROR
FLAGS

•
NO

•

•
C

GO SERVICE DECB
AND RETURN

CLOSE OUTPUT
OCB

•
NO

•

~
H5

SET ECB BUSY

AND I NO I CATE

SERVICE AIDS

INACTIVE

•

III

196

III

Chart QXB

TCAM TRACE FORMAT ROUTINE

•

WR ITE MESSAGE
JEOJ2J J

•

•
C

OPEN INPUT
OPEN OUTPUT

.
SET UP FORMAT
AND PR I NT

•
BUFF

•

SET DEFAULT
PARAMETERS

•

IOTR

WRITE MESSAGES

•

(

I
RETURN

)
.

•
SET UP FORMAT
AND PRINT

.
Flowcharts

197

Chart XCI

TCAM MESSAGE QUEUE PRINT (PAGE I OF 2)

•

.
B

•

INITIALIZE
ROUTINE OPEN
DCB

•

YES
B

.
C

•
PUT

FI ND NEXT QUEUE
TO BE PRINTEO

WRITE FIRST
HEADER

•
F'MTDATA

FORMAT AND
WR I TE RECORD

•
NO

.
F

•
FEDQFP

WRITE FIRST

MESSAGE IN
QUEUE

READ A RECORD

•
IEDQFP

FMTDATA

COMPUTE ADDRESS

FORMAT AND

WRITE UNIT

AND READ A
RECORD

•
PUT
NO

WR ITE PREF I X

•
FEDQFP
READ A RECORD

X:C2,FI

•

•
198

FMTDATA
WRITE DATA

•

Chart XC2

TeAM MESSAGE QUEUE PRINT (PART 2 OF 2)

•

•
B

COMPUTE DISK
AODRESS

PUT TO OUTPUT
DATA SET

FORMAT 32 BYTES
OF DATA

•
B

•

•
PUT
C

READ RECORD

CLEAR OUTPUT
BUFFER

WRITE DATA

•

•
D

(

RETURN

)

•

•
RETURN
E

•

•
FEDQFP

READ RECORD

•

•
FMTDATA
H

RESTORE

WRITE RECORD

REGISTERS

•

•
YES

•

•
K

INCREMENT
ADDRESS

ill

Flowcharts

199

Index

Access Manager
entry 28
functions 28
addressing characters 24
algorithms, core requirements 9
alternate printer, DCHB for 17
asynchronous on-line testing 9
asynchronous testing
implementing in MVT only 9
Attach routine 10
attached task 11
auto dial line 34
batch environment 179
BSC Remote Print module
entry 34
functions 34
BSC Remote Print sub-module
entry 36
functions 36
BLDL macro 31
BLOCK operand 178
buffer 11
Buffer Dump
entry 175
functions 176
buffer trace dump flow 172
cancel,OLT's 27
CECOM Service module
entry 30
functions 30
characters
addressing 24
polling 24
charts, list of 4-5
CIB (command input buffer) 11
c1osedown bit, TCAM 15
code, line translation 24
command input buffer (CIB) 11
Common Write routine (COMWRITE)
entry 177
functions 177
communication devices 23
communication parameter list 11
configura tor 9
Configurator Add Scheduler
entry 21
functions 21-22
Configura tor Change sub-module
entry 23
functions 23
Configurator Delete Scheduler module
entry 22
functions 22
Configura tor Delete sub-module
entry 23
functions 23
Configurator sub-module I
entry 22
functions 22
Configurator sub-module 2
entry 23
functions 23
Configura tor sub-module 3
entry 24
functions 24

Configurator sub-module 4
entry 24
functions 24
Configurator sub-module 5
entry 24
functions 24
contents, table of 3
control characters, line 36
control command, MODIFY operator
Convert Service module
entry 32
functions 32
conversion of data 15, 32
core requirements, algorithms 9
cross reference table 69-73
data area layouts 39
data conversion 15, 32
data, redefining in TOTE 9
data set, DCHB 21,22
DCHB (device characteristic block)
DCHB data set 21
reading 33
DCHB, workarea 26
DEBUG Service Aid Router
entry 173
functions 173
DELETE macro 31
deletion of a line 22
DEUTYPE macro 177
device characteristics block (DCHB)
device entry list 32
device tests, under TOTE 10
device table 19
devices
communication 23
graphic 23
diagnostic aids, Service Aids 181
diagnostic aids, TOTE 49
Dispatcher
entry 18
functions 19
DPRINT parameter list 29
DPRINT Service module
entry 29
functions 29
DPRINT Service module 1
entry 29
functions 29
DPRINT Service module 2
entry 30
functions 30

11,46-47

element 11
Enabling module
entry 33
functions 34
end-of-file 21
end-of-TRM character 21
entry list, device 32
error loop 19
excluding on-line test facility 9
EXIO Service module
entry 28
functions 28
formatting output messages 29
formula, asynchronous testing 16
Index

201

functional flow, TOTE 15
functions, INTRO initialization

GETMAIN areas 11
GETCONFG Service module
entry 33
functions 33
GRAB macro 32
GRAB Service module
entry 32
functions 32
graphic devices 23
HIO request 28
IBM 2260 & 2265 Display Stations 37
I/O communication, TOTE to operator 26
I/O Trace Dump flow 171
10HALT macro 28
including on-line tests 9
initialization function, INTRO 10
INTRO macro 16
layouts, data areas 41
LCBTRACE 176
library, TCAM OLT 9
line control characters 36
line deletion 22
line I/O trace table 169
Line I/O Trace Table
entry 175
functions 175
line request, stop 19
line translation code 24
LlNECNT operand 179
list, device entry 32
list of charts 4-5
LOAD macro 31
loops
error 19
test 19
macro expansion, STAR TMH 11
macro references (TOTE) 77
MCP (message control program) 9
MCPL field 11
message (TOTE)
operator 76
system 74-75
message buffers 169
message control program (MCP) 9
message origins and codes 184
message queue data set 179
messages, service aids 185-187
MODIFY operator control command 11
MTS (maximum on-line test size) 16
NAP option 26
NCM (non-concurrent mode)
Numeric TRM Handler
entry 20
functions 20-21

18, 26

OLT priority 10
OLT processing routines 13
OLT root module 11
OLT size value 10
OLT Test Control module I
entry 19
functions 19-20
OLT Test Control module II
entry 20
functions 20
OLTCB (on-line test control block) 41-45
OLTEST operand 16
default 9
on-line processing, introduction 9
on-line tests 9
202

on-line test facility
exclusion 9
inclusion 9
on-line test functions 9
operator control command, MODIFY
options
STCB 178
IOTR 178
BUFF 179
option field 18

permanent error flag 28
physical address table 19
PLINK Service module
entry 31
functions 31
polling characters 24
prefix characters, TRM 11
prefix record 184
prefix space 177
processing a TRM
remote 11
system console 11
processing routines, OLT 13
prompt request 25
Prompter 25
Prompter, TRM 11
prompting 11
queue, ready
queue, TRM

11
15

read only operation 38
reading DCHB data sets 33
ready queue 11
receive mode 38
record prefix 184
redefining data to TOTE 9
register usage 49-68
register usage, service aids 181-183
Remote Access Error module
entry 33
functions 33
remote stations 9
request for test (RFT) 10
request, HIO 28
request, prompt 25
request, stop line 19
request, stop terminal 19
responses
ACKO 34
ACKI 34
Resource Management module
entry 16
functions 16-17
return codes (see individual module descriptions)
reuse of current table 174
RFT (request for test) 10
scan function 173
scanning of a queue 15
section table 19
service aids 169
service aids flow 169
service aids modules
deleting 169
loading 169
size value, OLT 10
special characteristics table 24
specifying on-line testing 9
Start-Stop Remote Print 1030
entry 37
functions 37
Start-Stop Remote Print 1050 & 1060
entry 36
functions 36

Start-Stop Remote Print 2260 & 2265
entry 37
functions 37-38
Start-Stop Remote Print 2740
entry 35
functions 35
Start-Stop Remote Print 2741
entry 38
functions 38-39
STARTMH macro expansion 11
stations, remote 9
STCB flow 170
STCB trace table 174
stop line request 18
stop terminal request 19
Subtask Control Block Trace Dump
entry 174
functions 174
subtask control block trace table 169
syntax checking, prompter 25
tables
device 19
section 19
UCB 19
table of contents 3
table of cross-references 69-73
table of register usage 49-68
table of register usage, service aids 181-183
TAVTD macro 179
TCAM
closedown bit 15
interface with TOTE 9
OLT library 9
TCAM Message Queue Print routine
entry 179
functions 179-180
TCAM Trace Format routine
entry 178
functions 178-179
TECB 31
Telecommunications On-Line Test Executive (TOTE)
terminal name table 19
terminal table 24
test device field, checking 18
test field 18
test loop 19
test request message (TRM) 10
text mode 38
time interval, wait 31
time stamp 177
timeout 38

timer interval 177
TOTE 9
TOTE Configurator Scheduler
entry 21
functions 21
TOTE functional flow 15
TOTE Message module
entry 26
functions 26-27
TOTE Message sub-module
entry 27
functions 27
TOTE Resident module
entry 15
functions 15-16
TOTE Service module
entry 27
functions 27
TRM (test request message) 10
TRM Analysis module 1
entry
17
functions 17
TRM Analysis module 2
entry 18
functions 18
TRM Analysis module 3
entry 18
functions 18
TRM prefix characters 11
, TRM prompter 11
TRM Prompter module 1
entry 25
functions 25
TRM Prompter module 2
entry 25
functions 25-26
TRM Prompter module 3
entry 26
functions 26
TRM queue 15, 27
translation code, line 24
translation table, TCAM 34
transmission control unit (TCU) 9
transmission line, enabling 34
wait time interval 31
WAITIO Service module
entry 31
functions 31-32
workarea, DCHB 23
UCB address table
UCB table 19

Index 203

READER'S COMMENT FORM

IBM System/360 Operating System
TeAM Serviceability Aids:
Program Logic Manual

Order No. GY30-2027-0

• How did you use this publication?
As a reference source
As a classroom text
As a self-study text

0
0
0

• Based on your own experience, rate this publication.

•

As a reference source:

Very
Good

Good

Fair

Poor

Very
Poor

As a text:

Very
Good

Good

Fair

Poor

Very
Poor

What is your occupation?

• We would appreciate your other comments; please give specific page and line
references where appropriate. If you wish a reply, be sure to include your name
and address.

• Thank you for your cooperation.

No postage necessary if mailed in the U. S. A.

GY30-2027-0

YOUR COMMENTS, PLEASE . . .

This publication is one of a series that serves as a reference source for systems analysts,
programmers, and operators of IBM systems. Your answers to the questions on the
back of this form, together with your comments, help us produce better publications
for your use. Each reply is carefully reviewed by the persons responsible for writing and
publishing this material. All comments and suggestions become the property of IBM.
Please note: Requests for copies of publications and for assistance in using your IBM
system should be directed to your IBM representative or to the IBM sales office serving
your locality.

I
I
Fold

Fold

--I

FIRST CLASS
PERMIT NO, 569
RESEARCH TRIANGLE PARK
NORTH CAROLINA

OJ
~
C/)

w
8

oC/)
-l

()

»
~

C/)

:2'"

BUSINESS REPLY MAIL

!!.

NO POSTAGE STAMP NECESSARY IF MAILED IN U. S. A.

;::;'
'<

»
~

POSTAGE WILL BE PAID BY •••

I BM Corporation
P. O. Box 12275
Research Triangle Park
North Carolina 27709

r
o
(Q
0'
~

Attention: Publications Center, Dept. E01

----------1
Fold

International Business Machines Corporation
Data Processing Division
1133 Westchester Avenue, White Plains, New York 10604
(U.S.A. only)

IBM World Trade Corporation
821 United Nations Plaza, New York, New York 10017
(InternatioJHd)

Fold

GY30-2027-0

International Business Machines Corporation
Data Processing Division
1133 We8lchester Avenue, Whlta Plains, New York 10804
(U.S.A. only)
IBM World Trade Corporation
821 Unltad Nations Plaza, New York, New York 10017
(International)

Source Exif Data:

File Type                       : PDF
File Type Extension             : pdf
MIME Type                       : application/pdf
PDF Version                     : 1.3
Linearized                      : No
XMP Toolkit                     : Adobe XMP Core 4.2.1-c043 52.372728, 2009/01/18-15:56:37
Create Date                     : 2011:09:29 09:05:18-08:00
Modify Date                     : 2011:09:29 14:33:29-07:00
Metadata Date                   : 2011:09:29 14:33:29-07:00
Producer                        : Adobe Acrobat 9.45 Paper Capture Plug-in
Format                          : application/pdf
Document ID                     : uuid:7fac0f03-1730-4416-bd07-467df35136dc
Instance ID                     : uuid:62a16eb2-e1ef-4aac-8e00-27bc000f4806
Page Layout                     : SinglePage
Page Mode                       : UseNone
Page Count                      : 208

EXIF Metadata provided by EXIF.tools

GY30 2027 0_TCAM_Serviceability_Aids_Program_Logic_Rel_20_Mar71 0 TCAM Serviceability Aids Program Logic Rel 20 Mar71

GY30-2027-0_TCAM_Serviceability_Aids_Program_Logic_Rel_20_Mar71 GY30-2027-0_TCAM_Serviceability_Aids_Program_Logic_Rel_20_Mar71

Navigation menu

Versions of this User Manual:

Views

Navigation