Pathway/iTS TCP and Terminal Programming Guide

Processing Unsolicited Messages
Compaq NonStop™ Pathway/iTS TCP and Terminal Programming Guide—426751-001
7-17
Unsolicited-Message Reply Layout
02 SCOBOL-MSG.
CODE FIELD in the RECEIVE UNSOLICITED MESSAGE verb is relative to
this point.
03 MSG-TEXT PIC X(number-of-characters).
Text being sent to the SCREEN COBOL requester (can be null).
If the fields PROTOCOL-ID, DEST-NODE, and DEST-TCP-PROC are not filled out in
TCP-UMP-HDR, the TCP returns a file system security-violation error (48), with no
data, in response to the unsolicited message. If the unsolicited message has fewer bytes
than the 40-byte TCP-UMP-HDR header, the message is also rejected with an error 48.
Unsolicited-Message Reply Layout
Figure 7-2 illustrates, in a COBOL-like representation, the format of a reply to an
unsolicited message as viewed by both the TCP that sends it and the external process
(outside the PATHMON environment) that receives it.
On execution of a REPLY TO UNSOLICITED MESSAGE statement, the TCP adds the
appropriate UMP header to the reply text supplied by the requester.
The text that follows briefly describes each field.
01 UMP-REPLY.
Built by the TCP (with reply text supplied by the requester) and sent to the Guardian
process that sent the unsolicited message. The requester passes the reply text to the
TCP by using a REPLY TO UNSOLICITED MESSAGE statement.
02 TCP-UMP-HDR.
03 MSG-ID PIC 9(4) COMP.
Copied from the MSG-ID field of the unsolicited message.
Figure 7-2. UMP Reply Format
01 UMP-REPLY.
02 TCP-UMP-HDR.
03 MSG-ID PIC 9(4) COMP.
03 REPLY-ID PIC 9(4) COMP VALUE 1.
03 REPLY-VERSION PIC 9(4) COMP.
03 REPLY-HEADER-LEN PIC 9(4) COMP.
03 ERROR-CODE PIC 9(4) COMP.
03 INFO1 PIC 9(4) COMP.
03 INFO2 PIC 9(4) COMP.
03 REPLY-SEQ-NUM PIC 9(4) COMP.
02 SCOBOL-REPLY.
03 REPLY-TEXT PIC X(number-of-characters).