API Guide
2-482 API Functions 601355 Rev A
When the API software is operating in asynchronous mode,
client software must call VS_Select to receive intermediate
and final status on command requests submitted through the
API interface to the VolServ system.
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 Vary
command are set with
VSCMD_ArchiveVary_SetDefaults. If
command-specific defaults are set for the Archive Vary
command, they override the global defaults for all Archive
Vary requests.
The following fields can be retrieved from the status handle
after a successful reprioritize request:
• VSID_ARCHIVE_NAME,
• VSID_COMP_STATE,
• VSID_SEQUENCE_NUMBER,
• VSID_SEQUENCE_TABLE,
• VSID_STATUS_CODE,
Tip
To override a default (global or command-specific)
parameter value for a specific instance of an Archive Vary
request, the parameter identifier and the value to be used
for the parameter can be submitted on the command
request itself.