ENABLE Reference Manual

THE GENERAL SERVER
Response Format
GENERAL SERVER RESPONSE FORMAT
General Server responses consist of a fixed prefix common to all
types of transactions and a variable portion dependent on the
entry in REPLY-CODE. REPLY-CODE is equal to 0 or 1 as follows:
REPLY-CODE=0 Prefix only returned
REPLY-CODE=1 Prefix plus RECORD-IMAGE returned
The prefix consists of the 24-byte PATHWAY header, the 54-byte
General Server header, and the 96-byte context buffer. The
values returned in the prefix are the same as those passed in the
request except as noted in the following paragraphs.
The following header fields are set by the General Server for the
indicated REPLY-CODE and TRANS-CODE values of the request:
REPLY-CODE All codes
ERROR-STATUS All codes
FILE-NUMBER TRANS-CODE=0
RECORD-LENGTH REPLY-CODE=0 All codes if zero passed in
the request.
RECORD-AREA-LENGTH REPLY-CODE=0 All codes if zero passed in
the request.
FILE-POSITION TRANS-CODE=1
Normally the General Server returns:
• The RECORD-IMAGE in the variable portion of the General Server
response for a successful READ operation. A successful READ
operation is where the request has TRANS-CODE=1, and the
response has ERROR-CODE=0 and REPLY-CODE=1.
• The prefix only when an operation is unsuccessful. An
unsuccessful operation occurs when the request has any
TRANS-CODE, and the response has a nonzero ERROR-CODE.
The only exception to this procedure concerns the handling of
update conflicts, which occur when the present program
attempts to modify or delete a record that was altered by
another process since the present program read that record.
If an UPDATE operation (TRANS-CODE=2) or DELETE operation
(TRANS-CODE=3) fails because of update conflict, the new
record image is returned in the response; REPLY-CODE is set to
1 and ERROR-CODE is set to a nonzero value.
E-19