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

File System Procedures

HP NonStop TMF Application Programmer’s Guide—522419-005

4-40

TRANSIDTOTEXT

This procedure converts a transaction identifier from internal form to external ASCII

form. If the conversion fails (status <> 0), all output parameters are undefined.

text-byte-length specifies how many bytes in the string variable pointed to by

text are available for use by TRANSIDTOTEXT. bytes-used parameter specifies

how many of those bytes TRANSIDTOTEXT actually used.

If the system number of the transaction identifier can be converted to a system name,

the transaction identifier is formatted in either of the following ways (depending upon

whether or not the transaction identifier contains a nonzero TMF flags value):

\system-name(tm-flags).cpu.sequence

\system-name.cpu.sequence

If the system number of the transaction identifier cannot be converted to a system

name, the transaction identifier is formatted in either of the following ways (depending

upon whether or not the transaction identifier contains a nonzero TMF flags value):

\system-number(tm-flags).cpu.sequence

\system-number.cpu.sequence

If the system is not named, the transaction identifier is formatted as follows:

cpu.sequence

Syntax for C Programmers

Syntax for TAL Programmers

Note. Attempts to pass a transactional identifier (txid) to the TransIdToText procedure instead

of a transaction identifier (transid) will fail with a return code of -1. For information about txIds,

see the TMF_GET_TX_ID_

procedure description.

#include <cextdecs(TRANSIDTOTEXT)>

short TRANSIDTOTEXT ( long long transid

, char _far *text

, short text-byte-length

, short _far *bytes-used );

status := TRANSIDTOTEXT ( transid ! i

, text ! o

, text-byte-length ! i

, bytes-used ); ! o