dsdump (2) --- produce semi-readable dump of storage     03/25/82


            _C_a_l_l_i_n_g _I_n_f_o_r_m_a_t_i_o_n

                 subroutine dsdump (form)
                 character form

                 Library:  vswtlb (standard Subsystem library)


            _F_u_n_c_t_i_o_n

                 'Dsdump'  dumps  the contents of memory managed by 'dsinit',
                 'dsget', and 'dsfree' to ERROUT.  It is  primarily  intended
                 for debugging.

                 The  single  argument  is  either  the defined value LETTER,
                 signifying that a character-format dump is desired,  or  the
                 defined  value DIGIT, signifying that an integer-format dump
                 is desired.


            _I_m_p_l_e_m_e_n_t_a_t_i_o_n

                 'Dsdump' simply steps through the  memory  area  (in  common
                 block  DS$MEM) printing the locations and sizes of available
                 blocks and calling 'dsdbiu' to dump the location, size,  and
                 contents  of each block that is in use.  The dump terminates
                 when the end of memory (as indicated by the contents of  the
                 first word of memory) is reached.

                 The routine 'print' is used for all output.


            _C_a_l_l_s

                 print, dsdbiu


            _B_u_g_s

                 As advertised, the dump is only semi-readable.


            _S_e_e _A_l_s_o

                 dsget (2), dsfree (2), dsinit (2), dsdbiu (6)













            dsdump (2)                    - 1 -                    dsdump (2)