NAME
          iraReadADChannel, iraReadADDnisani, iraRewindADDnisani -
          read, and rewind the Application Dispatch tables

     SYNOPSIS
          #include <irapi-ad.h>

          int iraReadADChannel(int chan, int mode , AD_APPL *p_appl)

          int iraReadADDnisani(AD_DNISANI_ENTRY *p_ad_dnisani_entry)

          int iraRewindADDnisani()

     DESCRIPTION
          This group of functions allow applications to read the AD
          tables one entry at a time.

          The iraReadADChannel function will copy the application for
          channel chan and dispatch mode mode from the channel-based
          AD table into AD_APPL variable at address p_appl.  The user
          is responsible for allocating storage for the AD_APPL vari-
          able.

          The iraReadADDnisani function read the DNIS/ANI AD table
          sequentially, starting at the first entry.  The first call
          to iraReadADDnisani will return the first entry of the
          DNIS/ANI-based table and each subsequent call to
          iraReadADDnisani will return each subsequent DNIS/ANI-based
          entry.  iraReadADDnisani will copy the entry from the
          DNIS/ANI-based AD table into AD_DNISANI_ENTRY variable at
          address p_ad_dnisani_entry.  The user is responsible for
          allocating storage for the AD_DNISANI_ENTRY variable.

          The iraRewindADDnisani function can be used force the next
          call to iraReadADDnisani to read the first entry of the
          DNIS/ANI-based table.

     RETURN VALUE
          IRR_OK if successful.

          IRR_FAIL on failure.

     ERROR
          On error, irError is set as follows:

          IRER_INVALID if an invalid argument is passed in.

          IRER_ENDOFTABLE when the end of AD DNIS/ANI table is
          reached.

          IRER_SYSERROR if a system error occurred, errno will be set
          accordingly.

     SEE ALSO
          iraAddAD(3IRAPI-AD), iraRemoveAD(3IRAPI-AD),
          iraQueryAD(3IRAPI-AD), IRAPI-AD(4IRAPI-AD)

     VERSION
          This is version 11/25/02 of this man page.