mts_close_desc()

MTS_$CLOSE_DESC                   Domain/OS                    MTS_$CLOSE_DESC


NAME
     mts_$close_desc - close a magtape descriptor file

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

     void mts_$close_desc(
          mts_$handle_t &mt_handle,
          boolean &update,
          status_$t *status)

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

     procedure mts_$close_desc(
          in mt_handle: mts_$handle_t;
          in update: boolean;
          out status: status_$t);

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

           integer*4 mt_handle, status
           logical update

           call mts_$close_desc(mt_handle, update, status)

DESCRIPTION
     Mts_$close_desc closes the magtape descriptor file whose handle is
     mt_handle.  A magtape descriptor file must be closed before a program can
     read or write the tape.  When mts_$close_desc returns, mt_handle is no
     longer valid.

     mt_handle
          A magtape descriptor file handle.

     update
          A Boolean value that specifies whether the magtape descriptor file
          should be updated with new attribute values.  If update is true, the
          attributes will be updated with the values set while the file was
          open.  If update is false, the attributes will not be updated with
          the values set while the file was open, effectively ignoring any
          previous calls to mts_$set_attr as if the file were opened with
          mts_$read.

     status
          The completion status.
Museum
