API Guide
2-468 API Functions 601355 Rev A
• Information is being requested for more than one archive.
• Any archive query option is specified.
Archive Query statuses are cumulative. Each status is added to
the previous status; therefore, after the final status, the status
handle contains all needed information.
Two levels of default parameter settings are used in the API
software—global defaults and command-specific defaults.
• Global defaults are initialized at startup and can be set or
retrieved using VS_Global_SetFields and
VS_Global_GetFields function calls.
• Command-specific parameter defaults for the Archive
Query command are set with
VSCMD_ArchiveQuery_SetDefaults. If
command-specific defaults are set for the Archive Query
command, they override the global defaults for all Archive
Query requests.
The following fields can be retrieved from the status handle
after a successful Archive Query request:
• VSID_ARCHIVE_HANDLE,
• VSID_ARCHIVE_HANDLE_ENTRY,
• VSID_ARCHIVE_HANDLE_TABLE,
• VSID_QUERY_OPTION, VSID_SEQUENCE_NUM,
Tip
To override a default (global or command-specific)
parameter value for a specific instance of an Archive
Query request, the parameter identifier and the value to be
used for the parameter can be submitted on the command
request itself.