name_create_file()

NAME_$CREATE_FILE                 Domain/OS                  NAME_$CREATE_FILE


NAME
     name_$create_file - create a permanent file

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

     void name_$create_file(
          char *file_name,
          unsigned short &name_length,
          status_$t *status);

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

     procedure name_$create_file(
          in file_name: univ name_$long_pname_t;
          in name_length: integer;
          out status: status_$t);

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

           integer*4 status
           integer*2 name_length
           character file_name*1023

           call name_$create_file(file_name, name_length, status)

DESCRIPTION
     Name_$create_file creates a file at file_name.

     file_name
          The name of the new file.

     name_length
          The number of bytes in file_name.

     status
          The completion status.
Museum
