VMMALLC(3)                       VERSION 1.0                        VMMALLC(3)

NAME
        VMMALLC - allocate memory for VMM (Virtual Memory Management) system.

USAGE
        ier = vmmallc(nwords)
        integer vmmallc
        integer ier, nwords

DESCRIPTION
        VMMALLC - is an  integer function of the  VMM package (Virtual  Memory
Manager) used to allocate the  total memory that will  be used by the  Virtual
Memory Management package.  Every other  function of the VMM package  operates
within the  block of  memory that  is allocated  by vmmallc.  VMMALLC must  be
called before any other function of the VMM package.

        Upon succesfull completion, VMMALLC returns a  value of 0.  Any  error
in VMMALLC will cause a premature end of execution of the calling program.

ARGUMENT

        nwords    -(input) number of machine words to allocate

AUTHORS

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

NOTES
        Errors that will cause a premature end of program execution

            -Cannot allocate the requested amount of memory. 
            -VMMALLC has already been called. 
            -An error occured while trying to open the various control files.
            -The control structures have been damaged (In case of a restart).

        Latest revision, November 1993

        See  also   vmmatt(3),  vmmcks(3),   vmmcpk(3),   vmmcre(3),vmmdbg(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).