VMMLCK(3)                        VERSION 1.0                         VMMLCK(3)

NAME
        VMMLCK - lock one or more slices in memory

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

DESCRIPTION
        VMMLCK is  an integer  function  of the  VMM package  (Virtual  Memory
Manager) used to lock one or more slices  in memory.  Once a slice is  locked,
the user is  guaranteed that  this slice  will not  be moved  or ejected  from
memory by VMM.  Users should seldom feel the need to use VMMLCK since the  VMM
package provides another function which in  addition to locking a slice,  also
returns a pointer to the locked slice.

        NOTE:  trying to lock a slice that  is already locked or a slice  that
is not in central  memory  is an  error and will cause  a premature ending  of
program execution.

ARGUMENTS
        inlkey         -(input) list of keys pointing to the slices to  render
                        lock.

        nkey           -(input) number of keys contained in the inlkey array.

EXAMPLE

        integer key1, ier 
C       creating a variable with 2 slices of length 10
        key1 = vmmcre('VAR_1',10,2,'CLASS=1,WEIGHT=2')
C       loading and locking the second slice of VAR_1
        ier = vmmlod(key1+2,1)
        ier = vmmlck(key1+2,1)

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

NOTE

        Errors that will cause a premature end of program execution

                -No previous call to VMMALLC
                -Password is set (system is locked)
                -Slice not in memory
                -Invalid key
                -Trying to lock an already locked slice

        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), vmmlod(3), vmmlse(3), vmmpak(3),
vmmpwd(3), vmmrls(3), vmmrnm(3), vmmsav(3), vmmuld(3), vmmulk(3), vmmuln(3).