HELPLIB.HLB  —  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.

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

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

4  –  EXIT

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

    Format

      EXIT

5  –  START_SERVER

    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.

6  –  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
Close Help