VMMRLS(3)                        REVISION 1.0                       VMMRLS(3) 

NAME
        VMMRLS - eject one or more slices from memory without saving to disk

USAGE
        ier = vmmrls(inlkey,nkey)
        integer ier, vmmrls ,nkey
        integer inlkey(nkey)

DESCRIPTION
        VMMRLS is  an integer  function of  the VMM  (Virtual Memory  Manager)
package whose  purpose is  to eject  from memory  one or  more slices.  Slices
ejected via  VMMRLS are  never written  to  disk upon  ejection, even  if  the
variables were created with the 'SAVE=Y'  attribute.  Note however that for  a
variable having the  'SAVE=Y' attribute,  a VMMRLS on  a slice  that has  been
modified will cause VMMRLS to issue  a warning message prior to releasing  the
slice.  The message will be printed to the stderr file.

ARGUMENTS
        inlkey         -(input) list  of keys  pointing to  the slices  to  be
                        unloaded.  If inlkey(1) is equal to -1, all the memory
                        resident slices will be marked as ejectable.

        nkey           -(input) number  of keys  in the  inlkey array.    This
                        argument is ignored when inlkey(1) is set to -1.

AUTHORS

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

NOTES

        Errors that will cause a premature end of program execution

                - No previous call to VMMALLC
                - Password is set (system is locked)
                - Invalid key in the inlkey array.

        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),
vmmhpa(3), vmmhpd(3), vmmint(3), vmmintro(1), vmmlck(3), vmmlod(3), vmmlse(3),
vmmpak(3), vmmpwd(3), vmmrnm(3), vmmsav(3), vmmuld(3), vmmulk(3), vmmuln(3).