TMF Application Programmer's Guide (H06.06+, J06.03+)

TMF ARLIB2 Audit-Reading Procedures
HP NonStop TMF Application Programmer’s Guide—540139-009
5-62
ARGETANSINAME
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. No
name information is returned in either name buffer in such cases, but the minimum
buffer lengths needed are returned in both the ansi-name-length and
partition-name-length parameters.
guardian-name input
STRING .EXT:ref:*
specifies the Guardian name. This is a pointer to a buffer of type
DSMSMFILESPEC that is allocated by the calling process.
guardian-name-length input
INT(32):value
is the length in bytes of guardian-name.
ansi-name output
STRING .EXT:ref:*
is the corresponding ANSI name (in external format). This is a pointer to a buffer of
length ansi-name-buffer-length bytes that is allocated by the calling
process.
The format of an ANSI name is <Catalog>.<Schema>.<Object>.
ansi-name-buffer-length input
INT(32):value
is the length in bytes of the caller-allocated buffer for the returned ANSI name. The
maximum length necessary for this buffer is the maximum length in bytes of an
external format ANSI name: ((((128 * 2) + 2) * 3) + 2).
ansi-name-length output
INT(32) .EXT:ref
is the length in bytes of the returned ANSI name string.
namespace input
STRING .EXT:ref:2
is the name space of the returned ANSI name. Because the ANSI names of an
SQL/MX base table and an SQL/MX index can be the same, the name space is a
necessary adjunct to an ANSI name to prevent name clashes.