*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