rmfil$ (6) --- remove a file, return status              08/30/84


          | _C_a_l_l_i_n_g _I_n_f_o_r_m_a_t_i_o_n

                 integer function rmfil$ (name)
          |      packed_char name (MAXPACKEDFNAME)

                 Library:  vswtlb  (standard Subsystem library)


            _F_u_n_c_t_i_o_n

          |      'Rmfil$'  is  used to remove files, segment directories, and
          |      access categories by name.  The sole argument is the name of
                 a file (of either type, in  the  current  directory)  to  be
                 deleted.   Note  that  the  name  is  _n_o_t  an EOS-terminated
                 string; it is a packed, blank-filled  array  of  characters.
                 The  function  return  is  OK  if the deletion occurred, ERR
                 otherwise.


            _I_m_p_l_e_m_e_n_t_a_t_i_o_n

                 'Rmfil$' uses the Primos routine SRCH$$ to delete  the  file
                 if  possible.   If  this attempt fails because the file is a
                 non-empty segment directory, it is opened and cleaned out by
          |      a call to 'rmseg$', then deleted by  SRCH$$.   If  it  fails
          |      because  the  file is an access category, it calls CAT$DL to
          |      remove it.


            _C_a_l_l_s

          |      ptov, Primos cat$dl, Primos srch$$, rmseg$


            _S_e_e _A_l_s_o

                 remove (2), del (1), rmseg$ (6)





















            rmfil$ (6)                    - 1 -                    rmfil$ (6)