VMS Help  —  RTL Routines, LIB$  LIB$CREATE_USER_VM_ZONE
    The Create User-Defined Storage Zone routine creates a new user-
    defined storage zone in the 32-bit virtual address space.

    Format

      LIB$CREATE_USER_VM_ZONE  zone-id [,user-argument]

                               [,user-allocation-procedure]

                               [,user-deallocation-procedure]

                               [,user-reset-procedure]

                               [,user-delete-procedure] [,zone-name]

1  –  Returns

    OpenVMS usage:cond_value
    type:         longword (unsigned)
    access:       write only
    mechanism:    by value

2  –  Arguments

 zone-id

    OpenVMS usage:identifier
    type:         longword (unsigned)
    access:       write only
    mechanism:    by reference

    Zone identifier. The zone-id argument is the address of a
    longword that receives the identifier of the newly created zone.

 user-argument

    OpenVMS usage:user_arg
    type:         longword (unsigned)
    access:       read only
    mechanism:    by reference

    User argument. The user-argument argument is the address of an
    unsigned longword containing the user argument. LIB$CREATE_USER_
    VM_ZONE copies the value of user-argument and supplies the value
    to all user procedures invoked.

 user-allocation-procedure

    OpenVMS usage:procedure
    type:         procedure value
    access:       function call (before return)
    mechanism:    by value

    User allocation routine.

 user-deallocation-procedure

    OpenVMS usage:procedure
    type:         procedure value
    access:       function call (before return)
    mechanism:    by value

    User deallocation routine.

 user-reset-procedure

    OpenVMS usage:procedure
    type:         procedure value
    access:       function call (before return)
    mechanism:    by value

    User routine invoked each time LIB$RESET_VM_ZONE is called for
    the zone.

 user-delete-procedure

    OpenVMS usage:procedure
    type:         procedure value
    access:       function call (before return)
    mechanism:    by value

    User routine invoked when LIB$DELETE_VM_ZONE is called for the
    zone.

 zone-name

    OpenVMS usage:char_string
    type:         character string
    access:       read only
    mechanism:    by descriptor

    Name to be associated with the zone being created. The optional
    zone-name argument is the address of a descriptor pointing to the
    zone name. If zone-name is not specified, the zone will not have
    an associated name.
Close Help