NAME
    AllocLocalItem -- Create a local context item structure.

SYNOPSIS
    item = AllocLocalItem (type, id, ident, usize)
     d0                     d0   d1   d2     d3

    struct localcontextitem *item;
    LONG                    type, id, ident, usize;

FUNCTION
    Allocates and initializes a localcontextitem structure with "usize"
    bytes of associated user data.  This is the only supported way to
    create such an item.  The user data can be accessed with the
    localitemdata function.  an item created with this function
    automatically has its purge vectors set up correctly to dispose of
    itself and its associated user data area.  Any additional cleanup
    should be done with a user-supplied purge vector.

INPUTS
    type,id - additional longword identification values.
    ident   - longword identifier for class of context item.
    usize   - number of bytes of user data to allocate for this item.

RESULT
    item    - pointer to initialized localcontextitem or null if the
              allocation failed.

EXAMPLE

NOTES

BUGS

SEE ALSO
    freelocalitem(), localitemdata(), storelocalitem(),
    storeitemincontext(), setlocalitempurge()