TMF Management Programming Manual (G06.24+)

Commands and Responses
HP NonStop TMF Management Programming Manual—522420-002
5-25
ADD RESOURCEMANAGER
Tokens in Command Buffer
ZTMF-TKN-RMNAME
specifies the name of a resource manager to be added to the resource manager
directory. This token must appear at least once in the command buffer, and can
appear multiple times to add multiple resource managers. If multiple resource
managers are being added by a single command, the result of the operation is
returned in a separate response record for each resource manager name.
Resource manager names can have a maximum length of 128 characters. The
first character must be a letter, and the others can be alphanumeric or any of the
following special characters:
$ _ - ^ @ &
Names beginning with the string ZZ-VOLATILE- are reserved, and therefore not
allowed for this command. Names containing adjoining hyphens (--) are not
allowed, although names using multiple hyphens separated by one or more
intervening characters are legal. Thus, the name “ALPHA--1” is not permitted, but
“ALPHA-N-1” is allowed.
ZTMF-TKN-RMOWNERID
specifies the userid that will own the resource manager. The specified userid is
used to restrict programmatic access to and removal of the resource manager by
gateway processes. Only gateway processes running under a resource manager’s
owner userid or one of the super group userids will be allowed to open or remove
the resource manager.
Tokens in Response Buffer
ZTMF-TKN-RMNAME
specifies the name of the resource manager that was added to the directory or
resulted in an error, depending upon the value of ZSPI-TKN-RETCODE in the data
or error list.
Usage Guidelines
Only super-group users can issue this command.
TMF must be started for this command to execute successfully. If TMF is not started,
the error returned is ZTMF-ERR-TMFNOTSTARTED.
If the value specified for ZTMF-TKN-RMNAME is not a valid resource manager name,
the error returned is ZTMF-ERR-INVRMNAME.
If the specified resource manager name is already registered in the directory, the error
returned is ZTMF-ERR-RMNAMEDUPLICATE.