mts_open_desc_uid(A)

MTS_$OPEN_DESC_UID                Domain/OS                 MTS_$OPEN_DESC_UID


NAME
     mts_$open_desc_uid - open a magtape descriptor file

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

     mts_$handle_t mts_$open_desc_uid(
          uid_$t &desc_uid,
          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_uid(
          in desc_uid: uid_$t;
          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, desc_uid(2), status
           integer*2 read_write

           handle =  mts_$open_desc(desc_uid, read_write, status)

DESCRIPTION
     Mts_$open_desc_uid opens the magtape descriptor file whose Unique Iden-
     tifier (UID) is desc_uid, and returns a handle for it.

     desc_uid
          The UID of a magtape descriptor file.

     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.
Museum
