xio_allocef(3)                      CLIX                      xio_allocef(3)



  NAME

    xio_allocef, xio_deallocef - Allocates or deallocates an event flag number

  LIBRARY

    Intergraph XIO Library (libix.a)

  SYNOPSIS

    unsigned long xio_allocef(
      int *efn );

    void xio_deallocef(
      unsigned long mask );

  PARAMETERS

    efn    Points to an event flag number.

    mask   Specifies event flag numbers to be deallocated.

  DESCRIPTION

    The xio_allocef() function allocates an event flag number used for
    asynchronous requests.  The efn points to the integer location updated
    with an event flag number.  The event flag number is an argument passed to
    an asynchronous function to track the completion of the request.  The
    xio_allocef() function returns a mask that corresponds to the event flag
    number.  The xio_deallocef() function deallocates event flag numbers
    obtained with xio_allocef().  The bits set in mask correspond to the event
    flag numbers to be deallocated.

  RETURN VALUES

    Upon successful completion, of xio_allocef, a nonzero mask is returned.
    Otherwise, all event flag numbers have been allocated and a value of *N0
    is returned.

  RELATED INFORMATION

    Functions:  xio_readef(3), xio_waitfr(3), xio_notify(3), intro(3)












  2/94 - Intergraph Corporation                                              1