dmpfd$ (6) --- dump the contents of a file descriptor    01/05/83


            _C_a_l_l_i_n_g _I_n_f_o_r_m_a_t_i_o_n

                 subroutine dmpfd$ (fd, ofd)
                 file_des fd, ofd

                 Library:  vswtlb (standard Subsystem library)


            _F_u_n_c_t_i_o_n

                 'Dmpfd$' prints all information that is of importance to the
                 user  about  file descriptor 'fd' on file unit 'ofd'.  Among
                 the items of information produced  are  the  file  name  (if
                 obtainable),  file  position  (if  a disk file), file buffer
                 information, the most recent file system  return  code,  and
                 the  contents  of the file buffer (if a disk file).  Each of
                 these  pieces  of  information   is   displayed   with   the
                 appropriate heading.


            _I_m_p_l_e_m_e_n_t_a_t_i_o_n

                 'Gfnam$' is called to obtain the name of the file associated
                 with  the  descriptor.  If the name could be obtained, it is
                 printed out.  Other file unit information is printed, in the
                 proper format, from information stored in the Subsystem com-
                 mon areas.  The current position in a disk file is  obtained
                 by calling the Primos routine PRWF$$.


            _C_a_l_l_s

                 gfnam$, mapsu, print, putch, putlin, Primos prwf$$


            _S_e_e _A_l_s_o

                 dump (1)




















            dmpfd$ (6)                    - 1 -                    dmpfd$ (6)