Museum

MTS_$OPEN_DESC                    Domain/OS                     MTS_$OPEN_DESC


NAME
     mts_$open_desc - open a magtape descriptor file

SYNOPSIS (C)
     #include <apollo/base.h>
     #include <apollo/mts.h>

     mts_$handle_t mts_$open_desc(
          char *path_name,
          unsigned short &path_length,
          mts_$rw_t &read_write,
          status_$t *status)

SYNOPSIS (Pascal)
     %include '/sys/ins/base.ins.pas';
     %include '/sys/ins/mts.ins.pas';

     function mts_$open_desc(
          in path_name: univ name_$long_pname_t;
          in path_length: integer;
          in read_write: mts_$rw_t;
          out status: status_$t): mts_$handle_t;

SYNOPSIS (FORTRAN)
     %include '/sys/ins/base.ins.ftn'
     %include '/sys/ins/mts.ins.ftn'

           integer*4 handle, status
           integer*2 path_length, read_write
           character path_name*1023

           handle =  mts_$open_desc(path_name, path_length,
          &                         read_write, status)

DESCRIPTION
     Mts_$open_desc opens the magtape descriptor file at path_name and returns
     a handle for it.

     path_name
          The pathname of a magtape descriptor file.

     path_length
          The number of bytes in path_name.

     read_write
          An enumerated value that specifies whether the descriptor file
          should be opened for writing or for reading only.  Choose one of the
          following values:

          mts_$read
               Open the tape descriptor file for attribute inquiries only.

          mts_$write Open the tape descriptor file to set attributes and edit
          labels.

     status
          The completion status.