mts_copy_desc()

MTS_$COPY_DESC                    Domain/OS                     MTS_$COPY_DESC


NAME
     mts_$copy_desc - copy a magtape descriptor file

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

     mts_$handle_t mts_$copy_desc(
          char *src_path,
          unsigned short &src_length,
          char *dst_path,
          unsigned short &dst_length,
          status_$t *status)

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

     function mts_$copy_desc (
          in src_path: univ name_$long_pname_t;
          in src_length: integer;
          in dst_path: univ name_$long_pname_t;
          in dst_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 src_length, dst_length
           character src_path*1023, dst_path*1023

           handle = mts_$copy_desc(src_path, src_length,
          &                        dst_path, dst_length, status)

DESCRIPTION
     Mts_$copy_desc copies the magtape descriptor file at src_path to
     dst_path, then opens the descriptor file at dst_path and returns a handle
     for it.

     src_path
          The pathname of the magtape descriptor file to be copied.

     src_length
          The number of bytes in src_path.

     dst_path
          The pathname for the new magtape descriptor file.  Dst_path must not
          exist when mts_$copy_desc is called.

     dst_length
          The number of bytes in dst_path.

     status
          The completion status.
Museum
