ms_mk_permanent()

MS_$MK_PERMANENT                  Domain/OS                   MS_$MK_PERMANENT


NAME
     ms_$mk_permanent - make a temporary object permanent

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

     void ms_$ms_permanent(
          void *&address,
          ms_$perm_opt_t &option,
          char *name,
          short int &name_length,
          status_$t *status)

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

     procedure ms_$mk_permanent(
          in address: univ_ptr;
          in option: ms_$perm_opt_t;
          in name: univ name_$pname_t;
          in name_length: integer;
          out status: status_$t);

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

           integer*4 status
           integer*2 name_length, option
           character name*1023

           integer*4 address, dummy
           pointer /address/ dummy

           call ms_$mk_permanent(address, option, name, name_length, status)

DESCRIPTION
     This call makes the temporary object mapped at address permanent by giv-
     ing it the name specified in name.

     address
          A pointer to a currently mapped portion of the temporary object.

     option
          This is an option to specify what ms_$mk_permanent should do if an
          object already exists at name.  There is currently only one option
          available:

          ms_$mk_bak
               Make a backup object and give it the pathname supplied with the
               suffix ".bak" appended to it.

          name The pathname of the new permanent object.  The pathname must be
               on the same volume used when creating the temporary file.

          name_length
               The number of bytes in name.

          status
               The completion status.  Ms_$mk_permanent returns with
               ms_$not_temp in status if the object at address is already per-
               manent.

SEE ALSO
     ms_$attributes, ms_$mk_temporary.
Museum
