Guardian C Library Calls Reference Manual

chvol (supplementary)
3-16 128833—Guardian TNS C Library Calls Reference Manual
Reference to Library Calls
chvol (supplementary)
The chvol function changes the default volume and subvolume names used to qualify
partial file names.
volume
points to a string containing a valid volume and subvolume name.
Return Value
is zero if the operation is successful, or -1 if an error occurs.
Usage Guidelines
•
The run-time library expands all partial file names using the default volume and
subvolume names. To find out what the initial defaults are, use the getevn function.
•
If you include a file name in addition to the volume and subvolume names, the chvol
function ignores it.
Example
This example changes the default volume and subvolume names to $rock and music,
respectively:
#include <fcntlh>
chvol("$rock.music");
#include <fcntlh>
short chvol(char *volume);