HP NonStop TMF Programming Manual page 135

Commands and Responses
Tokens in Command Buffer
ZTMF-TKN-RmName
specifies the name of the resource manager to be deleted. This token must appear
at least once in the command buffer, and can appear multiple times to delete
multiple resource managers. If multiple resource managers are being deleted 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.
Tokens in Response Buffer
ZTMF-TKN-RmName
specifies the name of the resource manager that was deleted 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-TmfNotStartedf.
If the value specified for ZTMF-TKN-RmName is not a valid resource manager name,
the error returned is ZTMF-ERR-InvRmName.
If no ZTMF-TKN-RmName tokens are supplied in the request, the error returned is
ZTMF-ERR-MustSupplyRmName.
If the specified resource manager name is not registered in the directory, the error
returned is ZTMF-ERR-RmNameNotFound.
If the specified resource manager name is currently open, the error returned is ZTMF-
ERR-RMNameOpen.
If the specified resource manager is currently in a crashed state, the error returned is
ZTMF-ERR-RmNameCrashed. A resource manager is crashed if it is not currently
open, but has unresolved transaction branches associated with it. All such branches
must be resolved before the resource manager name can be deleted from the directory
HP NonStop TMF Management Programming Manual—540140-008
5-71
DELETE RESOURCEMANAGER