TRANSFER Reference Manual

IPC Request and Reply Headers
Programmatic Interface to the TRANSFER Delivery System
069139, Update 1 to 40969 Tandem Computers Incorporated 1–5
RQST-ERR (3)
indicates that the TRANSFER delivery system detected one of the following
two error conditions:
An error in the data in the IPC header occurred and the error is not
specific to any particular UOW.
An error in the range from 4900 to 5000 occurred in a UOW, earlier UOWs
in the IPC message were processed successfully, and additional
information about the error is stored in the IPC-RETN-CODE field.
Caution If your application receives a value of 2 or 3 in PW-REPLY-CODE, use TMF to abort and back out the
transaction. If the transaction is not backed out, consistency in the TRANSFER database cannot be
guaranteed and the statistics count might be incorrect.
VERSION-CODE
designates the version code for the TRANSFER IPC structure used for both a
request to and a reply from the TRANSFER delivery system. The version code is
defined by Tandem and consists of a letter followed by a two-digit revision
number.
The first release of the TRANSFER delivery system was version code A01; new
features were introduced in versions A02, B00, B10, B40, and C30. If you use
features not in an earlier version, your application cannot run with that previous
version of TRANSFER. You should set the version code in your IPC headers to the
newest version of the TRANSFER delivery system from which you used new
features. The TRANSFER delivery system returns an INVALID-VERSION-CODE
error in the IPC-RETN-CODE if you attempt to use your application with a
version of the TRANSFER delivery system that does not support all the new
features you use. On a B40 TRANSFER system, the use of a version code prior to
B40 affects the language and character map used to interpret the request.
IPC messages that use the current version of the TRANSFER delivery system will
be supported by subsequent versions of the TRANSFER delivery system. You
would not need to alter the IPCs used by your client when running your
application under new versions of the TRANSFER delivery system.
IPC-RETN-CODE
specifies one of the following values, in a reply from the TRANSFER delivery
system (in a request this field is ignored):
IPC-OK (0)
indicates that the TRANSFER delivery system detected no errors in the IPC
header. Warning indications or errors, however, might have been present in
the individual UOWs in the request.