VMMRNM(3)                        REVISION 1.0                       VMMRNM(3) 

NAME
        VMMRNM - change the name of a variable

USAGE
        ier = vmmrnm(inkey,newname)
        integer ier, vmmrnm, inkey
        character*8 newname

DESCRIPTION
        VMMRNM is  an integer  function of  the VMM  (Virtual Memory  Manager)
package whose purpose is to change the name of a variable that was created  by
VMMCRE.  VMMRNM merely substitues  the new name for the  old name and the  new
variable inherits  all the  attributes  of the  old one.    Note that  if  the
original variable was  created with the  'SAVE=Y' attribute,   its disk  image
will be associated to the new variable name following a call to VMMRNM.  After
it has been renamed, the original variable ceases to exist in the VMM  control
tables.

ARGUMENTS
        inkey          -(input) key  pointing  to one  of  the slices  of  the
                        variable to rename.
        newname        -(input) replacement name for the variable

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.

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