TMF Management Programming Manual (G06.24+)

Commands and Responses
HP NonStop TMF Management Programming Manual—522420-002
5-58
CLOSE RESOURCEMANAGER
Tokens in Command Buffer
ZTMF-TKN-RMNAME
specifies the name of the resource manager to be closed. This token must appear
at least once in the command buffer, and can appear multiple times to close
multiple resource managers. If multiple resource managers are being closed 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 closed 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 is not currently open, the error returned is ZTMF-
ERR-RMNAMENOTOPEN.
If no ZTMF-TKN-RMNAME tokens are supplied in the request, the error returned is
ZTMF-ERR-MUSTSUPPLYRMNAME.
If the value specified for ZSPI-TKN-CONTEXT token is not valid, the error returned is
ZTMF-ERR-INVALIDCONTEXT.