User 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