Using the OSI TP Administration Utility

Administration of the OSITP functions for Oracle Tuxedo Mainframe Adapter for OSI TP is provided by the osiadmin processor. Administration commands are input from a command line or script file. osiadmin can be run regardless of whether or not the TMA OSI TP process is booted, allowing the user to perform configuration utilities, such as export and import, independently.

The osiadmin processor provides the following features:

•

Imports configurations from eLink OSI TP 1.3 (DMCONFIG, OSITP configuration, and ULS configuration) and creates a comparable configuration in proper format for eLink OSI TP 4.x or Oracle Tuxedo Mainframe Adapter for OSI TP 8.1 or 9.1.

•

Exports the dmconfig file and creates the correct format of the config-in.txt file needed for the UNISYS ClearPath systems.

The osiadmin processor can be initiated in interactive, script, or batch mode. The OSIRUNDIR environment variable must be set in order to run the osiadmin utility. Refer to Setting Environment Variables for more information.

Enter the following interactive command at the command line:

The local domain name (LDOM) may be specified at osiadmin execution time. The LDOM is the LDOM identifier specified in the Local_Domains section of the DMCONFIG file.

osiadmin BA.CENTRAL01

where BA.CENTRAL01 is the LDOM.

The LDOM is necessary for CONNECTIONSTATUS, DUMP, TRACE, TESTCONNECTION, and LISTRDOM commands. If the LDOM is not specified on the command line, the user must enter an LDOM command before using any of these commands.

Enter the following command at the command line:

osiadmin [LDOM]<input_script_name>osiadmin_output

where input_script_name is the name of a script file that you created with a series of one or more commands you wish to execute. If the script file is in a different directory, you must also enter the directory path. The script file is a text file that you can create with any text editor. Following is an example run of a script that might be used with osiadmin:

Enter the following command at the command line:

The "-b" option initiates the osiadmin in batch mode with the following conditions: the menu of commands that is normally displayed upon startup of osiadmin is not printed, pagination is set to off, command echo is set to on, and interactive prompts (for example, "Overwrite file, Y or N") are suppressed.

When you initiate osiadmin or enter any of the other commands in interactive mode, the command executes if the syntax is correct. If the syntax is incorrect, an error message displays showing the correct syntax. When the command executes, results are printed to the screen. If the result is more than one page and PAGINATE=ON (which is the default), the prompt, “CONTINUE? Y or N” displays. Select Y to continue displaying another 20 lines or N to discontinue displaying the results.

At any time after a command has been executed, you can press Enter to redisplay the command syntax as shown by the Help command.

When you initiate osiadmin and enter commands using a script, the commands execute in order and the results are printed to the screen as the commands execute.

All osiadmin commands are initiated through interactive mode or through a script containing one or more commands. The following sections explain how to get Help for osiadmin commands and provide descriptions for each command in detail.

You can request a list of the valid osiadmin commands, request help for specific commands, or display command syntax after a command has been executed.

To display Help in interactive mode:

You can display a list of valid commands by entering the following command at the command line:

To display Help for a specific command:

Enter the following command at the command line:

where command is any of the valid commands.

The exact syntax for the specified command displays.

Following are descriptions of the valid osiadmin commands.

Allows a user to display the connection status for one or more RDOMS or a pattern containing wildcard characters (*). For example, CONNECTIONSTATUS * lists the connection status for all RDOMS. CONNECTIONSTATUS x* lists the connection status for all RDOMS starting with the letter x.

When a wildcard character is used to specify the pattern for the CONNECTIONSTATUS command, only those RDOMs using the same protocol as the current LDOM are considered. For example, if the current LDOM is using the multiplex protocol, only the RDOMS configured with MULTIPLEX=Y are checked for connection status.

Produces a dump of internal TMA OSI TP tables including the NW_BEA and the NW_UNISYS portion of code for diagnostic purposes. If a filename is entered, that file is used for the dump. If the filename is not entered, the default dump file, OSITPDUMP.TXT, is used.

Displays input command lines as they are entered when set to ON. If no option is given, the current setting is toggled and the new setting is printed. The initial setting is OFF.

Exports TMA OSI TP configuration information from the DMCONFIG file and creates configuration files readable by OSI-TP on UNISYS ClearPath servers. The names of the files produced are <output directory>TAILOR-IN.TXT and <output directory>CONFIG-IN.TXT. The output directory is optional. The current directory is the default if none is specified.

Imports the correct configuration information for the TMA gateway by automatically upgrading configurations from version 1.3 of the eLink gateway. importcfg specifies the DMCONFIG file, OSITP configuration file, and the ULS configuration file to be used for input. The DMCONFIG file is used as input to the dmloadcf processor. A DMCONFIG file is created as the output. The ULS-TAILOR and NEW-TAILOR files are optional and are only valid on Unix. If the output file already exists, a message is sent to confirm before overwriting the file. If no parameters are specified, the user is prompted for the filenames.

Note:

OSITP-CONFIGFILE is the source configuration file and not the current.cfg file that was required for older versions of Oracle Tuxedo Mainframe Adapter for OSI TP.

Sets the local domain name. The LDOM must be set for the DUMP, CONNECTIONSTATUS, TRACE, TESTCONNECTION, and LISTRDOM commands. The LDOM can also be specified as an argument when executing the osiadmin.

Retrieves and displays a list of all RDOMs. The list indicates if the RDOMs are offline or online, indicates if the online RDOMs are currently available, and indicates that communications with unavailable RDOMs are not operational. TMA OSI TP will try to establish communications until successful.

When the LISTRDOM command is run, only those RDOMs using the same protocol as the current LDOM are displayed. For example, if the current LDOM is using the multiplex protocol, only the RDOMS configured with MULTIPLEX=Y are listed.

Resets RDOM configured to be offline at startup to online. Once an RDOM is set OFFLINE, it must be manually reset to ONLINE before communications with the peer can continue. All remote services associated with the RDOM will be advertised.

The ONLINERDOM command changes the state of an RDOM to online. The state also immediately changes to available.

If the current LDOM and the specified RDOM are using multiplexed protocol, and the multiplex policy is STARTUP, then TMA OSI TP immediately attempts to establish a connection from the LDOM to the RDOM. If this fails, the state changes to online and unavailable; then connection attempts are retried until successful.

If the current LDOM and the specified RDOM are using multiplexed protocol, and the multiplex policy is DEMAND, then TMA OSI TP does not attempt to establish a connection from the LDOM to the RDOM until it is needed to perform a CALL or CONNECTION. If this later connection fails, the state changes to online and unavailable; then connection attempts are retried until successful.

If the current LDOM and the specified RDOM are using non-multiplexed protocol, then TMA OSI TP immediately attempts to establish a connection from the LDOM to the RDOM. If this later connection fails, the state changes to online and unavailable; then connection attempts are retried until successful.

Turns paginate mode ON or OFF. Default is ON.

Use the TESTCONNECTION command to verify that a connection to the RDOM can be established. This is useful to verify that the configuration is correct and the network is working properly.

If the current LDOM is using multiplexed protocol, this command checks to see if a connection already exists. If so, the command returns immediately indicating success. If no connection exists, this command attempts to establish a new connection and waits for the result before returning. The new connection is left open for future use.

If the current LDOM is using non-multiplexed protocol, this command attempts to establish a new connection and waits for the result before returning. Then the new connection is closed.

Sets trace levels in TMA OSI TP for diagnostics and debugging purposes. When TRACE is set to ON, messages are written to the Tuxedo ULOG. If the TRACE command is entered without any options, it returns the current trace level.