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.