TMF Application Programmer's Guide (G06.24+)

File System Procedures
HP NonStop TMF Application Programmer’s Guide—522419-004
4-12
GETTMPNAME
GETTMPNAME
This procedure returns the logical device name of the TMF Management Process
(TMP) defined during system configuration. You need to know the TMP name, which
is always $TMP, in order to open the TFILE.
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
status returned value
INT
is a file system error number:
For a list of all possible file system error numbers, refer to the Operator Messages
Manual.
devname output
INT:ref:12
is the name of a 12-word array into which GETTMPNAME returns the device
name of the TMP. This name can then be passed to the OPEN procedure to open
the TFILE. To call the FILE_OPEN_ procedure, pass a byte-addressable array
that has the same location as devname along with a length value of 4. If the TMP
is not configured, the returned device name is all blanks.
A process can open the TFILE only once. Attempts to open more than one instance of
the TFILE return an error number 12 (file in use). For multithreaded requesters, the
OPEN TFILE call must be performed before the first call to BEGINTRANSACTION.
#include <cextdecs(GETTMPNAME)>
short GETTMPNAME ( short _near *devname );
status := GETTMPNAME ( devname ); ! o
0 Successful completion.
29 Missing parameter(s).
82 TMF not running.
84 TMF not configured.