trnlnkrm {[-A OpenTP1-RM-name-to-be-added [,OpenTP1-RM-name-to-be-added]...] [-D OpenTP1-RM-name-to-be-deleted [,OpenTP1-RM-name-to-be-deleted]...] [-a non-OpenTP1-RM-name-to-be-added [,non-OpenTP1-RM-name-to-be-added]...] -s RM-switch-name [,RM-switch-name]... -o 'RM-related-object-name [RM-related-object-name]...' [,'RM-related-object-name [RM-related-object-name]...']...] [-d non-OpenTP1-RM-name-to-be-deleted [,non-OpenTP1-RM-name-to-be-deleted]...] |[-n]} [-C 'compile-option-name[compile-option-name]...'] [-B 'linkage-option-name[linkage-option-name]...'][-l][-f][-P]

The trnlnkrm command adds or deletes resource managers used under OpenTP1, and recreates a transaction service control execution-form program and a client service execution-form program and a standard transaction control object file (dc_trn_allrm.o).

When an OpenTP1 program product is installed, XA interface object files provided by resource managers have not been linked with the transaction service control execution-form program and a client service execution-form program. When executed, the dcsetup command determines the installed OpenTP1 program product and automatically links XA interface object files for the OpenTP1 resource managers (DAM, TAM, MCF, ISAM, and MQA) with OpenTP1 resource manager. In order for a transaction executing under OpenTP1 to access non-OpenTP1 resource managers, the trnlnkrm command must be executed to catalog the non-OpenTP1 resource managers after execution of the dcsetup command and before startup of OpenTP1, thereby recreating a transaction service control execution-form program and a client service execution-form program. For using non-Hitachi databases, see the manual OpenTP1 Programming User's Guide.

Up to 32 resource managers can be cataloged under OpenTP1.

XA interface object files for all resource managers to be accessed by UAPs operating under OpenTP1 must be linked with the transaction service control execution-form program and a client service execution-form program. Otherwise, an error (dc_rpc_open error) occurs at startup of a UAP that is accessing a resource manager not linked with OpenTP1.

The trnlnkrm command cannot be executed when OpenTP1 in the online mode.

If OpenTP1 is on restart status, the -f option must be specified in the trnlnkrm command. Once the trnlnkrm command with its -f option specified has been normally terminated, OpenTP1 is no longer be restarted.

If the resource manager registration status is changed with the trnlnkrm command, the UAP to which a standard transaction control object file has been linked requires linkage again.

The trnlnkrm command searches for the target C compiler in the following sequence:

1. /bin/cc and /lib/ccom
   Both /bin/cc and /lib/ccom are required.
   
2. /usr/bin/cc
3. /usr/vac/bin/cc

If the target C compiler is not found in the above search sequence, OpenTP1 assumes the setting specified in the PATH environment variable of the process that executes the trnlnkrm command. The -P option must be specified when the user wants to use the value specified in the environment variable (PATH).

-A OpenTP1-RM-name-to-be-added~<1-31 alphanumeric characters>

Specifies the name of a resource manager provided by OpenTP1 that is to be added. The OpenTP1 resource managers are:

OpenTP1_DAM

TP1/FS/Direct Access resource manager

OpenTP1_TAM

TP1/FS/Table Access resource manager

OpenTP1_MCF

TP1/Message Control resource manager

OpenTP1_MQA

TP1/Message Queue resource manager

OpenTP1_ISM

ISAM/B resource manager

The RM switch name and RM-related object name need not be specified for resource managers specified by the -A option. More than one RM name can be specified, with a comma (,) placed between names.

-D OpenTP1-RM-name-to-be-deleted~<1-31 alphanumeric characters>

Specifies the name of a resource manager provided by OpenTP1 that is to be deleted. The OpenTP1 resource managers are:

OpenTP1_DAM

TP1/FS/Direct Access resource manager

OpenTP1_TAM

TP1/FS/Table Access resource manager

OpenTP1_MCF_A

TP1/Message Control resource manager

OpenTP1_MQA

TP1/Message Queue resource manager

OpenTP1_ISM

ISAM/B resource manager

The RM switch name and RM-related object name need not be specified for resource managers specified by the -D option. More than one RM name can be specified, with a comma (,) placed between names.

-a non-OpenTP1-RM-name-to-be-added~<1-31 alphanumeric characters>

Specifies the name of an additional resource manager not provided by OpenTP1. Do not specify a resource manager provided by OpenTP1.

The RM switch name and RM-related object name must be specified for resource managers specified by the -a option. More than one RM name can be specified, with a comma (,) placed between names.

-s RM-switch-name~<1-32 alphanumeric characters beginning with an alphabetic character or an underscore>

Specifies the name of a resource manager switch to be added. For the switch names, see the applicable resource manager specifications. More than one RM switch name can be specified, with a comma (,) placed between names. The RM switch names correspond to the RM names in the order they are specified.

-o RM-related-object-name~<alphanumeric characters>

Specifies the name of an object file (for the XA interface) related to the non-OpenTP1 resource manager to be added.

More than one RM-related object name can be specified for one resource manager. For the RM-related object names, see the applicable resource manager specifications.

If commas (,) need be specified for RM-related object files, '\' must be placed before the comma. More than one RM-related object file name can be specified, with a space placed between names.

When RM-related object file names are specified for multiple resource managers, the set of the RM-related object names for one resource manager must be enclosed in single quotation marks (') and a comma (,) placed between sets.

The RM-related object names correspond to the RM names in the order they are specified.

-d non-OpenTP1-RM-name-to-be-deleted~<1-31 alphanumeric characters>

Specifies the name of a non-OpenTP1 resource manager to be deleted. In no case must OpenTP1 resource managers be specified in this option.

The RM switch name and RM-related object name need not be specified for any resource manager specified in this option. More than one RM name can be specified, with a comma (,) placed between names.

-n

Recreates a transaction service control execution-form program and client service execution-form program without changing the resource managers cataloged into OpenTP1.

-C compile-option-name~<string of 1-512 characters>

Specifies the compile option to be used when compilation is executed.

Enclose the compile option name in single quotation marks ('). If you need to include a comma (,) in the compile option name, insert a backslash (\) before the comma.

When you specify multiple compile option names, use spaces to delimit them.

Under normal circumstances, there is no need to specify this option.

-B linkage-option-name~<string of 1-512 characters>

Specifies the linkage option to be used when library linkage is performed.

Enclose the linkage option name in single quotation marks ('). If you need to include a comma (,) in a linkage option name, insert a backslash (\) before the comma.

When you specify multiple linkage option names, use spaces to delimit them. Because the trnlnkrm command uses the cc command to perform linkage, the linkage options you specify in the trnlnkrm command must be options that can be specified in the cc command.

Under normal circumstances, there is no need to specify this option.

-l

Outputs the progress of executing the trnlnkrm command to the standard output.

-f

Forcibly executes the trnlnkrm command independently of the OpenTP1 status. However, the command cannot be executed while OpenTP1 is online mode because of recreating an OpenTP1 transaction service execution-form program and a client service execution-form program.

The trnlnkrm command can be specified only when OpenTP1 is to be normally started, with the resource managers changed, after non-normal termination (that is, planned termination A, planned termination B, forced termination, or abnormal termination).

Once the command with this option specified has normally terminated, OpenTP1 can no longer be restarted.

-P

A C compiler is selected according to the value specified in the PATH environment variable for the trnlnkrm command execution process. The trnlnkrm command looks for "cc" in the order specified in PATH and use the first "cc" encountered.

When none of the options is specified, the method for specifying the trnlnkrm command is output to the standard output.

• Once the trnlnkrm command has normally terminated, OpenTP1 can no longer be restarted; normal startup is only the method to start OpenTP1.
• When options are specified over more than one line, place the continuation mark '\' between options and perform a line feed. If a line feed is performed within the specified value of an option (for example, between RM-related object names specified in the -o option), the command may operate incorrectly.