EciRequestSetCommareaData Method

CICS Transaction Gateway V10.1.0.0
Sets the COMMAREA data associated with the request.

Namespace:  IBM.CTG
Assembly:  IBM.CTG.Client (in IBM.CTG.Client.dll) Version: 10.1.0.0 (10.1.0.0)
Syntax

public void SetCommareaData(
	byte[] commarea
)

Parameters

commarea
Type: SystemByte
A byte array containing the COMMAREA data, or to specify no COMMAREA.
Exceptions

ExceptionCondition
ArgumentOutOfRangeException The length of commarea exceeds the maximum value of an Int16 (32767).
Remarks

If the length of commarea is zero, it is treated as if was specified. The COMMAREA held within the EciRequest is cloned from commarea. Subsequent modifications to the array will not be reflected in the COMMAREA that is sent to CICS unless SetCommareaData(Byte) is invoked with the modified array. The maximum COMMAREA size that can be flowed successfully to the CICS server depends on a variety of factors, including the communication protocol used between the CICS Transaction Gateway and the CICS server, and the amount of non-zero data in the COMMAREA. Applications are advised to use a maximum size of 32500 bytes, as this is guaranteed to be flowed successfully across all protocols. COMMAREA sizes larger than this may generate an EciErrInvalidDataLength return code when the request is flowed.
See Also

Reference