VMMDBG(3)                        VERSION 1.0                         VMMDBG(3)

NAME
        VMMDBG - activate debug mode for some variables.

USAGE

        ier = vmmdbg(command,inlkey,nkey)
        integer vmmdbg
        integer nkey
        integer ier, inlkey(nkey)
        character*(*) command

DESCRIPTION

        VMMDBG is  an integer  function  of the  VMM package  (Virtual  Memory
Manager) used to control the amount of information that is printed out to  the
VMM output file.   This function is useful  mostly during program  development
for debuging purposes.

        VMMDBG allows the  user to select  an output file  where VMM  messages
will be written, to  write personal messages to  that output file, to  monitor
the movements  (memory to memory, memory to disk,...) and state of one or more
slices and to dump the current state of one or more of the variables that have
been created thus far.

ARGUMENTS

        command        -(input) character string containing the commands to be
                        performed  by  VMMDBG.    command  may  have  one  the
                        following format:
                                'OUTFILE=file_name' 
                                'TRACE'
                                'MSG=string'
                                'MEMDUMP'

                        The OUTFILE  key word is used to select an output file
                        where all VMM messages will be written. If the OUTFILE
                        command is  not used,  VMM will  write to  the  stdout
                        file.

                        The TRACE keyword  indicates to the  VMM package  that
                        the user wishes  to be informed  of all the  movements
                        and state  changes that  the fields  contained in  the
                        list inlkey are subjected to.

                        The MSG keyword will cause the string following to  be
                        written to the VMM output file.

                        The MEMDUMP keyword indicates to the VMM package  that
                        the current state of the fields contained in the  list
                        inlkey is to be written to the  VMM output file.

        inlkey         -(input) array containing a list of keys for which  the
                        commands are to be performed.  If inlkey(1) = -1,  The
                        instructions contained  in the  command argument  will
                        apply to all variables.
        nkey           -(input) number  of  keys  contained  in  inlkey.  This
                        argument is ignored when inlkey(1) = -1.

EXAMPLES

        Set the VMM output file to vmm_out
                ier = vmmdbg('OUTFILE=vmm_out',0,0)

        Write the message 'After loading all necessary fields' to vmm_out
                ier = vmmdbg('MSG=After loading all necessary fields',0,0)

        Set a trace on the three keys contained in inlkey(3)
                ier = vmmdbg('TRACE',inlkey,3)

        Write to vmm_out the present state of all the variables
                ier = vmmdbg('MEMDMP',-1,0)

AUTHORS
        J.Caveen, M.Lepine, M.Roch - RPN

NOTES
        Error that will cause a premature end of program execution

                - No previous call to VMMALLC

        Latest revision, November 1993

        See  also  vmmallc(3),  vmmatt(3),  vmmcks(3),  vmmcpk(3),  vmmcre(3),
vmmdiag(3),  vmmdmp(3),  vmm_example(1),   vmmfgt(3),  vmmget(3),   vmmhpa(3),
vmmhpd(3), vmmint(3), vmmintro(1), vmmlck(3), vmmlod(3), vmmlse(3), vmmpak(3),
vmmpwd(3), vmmrls(3), vmmrnm(3), vmmsav(3), vmmuld(3), vmmulk(3), vmmuln(3).