Measure Reference Manual

input_type
input
INT:ref:1
specifies the type of the data in the fname_pathid_uid field. input_type is a required
parameter if the data is an ANS UID, otherwise it is optional.
For ANSI SQL names:
File name data type0
Path ID data type1
ANS UID data type2
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 a pathid is passed in fname_pathid_uid, crvsn must also be provided.
• If an ANS UID is passed in fname_pathid_uid, the input_type parameter must be
specified to be MEAS_ANSUID.
• If you want extname and extname_len as output, specify extname_max.
• If the caller of MEASLISTENAME does not include the extname_format parameter, zero is
assumed for the parameter.
• Never change a returned index to another positive value. It can result in a never ending loop
of calls to MEASLISTENAME.
Example
This a simplified example in pTAL pseudo code of how to call MEASLISTENAME with an ANS
UID:
! get the ANSI SQL name for a specified UID
uid := desc.AnsiUIDs;
if ( error := measlistename( dfnum,
uid,
!sysname!,
!crvsn!,
!pathid!,
ansi_name,
ansi_name_max,
ansi_name_len,
!index!,
!extname_type!,
!context_crvsn!,
!extname_format!,
MEAS_ANSUID )) then
return error
else
! use the ansi_name
402 Measure Callable Procedures