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)
public void SetCommareaData(
byte[] commarea
)
Public Sub SetCommareaData (
commarea As Byte()
)
public:
void SetCommareaData(
array<unsigned char>^ commarea
)
Parameters
- commarea
- Type: SystemByte
A byte array containing the COMMAREA data, or to specify no COMMAREA.
| Exception | Condition |
|---|
| ArgumentOutOfRangeException |
The length of commarea exceeds the maximum value of an Int16 (32767).
|
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.
Reference