Open System Services Library Calls Reference Manual (G06.29+, H06.08+, J06.03+)

chvol(3) OSS Library Calls Reference Manual
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.
1−110 Hewlett-Packard Company 527187-017