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

File System Procedures
HP NonStop TMF Application Programmer’s Guide—522419-004
4-22
TEXTTOTRANSID
TEXTTOTRANSID
This procedure converts a transaction identifier from external ASCII form to internal
form. If the conversion fails (status <> 0), all output parameters are undefined.
If the string pointed to by the text parameter does not include a system name or
number and the local system is a named system, TEXTTOTRANSID uses the local
Expand node number as the system number.
If the string pointed to by the text parameter does not include a TMF flags value,
TEXTTOTRANSID generates a TMF flags field containing 0.
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
status returned value
INT
is a TMF or file system error number:
#include <cextdecs(TEXTTOTRANSID)>
short TEXTTOTRANSID ( char _far *text
, short text-byte-length
, long long _far *transid );
status := TEXTTOTRANSID ( text ! i
, text-byte-length ! i
, transid ); ! o
-6 Additional characters in transaction identifier (TMF).
-5 text-byte-length out of range (TMF).
-4 Invalid system name or number (TMF).
-3 Invalid TMF flags value (TMF).
-2 Invalid CPU (TMF).
-1 Invalid sequence (TMF).
0 Successful completion.
22 Bounds error.