supplied by the installation for each routing table. These entries are processed only
when the routing table is loaded, so they are not searched during programmable
operator message handling.
The configuration shown in Figure 52 can be described in a routing table with the
first few lines like those in Figure 53 on page 431.
Local System Nodel d = tWDEl Distributed System Nodeid = NODE2 RSCS Virtual Muchine ID = NETI
Logical
User Operator Virtual Virtual
f1achi ne Machine
Userid =
Userid = USERll LGLOPR RSCS Virtual Machine
ID = NET2 Pro9rammuble User Operator Virtual Virtual
Machine i ne
Userid
=
Userid = USER21 OPERATOR Figure 52. The Programmable Operator Facility in a Distributed System. The logical operator is situated at the Host system and the programmable
operator is running in a different system at a distributed site.
The routing table entries to be searched must be in the following fixed format.
Note: The words in parentheses correspond to the vertically aligned words in the
comment records in Figure 53 on page 431 through Figure 57, and also in the IBM
sample routing table file.
FIELD
COMPARISON TEXT (TEXT)
STARTING COLUMN (SCOL)
ENDING COLUMN (ECOL)
IUCV MESSAGE CLASS (TYPE)
USERID (USER)
NODEID (NODE)
ACTION ROUTINE NAME (ACTN)
PARAMETER TO ACTION ROUTINE (PARM)
where:
EXAMPLE
/FEEDBACK/
1
9
1
USER21
NODE2
DMSPOR
TOFB
COMPARISON TEXT
FIELD COLUMNS 1-25
27-29
31-33
35-36
38-45
47-54
56-63
65-72
LENGTH OF FIELD
25
3
3
2
8
8
8
8
is a particular character string that the programmable operator facility is to
search for in the incoming message. If this field is left blank, any text com­
pared with this field is considered a match. Multiple texts may be specified,
with the capability to skip over intervening blank or non-blank characters.
The Programmable Operator Facility 429

STARTING COLUMN is the column in the incoming message where the programmable operator facili­
ty starts looking for the character string mentioned in the COMPARISON TEXT field. If this field is left blank, the programmable operator facilllY starts
scanning at the beginning of the message.
ENDING COLUMN is the column in the incoming message where the programmable operator facili­
ty stops looking for the character string(s) mentioned in the COMPARISON TEXT field. If this field is left blank, the programmable operator facility con­
tinues scanning until the end of the message. IUCV MESSAGE CLASS
identifies the origin of the incoming message according to the IUCV message
type. For more details on message types, see the Message System Service sec­
tion of this manual. If this field is left blank, any value compared with this field
is considered a match.
The IUCV message types are:
Class Message Types
1 Message sent using CP MESSAGE and CP MSGNOH. 2 Message sent using CP WARNING.
3 Asynchronous CP messages and CP responses to a CP command
executed by the programmable operator facility virtual machine.
4 Message sent using CP SMSG command.
5 Any data directed to the virtual console by the virtual machine
(WRTERM, LINEDIT, etc.).
6 Error messages from CP (EMSG).
7 Information messages from CP (IMSG).
8 Single Console Image Facility (SCIF) message from CP.
Note: CP responses that are trapped in a buffer using the extended DIAG­ NOSE X'08' do not become type-3 messages. For example, CP responses
from the programmable operator CMD command are not type 3-messages, and
therefore are not logged when LOGGING is set to "ON". USERID
is the character string that is compared to the VM userid of the user that sent
the incoming message to the programmable operator facility. It determines the
authority of the user to cause an action to be performed. If this field is left
blank, all userids compared with this field are assumed to match. NODEID is the character string that is compared to the VM nodeid of the user that sent
the incoming message to the programmable operator facility. Again, it deter­
mines the authority of the user to cause an action to be performed. If this field
is left blank, all node ids compared with this field are assumed to match. ACTION ROUTINE NAME 430 VM/SP System Programmer's Guide
is the name of the LOADLIB member (a Basic Assembler Language routine)
that the programmable operator facility is to NUCXLOAD when the LOADTBL function is performed, or the name of an EXEC, and subsequently,