trnlnkrm [[-a name-of-additional-RM-provided-by-other-than-OpenTP1 [, name-of-additional-RM-provided-by-other-than- OpenTP1]...] -s RM-switch-name [, RM-switch-name]... -o 'RM-related-object-name [, RM-related-object-name]...' [, 'RM-related-object-name [, RM-related-object-name]...']...] [-l] [-f]

This command registers the resource managers that are provided by other than OpenTP1 after the resource managers provided by OpenTP1 are registered in the dcsetup command.

-a name-of-additional-RM-provided-by-other-than-OpenTP1 [, name-of-additional-RM-provided-by-other-than-OpenTP1]...~<1-31 character alphanumerics)

Specify the name of the additional resource manager that is provided by other than OpenTP1. Do not specify the resource manager that is provided by OpenTP1.

For the resource manager specified in this option, specify the RM switch name and the RM-related object name.

When specifying more than one RM name, delimit them using commas (,).

-s RM-switch-name [, RM-switch-name]...~<1-32 character alphanumerics beginning with an alphabetic character or underscore>

Specify the switch name of the additional resource manager that is provided by other than OpenTP1.

For switch names, see the specifications of the resource manager to be added. To specify more than one RM switch name, delimit them using commas (,).

The RM switch names and RM names correspond to each other in the sequence they are specified.

-o 'RM-related-object-name [, RM-related-object-name]...' [, 'RM-related-object-name [, RM-related-object-name]...']... ~<alphanumerics>

Specify the name of the object file (for XA interface) that is related to the additional resource manager provided by other than OpenTP1.

Multiple RM-related object names can be specified for a resource manager. For the RM-related object names, see the specifications of the additional resource manager.

To write a comma (,) in an RM-related object name, write a yen mark (\) before the comma.

To specify more than one RM-related object name, delimit them using spaces.

To specify RM-related object names for multiple resource managers, enclose the group of RM-related object names for a resource manager between apostrophes (') and delimit the groups using commas (,).

The RM-related object names and resource managers correspond to each other in the sequence they are specified.

-l

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

-f

Forcibly executes the trnlnkrm command regardless of the OpenTP1 status. However, the trnlnkrm command cannot be forcibly executed while OpenTP1 is online since the transaction service control program and the client service executable program of OpenTP1 are recreated.

Specify this option only when OpenTP1 is terminated other than normally (planned termination A, planned termination B, forced termination, and abnormal termination) and then OpenTP1 is started normally by changing the resource manager to be used.

When the trnlnkrm command with this option is normally terminated, OpenTP1 cannot be restarted.

Write the extended RM registration definition in the Bourne shell (/bin/sh) format.

When more than one trnlnkrm command is written, the commands are executed from the first one.

OpenTP1 cannot be restarted after the trnlnkrm command is normally terminated. OpenTP1 must be started normally.

To specify options using more than one line, insert a continuation symbol (\) between options for linefeed. The command may not be correctly executed if a linefeed is entered in the middle of a specification value of an option (for example, between two RM-related object names when multiple RM-related object names are specified in the -o option).