PURPOSE

GWADM - /Domain gateway administrative server

SYNOPSIS

GWADM SRVGRP = "identifier"
SRVID = "number"
REPLYQ = "N"
      CLOPT = "-A --
[-a { on | off } ]
[-t { on | off } ]"

DESCRIPTION

The gateway administrative server (GWADM) is a TUXEDO System-supplied server that provides administrative functions for a /Domain gateway group.

GWADM should be defined in the *SERVERS section of the UBBCONFIG file as a server running within a particular gateway group, that is, SRVGRP must be set to the corresponding GRPNAME tag specified in the *GROUPS section. The SVRID parameter is also required and its value must consider the maximum number of gateways allowed within the gateway group.

There should be only one instance of a GWADM per /Domain gateway group, and it should NOT be part of the MSSQ defined for the gateways associated with the group. Also, GWADM should have the REPLYQ attribute set to N.

The CLOPT option is a string of command line options that is passed to the GWADM when it is booted. This string has the following format:

     CLOPT="-A -- <gateway group runtime parameters>"

The following runtime parameters are recognized for a gateway group:

-a { on | off }

This option turns off or on the audit log feature for this local domain. The default is off. The dmadmin program can be used to change this setting while the gateway group is running (see dmadmin(1)).

-t { on | off }

This option turns off or on the statistics gathering feature for the local domain. The default is off. The dmadmin program can be used to change this setting while the gateway group is running (see dmadmin(1)).

The GWADM server must be booted before the corresponding gateways.

PORTABILITY

GWADM is supported a TUXEDO System-supplied server on UNIX System operating systems.

INTEROPERABILITY

GWADM must be installed on a TUXEDO System Release 4.2.1 or later; other nodes in the same domain with an R4.2.2 gateway can be Release 4.1 or later.

EXAMPLES

The following example illustrates the definition of the administrative server in the UBBCONFIG file.

#
*GROUPS
DMADMGRP  GRPNO=1
gwgrp    GRPNO=2
#
*SERVERS
DMADM SRVGRP="DMADMGRP" SRVID=1001 REPLYQ=N RESTART=Y GRACE=0
GWADM SRVGRP="gwgrp" SRVID=1002 REPLYQ=N RESTART=Y GRACE=0
      CLOPT="-A -- -a on -t on"
GWTDOMAIN SRVGRP="gwgrp" SRVID=1003 RQADDR="gwgrp" REPLYQ=Y RESTART=Y MIN=1 MAX=1

SEE ALSO

dmadmin(1),
tmboot(1),
dmconfig(5),
DMADM(5),
servopts(5),
ubbconfig(5),
BEA TUXEDO Administrator's Guide
BEA TUXEDO /Domain Guide