VMS Help
XGCP
*Conan The Librarian
|
On OpenVMS Alpha and I64 systems, the XA Gateway Control Program
utility (XGCP) provides the management interface to the DECdtm
XA Gateway and creates the transaction logs used by the DECdtm
XA Gateway. It can also be used to stop and restart the XA
Gateway server.
The Gateway allows a DECdtm-compliant resource manager, such as
RMS Journaling or Oracle Rdb, to be used with an XA-compliant
transaction manager.
The following table summarizes XGCP commands:
Command Description
CREATE_LOG Creates a new XA Gateway log
EXIT Exits XGCP
START_SERVER Starts the XA Gateway server
STOP_SERVER Stops the XA Gateway server
Format
RUN SYS$SYSTEM: XGCP
To invoke XGCP, enter the following command at the DCL prompt:
$ RUN SYS$SYSTEM:XGCP
XGCP displays the following prompt, at which you can enter any
XGCP command:
XGCP>
To exit from XGCP, enter the EXIT command at the XGCP> prompt, or
press Ctrl/Z.
Creates a new XA Gateway log. Requires SYSPRV privilege or
read/write access to the SYS$JOURNAL directory.
Format
CREATE_LOG /GATEWAY_NAME=name /SIZE=size
3.1 - Qualifiers
3. 1.1 - /GATEWAY_NAME
/GATEWAY_NAME=name
This qualifier is required. Specify a gateway name of up to 15
characters.
Creates a gateway log named SYS$JOURNAL:name.DDTM$XG_JOURNAL.
Create a separate Gateway log for each Gateway name under which
you want your XA applications to run.
3. 1.2 - /SIZE
/SIZE=size
Specifies the initial size of the log, in blocks. If you omit
this qualifier, the log is created with an initial size of 242
blocks. The log file is automatically expanded in size when
necessary.
3.2 - Example
XGCP> CREATE_LOG/GATEWAY_NAME=MYLOG1/SIZE=150
The command in this example creates a gateway log named
SYS$JOURNAL:MYLOG1.DDTM$XG_JOURNAL. Its initial size is 150
blocks.
Exits XGCP. You can also press Ctrl/Z to exit from XGCP.
Format
EXIT
Starts the XA Gateway server. Requires IMPERSONATE privilege.
Format
START_SERVER
5.1 - Example
XGCP> START_SERVER
The command in this example executes the DCL command file
SYS$STARTUP:DDTM$XG_STARTUP.COM, which starts the server
process called DDTM$XG_SERVER.
Stops the XA Gateway server process, called DDTM$XG_SERVER, on
the current node.
Requires OPER, SYSPRV and AUDIT privileges.
Format
STOP_SERVER