TMF Management Programming Manual (H06.05+)

Introduction to TMF

HP NonStop TMF Management Programming Manual—540140-002

1-10

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.