Pathway/iTS TCP and Terminal Programming Guide

Processing Unsolicited Messages
Compaq NonStop™ Pathway/iTS TCP and Terminal Programming Guide—426751-001
7-16
Unsolicited-Message Layout
The text that follows briefly describes each field.
01 UMP-MSG.
Sent to the appropriate TCP by a Guardian process by making a WRITEREAD call
with a read-count large enough to contain the reply header and reply text. The target
SCREEN COBOL requester accepts the text portion by using a RECEIVE
UNSOLICITED MESSAGE statement.
02 TCP-UMP-HDR.
The header is seen only by the TCP (not by the SCREEN COBOL requester).
03 PROTOCOL-ID PIC 9(4) COMP VALUE 42.
Unsolicited message protocol indicator. Must be 42.
03 MSG-ID PIC 9(4) COMP VALUE 1.
Message identification number. Must be 1.
03 MSG-VERSION PIC 9(4) COMP VALUE 1.
Message format version number. Must be 1.
03 MSG-HEADER-LEN PIC 9(4) COMP VALUE 40.
Number of bytes in TCP-UMP-HDR. Must be 40.
03 DEST-NODE PIC X(8).
The symbolic name of the destination node of this message (such as
\CORPHQ), left justified and blank filled.
03 DEST-TCP-PROC PIC X(6).
The Guardian process name of the destination TCP of this message (such as
$BTCP), left justified and blank filled.
03 LOGICAL-TERM-NAM PIC X(15).
The name of the destination terminal as defined by the PATHCOM ADD
TERM command.
03 FILLER PIC X.
Filler ensuring that the next field starts on word boundary.
03 MSG-SEQUENCE-NUM PIC 9(4) COMP.
A 16-bit binary number that uniquely identifies this particular message
within the context of the program that generated the message.