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

TMF ARLIB2 Audit-Reading Procedures
HP NonStop TMF Application Programmer’s Guide—522419-004
5-56
ARGETANSINAME
ARGETANSINAME
This procedure returns the ANSI name of an SQL/MX object. It also returns the ANSI
partition name of the object (where pertinent) and the name space of the returned
ANSI name.
Using the ANSI name, the calling program can perform SQL/MX SELECT statements
against the SQL/MX metadata to obtain additional information about that object not
available from the ARGETMXCOLUMNINFO procedure.
Each partition of an SQL/MX table has another file associated with it called a resource
fork that contains additional label information. Actually, all SQL/MX partitions/files
except resource forks have resource forks associated with them.
If this procedure is called using the Guardian name of a resource fork, the information
pertaining to the SQL/MX partition/file that the resource fork is associated with is
returned.
return-code output
INT .EXT:ref:1
is a returned value indicating the outcome of this procedure.
If the format of the specified Guardian name is not valid, an ARE-INVALID-PARAM
error is returned.
If the specified Guardian name does not map to the SQL/MX name space, an
ARE-ONLY-USABLE-WITH-SQLMX error is returned. This determination is made
by examining the Guardian name, not by accessing the file on disk that has that
Guardian name.
If the file that has the specified Guardian name does not exist on disk, an ARE-
DATA-FILE-NOT-FOUND error is returned.
If the ANSI name being returned is too long to fit in the caller-allocated ANSI-name
buffer, or the partition name being returned is too long to fit in the caller-allocated
partition-name buffer, or both, an ARE-BUFFER-TOO-SMALL error is returned.
CALL ARGETANSINAME ( return-code ! o
, guardian-name ! i
, ansi-name ! o
, ansi-name-buffer-length ! i
, ansi-name-length ! o
, namespace ! i
, partition-name ! o
, partition-name-buffer-length ! i
, partition-name-length ); ! o
Errors (<0) Table 5-3 (later in this section) describes the error codes.
Warnings (>0) None.