Filter
Top Products
Server Application Considerations
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.