VMMPWD(3)                        VERSION 1.0                         VMMPWD(3)

NAME
        VMMPWD - lock or unlock access to the VMM package.

USAGE
        ier = vmmpwd(passwrd, mode)
        integer ier, vmmpwd
        integer passwrd, mode

DESCRIPTION
        VMMPWD - is  an integer function  of the VMM  package (Virtual  Memory
Manager) which  serves  to restrict  (or  grant) access  to  some of  the  VMM
functions.  VMMPWD called with  a user defined password  and mode set to  zero
has the effect of  locking the Virtual  Memory Manager package.   When VMM  is
locked, VMMGET and VMMPWD become the only two functions that can be called  by
the user.

        In order to unlock the VMM  package, VMMPWD must be called again  with
the password that was used  for locking and the argument  mode set to 1.   Any
other use of VMMPWD will cause an error.

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

ARGUMENTS
        passwrd        -(input) integer value  used as a  code for locking  or
                        unlocking the VMM package.

        mode           -(input) if mode = 0, the user requests locking of  the
                        VMM package.  If mode = 1, the lock is deleted.   Note
                        that the same  password must be  used for locking  and
                        unlocking the VMM package.

NOTES

        Errors that will cause a premature end of program execution

                -no previous call to VMMALLC
                -trying to perform two consecutive locks
                -trying to unlock the sytem with the wrong password.

        A call  to any  function other  than VMMGET  or VMMPWD  while the  VMM
package is subjected  to a lock  will also  cause a premature  end of  program
execution.

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