ENFORM User's Guide

Writing ENFORM Servers
ENFORM Servers
058058 Tandem Computers Incorporated 7–7
Message Components The messages to and from the query processor and an ENFORM server consist of two
components, a message header and the message data. The message header is a fixed
length for all messages. The message data is a fixed length for all messages except
RECORD-INPUT-REQUEST and RECORD-INPUT-REPLY; the lengths are determined
during initialization.
DDL Message Header Description
The following DDL definition shows the message header format.
DEF pw-header-def.
05 reply-code TYPE BINARY 16
! = 1, indicates error, including end-of-file
! = 0, everything’s OK
05 application-code PIC XX
! = "S1", indicating sequential file simulation
05 function-code PIC XX
! = "DA" for data input
05 trans-code PIC XX
! = "SR", initiate-input-request or -reply
! = "RR", record-input-request or -reply
! = "TR", terminate-input-request or -reply
05 term-id PIC X(15)
! not used
05 log-request PIC X
! not used
END
DEF ENFORM-error-header-def
05 error-code TYPE BINARY 16
! = 0, no error
! = 1, server EOF
! = 29, invalid message or any other server detected
05 error-file-name PIC X(24)
! Must be blank unless error-code is non-zero.
! If supplied, this filename will be printed in the
! error message instead of the server’s name. Must be
! in the form of a Tandem filename.
05 file-error TYPE BINARY 16
! Must be zero unless error-code is non-zero.
! If supplied, this error number will be printed in the
! error message instead of a file system error.
END
DEF ENFORM-server-header-def
05 pw-header-def TYPE *
05 ENFORM-error-header-def TYPE *.
END