XACI Command Reference Manual

● Commands for the XABroker Object
● Commands for the XADef Object
● Commands for the XATrans Object
● Commands for the XASession Object
Commands for the XABroker Object
This object represents the XABroker process on the system. Only one XABroker process can be running per node because
of TMF restriction and the process name is always $XABR. When the XABroker stops, the ACTIVE transactions are
aborted automatically by TMF. The PREPARED transactions must be resolved as fast as possible either by the application
or by the user (using TMFCOM). The user will know when XABroker stops because the application will return an error
code. The TMF will see a XABroker stopped like any other user. It will then flush all transactions except prepared ones. It
will be connected to the restarted XABroker (restarted by MXCS service) and return a list of prepared transactions to be
completed.
INFO XABROKER
This command will display name, state, and attributes of XABroker. The attributes include number of transactions and
sessions, process name, path, maximum number of connections and transactions, message level, domain name, and
version. Some of this info will be displayed only when the detail option is specified on the command line. The operator
can change number of connections and message level. Whereas others require the broker to restart with new options. This
is not a sensitive command and does not support the "*" wild card.
INFO XABROKER [obj-name][, DETAIL];
The obj-name can be:
[[\system-name.]$XABR]
DETAIL
is a flag requesting all attributes. When it is not present, the report provides only the most commonly used
attributes.
XABroker-name
is the name of the XABroker process to be displayed. When the wild card is used the XABroker on the
system is contacted. In this case, it is fixed ($XABR).
Example:
The following commands will display the attributes of the $XABR. The first example is without the detail option and the
second example is with the detail option. Transaction statistics shows the number of active, prepared or heuristically
completed transactions and total transactions on this broker. There are three levels of messages.
ERROR_LVL = 01.
INFO_LVL = 12.
DEBUG_LVL = 23.
0 ------- ERROR messages sent to $0
1 ------- ERROR + INFO