|
VMS Help XGCP *Conan The Librarian |
On OpenVMS Alpha systems, the XA Gateway Control Program (XGCP)
utility 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. 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.
| 1 - CREATE_LOG |
Creates a new XA Gateway log. Requires SYSPRV privilege or
read/write access to the SYS$JOURNAL directory.
Format
CREATE_LOG /GATEWAY_NAME=name
1.1 - Qualifiers
1. 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:SYSTEM$name.DDTM$XG_
JOURNAL. Create a separate log for each node of an OpenVMS
Cluster system.
1. 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.
1.2 - Example
XGCP> CREATE_LOG/GATEWAY_NAME=MYLOG1/SIZE=150
The command in this example creates a gateway log named
SYS$JOURNAL:SYSTEM$MYLOG1.DDTM$XG_JOURNAL. Its initial size
is 150 blocks.
| 2 - EXIT |
Exits XGCP. You can also press Ctrl/Z to exit from XGCP.
Format
EXIT
| 3 - START_SERVER |
Starts the XA Gateway server. Requires the IMPERSONATE privilege.
Format
START_SERVER
3.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.
| 4 - STOP_SERVER |
Stops the XA Gateway server process called DDTM$XG_SERVER.
Requires the OPERATOR privilege.
Format
STOP_SERVER
|
|