TMF Management Programming Manual (H06.06+, J06.03+)
Table Of Contents
- HP NonStop TMF Management Programming Manual
- Legal Notices
- Contents
- What’s New in This Manual
- About This Manual
- 1 Introduction to TMF
- 2 Communicating With the TMFSERVE Process
- 3 SPI Programming Considerations for TMF
- 4 Common Definitions
- 5 Commands and Responses
- Command Summary
- Command Descriptions
- ABORT TRANSACTION
- ADD AUDITTRAIL
- ADD DATAVOLS
- ADD DUMPS
- ADD MEDIA
- ADD RESOURCEMANAGER
- ALTER AUDITDUMP
- ALTER AUDITTRAIL
- ALTER BEGINTRANS
- ALTER CATALOG
- ALTER DATAVOLS
- ALTER DUMPS
- ALTER MEDIA
- ALTER PROCESS
- ALTER TMF
- CANCEL OPERATION
- CLOSE RESOURCEMANAGER
- DELETE CATALOG
- DELETE DATAVOLS
- DELETE DUMPS
- DELETE MEDIA
- DELETE RESOURCEMANAGER
- DELETE TMF
- DELETE TRANSACTION
- DISABLE AUDITDUMP
- DISABLE BEGINTRANS
- DISABLE DATAVOLS
- DUMP FILES
- ENABLE AUDITDUMP
- ENABLE BEGINTRANS
- ENABLE DATAVOLS
- INFO ATDUMPDM
- INFO ATVOLUME
- INFO AUDITDUMP
- INFO AUDITTRAIL
- INFO BEGINTRANS
- INFO CATALOG
- INFO DATAVOLS
- INFO DUMPS
- INFO MEDIA
- INFO PROCESS
- INFO RESOURCEMANAGER
- INFO TMF
- LIST AUDITTRAIL
- NEXT AUDITTRAIL
- RECOVER FILES
- RELOCATE DISKDUMPS
- RESOLVE TRANSACTION
- START TMF
- STATUS ATFILE
- STATUS AUDITDUMP
- STATUS AUDITTRAIL
- STATUS BEGINTRANS
- STATUS CATALOG
- STATUS DATAVOLS
- STATUS OPERATION
- STATUS RESOURCEMANAGER
- STATUS RMTRANSBRANCHES
- STATUS TMF
- STATUS TMFSERVER
- STATUS TRANSACTION
- STATUS TRANSACTIONCHILDREN
- STOP TMF
- 6 Event Messages
- 7 Error and Warning Messages
- A TMF Configuration Limits and Defaults
- Index
Commands and Responses
HP NonStop TMF Management Programming Manual—540140-010
5-24
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.