mts_create_default_desc()

MTS_$CREATE_DEFAULT_DESC          Domain/OS           MTS_$CREATE_DEFAULT_DESC


NAME
     mts_$create_default_desc - create a default magtape descriptor file

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

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

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

     function mts_$create_default_desc(
          in path_name: univ name_$long_pname_t;
          in path_length: integer;
          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
           character path_name*1023

           handle =  mts_$create_default_desc(path_name, path_length, status)

DESCRIPTION
     Mts_$create_default_desc creates an open magtape descriptor file at
     path_name and returns a handle for it.  The created descriptor file has
     default attribute values and is opened for writing.

     path_name
          The pathname of the descriptor file to be created.  There must not
          be an existing file at path_name when mts_$create_default_desc is
          called.

     path_length
          The number of bytes in path_name.

     status
          The completion status.
Museum
