trnrmid (Specify resource manager extension)

The trnrmid command defines the extension of a resource manager to be accessed by user servers when more than one resource manager extension is assigned to the resource manager so that it can be accessed as more than one control unit (that is, when the -i option is specified in the trnstring command for the resource manager of the transaction service definition).

If the -i option is specified, the OpenTP1 system modifies the resource manager name to a resource manager name + resource manager extension to control the manager. This means that a user server cannot access the resource manager by its name alone. It is necessary to define the trnrmid command.

The OpenTP1 transaction service executes a transaction in collaboration with the resource manager through the X/Open XA interface. The XA interface must report the xa_open function character string and xa_ close function character string that are defined by the resource manager.

If the user server accesses the resource manager provided by a system other than OpenTP1 within a transaction under OpenTP1 (that is, if the trnmkobj command is executed to specify a resource manager provided by a system other than OpenTP1, and this resource manager creates a transaction control object file and links with the user server), specify the xa_ open function character string and xa_close function character string for that resource manager. The xa_open and xa_close functions are issued by the transaction service with the specified characters strings used as arguments at startup and termination of the user server, and at transaction recovery processing.

The resource manager extension specified in the -i option must be the same as specified in the transaction service definition.

This command need not be defined if it is unnecessary to assign more than one resource manager extension to one resource manager and to access it as more than one control unit (that is, when the -i option is omitted in the trnstring command for the resource manager in the transaction service definition).

If more than one trnstring command for the same resource manager extension is specified under the same resource manager name within one definition file, only the last definition specified is valid.

When OpenTP1 provides the resource, specify this definition for OpenTP1_MCF only.

-n resource-manager-name~<1-31 character identifier>

Specify the name of the resource manager (resource manager name that is specified using the trnstring command in the transaction service definition) the current user server accesses. When OpenTP1 provides the resource, you can omit this specification except for OpenTP1_MCF. However, you can omit the specification of OpenTP1_MCF for the following case:

When the id operand is omitted in the mcfmenv command of the MCF manager environment definition or when A is specified in the operand

-i resource-manager-extension~<1-2 character identifier>

Specify the extension of the resource manager (the resource manager extension specified by the trnstring command of the transaction service definition).

If more than one extension is specified, a comma (,) must be placed between extensions.

In order to control an MCF relating to transactions, the resource manager extensions for that MCF must be specified. The extension specified in the -i option must be the same as that for MCF specified in the MCF transaction service definition.