Measure Reference Manual

extname_max
input
INT:value
is the maximum length, in bytes, that the extname buffer can hold. Required when extname
is specified.
extname_len
input
INT:ref:12
for iterative calls, is the length, in bytes, of the OSS file pathname or ANSI SQL partition name
returned in extname. The length includes the null terminator.
index
input, output
FIXED:ref:1
is a context value for iterative calls. On the initial call of MEASLISTGNAME, index must be
set to -1f. If the translation resolves to an OSS file or an ANSI SQL partition name, index is
returned as -1f.
If the translation resolves to an OSS directory or an ANSI SQL object name, index contains
an internal value that must be passed to subsequent MEASLISTGNAME calls. If index is
returned as -1f, no more data is available about the OSS directory or ANSI SQL object. To
explicitly stop the iteration of the MEASLISTGNAME call sequence for OSS names before
encountering a -1f termination value, make a final call using a negated index (index := -index).
name_type
input
INT:value
indicates whether the name passed in name is to be treated as an OSS pathname or as an
ANSI SQL name. If omitted, name is treated as an OSS pathname.
OSS pathname1
ANSI SQL name2
connectionInfo
input
INT(32) .EXT:ref:25
is allocated by the caller to be at least 100 bytes. connectionInfo must have been filled
in by a call to MEAS_SQL_MAP_INIT_. connectionInfo is only needed when the SQL
journal is not being used.
Usage Notes
• If iterative calls are initiated, the program should continue calling MEASLISTGNAME until
index is returned as -1f. Otherwise iterative processing should be terminated by a final call
with index negated (index := -index). If the iterative processing is interrupted, the calling
program retains an open of the OSS file-system directory. Repeated behavior of this type
eventually results in the program reaching the limit of concurrent opens for a process.
• Never change a returned index to another positive value. It can result in a never ending loop
of calls to MEASLISTGNAME.
406 Measure Callable Procedures