Programming services with a response, Programming services without a response, Modifying the length of the return message – Oracle Audio Technologies Oracle Tuxedo User Manual
Page 97: Modifying return message lengths for c programs
S e r v e r A p p l i c a t i o n C o n s i d e r a t i o n s
Oracle Tuxedo Mainframe Adapter for TCP - CICS User Guide
5-9
Programming Services with a Response
Service programs expected to send a response to the client use the
EXEC CICS LINK
command
to execute. The
COMMAREA
option contains a pointer to the raw data; therefore, no header is sent.
As a result, the request data is available to the service programs in the
COMMAREA
.
Programming Services without a Response
Service programs that do not send replies back to the requester execute using transactions started
by the
EXEC CICS START
command. The
FROM
option of this command contains a pointer to the
raw data; therefore, no header is sent. As a result, such service programs must use an
EXEC CICS
RETRIEVE
command with the
SET
option containing a pointer to the raw data.
Note:
Define a unique transaction for each service that does not send a reply and enter the name
of that transaction in the
TRANSACTION NAME
field of the Inbound Service Information
screen for the corresponding service.
An example of a service sending no reply is one requested by a client using a tpacall with the
TPNOREPLY
flag set.
Modifying the Length of the Return Message
You can manage the actual size of the return message the system sends over the gateway on a per
request basis. This is different than simply limiting the message size for a particular service using
the
MAX MESSAGE
field of the Inbound Service Information screen. To limit the size of the return
message per request, the service program must
ADDRESS
the TWA using the copybook or the
include file delivered in the
"YOURHLQ".BEATCPC.INCLUDE
file.
Modifying Return Message Lengths for C Programs
To modify the return message length on a per request basis, specify the message length in the
rtnMsgSize
field in a
TWA_CONNECT
structure defined in the
TWAINCL
file.
Modifying Return Message Lengths for COBOL Programs
To modify the return message length on a per request basis, specify the message length in the
RTN-MSG-SIZE
field in a
TWA_CONNECT
record layout in the copybook
TWACOPY
.