public class ECIRequest extends GatewayRequest implements ECIReturnCodes
JavaGateway.flow
methodGatewayRequest
Modifier and Type | Field and Description |
---|---|
java.lang.String |
Abend_Code
CICS transaction abend code.
|
int |
Call_Type
CICS ECI call type.
|
Channel |
channel
The
Channel to be passed to the CICS program. |
static int |
CICS_EciListSystems
List CICS servers.
|
int |
Cics_Rc
CICS ECI return code.
|
int |
CicsClientStatus
After
getStatus() , shows status of the Client daemon. |
int |
CicsServerStatus
After
getStatus() , shows status of CICS server. |
byte[] |
Commarea
COMMAREA to be passed to the CICS program.
|
int |
Commarea_Length
Length of COMMAREA.
|
int |
ConnectionType
After
getStatus() , shows type of CICS system. |
static int |
ECI_ASYNC
Asynchronous call.
|
static int |
ECI_ASYNC_TPN
Asynchronous call with eci_tpn.
|
static int |
ECI_BACKOUT
End LUW and backout changes.
|
static int |
ECI_CANCEL
Deprecated.
End LUW and commit changes, exactly the same as ECI_COMMIT.
|
static short |
ECI_CLIENTSTATE_INAPPLICABLE
Return value from a
getStatus() call. |
static short |
ECI_CLIENTSTATE_UNKNOWN
Return value from a
getStatus() call. |
static short |
ECI_CLIENTSTATE_UP
Return value from a
getStatus() call. |
static int |
ECI_COMMIT
End LUW and commit changes.
|
static short |
ECI_CONNECTED_NOWHERE
Return value from a
getStatus() call. |
static short |
ECI_CONNECTED_TO_CLIENT
Return value from a
getStatus() call. |
static short |
ECI_CONNECTED_TO_SERVER
Return value from a
getStatus() call. |
static int |
ECI_EXTENDED
This request is part of an Extended Logical Unit of Work.
|
static int |
ECI_GET_REPLY
In local mode, use this call type to get any reply to an asynchronous call.
|
static int |
ECI_GET_REPLY_WAIT
In local mode, use this call type to await any reply to an asynchronous call.
|
static int |
ECI_GET_SPECIFIC_REPLY
Get a specific asynchronous reply.
|
static int |
ECI_GET_SPECIFIC_REPLY_WAIT
Await a specific asynchronous reply.
|
static int |
ECI_LUW_NEW
New LUW.
|
static int |
ECI_NO_EXTEND
Non-extended LUW call, or the last call in a LUW.
|
static short |
ECI_SERVERSTATE_DOWN
Return value from a
getStatus() call. |
static short |
ECI_SERVERSTATE_UNKNOWN
Return value from a
getStatus() call. |
static short |
ECI_SERVERSTATE_UP
Return value from a
getStatus() call. |
static int |
ECI_STATE_ASYNC
Asynchronous request for status.
|
static int |
ECI_STATE_ASYNC_JAVA
Deprecated.
The getStatus(String,int,Callbackable) method of ECIRequest should be used to
retrieve immediate asynchronous status information about a CICS server.
|
static int |
ECI_STATE_CANCEL
Cancel a previous request to be alerted on a state change
|
static int |
ECI_STATE_CHANGED
Return state information when the CICS Server changes state e.g.
|
static int |
ECI_STATE_IMMEDIATE
Return state information immediately.
|
static int |
ECI_STATE_SYNC
Synchronous request for status information.
|
static int |
ECI_STATE_SYNC_JAVA
Deprecated.
The getStatus(String) method of ECIRequest should be used to retrieve immediate
synchronous status information about a CICS server.
|
static int |
ECI_STATUS_LENGTH
Length of COMMAREA needed for status information.
|
static int |
ECI_SYNC
Synchronous call.
|
static int |
ECI_SYNC_TPN
Synchronous call with eci_tpn.
|
int |
Extend_Mode
Extend mode of request.
|
int |
Luw_Token
Extended Logical Unit of Work token.
|
int |
maxNumServers
Maximum number of CICS servers about which information is to be
returned (see
listSystems() ). |
int |
numServersKnown
Number of CICS servers which are defined (output from
listSystems() flow). |
int |
numServersReturned
Number of CICS servers about which information has been returned
(output from
listSystems() flow). |
java.lang.String |
Password
Password or password phrase for CICS server.
|
java.lang.String |
Program
Program to invoke on CICS server.
|
java.lang.String |
Server
CICS server to direct request to.
|
java.util.Vector<java.lang.String> |
SystemList
List of known systems and system descriptions following a
listSystems(int) call. |
java.lang.String |
Transid
Transaction ID to run CICS program under.
|
java.lang.String |
Userid
User ID for CICS server.
|
astrCics_Rc, astrCics_Rc2, ECI_ERR_ALREADY_ACTIVE, ECI_ERR_CALL_FROM_CALLBACK, ECI_ERR_CICS_DIED, ECI_ERR_EXEC_NOT_RESIDENT, ECI_ERR_INVALID_CALL_TYPE, ECI_ERR_INVALID_DATA_AREA, ECI_ERR_INVALID_DATA_LENGTH, ECI_ERR_INVALID_EXTEND_MODE, ECI_ERR_INVALID_VERSION, ECI_ERR_LUW_TOKEN, ECI_ERR_MAX_SESSIONS, ECI_ERR_MAX_SYSTEMS, ECI_ERR_MORE_SYSTEMS, ECI_ERR_MSG_QUAL_IN_USE, ECI_ERR_NO_CICS, ECI_ERR_NO_MSG_QUALS, ECI_ERR_NO_REPLY, ECI_ERR_NO_SESSIONS, ECI_ERR_NO_SYSTEMS, ECI_ERR_NULL_MESSAGE_ID, ECI_ERR_NULL_SEM_HANDLE, ECI_ERR_NULL_WIN_HANDLE, ECI_ERR_REQUEST_TIMEOUT, ECI_ERR_RESOURCE_SHORTAGE, ECI_ERR_RESPONSE_TIMEOUT, ECI_ERR_ROLLEDBACK, ECI_ERR_SECURITY_ERROR, ECI_ERR_SYSTEM_ERROR, ECI_ERR_THREAD_CREATE_ERROR, ECI_ERR_TRANSACTION_ABEND, ECI_ERR_UNKNOWN_SERVER, ECI_ERR_XID_INVALID, ECI_NO_ERROR
astrGateway_Rc, ERROR_BASE, ERROR_CONNECTION_FAILED, ERROR_EXIT_RETRY_INVALID, ERROR_GATEWAY_BACK_LEVEL, ERROR_GATEWAY_CLOSED, ERROR_GATEWAY_EXCEPTION, ERROR_INVALID_REQUEST_TYPE, ERROR_NOT_AUTHORIZED, ERROR_NOT_SUPPORTED, ERROR_REPLY_MISMATCH, ERROR_UNKNOWN_REQUEST_TYPE, ERROR_WORK_WAS_REFUSED, ERROR_XA_SUPPORT_NOT_ENABLED, strINVALID_GATEWAY_RC
Constructor and Description |
---|
ECIRequest()
Default constructor, which leaves all the values set to their defaults.
|
ECIRequest(int iCallType,
java.lang.String strServer,
java.lang.String strUserid,
java.lang.String strPassword,
java.lang.String strProgram,
java.lang.String strTransid,
byte[] abytCommarea)
Creates an ECIRequest object with commarea for a basic request using
the most commonly used ECI parameters.
|
ECIRequest(int iCallType,
java.lang.String strServer,
java.lang.String strUserid,
java.lang.String strPassword,
java.lang.String strProgram,
java.lang.String strTransid,
byte[] abytCommarea,
int iCommareaLength,
int iExtendMode,
int iLuwToken)
Creates an ECIRequest object with commarea which expands on the basic values
to allow Extended Logical Unit-of-Work requests.
|
ECIRequest(int iCallType,
java.lang.String strServer,
java.lang.String strUserid,
java.lang.String strPassword,
java.lang.String strProgram,
java.lang.String strTransid,
byte[] abytCommarea,
int iCommareaLength,
int iExtendMode,
int iLuwToken,
int iMessageQualifier,
Callbackable callBack)
Creates an ECIRequest object with commarea for ECI asynchronous call types.
|
ECIRequest(int iCallType,
java.lang.String strServer,
java.lang.String strUserid,
java.lang.String strPassword,
java.lang.String strProgram,
java.lang.String strTransid,
Channel channel,
int iExtendMode,
int iLuwToken)
Creates an ECIRequest object with a Channel to make Extended Logical
Unit-of-Work requests.
|
ECIRequest(int iCallType,
java.lang.String strServer,
java.lang.String strUserid,
java.lang.String strPassword,
java.lang.String strProgram,
java.lang.String strTransid,
Channel channel,
int iExtendMode,
int iLuwToken,
int iMessageQualifier,
Callbackable callBack)
Creates an ECIRequest object with a Channel for ECI asynchronous call types.
|
ECIRequest(java.lang.String strServer,
java.lang.String strUserid,
java.lang.String strPassword,
java.lang.String strProgram,
byte[] abytCommarea,
int iExtendMode,
int iLuwToken)
Creates an ECIRequest object with commarea for a simple synchronous call.
|
ECIRequest(java.lang.String strServer,
java.lang.String strUserid,
java.lang.String strPassword,
java.lang.String strProgram,
Channel channel,
int iExtendMode,
int iLuwToken)
Creates an ECIRequest object with a Channel using the most commonly
used ECI parameters.
|
Modifier and Type | Method and Description |
---|---|
int |
getCallType()
This method returns the Call_Type field of this ECIRequest object.
|
java.lang.String |
getCallTypeString()
This method returns a String representing the Call_Type field of this
ECIRequest object.
|
Channel |
getChannel()
Gets the
Channel associated with the request. |
int |
getCicsRc()
Gets the CICS return code set in this object.
|
java.lang.String |
getCicsRcString()
Gets the CICS return code set in this object and returns it as a String.
|
java.lang.String |
getClientStatusString()
This method returns a String describing the CicsClientStatus field of
this ECIRequest object.
|
int |
getCommareaInboundLength()
This method returns an int, which is the Commarea inbound length.
|
int |
getCommareaOutboundLength()
This method returns an int, which is the Commarea outbound length.
|
java.lang.String |
getConnectionTypeString()
This method returns a String describing the ConnectionType field of
this ECIRequest object.
|
short |
getECITimeout()
This method returns a short.
|
int |
getExtendMode()
This method returns the Extend_Mode field of this ECIRequest object.
|
java.lang.String |
getExtendModeString()
This method returns a String describing the Extend_Mode field of this
ECIRequest object.
|
int |
getInboundDataLength()
This method returns an integer, which is the inbound data length.
|
int |
getMessageQualifier()
Returns the Message Qualifier associated with this request.
|
int |
getRc()
Gets the return code set in this object.
|
java.lang.String |
getRcString()
Gets the return code set in this object and return it as a string.
|
java.lang.String |
getServerStatusString()
This method returns a String describing the CicsServerStatus field of
this ECIRequest object.
|
ECIRequest |
getStatus(java.lang.String strServer)
This method creates an ECIRequest object which can be used to find the
current status of a CICS system.
|
ECIRequest |
getStatus(java.lang.String strServer,
int iMessageQualifier,
Callbackable callBack)
This method creates an ECIRequest object which can be used to find the
current status of a CICS system.
|
boolean |
hasChannel()
Gets a value indicating whether the request has an associated
Channel . |
boolean |
isAutoMsgQual()
Returns whether Automatic Message Qualifier generation is on or not.
|
boolean |
isCallback()
This method returns a boolean indicating whether there is a Callbackable
object associated with this ECIRequest object.
|
boolean |
isCommareaInboundLength()
This method returns a boolean value which indicates that
setCommareaInboundLength was called with a valid value.
|
boolean |
isCommareaOutboundLength()
This method returns a boolean indicating whether the Commarea outbound
length is valid.
|
boolean |
isInboundDataLength()
This method returns a boolean indicating whether automatic null stripping
took place.
|
boolean |
isTPNTransid()
Returns a boolean indicating whether the Transid field
is interpreted as an eci_tpn transid (if supported).
|
static ECIRequest |
listSystems(int iNumOfSys)
This method returns an ECIRequest object which can be flowed to a
CICS Transaction Gateway to retrieve the defined CICS servers.
|
void |
setAutoMsgQual(boolean newFlag)
Allows you to turn on or off the Automatic Message Qualifier generation
facility.
|
void |
setCallback(Callbackable callBack)
Sets the Callbackable object associated with this ECIRequest object.
|
void |
setChannel(Channel channel)
Sets the
Channel associated with the request. |
void |
setCommareaInboundLength(boolean bIn)
This method controls how much of the Commarea, (associated with this
ECIRequest object), will be returned by the CICS Transaction Gateway.
|
void |
setCommareaInboundLength(int iIn)
This method controls how much of the Commarea, (associated with this ECIRequest
object), will be flowed from the CICS Transaction Gateway.
|
void |
setCommareaOutboundLength(boolean bOut)
This method controls how much of the Commarea, (associated with this
ECIRequest object), will be flowed to the CICS Transaction Gateway.
|
void |
setCommareaOutboundLength(int iOut)
This method controls how much of the Commarea, (associated with this
ECIRequest object), will be flowed to the CICS Transaction Gateway.
|
void |
setECITimeout(short sTimeout)
This method controls whether there will be an ECI timeout value associated
with this ECIRequest object.
|
void |
setMessageQualifier(int newMsgQual)
Sets the Message Qualifier associated with this request.
|
java.lang.String |
stringClientStatus(int iCicsClientStatus)
This method takes an int representing the status of the Client i.e.
|
java.lang.String |
stringConnectionType(int iConnectionType)
This method takes an int representing the status of the Connection, that is,
the ConnectionType, and returns a String describing the ConnectionType.
|
java.lang.String |
stringServerStatus(int iCicsServerStatus)
This method takes an int representing the status of the Server, this is, the
CicsServerStatus, and returns a String describing the ServerStatus.
|
getGatewayRc, getGatewayRcString
public static final int ECI_SYNC
public static final int ECI_ASYNC
public static final int ECI_GET_REPLY
ECI_ERR_INVALID_CALL_TYPE
.
If a call of this type fails because the COMMAREA is too small, CICS TG sets Commarea_Length to the minimum size needed to store the reply. Interrogate the Commarea_Length integer to find out how big the COMMAREA needs to be, create a new COMMAREA of the right size and reissue the call.
public static final int ECI_GET_REPLY_WAIT
ECI_ERR_INVALID_CALL_TYPE
.
If a call of this type fails because the COMMAREA is too small, CICS TG sets Commarea_Length to the minimum size needed to store the reply. Interrogate the Commarea_Length integer to find out how big the COMMAREA needs to be, create a new COMMAREA of the right size and reissue the call.
public static final int ECI_GET_SPECIFIC_REPLY
If a call of this type fails because the COMMAREA is too small, CICS TG sets Commarea_Length to the minimum size needed to store the reply. Interrogate the Commarea_Length integer to find out how big the COMMAREA needs to be, create a new COMMAREA of the right size and reissue the call.
public static final int ECI_GET_SPECIFIC_REPLY_WAIT
If a call of this type fails because the COMMAREA is too small, CICS TG sets Commarea_Length to the minimum size needed to store the reply. Interrogate the Commarea_Length integer to find out how big the COMMAREA needs to be, create a new COMMAREA of the right size and reissue the call.
public static final int ECI_STATE_SYNC
public static final int ECI_STATE_ASYNC
public static final int CICS_EciListSystems
@Deprecated public static final int ECI_STATE_SYNC_JAVA
@Deprecated public static final int ECI_STATE_ASYNC_JAVA
public static final int ECI_SYNC_TPN
Synchronous call with the Transid field representing eci_tpn. Refer to the CICS Transaction Gateway Information Center for more information on the difference between eci_transid and eci_tpn.
public static final int ECI_ASYNC_TPN
Asynchronous call with the Transid field representing eci_tpn. Refer to the CICS Transaction Gateway Information Center for more information on the difference between eci_transid and eci_tpn.
public static final int ECI_NO_EXTEND
public static final int ECI_EXTENDED
public static final int ECI_COMMIT
@Deprecated public static final int ECI_CANCEL
public static final int ECI_BACKOUT
public static final int ECI_STATE_IMMEDIATE
public static final int ECI_STATE_CHANGED
public static final int ECI_STATE_CANCEL
public static final int ECI_LUW_NEW
public static final int ECI_STATUS_LENGTH
public static final short ECI_CONNECTED_NOWHERE
getStatus()
call.public static final short ECI_CONNECTED_TO_SERVER
getStatus()
call.public static final short ECI_CONNECTED_TO_CLIENT
getStatus()
call.public static final short ECI_SERVERSTATE_UNKNOWN
getStatus()
call.public static final short ECI_SERVERSTATE_UP
getStatus()
call.public static final short ECI_SERVERSTATE_DOWN
getStatus()
call.public static final short ECI_CLIENTSTATE_UNKNOWN
getStatus()
call.public static final short ECI_CLIENTSTATE_UP
getStatus()
call.public static final short ECI_CLIENTSTATE_INAPPLICABLE
getStatus()
call.public int Call_Type
ECI_SYNC
.public int Extend_Mode
ECI_NO_EXTEND
.public int Luw_Token
ECI_LUW_NEW
.public java.lang.String Server
null
.
If this is left unset, the default server defined in the gateway is used.public java.lang.String Userid
null
.public java.lang.String Password
Password or password phrase for CICS server. The maximum supported password or password phrase length varies by CICS server and communication protocol. Refer to your CICS server documentation for details.
The default value is null
.
public java.lang.String Program
null
.public java.lang.String Transid
null
.
If Call_Type
is set to ECI_SYNC_TPN
or
ECI_ASYNC_TPN
, this field specifies the mirror transaction
that the called program runs under. If the request is extended, this field
has a meaning only for the first request within a logic unit of work.
Subsequent requests within the same unit of work will use the mirror
transaction specified on the first request.
If Call_Type
is set to ECI_SYNC
or ECI_ASYNC
, the called program runs under the default CICS
mirror transaction but is linked to under the transaction specified in
this field. The transaction identifier is stored in EIBTRNID for the
duration of the LINK to the CICS program, so it is available to the called
program.
Some servers use the transaction identifier to determine security and
performance attributes for the called program. In those servers, use this
property to control the processing of called programs.
public int Commarea_Length
public byte[] Commarea
null
.public int Cics_Rc
public java.lang.String Abend_Code
public java.util.Vector<java.lang.String> SystemList
listSystems(int)
call.
On return from a CICS_EciListSystems call, this vector is filled with Strings containing system names and system descriptions. Entries with even indices contain system names, and those with odd indices contain system descriptions.
public int ConnectionType
getStatus()
, shows type of CICS system.public int CicsServerStatus
getStatus()
, shows status of CICS server.public int CicsClientStatus
getStatus()
, shows status of the Client daemon.public int maxNumServers
listSystems()
).public int numServersKnown
listSystems()
flow).public int numServersReturned
listSystems()
flow).public ECIRequest()
Since all the valid ECIRequest parameters are public data members you can set them by hand if required.
public ECIRequest(java.lang.String strServer, java.lang.String strUserid, java.lang.String strPassword, java.lang.String strProgram, byte[] abytCommarea, int iExtendMode, int iLuwToken)
strServer
- CICS server name to make request to (default used if not set)strUserid
- CICS userid to usestrPassword
- CICS password or password phrase to usestrProgram
- CICS program to be run on the serverabytCommarea
- Byte array containing the COMMAREA to pass to CICSiExtendMode
- ECI extend modeiLuwToken
- ECI LUW tokenpublic ECIRequest(int iCallType, java.lang.String strServer, java.lang.String strUserid, java.lang.String strPassword, java.lang.String strProgram, java.lang.String strTransid, byte[] abytCommarea)
The length of the COMMAREA is assumed to be the length of the byte array passed in via the abytCommarea parameter.
iCallType
- ECI call typestrServer
- CICS server name to make request to (default used if not set)strUserid
- CICS userid to usestrPassword
- CICS password or password phrase to usestrProgram
- CICS program to be run on the serverstrTransid
- CICS transid to be run on the serverabytCommarea
- Byte array containing the COMMAREA to pass to CICSpublic ECIRequest(int iCallType, java.lang.String strServer, java.lang.String strUserid, java.lang.String strPassword, java.lang.String strProgram, java.lang.String strTransid, byte[] abytCommarea, int iCommareaLength, int iExtendMode, int iLuwToken)
It also accepts a COMMAREA length parameter. This should be set to less than or equal to the length of the byte array passed in via the abytCommarea parameter.
iCallType
- ECI call typestrServer
- CICS server name to make request to (default used if not set)strUserid
- CICS userid to usestrPassword
- CICS password or password phrase to usestrProgram
- CICS program to be run on the serverstrTransid
- CICS transid to be run on the serverabytCommarea
- Byte array containing the COMMAREA to pass to CICSiCommareaLength
- COMMAREA lengthiExtendMode
- ECI extend modeiLuwToken
- ECI LUW tokenpublic ECIRequest(int iCallType, java.lang.String strServer, java.lang.String strUserid, java.lang.String strPassword, java.lang.String strProgram, java.lang.String strTransid, byte[] abytCommarea, int iCommareaLength, int iExtendMode, int iLuwToken, int iMessageQualifier, Callbackable callBack)
iCallType
- ECI call typestrServer
- CICS server name to make request to (default used if not set)strUserid
- CICS userid to usestrPassword
- CICS password or password phrase to usestrProgram
- CICS program to be run on the serverstrTransid
- CICS transid to be run on the serverabytCommarea
- Byte array containing the COMMAREA to pass to CICSiCommareaLength
- COMMAREA lengthiExtendMode
- ECI extend modeiLuwToken
- ECI LUW tokeniMessageQualifier
- Application provided identifiercallBack
- ECI Callbackable object. This may be null if no callback is required.public ECIRequest(java.lang.String strServer, java.lang.String strUserid, java.lang.String strPassword, java.lang.String strProgram, Channel channel, int iExtendMode, int iLuwToken)
strServer
- CICS server name to make request to (default used if not set)strUserid
- CICS userid to usestrPassword
- CICS password or password phrase to usestrProgram
- CICS program to be run on the serverchannel
- Channel with containers to pass to CICSiExtendMode
- ECI extend modeiLuwToken
- ECI LUW tokenpublic ECIRequest(int iCallType, java.lang.String strServer, java.lang.String strUserid, java.lang.String strPassword, java.lang.String strProgram, java.lang.String strTransid, Channel channel, int iExtendMode, int iLuwToken)
It takes a Channel parameter instead of commarea.
iCallType
- ECI call typestrServer
- CICS server name to make request to (default used if not set)strUserid
- CICS userid to usestrPassword
- CICS password or password phrase to usestrProgram
- CICS program to be run on the serverstrTransid
- CICS transid to be run on the serverchannel
- Channel with containers to pass to CICSiExtendMode
- ECI extend modeiLuwToken
- ECI LUW tokenpublic ECIRequest(int iCallType, java.lang.String strServer, java.lang.String strUserid, java.lang.String strPassword, java.lang.String strProgram, java.lang.String strTransid, Channel channel, int iExtendMode, int iLuwToken, int iMessageQualifier, Callbackable callBack)
It takes a Channel parameter instead of commarea.
iCallType
- ECI call typestrServer
- CICS server name to make request to (default used if not set)strUserid
- CICS userid to usestrPassword
- CICS password or password phrase to usestrProgram
- CICS program to be run on the serverstrTransid
- CICS transid to be run on the serverchannel
- Channel with containers to pass to CICSiExtendMode
- ECI extend modeiLuwToken
- ECI LUW tokeniMessageQualifier
- Application provided identifiercallBack
- ECI Callbackable object. This may be null if no callback is required.public static ECIRequest listSystems(int iNumOfSys)
If the flow call is successful, the Vector ECIRequest.SystemsList
contains all the CICS servers defined to the CICS Transaction
Gateway. If the connected Gateway is running on z/OS then any
logical CICS servers are included. Logical CICS servers can
be identified by a prefix of (LS) in the description.
There is no guarantee that a communications link exists between the CICS Transaction Gateway and any server in the list, or that any of the CICS servers are available.
iNumOfSys
- Maximum number of systems to request information onpublic ECIRequest getStatus(java.lang.String strServer)
flow
of
the ECIRequest, the fields: ConnectionType, CicsServerStatus and
CicsClientStatus will have been updated with any information the server
has supplied.strServer
- CICS server name to make request to. If null is specified
the default server defined in the gateway is used.public ECIRequest getStatus(java.lang.String strServer, int iMessageQualifier, Callbackable callBack)
If the parameter callBack is specified, a reply will be sent to the Callback routine when the status information is available. When the Callback routine is invoked the fields: ConnectionType, CicsServerStatus and CicsClientStatus will have been updated with any information the server has supplied. This data is platform independent.
If a Callbackable object is not supplied, then an ECI_GET_SPECIFIC_REPLY with a Message_Qualifier must be done to receive the status information. This is not the recommended way of obtaining status information since the reply will be in platform specific bytes returned in the Commarea and not in the ConnectionType, CicsServerStatus and CicsClientStatus fields.
strServer
- CICS server name to make request to. If null is specified
the default server defined in the gateway is used.iMessageQualifier
- Application provided identifier (optional value)callBack
- ECI Callbackable object. This may be null if no callback is required.public int getCallType()
public java.lang.String getCallTypeString()
The String returned is the name of the appropriate Java constant for example if the Call_Type is ECI_SYNC, then the String returned will be "ECI_SYNC". If the Call_Type is unknown then the String returned will be "ECI_UNKNOWN_CALL_TYPE".
public int getExtendMode()
public java.lang.String getExtendModeString()
The String returned is the name of the appropriate Java constant, for example, if the Extend_Mode is ECI_NO_EXTEND, then the String returned will be "ECI_NO_EXTEND". If the Extend_Mode is unknown then the String returned will be "ECI_UNKNOWN_EXTEND_MODE".
public java.lang.String getConnectionTypeString()
The String returned is the name of the appropriate Java constant, for example, if the ConnectionType is ECI_CONNECTED_TO_CLIENT, then the String returned will be "ECI_CONNECTED_TO_CLIENT". If the ConnectionType is unknown then the String returned will be "ECI_UNKNOWN_CONNECTION_TYPE".
public java.lang.String stringConnectionType(int iConnectionType)
NOTE: the String returned is not the same as the name of the appropriate Java constant e.g. if the ConnectionType is ECI_CONNECTED_TO_CLIENT, the String returned is "ECI connected to client".
iConnectionType
- int representing the Connection Typepublic java.lang.String getServerStatusString()
The String returned is the name of the appropriate Java constant, for example, if the CicsServerStatus is ECI_SERVERSTATE_UP, then the String returned will be "ECI_SERVERSTATE_UP". If the CicsServerStatus is unknown then the String returned will be "ECI_UNKNOWN_SERVER_STATE".
public java.lang.String stringServerStatus(int iCicsServerStatus)
NOTE: the String returned is not the same as the name of the appropriate Java constant e.g. if the CicsServerStatus is ECI_SERVERSTATE_UP, the String returned is "ECI server state up".
iCicsServerStatus
- int representing the Server Statuspublic java.lang.String getClientStatusString()
The String returned is the name of the appropriate Java constant, for example, if the CicsClientStatus is ECI_CLIENTSTATE_UP, then the String returned will be "ECI_CLIENTSTATE_UP". If the CicsClientStatus is unknown then the String returned will be "ECI_UNKNOWN_CLIENT_STATE".
public java.lang.String stringClientStatus(int iCicsClientStatus)
NOTE: the String returned is not the same as the name of the appropriate Java constant e.g. if the CicsClientStatus is ECI_CLIENTSTATE_UP, the String returned is "ECI client state up".
iCicsClientStatus
- int representing the Client Statuspublic int getRc()
public java.lang.String getRcString()
public int getCicsRc()
public java.lang.String getCicsRcString()
The String returned is the name of the appropriate Java constant, for example, if the Cics_Rc is ECI_NO_ERROR, then the String returned will be "ECI_NO_ERROR". If the Cics_Rc is unknown then the String returned will be "ECI_UNKNOWN_CICS_RC".
NOTE: for CICS return codes that may have more than one meaning the String returned is a concatenation of the return codes. The only concatenated String is: ECI_ERR_REQUEST_TIMEOUT_OR_ERR_NO_REPLY
public void setCallback(Callbackable callBack)
If null is passed to this method then it is assumed that no Callbackable object is required.
callBack
- ECI Callbackable object.public boolean isCallback()
public void setCommareaOutboundLength(boolean bOut)
bOut
- boolean indicated whether there is valid Commarea outbound lengthpublic void setCommareaOutboundLength(int iOut) throws java.lang.IllegalArgumentException
iOut
- int representing amount of Commarea to be sentjava.lang.IllegalArgumentException
- if the parameter value is negative
or greater than the maximum commarea lengthpublic boolean isCommareaOutboundLength()
public int getCommareaOutboundLength()
public void setCommareaInboundLength(boolean bIn)
NOTE: Commarea_Length still specifies the size of the Commarea that will be given to CICS, and should be set to the maximum value that the CICS application will require. This method takes one parameter: a boolean, indicating whether the Commarea inbound length is valid. Generally, this method would only be used to set the Commarea inbound length to "false".
bIn
- boolean indicating whether there is valid Commarea inbound lengthpublic void setCommareaInboundLength(int iIn) throws java.lang.IllegalArgumentException
NOTE: Commarea_Length still specifies the size of the Commarea that will be given to CICS, and should be set to the maximum value that the CICS application will require. This method takes one parameter: an int, representing the amount of Commarea to be returned. If this value is negative then an IllegalArgumentException will be thrown; and the current values associated with the Commarea inbound length will not be changed. If this value is positive then this will be used to set a valid inbound length (after which a call to "isCommareaInboundLength()" would return "true").
iIn
- int representing amount of Commarea to be receivedjava.lang.IllegalArgumentException
- if the parameter value is negativepublic boolean isCommareaInboundLength()
public int getCommareaInboundLength()
NOTE: it is necessary to check whether the Commarea inbound length is valid, (using "isCommareaInboundLength()"), before checking the value of the Commarea inbound length.
public boolean isInboundDataLength()
public int getInboundDataLength()
public short getECITimeout()
An ECI timeout value of zero indicates that this ECIRequest will not be timed out by CICS Transaction Gateway. An ECI timeout value greater than zero indicates that this ECIRequest may be timed out by CICS Transaction Gateway. ECI timeout can expire before a response is received from CICS. This means that the client does not receive the confirmation from CICS that a unit of work has been backed out or committed.
For remote mode IPIC, this value can be overridden by the ECITIMEOUT property on the IPIC server definition.
NOTE: This option is not used when issuing a CICS_EciListSystems request.
public void setECITimeout(short sTimeout) throws java.lang.IllegalArgumentException
This method takes one parameter: a short. If this value is positive then it
will be used as the ECI timeout value (in seconds). If this value is negative
then an IllegalArgumentException will be thrown; and the current value of the
ECI timeout will remain unchanged. note that if you want to use explicit numbers
you need to cast them to a short first or Java will complain. eg
ECIRequest.setECITimeout((short)10);
.
An ECI timeout value of zero indicates that this ECIRequest will not be timed out by CICS Transaction Gateway. An ECI timeout value greater than zero indicates that this ECIRequest may be timed out by CICS Transaction Gateway. ECI timeout can expire before a response is received from CICS. This means that the client does not receive the confirmation from CICS that a unit of work has been backed out or committed.
For remote mode IPIC, this value can be overridden by the ECITIMEOUT property on the IPIC server definition.
NOTE: This option is not used when issuing a CICS_EciListSystems request.
sTimeout
- short representing the ECI timeout valuejava.lang.IllegalArgumentException
- if the parameter value is negativepublic boolean isTPNTransid()
This method returns true if the Call_Type is ECI_SYNC_TPN or ECI_ASYNC_TPN.
In order to understand the difference between a Transid field interpreted as an eci_transid, and one interpreted as an eci_tpn, you should refer to CICS Transaction Gateway Information Center. If you do not specify a Transid then the default CICS server transid is used.
public void setAutoMsgQual(boolean newFlag)
If set to true, you do not need to supply a message qualifier for ASYNC type calls which do not provide a callback object. A valid value which won't conflict with any other application (which could occur if you are communicating to a remote gateway server) will be returned from the call You then retrieve this value and use it on GET_SPECIFIC_REPLY and GET_SPECIFIC_REPLY_WAIT requests.
newFlag
- true = turn Auto Message Qualifier generation on.public boolean isAutoMsgQual()
public int getMessageQualifier()
public void setMessageQualifier(int newMsgQual) throws java.lang.IllegalArgumentException
Valid range is -32767 to 32767. If a value outside of this range is passed then an IllegalArgumentException will be thrown.
newMsgQual
- The Message Qualifier to be used for this requestillegalArgumentException
- Thrown if outside of the valid rangejava.lang.IllegalArgumentException
getMessageQualifier()
,
setAutoMsgQual(boolean)
public Channel getChannel()
Channel
associated with the request.Channel