Guardian Native C Library Calls Reference Manual (G06.28+, H06.05+)

Guardian Native C Library Calls (a - e) chvol(3)
NAME
chvol - Changes default volume and subvolume names used to qualify partial Guardian filenames
LIBRARY
For G-series Guardian native processes: $SYSTEM.SYSnn.ZCRTLSRL
For G-series OSS native processes: /G/system/sysnn/zcrtlsrl
For H-series Guardian native processes: $SYSTEM.ZDLLnnn.ZCRTLDLL
For H-series OSS processes: /G/system/zdllnnn/zcrtldll
SYNOPSIS
#include <fcntl.h>
short chvol (
char *volume);
PARAMETERS
volume Points to a string containing a valid volume and subvolume name.
DESCRIPTION
The chvol() function changes the default volume and subvolume names used to qualify partial
Guardian filenames.
The chvol() function can be called from Guardian modules (modules compiled for the Guardian
environment) within Guardian and OSS processes. It cannot be called from OSS modules.
The run-time library expands all partially qualified Guardian filenames using the default volume
and subvolume names. The getenv() function can be used to determine the initial default
volume and subvolume names for a process.
If a filename is included in addition to the volume and subvolume names, the chvol() function
ignores it.
RETURN VALUES
Upon successful completion, the value 0 (zero) is returned. Otherwise, the value -1 is returned.
ERRORS
If any of the following conditions occurs, the chvol() function sets errno to the corresponding
value.
[EINVAL] The volume parameter has an invalid Guardian volume or subvolume value.
RELATED INFORMATION
Functions: getenv(3).
STANDARDS CONFORMANCE
The chvol() function is an HP extension to the XPG4 Version 2 specification.
527192-007 Hewlett-Packard Company 1−37