Measure Reference Manual

firstcall
input, output
FIXED:ref:1
is a context value. The first time you pass entity to MEASLISTCONFIG, specify firstcall
as 0. MEASLISTCONFIG modifies and returns firstcall. A firstcall value other than
-1 indicates that more descriptors are available. Call MEASLISTCONFIG again with the same
entity value and the returned firstcall value.
When no more descriptors are available, MEASLISTCONFIG sets firstcall to -1 and returns
error 3022 (WARN^NO^MORE^DATA). To retrieve information for a different entity, reinitialize
firstcall to 0 and specify a new entity value.
Usage Note
If MEASLISTCONFIG is called at the same time a ServerNet device is dynamically added or deleted
(e.g., with an SCF ADD or SCF DELETE command), the returned configuration data could contain
duplicate entries or have missing entries.
MEASLISTENAME
Translates a Guardian file name, MID, or ANS UID to its corresponding external format ANSI SQL
name or OSS pathname.
The specific ANSI SQL name or OSS pathname must be valid (translatable) at the time of the call.
If the CRVSN is specified, only a translation that matches the specified CRVSN returns a name.
error := MEASLISTENAME ( dfnum ! i
,fname–pathid–uid ! i
,[ sysname ] ! i
,[ crvsn ] ! i
,[ pathid ] ! o
,[ extname ] ! o
,[ extname_max ] ! i
,[ extname_len ] ! o
,[ index ] ! i,o
,[ extname_type ] ! o
,[ context_crvsn ] ! o
,[ extname_format ] ! i
,[ input_type ] ! i
,[ connectionInfo ] ); ! i
error
INT
is the error code indicating the outcome of the operation. Possible error codes include:
DescriptionError Code
Successful completion.0
The external name returned exceeded the buffer size.err^buftoosmall3204
The specified pathname could not be resolved.err^invalidosspath3233
A CRVSN was required but not specified.err^crvsnnotspecified3234
An OSS journal segment was required but not available.err^missingossjournal3236
The specified ANSI SQL name could not be translated.err^unknownsqlname3238
The specified ANSI SQL name contained syntax errors or was not fully
qualified.
err^badformatsqlname3239
An SQL journal segment was required but not available.err^missing^sqljournal3241
MEASLISTENAME 399