Guardian Native C Library Calls Reference Manual (G06.29+, H06.08+, J06.03+)

Guardian Native C Library Calls (a - e) chvol(3)
NAME
chvol - Changes default volume and subvolume names used to qualify partial Guardian filenames
LIBRARY
G-series Guardian native processes: $SYSTEM.SYSnn.ZCRTLSRL
G-series OSS native processes: /G/system/sysnn/zcrtlsrl
H-series and J-series Guardian native processes: $SYSTEM.ZDLLnnn.ZCRTLDLL
32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll
64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll
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-018 Hewlett-Packard Company 1−103