imsadmin supports the following options:

[-p <profile>]

The name of the security profile used for authentication. This parameter is needed when Oracle Tuxedo security is enabled. Two types of security profile are supported: Oracle Wallet and profile created by genimsprofile.

For Oracle Wallet profile:

• you need to create an Oracle Wallet using Oracle utility "orapki" or "mkstore" in advance. See Authentication Configuration in the Oracle Tuxedo Application Runtime for IMS User Guide for more details.
• Oracle wallet profile name is prefixed with "file:" string and followed by a directory name pointing to the location of an Oracle Wallet. For example: file:/path/to/wallet

If no file name is provided, it defaults to ~/.tuxAppProfile.

Note:

When security level is set to MANDANTORY_ACL, to ensure imsadmin successfully transmits reloading request to Tuxedo ART for IMS servers, you must make sure the username in the profile has access permission to the services named “..IMSADM _grpid_svrid”, where the grpid/svrid represents every Tuxedo ART for IMS MPP/BMP corresponding group id and server id.

-l PGM1, PGM2

Specifies names of the COBOL programs that need to be reloaded. The program names are separated by commas.

Note:

The maxi program numbers for one command line is 128. The program maximum name length is 8 bytes.

-u

Updates the configuration.

-c

Verifies the configuration.

-d <directory>

Specifies the directory of the new configuration files. This directory must be on the master machine.

-x flushperf|cleanperf|enableperf|disableperf

Used to dynamically control performance trace. Each action function is listed as follows:

flushperf: Flushes the performance trace into log files.

cleanperf: Cleans up the performance trace log files.

enableperf: Enables performance trace.

disableperf: Disables performance trace.

-x settracelevel number

Specifies the debug trace level.

Number:

-1: Trace off

0: Function stack trace

1: Function stack trace + execution flow trace

2: Function stack trace + execution flow trace + data convert trace

[-m machine]

Specifies the machine logic name.

[-g groupid]

Specifies group id.

[-s serverid]

Specifies server id.

If machine, groupid, and serverid parameter are not specified, the action is applied to all applicable servers specified in the UBBCONFIG SERVERS section. Once you specify one or more parameters, the action is only applied to the servers specified.

The applicable server includes ARTIMPP*/ARTIBMP*/ARTIGW/ARTIADM. Currently, this feature does not support dynamic trace control for ARTICTL/ARTICTLH.

Note:

If flushperf or cleanperf are specified, -m, -g and -s are be omitted, since these two actions apply to all applicable servers.

Debug tracing is automatically disabled when performance trace is enabled.

[-v]

Displays the imsadmin tool version and bit mode.

[-h]

Displays usage help information.

-t

Runs in test mode to check whether local configuration files are correct and whether specific programs are existed (only checks entry points). All configuration files except for imsresource.desc and all programs configured in imsapps.desc are checked.