remove (2) --- remove a file, return status              07/04/83


          | _C_a_l_l_i_n_g _I_n_f_o_r_m_a_t_i_o_n

                 integer function remove (pathname)
                 character pathname (ARB)

                 Library:  vswtlb (standard Subsystem library)


            _F_u_n_c_t_i_o_n

                 'Remove' deletes the file specified by the pathname given as
                 the  first  argument.   If the deletion could not be carried
                 out, ERR is returned; otherwise, OK is returned.


            _I_m_p_l_e_m_e_n_t_a_t_i_o_n

                 'Getto' is called  to  attach  to  the  UFD  containing  the
                 undesirable  file.   The  file  is  deleted  by  a  call  to
          |      'rmfil$', and a call to the Primos routine  AT$HOM  attaches
                 the  user  back  to  his  home  directory.   If  any call to
                 'rmfil$' or 'getto' fails, ERR is returned; otherwise, OK is
                 returned.


            _C_a_l_l_s

          |      getto, Primos srch$$, Primos at$hom


            _S_e_e _A_l_s_o

                 getto (2), rmtemp (2), rmfil$ (6), del (1)

























            remove (2)                    - 1 -                    remove (2)