Introduction to TMF
HP NonStop TMF Management Programming Manual—540140-008
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.
Summary of Contents for NonStop TMF
Page 4: ......
