1  XGCP
   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.
 

2  Commands
   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
 

2  Usage_Summary

   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.
 

2  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 /SIZE=size
 

3  Qualifiers
 

/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.
 

/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  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.
 

2  EXIT
   Exits XGCP. You can also press Ctrl/Z to exit from XGCP.

   Format

     EXIT
 

2  START_SERVER
   Starts the XA Gateway server. Requires IMPERSONATE privilege.

   Format

     START_SERVER
 

3  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.
 

2  STOP_SERVER
   Stops the XA Gateway server process, called DDTM$XG_SERVER, on
   the current node.

   Requires OPER, SYSPRV and AUDIT privileges.

   Format

     STOP_SERVER