TMF Management Programming Manual (H06.06+, J06.03+)

Introduction to TMF
HP NonStop TMF Management Programming Manual—540140-010
1-10
Operating System Procedure Calls
Operating System Procedure Calls
Through its Guardian application program interface (API), the NonStop operating
system provides procedure calls you can include in application programs written in
any of the following languages: C, C++, COBOL, FORTRAN, Pascal, and the native
Transaction Application Language (TAL). In most cases, the code for the procedures is
made available through external declaration files provided with the compiler.
Through the procedure calls, you can request many system services. Table 1-5 lists a
few of the calls that you can apply to TMF transactions.
Table 1-5. System Procedure Calls
Procedure Call Description
ABORTTRANSACTION Cancels a transaction. When a process calls this
procedure, TMF backs out the database changes
associated with the current transaction.
ACTIVATERECEIVETRANSID Permits multithreaded servers to read requests from
$RECEIVE before replying to previously read
$RECEIVE requests.
BEGINTRANSACTION Starts a new transaction and creates a new
transaction identifier for the process.
COMPUTETRANSID Converts the individual numeric components of a
transaction identifier to a transaction identifier in
internal format.
ENDTRANSACTION Commits the database changes associated with a
transaction identifier. If the action completes
successfully, the changes made by the transaction
are permanent.
FILE_GETINFO[LIST][BYNAME] Returns information about a file, including whether the
redo or undo phases of file recovery are required to
return the file to a consistent state.
GETTMPNAME Obtains the name of the transaction management
process.
GETTRANSID Returns the current transaction identifier of the calling
process.
INTERPRETTRANSID Converts a transaction identifier in internal format to
its numeric components.
RESUMETRANSACTION Restores as current a transaction identifier created by
a previous call to BEGINTRANSACTION.
STATUSTRANSACTION Returns the transaction state of the current
transaction or that of a specified transaction.
TEXTTOTRANSID Converts a transaction identifier from its external
ASCII form to internal format.
TRANSIDTOTEXT Converts a transaction identifier in internal format to
its external ASCII form.