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

Advertising
background image

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

.

Advertising