•
• The /DOMAIN administrative server DMADM is a Tuxedo-supplied server that provides run-time access to the BDMCONFIG file. When DMADM is booted, the BDMCONFIG environment variable should be set to the pathname of the file containing the binary version of the DMCONFIG file.DMADM is described in the *SERVERS section of the UBBCONFIG file as a server running within a group, e.g., DMADMGRP. There should be only one instance of the DMADM running in this group and it must not have a reply queue (REPLYQ must be set to “N”).The following server parameters can also be specified for the DMADM server in the *SERVERS section: SEQUENCE, ENVFILE, MAXGEN, GRACE, RESTART, RQPERM and SYSTEM_ACCESS.DMADM is supported as a Tuxedo-supplied server on non-/WS System operating systems.The following example illustrates the definition of the administrative server and a gateway group in the UBBCONFIG file.dmadmin is an interactive command interpreter used for the administration of domain gateway groups defined for a particular OSITP application. dmadmin can operate in two modes: administration mode and configuration mode.dmadmin enters administration mode when called with no parameters. This is the default. In this mode, dmadmin can be run on any active node (excluding workstations) within an active application. Application administrators can use this mode to obtain or change parameters on any active domain gateway group.
Note: dmadmin is one of the three methods you can use to modify your configuration. Refer to “Methods for Modifying Configurations” for more information.Application administrators may also use this mode to create, destroy, or reinitialize the DMTLOG for a particular local domain. In this case, the domain gateway group associated with that local domain must not be active, and dmadmin must be run on the machine assigned to the corresponding gateway group.dmadmin enters configuration mode when it is invoked with the -c option or when the config subcommand is invoked. Application administrators can use this mode to update or add new configuration information to the binary version of the domain configuration file BDMCONFIG.dmadmin requires the use of the DOMAIN administrative server DMADM for the administration of the BDMCONFIG file and the gateway administrative server GWADM for the re-configuration of active DOMAIN gateway groups (there is one GWADM per gateway group).Once dmadmin has been invoked, commands may be entered at the prompt (“>”) according to the following syntax:Commands may be entered either by their full name or their abbreviation (shown in parentheses) followed by any appropriate arguments. Arguments appearing in square brackets, [], are optional; those in curly braces, {}, indicate a selection from mutually exclusive options. Note that for many commands local_domain_name is a required argument, but note also that it can be set with the default command.Add local user mappings to remote user mappings for a local/remote domain pair. Mappings are defined to be inbound, outbound or both. See the addumap manual page for an explanation of the available options and for examples.Add remote usernames and passwords to the remote user and password tables of a remote domain. See the addusr manual page for an explanation of the available options and for examples.Activate (on) or deactivate (off) the audit trace for the named local domain. If no option is given, then the current setting will be toggled between the values on and off, and the new setting will be printed. The initial setting is off.Enter configuration mode. Commands issued in this mode follow the conventions defined in the section “CONFIGURATION MODE COMMANDS” on page A‑7.Create the domain transaction log for the named local domain on the current machine (that is, the machine where dmadmin is running). The command uses the parameters specified in the DMCONFIG file. This command fails if the named local domain is active on the current machine or if the log already exists.If the default command is entered with no arguments, the current default values are printed.Delete local to remote user mappings for a local/remote domain pair. See the delumap manual page for an explanation of the available options and for examples.Delete remote usernames and passwords from the remote user and password tables of a remote domain. See the delusr reference page for an explanation of the available options and for examples.Destroy the domain transaction log for the named local domain on the current machine (that is, the machine where dmadmin is running). An error is returned if a DMTLOG is not defined for this local domain, if the local domain is active, or if outstanding transaction records exist in the log. The term outstanding transactions means that a global transaction has been committed but an end-of-transaction has not yet been written. This command prompts for confirmation before proceeding unless the -y option is specified.Echo input command lines when set to on. If no option is given, then the current setting is toggled, and the new setting is printed. The initial setting is off.Forget one or all heuristic log records for the named local domain. If the transaction identifier tran_id is specified, then only the heuristic log record for that transaction will be forgotten. The transaction identifier tran_id can be obtained from the printtrans command or from the ULOG file.Print help messages. If command is specified, the abbreviation, arguments, and description for that command are printed. Omitting all arguments causes the syntax of all commands to be displayed.Reinitialize the domain transaction log for the named local domain on the current machine (that is, the machine where dmadmin is running). An error is returned if a DMTLOG is not defined for this local domain, if the local domain is active, or if outstanding transaction records exist in the log. The term outstanding transactions means that a global transaction has been committed but an end-of-transaction has not yet been written. The command prompts for confirmation before proceeding unless the -y option is specified.Prompts the administrator for new passwords for the specified local and remote domains. The -r option specifies that existing passwords and new passwords should be encrypted using a new key generated by the system. The password is truncated after at most eight characters. The TMA OSI TP gateway must be shut down and restarted for new passwords to take effect.printdomain (pd) –d local_domain_nameprintstats (stats) –d local_domain_nameprinttrans (pt) –d local_domain_nameActivate (on), deactivate (off), or reset (reset) statistics gathering for the named local domain. If no option is given, then the current setting will be toggled between the values on and off, and the new setting will be printed. The initial setting is off.! shellcommandEscape to shell and execute shellcommand.The dmadmin command enters configuration mode when executed with the -c option or when the config subcommand is used. In this mode, dmadmin allows run-time updates to the BDMCONFIG file. dmadmin manages a buffer that contains input field values to be added or retrieved, and displays output field values and status after each operation completes. The user can update the input buffer using any available text editor.dmadmin first prompts for the desired section followed by a prompt for the desired operation.The number of the default section appears in square brackets at the end of the prompt. You can accept the default by pressing RETURN or ENTER. To select another section enter its number, then press RETURN or ENTER.dmadmin then prompts for the desired operation.The number of the default operation is printed in square brackets at the end of the prompt. Pressing RETURN or ENTER selects this option. To select another operation enter its number, then press RETURN or ENTER.Add the indicated record in the specified section. Any fields not specified (unless required) take their default values as specified in dmconfig. The current value for all fields is returned in the output buffer. This operation can only be done by the System/T administrator.Clear the input buffer (all fields are deleted). After this operation, dmadmin immediately prompts for the section again.Exit the program gracefully (dmadmin is terminated). A value of q for any prompt also exits the program.For configuration operations, the effective user identifier must match the System/T administrator user identifier UID for the machine on which this program is executed. When a record is updated or added, all default values and validations used by udmloadcf are enforced.dmadmin then prompts whether or not to edit the input buffer.Entering a value of y will put the input buffer into a temporary file and execute the text editor. The environment variable EDITOR is used to determine which editor to be used; the default is “ed”. The input format is in field name/field value pairs and is described in the CONFIGURATION INPUT FORMAT section that follows. The field names associated with each DMCONFIG section are listed in tables in the subsections that follow. The semantics of the fields and associated ranges, default values, restrictions, etc., are described in dmconfig. In most cases, the field name is the same as the KEYWORD in the DMCONFIG file, prefixed with “TA_DM”. When the user completes editing the input buffer, dmadmin reads it. If more than one line occurs for a particular field name, the first occurrence is used and other occurrences are ignored. If any errors occur, a syntax error will be printed and dmadmin prompts whether or not to correct the problem.If the problem is not corrected (response n), then the input buffer will contain no fields. Otherwise, the editor is executed again.Finally, dmadmin asks if the operation should be done.When the operation completes, dmadmin prints the return value as inWhen “QUIT” is selected, dmadmin prompts for authorization to create a backup ASCII version of the configuration:If a backup is selected, dmadmin prompts for the file name.On success, dmadmin indicates that a backup was created, otherwise an error is printed.To enter an unprintable character in the field value or to start a field value with a tab, use a backslash followed by the two-character hexadecimal representation of the desired character. A space, for example, can be entered in the input data as \20. A backslash can be entered using two backslash characters. dmadmin recognizes all input in this format, but its greatest usefulness is for non-printing characters.The following sections describe, for each DMCONFIG section, what the field identifiers are for each DMCONFIG field, what the field type of the identifier is, and when the field can be updated. All applicable field values are returned with the retrieval operations. Fields that are allowed and/or required for adding a record are described in dmconfig. The following fields indicated as key are key fields that are used to uniquely identify a record within section. These key fields are required to be in the input buffer when updates are done and are not allowed to be updated dynamically. The Update column indicates when a field can be updated. The possible values areThe following table lists the fields in the DM_LOCAL_DOMAINS section.
Refer to the “DM_LOCAL_DOMAINS Section” in “Understanding the DMCONFIG File” for information about some of these fields information.The following table lists the fields in the DM_REMOTE_DOMAINS section.
Refer to the “DM_REMOTE_DOMAINS Section” in “Understanding the DMCONFIG File” for related information about some of these fields.The DM_OSITPX section contains the network addressing parameters required by OSITP type domains. The following lists the fields in this section:
TA_LDOM or TA_RDOM If the domain identifier (TA_LDOM) is a local domain identifier, then the other fields in this table can be updated if the gateway group representing that local domain is not running.Refer to the “DM_OSITPX Section” in “Understanding the DMCONFIG File” for related information about some of these fields.The following table lists the fields in the DM_LOCAL_SERVICES section.
Refer to the “DM_LOCAL_SERVICES Section” in “Understanding the DMCONFIG File” for related information about some of these fields.The following table lists the fields in the DM_REMOTE_SERVICES section.
Refer to the “DM_REMOTE_SERVICES Section” in “Understanding the DMCONFIG File” for related information about some of these fields.The following table lists the fields in the DM_ROUTING section.
The following table lists the fields in the DM_ACCESS_CONTROL section.
Refer to the “DM_ACCESS_CONTROL Section” in “Understanding the DMCONFIG File” for related information.CONFIGURING THE DM_PASSWORDS SECTIONThe following table lists the fields in the DM_PASSWORDS section.
The TA_LPWD and TA_RPWD show the existence of a defined password for the local and/or the remote domain. Passwords are not displayed. If an UPDATE operation is selected, the value of the corresponding field must be set to U. The program will then prompt with echo turned off for the corresponding passwords.dmadmin fails if it cannot allocate an FML typed buffer, if it cannot determine the /etc/passwd entry for the user, or if it cannot reset the environment variables FIELDTBLS or FLDTBLDIR.The return value printed by dmadmin after each operation completes indicates the status of the requested operation. There are three classes of return values.The calling process specified an ADD, UPDATE, or DELETE operation but it is not running as the System/T administrator. Update operations must be run by the administrator (that is, the user specified in the UID attribute of the RESOURCES section of the TUXCONFIG file).The following return values indicate a problem in doing the operation itself and generally are semantic problems with the application data in the input buffer. The string field TA_STATUS will be set in the output buffer and will contain short text describing the problem. The string field TA_BADFLDNAME will be set to the field name for the field containing the value that caused the problem (assuming the error can be attributed to a single field).An error occurred while reading the BDMCONFIG file.The operation succeeded. No updates were done to the BDMCONFIG file.The operation succeeded. Updates were made to the BDMCONFIG file.When using dmunloadcf to print entries in the configuration, optional field values are not printed if they are not set (for strings) or 0 (for integers). These fields will always appear in the output buffer when using dmadmin. In this way, it makes it easier for the administrator to retrieve an entry and update a field that previously was not set. The entry will have the field name followed by a tab but no field value.In the following example, dmadmin is used to add a new remote domain. For illustration purposes, ed is used for the editor.If dmadmin is run with the application administrator’s UID, it assumes a trusted user and Security is bypassed. If dmadmin is run with another user ID, and if the security option is enabled in the TUXCONFIG file, then the corresponding application password is required to start the dmadmin program. If standard input is a terminal, then dmadmin will prompt the user for the password with echo turned off. If standard input is not a terminal, the password is retrieved from the environment variable, APP_PW. If this environment variable is not specified and an application password is required, then dmadmin will fail to start.dmadmin resets the FIELDTBLS and FLDTBLDIR environment variables to pick up the ${TUXDIR}/udataobj/dmadmin field table. Hence, the TUXDIR environment variable should be set correctly.If the application requires security and the standard input to dmadmin is not from a terminal, then the APP_PW environment variable must be set to the corresponding application password.The TUXCONFIG environment variable should be set to the pathname of the OSITP configuration file.If the dmadmin command is entered before the system has been booted, the following message is displayed:dmadmin then prompts for the corresponding commands.GWADM SRVGRP = “identifier” SRVID = “number” REPLYQ = “N”
CLOPT = “-A -- [-a {on | off}] [-s services]
[-t {on | off}]“The gateway administrative server GWADM is a Tuxedo-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: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).-s servicesSpecifies the remote services that should be initially offered by the domain gateway. The specifications for these services are found in the DMCONFIG file. For example, the specificationimplies that the gateway should initially advertise remote services x, y, and z. Spaces are not allowed between commas and the -s option may appear several times.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).GWADM is supported on Tuxedo-supplied servers, using non-/WS operating systems.The following example illustrates the definition of the administrative server in the UBBCONFIG file.dmadmin, tmboot