VMMHPA(3)                        VERSION 1.0                         VMMHPA(3)

NAME
        VMMHPA - use a portion of memory  from the block of memory managed  by
the VMM package as if allocated independently from VMM.

USAGE
        ier = vmmhpa(ptr,nwords,mode)
        integer ier,vmmhpa
        integer mode,nwords
        pointer(ptr,array)

DESCRIPTION
        VMMHPA is  an integer  function  of the  VMM package  (Virtual  Memory
Manager) that reserves a  portion of the  memory under the  control of VMM  so
that the user may treat it as if it had been allocated independently from VMM.
The portion of  memory thus  allocated stops being  under the  control of  VMM
until it is  released by  a call to  VMMHPD. Note  that whenever  possible,the
portion of memory is allocated from the total memory that was requested by the
initial call to VMMALLC  .  Therefore,  any space allocated  by VMMHPA is  not
available to the function VMMLOD.

        In the event that there is  not enough memory available from the  pool
of memory under the control of VMM, VMMHPA will request additional memory from
the system.

        Upon successful completion, VMMHPA returns a value of zero.

ARGUMENTS
        ptr            -(output) FORTRAN  pointer  to the  section  of  memory
                        allocated.
        nwords         -(input) number of machine words to allocate.
        mode           -(input) if mode equals 8, nwords words of eight  bytes
                        will be  allocated.  Otherwise, four  byte  words  are
                        reserved.
AUTHORS
        J.Caveen, M.Lepine, M.Roch - RPN

NOTES

        Errors that will cause a premature end of program execution

                -cannot allocate requested memory
                -no previous call to VMMALLC

        Latest revision, November 1993

        See  also  vmmallc(3),  vmmatt(3),  vmmcks(3),  vmmcpk(3),  vmmcre(3),
vmmdbg(3),  vmmdiag(3),  vmmdmp(3),   vmm_example(1),  vmmfgt(3),   vmmget(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).