VReadTapePathName
Name
VReadTapePathName - reads the TAPE_PATH_NAME file.
Synopsis
VReadTapePathName(num_of_path_name, path_name)
int *num_of_path_name; /*RETURN*/
TapePathName **path_name; /*RETURN*/
Description
VReadTapePathName reads the TAPE_PATH_NAME file in the 3DVIEWNIX/FILES
directory and gets all available tape path names. VReadTapePathName
also reads TAPE_PATH_NAME file in the current directory. VReadTapePathName
returns the number of tape path names available to *num_of_path_name and
the tape paths to **path_name. Currently the first path name in **path_name
is used to load or dump a tape.
Structures
typedef struct {
Char30 machine_name; /*machine on which tape is mounted*/
Char30 tape_drive_name; /*name of tape drive*/
Char30 mt_option; /*option to be used with mt command*/
Char30 tape_size; /*kind of drive (1/4,1/2inch,8mm)*/
} TapePathName;
Return Value
0 - work successfully.
2 - read error.
4 - cannot open file TAPE_PATH_NAME under 3DVIEWNIX/FILES directory.
7 - environment variable does not exist.
8 - user specified tape pathname is not available in the current 3DVIEWNIX
environment.
Parameters
num_of_path_name - returns the number of tape pathname available in current
3DVIEWNIX environment.
path_name - returns an array of the tape pathnames available in current
3DVIEWNIX environment.
Side Effects
None.
Entry Conditions
The environment variable VIEWNIX_ENV must be set to the 3DVIEWNIX system
directory.
Related Functions
VWriteTapePathName,
VInitializeTape.