NAME
          iraAddADChannel, iraAddADDnisani - add an entry to the
          Application Dispatch channel and DNIS/ANI table

     SYNOPSIS
          #include <irapi-ad.h>

          int iraAddADChannel (int channel, int disp_mode, const char
          * reg_file);

          int iraAddADDnisani (const IRA_STR_RANGE *dnisrange, const
          IRA_STR_RANGE *anirange, const char *reg_file);

     DESCRIPTION
          Functions iraAddADChannel and iraAddADDnisani allow users to
          add entries to the AD channel table and the AD DNIS/ANI
          table respectively (see IRAPI-AD(4IRAPI-AD)).

          Function iraAddADChannel adds the application described by
          the registration file reg_file for channel channel and
          dispatch mode disp_mode into the Application Dispatch chan-
          nel table.

          The disp_mode argument specifies the dispatch mode for the
          application. Possible values are IRD_AD_STANDARD or
          IRD_AD_STARTUP .

          Function iraAddADDnisani adds the application described by
          the registration file reg_file for the dnis range dnisrange
          and ani range anirange into the Application Dispatch
          DNIS/ANI table.

          The start value of a range must be less than or equal to the
          end value of the range. 

          The global parameter IRP_AD_READ_ONLY must be set to
          IRD_READWRITE or both functions will return an error.

          The global parameters IRP_AD_CHANNEL_TABLE and
          IRP_AD_DNISANI_TABLE contain the full pathnames of the AD
          Channel and AD DNIS/ANI tables, respectively.

     RETURN VALUE
          IRR_OK if sucessful.

          IRR_FAIL on error.

     ERROR
          On error, irError is set as follows:

          IRER_INVALID if an invalid argument is passed in.

          IRER_OVERFLOW if the Application Dispatch DNIS/ANI table is
          full.

          IRER_BADRANGE if an invalid range was passed into the func-
          tion iraAddADDnisani.

          IRER_PERMISSION if the global parameter IRP_AD_READ_ONLY is
          not set to IRD_READWRITE.

          IRER_SYSERROR if a system error occurred, irSysError will be
          set to the corresponding errno.

     SEE ALSO
          iraRemoveAD(3IRAPI-AD), IRAPI-AD(4IRAPI-AD),
          IrDEFINES(4IRAPI)

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