NAME
          IrVARPARAMS - IRAPI VarParam

     SYNOPSIS
          #include <irapi.h>

     DESCRIPTION
          Each IRAPI VarParam has a set of valid values.  IRAPI Var-
          Params are retrieved with irGetVarParam, modified with
          irSetVarParam and printed with irPrintVarParam.

          VarParams vary in scope.  Some VarParams are global to the
          voice system, others are channel specific and others are
          card specific.  VarParams will be added in future releases
          to provide additional access to system internal data ele-
          ments.

          Direct access to the data structures currently specified by
          /att/include/shmemtab.h will not be supported in future
          releases.  All access to the data in those structures should
          be done through irVarParam functions.

          All VarParams are either int or char.  Size is the maximum
          number of bytes the parameter value may occupy.  The sizes
          listed which are not numbers are #define symbols found in
          /att/include/shmemtab.h.  Note that char type VarParams may
          contain raw (non-ASCII) data; therefore, no assumptions
          about NULL character termination apply to char type parame-
          ters when setting and getting parameter values.  All data is
          read or written according to the size of the VarParam.

          The size of char VarParams may be obtained at run time by
          calling irGetVarParam with a NULL buffer pointer.  The
          return code of irGetVarParam in this case will be the size
          of the required buffer for the VarParam.  For example, see
          IRVP_CARD_IDENTIFIER, below.

          The irPrintVarParam function may be used for printing a Var-
          Param.

          The argument list to irGetVarParam, irSetVarParam and
          irPrintVarParam varies according to each VarParam.  The
          first argument to each function is always the VarParam iden-
          tifier.  One or more additional arguments may be required,
          e.g., a channel or card number, equipment group number,
          pointers to integers or pointers to buffers.

          Application use of irSetVarParam is not supported.  Use of
          this function will result in undefined behaviour.

          The next section describes each VarParam, and how to call
          irGetVarParam irSetVarParam and irPrintVarParam for each
          VarParam.  All arguments of the form "int *" are pointers to
          integers.  All arguments of the form "char *" are pointers
          to character buffers.

          An online code example is available in
          /vs/examples/IRAPI/mtcdump.c

          VarParam                     type     size

          Valid Values
                    Describes the values to which this VarParam may be
                    set, and how the application may interpret these
                    values.

          Default Value
                    Describes the default value, if any, which this
                    VarParam is set to.

          Description
                    What the parameter is and how the parameter is
                    used

          irGetVarParam
                    This describes how to call irGetVarParam for a
                    particular VarParam.  For int VarParams, the last
                    argument is a pointer to an integer to be written
                    to by irGetVarParam.  For char VarParams, the next
                    to last argument is a pointer to a character
                    buffer to be written to by irGetVarParam, and the
                    last argument is the size of that buffer.

          irSetVarParam
                    This describes how to call irSetVarParam for a
                    particular VarParam.  For int VarParams, the last
                    argument is the value to set the VarParam to.  For
                    char VarParams, the next to last argument is a
                    character buffer to set to the VarParam to, and
                    the last argument is size of the buffer.

          irPrintVarParam
                    This describes how to call irPrintVarParam for a
                    particular VarParam.  The buffer argument to
                    irPrintVarParam is a character buffer that an
                    ASCII version of the VarParam is written into.
                    The buffer_size argument to irPrintVarParam is the
                    size of the character buffer argument.  No more
                    than buffer_size bytes will be written to buffer.

          Bitmasks  This describes the value of each bit in a bitmask
                    VarParam.


          SYSTEM CONTROL VARPARAMS


          IRVP_DEVTBL_VALID             int       4

          Description
                    If the contents of the device table are valid then
                    this VarParam will have a value of 0xcafe (decimal
                    56199).  If the contents of the device table are
                    not valid then this VarParam will be some other a
                    value.

          irGetVarParam
                    irGetVarParam(IRVP_DEVTBL_VALID, int *valid);

          irSetVarParam
                    irSetVarParam(IRVP_DEVTBL_VALID, int valid);

          irPrintVarParam
                    irPrintVarParam(IRVP_DEVTBL_VALID, char *buffer,
                    int buffer_size);

          IRVP_EQPTAG                  char     MAXEQTAG

          Description
                    Equipment group name for a given equipment group
                    number, where 0 <= equipment group number < MAX-
                    EQPGRP.

          irGetVarParam
                    irGetVarParam(IRVP_EQPTAG, int eqpgrp_number, char
                    *buffer, int buffer_size);

          irSetVarParam
                    irSetVarParam(IRVP_EQPTAG, int eqpgrp_number, char
                    *buffer, int buffer_size);

          irPrintVarParam
                    irPrintVarParam(IRVP_EQPTAG, int eqpgrp_number,
                    char *buffer, int buffer_size);

          IRVP_NUM_CARDS                int       4

          Description
                    This VarParam is the number of telephony cards
                    installed in the system.

          irGetVarParam
                    irGetVarParam(IRVP_NUM_CARDS, int *numcards);

          irSetVarParam
                    irSetVarParam(IRVP_NUM_CARDS, int numcards);

          irPrintVarParam
                    irPrintVarParam(IRVP_NUM_CARDS, char *buffer, int
                    buffer_size);

          IRP_NUM_CHANS                 int       4

          Description
                    This is the number of channels configured in the
                    system.

          irGetVarParam
                    irGetVarParam(IRVP_NUM_CHANS, int *numchans);

          irSetVarParam
                    irSetVarParam(IRVP_NUM_CHANS, int numchans);

          irPrintVarParam
                    irPrintVarParam(IRVP_NUM_CHANS, char *buffer, int
                    buffer_size);

          IRVP_NUM_NONVCHANS            int       4

          Description
                    This VarParam is the number of non-virtual chan-
                    nels in the system.

          irGetVarParam
                    irGetVarParam(IRVP_NUM_NONVCHANS, integer
                    *num_nonvchans);

          irSetVarParam
                    irSetVarParam(IRVP_NUM_NONVCHANS, int
                    num_nonvchans);

          irPrintVarParam
                    irPrintVarParam(IRVP_NUM_NONVCHANS, char *buffer,
                    int buffer_size);

          IRVP_NUM_PCHANS               int       4

          Description
                    This varparam is the number of purchased channels
                    in the system.

          irGetVarParam
                    irGetVarParam(IRVP_NUM_PCHANS, int *num_pchans);

          irSetVarParam
                    irSetVarParam(IRVP_NUM_PCHANS, int num_pchans);

          irPrintVarParam
                    irPrintVarParam(IRVP_NUM_PCHANS, char *buffer, int
                    buffer_size);

          IRVP_NUM_SP                   int       4

          Description
                    This parameter is the number of SP and SSP cards
                    in the system.

          irGetVarParam
                    irGetVarParam(IRVP_NUM_SP, int *num_sp);

          irSetVarParam
                    irSetVarParam(IRVP_NUM_SP, int num_sp);

          irPrintVarParam
                    irPrintVarParam(IRVP_NUM_SP, char *buffer, int
                    buffer_size);

          IRVP_NUM_LSPS                 int       4

          Description
                    This parameter is the number of LSPS cards in the
                    system.

          irGetVarParam
                    irGetVarParam(IRVP_NUM_LSPS, int *num_lsps);

          irSetVarParam
                    irSetVarParam(IRVP_NUM_LSPS, int num_lsps);

          irPrintVarParam
                    irPrintVarParam(IRVP_NUM_LSPS, char *buffer, int
                    buffer_size);

          IRVP_NUM_T1                   int       4

          Description
                    This parameter is the number of T1 type cards in
                    the system.

          irGetVarParam
                    irGetVarParam(IRVP_NUM_T1, int *num_t1);

          irSetVarParam
                    irSetVarParam(IRVP_NUM_T1, int num_t1);

          irPrintVarParam
                    irPrintVarParam(IRVP_NUM_T1, char *buffer, int
                    buffer_size);

          IRVP_NUM_TR                   int       4

          Description
                    This parameter is the number of Tip Ring cards in
                    the system.

          irGetVarParam
                    irGetVarParam(IRVP_NUM_TR, int *num_tr);

          irSetVarParam
                    irSetVarParam(IRVP_NUM_TR, int num_tr);

          irPrintVarParam
                    irPrintVarParam(IRVP_NUM_TR, char *buffer, int
                    buffer_size);

          IRVP_T1PROT_CHANGE            int       4

          Description
                    Count/indication of t1prot changes -- what does
                    this mean ?!?

          irGetVarParam
                    irGetVarParam(IRVP_T1PROT_CHANGE, int
                    *t1prot_change);

          irSetVarParam
                    irSetVarParam(IRVP_T1PROT_CHANGE, int
                    t1prot_change);

          irPrintVarParam
                    irPrintVarParam(IRVP_T1PROT_CHANGE, char *buffer,
                    int buffer_size);


          IRVP_MTC_INIT_DONE            int       4

          Description
                    Indication of where the mtc process is in terms of
                    initialization.  If equal to 1, then the mtc pro-
                    cess has finished initialization. The mtc process
                    uses this value to determine if it has been
                    respawned.

          irGetVarParam
                    irGetVarParam(IRVP_MTC_INIT_DONE, int
                    *mtc_init_done);

          irSetVarParam
                    irSetVarParam(IRVP_MTC_INIT_DONE, int
                    mtc_init_done);

          irPrintVarParam
                    irPrintVarParam(IRVP_MTC_INIT_DONE, char *buffer,
                    int buffer_size);

          CARD CONTROL VARPARAMS

          Note: for all card control VarParams a card number must
          always be passed to irGetVarParam, irSetVarParam and
          irPrintVarParam.


          IRVP_CARD_ATTRIBUTES          int       4

          Description
                    This VarParam are card specific attributes.  Each
                    of the bits in this field need to be documented.

          irGetVarParam
                    irGetVarParam(IRVP_CARD_ATTRIBUTES, int card, int
                    *card_attributes);

          irSetVarParam
                    irSetVarParam(IRVP_CARD_ATTRIBUTES, int card, int
                    card_attributes);

          irPrintVarParam
                    irPrintVarParam(IRVP_CARD_ATTRIBUTES, char
                    *buffer, int buffer_size);

          IRVP_CARD_IDENTIFIER        buffer    BDID_LEN

          Description
                    AYC number of the card type

          irGetVarParam
                    irGetVarParam(IRVP_CARD_IDENTIFIER, int card, char
                    *ident, int ident_size);

          irSetVarParam
                    irSetVarParam(IRVP_CARD_IDENTIFIER, int card, char
                    *ident, int ident_size);

          irPrintVarParam
                    irPrintVarParam(IRVP_CARD_IDENTIFIER, int card,
                    char *buffer, int buffer_size);

          IRVP_CARD_BUS_TERM            int       4

          Description
                    card bus termination information -- need to docu-
                    ment bits

          irGetVarParam
                    irGetVarParam(IRVP_CARD_BUS_TERM, int card, int
                    *bus_term);

          irSetVarParam
                    irSetVarParam(IRVP_CARD_BUS_TERM, int card, int
                    bus_term);

          irPrintVarParam
                    irPrintVarParam(IRVP_CARD_BUS_TERM, int card, char
                    *buffer, int buffer_size);

          IRVP_CARD_CMP_BDS             int       4

          Description
                    This field is obsolete.

          irGetVarParam
                    irGetVarParam(IRVP_CARD_CMP_BDS, int card, int
                    *cmp_bds);

          irSetVarParam
                    irSetVarParam(IRVP_CARD_CMP_BDS, int card, int
                    cmp_bds);

          irPrintVarParam
                    irPrintVarParam(IRVP_CARD_CMP_BDS, int card, char
                    *buffer, int buffer_size);

          IRVP_CARD_DCHAN_GROUP_ID      int       4

          Description
                    D-channel group id -- (PRI only)

          irGetVarParam
                    irGetVarParam(IRVP_CARD_DCHAN_GROUP_ID, int card,
                    int *dchangroupid);

          irSetVarParam
                    irSetVarParam(IRVP_CARD_DCHAN_GROUP_ID, int card,
                    int dchangroupid);

          irPrintVarParam
                    irPrintVarParam(IRVP_CARD_DCHAN_GROUP_ID, int
                    card, char *buffer, int buffer_size);

          IRVP_CARD_EQPGRP              int       4

          Description
                    bitmask of card equipment groups for this card

          irGetVarParam
                    irGetVarParam(IRVP_CARD_EQPGRP, int card, int
                    *eqpgrp);

          irSetVarParam
                    irSetVarParam(IRVP_CARD_EQPGRP, int card, int
                    eqpgrp);

          irPrintVarParam
                    irPrintVarParam(IRVP_CARD_EQPGRP, int card, char
                    *buffer, int buffer_size);

          IRVP_CARD_ERROR_QUEUE         int       4

          Description
                    queue id to send error message to (SP ONLY)

          irGetVarParam
                    irGetVarParam(IRVP_CARD_ERROR_QUEUE, int card, int
                    *error_queue);

          irSetVarParam
                    irSetVarParam(IRVP_CARD_ERROR_QUEUE, int card, int
                    error_queue);

          irPrintVarParam
                    irPrintVarParam(IRVP_CARD_ERROR_QUEUE, int card,
                    char *buffer, int buffer_size);

          IRVP_CARD_FIRST_CHAN          int       4

          Description
                    first VIS channel number on the card - network
                    interface cards only

          irGetVarParam
                    irGetVarParam(IRVP_CARD_FIRST_CHAN, int card, int
                    *first_chan);

          irSetVarParam
                    irSetVarParam(IRVP_CARD_FIRST_CHAN, int card, int
                    first_chan);

          irPrintVarParam
                    irPrintVarParam(IRVP_CARD_FIRST_CHAN, int card,
                    char *buffer, int buffer_size);

          IRVP_CARD_FLASHTIME           int       4

          Description
                    milliseconds for switch hook flash -- network
                    interface cards only

          irGetVarParam
                    irGetVarParam(IRVP_CARD_FLASHTIME, int card, int
                    *flashtime);

          irSetVarParam
                    irSetVarParam(IRVP_CARD_FLASHTIME, int card, int
                    flashtime);

          irPrintVarParam
                    irPrintVarParam(IRVP_CARD_FLASHTIME, int card,
                    char *buffer, int buffer_size);

          IRVP_CARD_IVOL                int       4

          Description
                    Incoming DSP attenuation factor -- for network
                    interface cards only

          irGetVarParam
                    irGetVarParam(IRVP_CARD_IVOL, int card, int
                    *card_ivol);

          irSetVarParam
                    irSetVarParam(IRVP_CARD_IVOL, int card, int
                    card_ivol);

          irPrintVarParam
                    irPrintVarParam(IRVP_CARD_IVOL, int card, char
                    *buffer, int buffer_size);

          IRVP_CARD_NUM_CHANS           int       4

          Description
                    Number of channels on the card - for network
                    interface cards only

          irGetVarParam
                    irGetVarParam(IRVP_CARD_NUM_CHANS, int card, int
                    *num_chans);

          irSetVarParam
                    irSetVarParam(IRVP_CARD_NUM_CHANS, int card, int
                    num_chans);

          irPrintVarParam
                    irPrintVarParam(IRVP_CARD_NUM_CHANS, int card,
                    char *buffer, int buffer_size);

          IRVP_CARD_OSINDEX             int       4

          Description
                    UNIX driver index of the card

          irGetVarParam
                    irGetVarParam(IRVP_CARD_OSINDEX, int card, int
                    *osindex);

          irSetVarParam
                    irSetVarParam(IRVP_CARD_OSINDEX, int card, int
                    osindex);

          irPrintVarParam
                    irPrintVarParam(IRVP_CARD_OSINDEX, int card, char
                    *buffer, int buffer_size);

          IRVP_CARD_OVOL                int       4

          Description
                    outgoing DSP attenuation factor - network inter-
                    face cards only

          irGetVarParam
                    irGetVarParam(IRVP_CARD_OVOL, int card, int
                    *card_ovol);

          irSetVarParam
                    irSetVarParam(IRVP_CARD_OVOL, int card, int
                    card_ovol);

          irPrintVarParam
                    irPrintVarParam(IRVP_CARD_OVOL, int card, char
                    *buffer, int buffer_size);

          IRVP_CARD_OWNER_QUEUE         int       4

          Description
                    queue id to send state messages to - SP cards only

          irGetVarParam
                    irGetVarParam(IRVP_CARD_OWNER_QUEUE, int card,
                    *owner_queue);

          irSetVarParam
                    irSetVarParam(IRVP_CARD_OWNER_QUEUE, int card, int
                    owner_queue);

          irPrintVarParam
                    irPrintVarParam(IRVP_CARD_OWNER_QUEUE, int card,
                    char *buffer, int buffer_size);

          IRVP_CARD_PACKFILE           char     MAXPNAME

          Description
                    UNIX path of file containing nmes of functions
                    assigned - SP only

          irGetVarParam
                    irGetVarParam(IRVP_CARD_PACKFILE, int card, char
                    *packfile);

          irSetVarParam
                    irSetVarParam(IRVP_CARD_PACKFILE, int card, char
                    *packfile);

          irPrintVarParam
                    irPrintVarParam(IRVP_CARD_PACKFILE, int card, char
                    *buffer, int buffer_size);

          IRVP_CARD_PENDING             int       4

          Description
                    MANOOS, BROKEN, INSERV, NONEX

          irGetVarParam
                    irGetVarParam(IRVP_CARD_PENDING, int card, int
                    *card_pending);

          irSetVarParam
                    irSetVarParam(IRVP_CARD_PENDING, int card, int
                    card_pending);

          irPrintVarParam
                    irPrintVarParam(IRVP_CARD_PENDING, int card, char
                    *buffer, int buffer_size);

          IRVP_CARD_RESET               int       4

          Description
                    indicates if card is reset when broken

          irGetVarParam
                    irGetVarParam(IRVP_CARD_RESET, int card, int
                    *card_reset);

          irSetVarParam
                    irSetVarParam(IRVP_CARD_RESET, int card, int
                    *card_reset);

          irPrintVarParam
                    irPrintVarParam(IRVP_CARD_RESET, int card, char
                    *buffer, int buffer_size);

          IRVP_CARD_STATE               int       4

          Description
                    MANOOS, BROKEN, INSERV, NONEX

          irGetVarParam
                    irGetVarParam(IRVP_CARD_STATE, int card, int
                    *card_state);

          irSetVarParam
                    irSetVarParam(IRVP_CARD_STATE, int card, int
                    card_state);

          irPrintVarParam
                    irPrintVarParam(IRVP_CARD_STATE, int card, char
                    *buffer, int buffer_size);

          IRVP_CARD_SUB_VERSION         int       4

          Description
                    protocol sub category

          irGetVarParam
                    irGetVarParam(IRVP_CARD_SUB_VERSION, int card, int
                    *subversion);

          irSetVarParam
                    irSetVarParam(IRVP_CARD_SUB_VERSION, int card, int
                    subversion);

          irPrintVarParam
                    irPrintVarParam(IRVP_CARD_SUB_VERSION, int card,
                    char *buffer, int buffer_size);

          IRVP_CARD_TTSOVOL             int       4

          Description
                    outgoing volume for text to speech - network
                    interface cards only

          irGetVarParam
                    irGetVarParam(IRVP_CARD_TTSOVOL, int card, int
                    *ttsovol);

          irSetVarParam
                    irSetVarParam(IRVP_CARD_TTSOVOL, int card, int
                    ttsovol);

          irPrintVarParam
                    irPrintVarParam(IRVP_CARD_TTSOVOL, int card, char
                    *buffer, int buffer_size);

          IRVP_CARD_TYPE                int       4

          Description
                    card type, DVTR, DVT1, DVSP, DVLSPS, etc.

          irGetVarParam
                    irGetVarParam(IRVP_CARD_TYPE, int card, int
                    *card_type);

          irSetVarParam
                    irSetVarParam(IRVP_CARD_TYPE, int card, int
                    card_type);

          irPrintVarParam
                    irPrintVarParam(IRVP_CARD_TYPE, int card, char
                    *buffer, int buffer_size);

          IRVP_CARD_VERSION             int       4

          Description
                    what verison of software to down load

          irGetVarParam
                    irGetVarParam(IRVP_CARD_VERSION, int card, int
                    *card_version);

          irSetVarParam
                    irSetVarParam(IRVP_CARD_VERSION, int card, int
                    card_version);

          irPrintVarParam
                    irPrintVarParam(IRVP_CARD_VERSION, int card, char
                    *buffer, int buffer_size);

          IRVP_CARD_WINKTIME            int       4

          Description
                    milliseconds for shortest current loss

          irGetVarParam
                    irGetVarParam(IRVP_CARD_WINKTIME, int card, int
                    *winktime);

          irSetVarParam
                    irSetVarParam(IRVP_CARD_WINKTIME, int card, int
                    winktime);

          irPrintVarParam
                    irPrintVarParam(IRVP_CARD_WINKTIME, int card, char
                    *buffer, int buffer_size);


          IRVP_CARD_PREVTOBROK_STATE     int       4

          Description
                    indicates the state the card was in prior to being
                    marked BROKEN. If the card has never been marked
                    broken, the value of this field will be MANOOS.

          irGetVarParam
                    irGetVarParam(IRVP_CARD_PREVTOBROK_STATE, int
                    card, int *prevToBrokState);

          irSetVarParam
                    irSetVarParam(IRVP_CARD_PREVTOBROK_STATE, int
                    card, int prevToBrokState);

          irPrintVarParam
                    irPrintVarParam(IRVP_CARD_PREVTOBROK_STATE, int
                    card, char *buffer, int buffer_size);


          IRVP_CARD_CLOCK               int       4

          Description
                    on CPCI systems, this field indicates which
                    telephony bus clock the card is listening to, A
                    clock or B clock. If the field is set to 1, this
                    means the card is listening to the A clock. If
                    this field is set to 2, this means the card is
                    listening to the B clock. For ISA systems, this
                    field will be set to -1.

          irGetVarParam
                    irGetVarParam(IRVP_CARD_CLOCK, int card, int
                    *clock);

          irSetVarParam
                    irSetVarParam(IRVP_CARD_CLOCK, int card, int
                    clock);

          irPrintVarParam
                    irPrintVarParam(IRVP_CARD_CLOCK, int card, char
                    *buffer, int buffer_size);


          IRVP_CARD_BRDPRESENT          int       4

          Description
                    this field indicates if the card was detected as
                    physically present and in the case of CPCI sys-
                    tems, attached, at the last voice system start up
                    time. A value of 1 indicates the card was detected
                    as present, 0 means not present. For CPCI systems,
                    the value of 2 means that the card is attachable.

          irGetVarParam
                    irGetVarParam(IRVP_CARD_BRDPRESENT, int card, int
                    *brdPresent);

          irSetVarParam
                    irSetVarParam(IRVP_CARD_BRDPRESENT, int card, int
                    brdPresent);

          irPrintVarParam
                    irPrintVarParam(IRVP_CARD_BRDPRESENT, int card,
                    char *buffer, int buffer_size);


          IRVP_CARD_BRDINIT             int       4

          Description
                    this field indicates if the card is currently
                    being downloaded or diagnosed, or is about to
                    become unavailable to due a download, diagnose,
                    detach, etc.  A value of 0 means the board is not
                    being downloaded, diagnosed, etc.

          irGetVarParam
                    irGetVarParam(IRVP_CARD_BRDINIT, int card, int
                    *brdInit);

          irSetVarParam
                    irSetVarParam(IRVP_CARD_BRDINIT, int card, int
                    brdInit);

          irPrintVarParam
                    irPrintVarParam(IRVP_CARD_BRDINIT, int card, char
                    *buffer, int buffer_size);


          CHANNEL CONTROL VARPARAMS


          IRVP_CHAN_CARD                int       4

          Description
                    card number this channel is associated with

          irGetVarParam
                    irGetVarParam(IRVP_CHAN_CARD, int chan, int
                    *chan_card);

          irSetVarParam
                    irSetVarParam(IRVP_CHAN_CARD, int chan, int
                    chan_card);

          irPrintVarParam
                    irPrintVarParam(IRVP_CARD_CHAN, int chan, char
                    *buffer, int buffer_size);

          IRVP_CHAN_EQPGRP              int       4

          Description
                    bitmap of equipment group for the channel

          irGetVarParam
                    irGetVarParam(IRVP_CHAN_EQPGRP, int chan, int
                    *eqpgrp);

          irSetVarParam
                    irSetVarParam(IRVP_CHAN_EQPGRP, int chan, int
                    eqpgrp);

          irPrintVarParam
                    irPrintVarParam(IRVP_CHAN_EQPGRP, int chan, char
                    *buffer, int buffer_size);

          IRVP_CHAN_OPTIONS             int       4

          Description
                    bitmap of equipment group for the channel

          irGetVarParam
                    irGetVarParam(IRVP_CHAN_OPTIONS, int chan, int
                    *chan_options);

          irSetVarParam
                    irSetVarParam(IRVP_CHAN_OPTIONS, int chan, int
                    chan_options);

          irPrintVarParam
                    irPrintVarParam(IRVP_CHAN_OPTIONS, int chan, char
                    *buffer, int buffer_size);

          IRVP_CHAN_OSINDEX             int       4

          Description
                    UNIX driver index of the card associated with this
                    channel

          irGetVarParam
                    irGetVarParam(IRVP_CHAN_OSINDEX, int chan, int
                    *chanosindex);

          irSetVarParam
                    irSetVarParam(IRVP_CHAN_OSINDEX, int chan, int
                    chanosindex);

          irPrintVarParam
                    irPrintVarParam(IRVP_CHAN_OSINDEX, int chan, char
                    *buffer, int buffer_size);

          IRVP_CHAN_OWNER_QUEUE         int       4

          Description
                    queue id to send messages to

          irGetVarParam
                    irGetVarParam(IRVP_CHAN_OWNER_QUEUE, int chan, int
                    *ownerqueue);

          irSetVarParam
                    irSetVarParam(IRVP_CHAN_OWNER_QUEUE, int chan, int
                    ownerqueue);

          irPrintVarParam
                    irPrintVarParam(IRVP_CHAN_OWNER_QUEUE, int chan,
                    char *buffer, int buffer_size);

          IRVP_CHAN_PENDING             int       4

          Description
                    MANOOS, BROKEN, INSERV, or NONEX

          irGetVarParam
                    irGetVarParam(IRVP_CHAN_PENDING, int chan, int
                    *chan_pending);

          irSetVarParam
                    irSetVarParam(IRVP_CHAN_PENDING, int chan, int
                    chan_pending);

          irPrintVarParam
                    irPrintVarParam(IRVP_CHAN_PENDING, int chan, char
                    *buffer, int buffer_size);

          IRVP_CHAN_PORT                int       4

          Description
                    sub-device number on the card, e.g., 0-5 for
                    tip/ring card

          irGetVarParam
                    irGetVarParam(IRVP_CHAN_PORT, int chan, int
                    *chan_port);

          irSetVarParam
                    irSetVarParam(IRVP_CHAN_PORT, int chan, int
                    chan_port);

          irPrintVarParam
                    irPrintVarParam(IRVP_CHAN_PORT, int chan, char
                    *buffer, int buffer_size);

          IRVP_CHAN_STATE               int       4

          Description
                    MANOOS, BROKEN, INSERV, or NONEX

          irGetVarParam
                    irGetVarParam(IRVP_CHAN_STATE, int chan, int
                    *chan_state);

          irSetVarParam
                    irSetVarParam(IRVP_CHAN_STATE, int chan, int
                    chan_state);

          irPrintVarParam
                    irPrintVarParam(IRVP_CHAN_STATE, int chan, char
                    *buffer, int buffer_size);

          IRVP_CHAN_STATE_CHANGE        int       4

          Description
                    time stamp when the channel state last changed

          irGetVarParam
                    irGetVarParam(IRVP_CHAN_STATE_CHANGE, int chan,
                    int *chan_state_change);

          irSetVarParam
                    irSetVarParam(IRVP_CHAN_STATE_CHANGE, int chan,
                    int chan_state_change);

          irPrintVarParam
                    irPrintVarParam(IRVP_CHAN_STATE_CHANGE, int chan,
                    char *buffer, int buffer_size);

          IRVP_CHAN_TELNO              char     MAXPBXEXT

          Description
                    telephone number associated with the channel

          irGetVarParam
                    irGetVarParam(IRVP_CHAN_TELNO, int chan, char
                    *telno, int telnosize);

          irSetVarParam
                    irSetVarParam(IRVP_CHAN_TELNO, int chan, char
                    *telno, int telnosize);

          irPrintVarParam
                    irPrintVarParam(IRVP_CHAN_TELNO, int chan, char
                    *buffer, int buffer_size);

          Description
                    telephone number associated with the channel


          SYSMON VARPARAMS


          IRVP_SYSMON_CHACT             int       4

          Description
                    channel status and or activity, see
                    /att/include/chstate.h

          irGetVarParam
                    irGetVarParam(IRVP_SYSMON_CHACT, int chan, int
                    *chact);

          irSetVarParam
                    irSetVarParam(IRVP_SYSMON_CHACT, int chan, int
                    chact);

          irPrintVarParam
                    irPrintVarParam(IRVP_SYSMON_CHACT, int chan, char
                    *buffer, int buffer_size);

          IRVP_SYSMON_DIPNO             int       4

          Description
                    dip number the channel is communicating with

          irGetVarParam
                    irGetVarParam(IRVP_SYSMON_DIPNO, int chan, int
                    *dipno);

          irSetVarParam
                    irSetVarParam(IRVP_SYSMON_DIPNO, int chan, int
                    dipno);

          irPrintVarParam
                    irPrintVarParam(IRVP_SYSMON_DIPNO, int chan, char
                    *buffer, int buffer_size);

          IRVP_SYSMON_ITP               int       4

          Description
                    TIP mode indicator

          irGetVarParam
                    irGetVarParam(IRVP_SYSMON_ITP, int chan, int
                    *itp);

          irSetVarParam
                    irSetVarParam(IRVP_SYSMON_ITP, int chan, int itp);

          irPrintVarParam
                    irPrintVarParam(IRVP_SYSMON_ITP, int chan, char
                    *buffer, int buffer_size);

          IRVP_SYSMON_SCRIPT           char     IRD_SERVICE_NAME_LEN
          Description
                    script name running on channel

          irGetVarParam
                    irGetVarParam(IRVP_SYSMON_SCRIPT, int chan, char
                    *script, int count);

          irSetVarParam
                    irSetVarParam(IRVP_SYSMON_SCRIPT, int chan, char
                    *script, int count);

          irPrintVarParam
                    irPrintVarParam(IRVP_SYSMON_SCRIPT, int chan, char
                    *buffer, int buffer_size);

          IRVP_SYSMON_DNIS             char     IRD_MAX_DNIS_DIGITS

          Description
                    DNIS number received by channel, only applies to
                    T1, PRI, and ASAI

          irGetVarParam
                    irGetVarParam(IRVP_SYSMON_DNIS, int chan, char
                    *dnis, int count);

          irSetVarParam
                    irSetVarParam(IRVP_SYSMON_DNIS, int chan, char
                    *dnis, int count);

          irPrintVarParam
                    irPrintVarParam(IRVP_SYSMON_DNIS, int chan, char
                    *buffer, int buffer_size);

          IRVP_SYSMON_ANI              char     IRD_MAX_ANI_DIGITS

          Description
                    ANI number received by channel, only applies to
                    T1, PRI, and ASAI

          irGetVarParam
                    irGetVarParam(IRVP_SYSMON_ANI, int chan, char
                    *ani, int count);

          irSetVarParam
                    irSetVarParam(IRVP_SYSMON_ANI, int chan, char
                    *ani, int count);

          irPrintVarParam
                    irPrintVarParam(IRVP_SYSMON_ANI, int chan, char
                    *buffer, int buffer_size);

          IRVP_SYSMON_DIGS             char      16
          Description
                    last 16 characters of caller input

          irGetVarParam
                    irGetVarParam(IRVP_SYSMON_DIGS, int chan, char
                    *digs, int count);

          irSetVarParam
                    irSetVarParam(IRVP_SYSMON_DIGS, int chan, char
                    *digs, int count);

          irPrintVarParam
                    irPrintVarParam(IRVP_SYSMON_DIGS, int chan, char
                    *buffer, int buffer_size);

          IRVP_SYSMON_DIALED           char      16

          Description
                    last 16 characters of caller digits dialed

          irGetVarParam
                    irGetVarParam(IRVP_SYSMON_DIALED, int chan, char
                    *dialed, int count);

          irSetVarParam
                    irSetVarParam(IRVP_SYSMON_DIALED, int chan, char
                    *dialed, int count);

          irPrintVarParam
                    irPrintVarParam(IRVP_SYSMON_DIALED, int chan, char
                    *buffer, int buffer_size);

          IRVP_SYSMON_TRAFFIC           int       4

          Description
                    total calls per day

          irGetVarParam
                    irGetVarParam(IRVP_SYSMON_TRAFFIC, int chan, int
                    *traffic);

          irSetVarParam
                    irSetVarParam(IRVP_SYSMON_TRAFFIC, int chan, int
                    traffic);

          irPrintVarParam
                    irPrintVarParam(IRVP_SYSMON_TRAFFIC, int chan,
                    char *buffer, int buffer_size);

          DISCONNECT TONE VARPARAMS


          IRVP_RINGTONE_DISCONNECT      int       4

          irGetVarParam
                    irGetVarParam(IRVP_RINGTONE_DISCONNECT, int
                    *ringtonedisc);

          irSetVarParam
                    irSetVarParam(IRVP_RINGTONE_DISCONNECT, int
                    ringtonedisc);

          irPrintVarParam
                    irPrintVarParam(IRVP_RINGTONE_DISCONNECT, char
                    *buffer, int buffer_size);

          IRVP_BUSYTONE_DISCONNECT      int       4

          irGetVarParam
                    irGetVarParam(IRVP_BUSYTONE_DISCONNECT, int
                    *busytonedisc);

          irSetVarParam
                    irSetVarParam(IRVP_BUSYTONE_DISCONNECT, int
                    busytonedisc);

          irPrintVarParam
                    irPrintVarParam(IRVP_BUSYTONE_DISCONNECT, char
                    *buffer, int buffer_size);

          IRVP_REORDERTONE_DISCONNECT     int       4

          irGetVarParam
                    irGetVarParam(IRVP_REORDERTONE_DISCONNECT, int
                    *reordertonedisc);

          irSetVarParam
                    irSetVarParam(IRVP_REORDERTONE_DISCONNECT, int
                    reordertonedisc);

          irPrintVarParam
                    irPrintVarParam(IRVP_REORDERTONE_DISCONNECT, char
                    *buffer, int buffer_size);

          IRVP_DIALTONE_DISCONNECT      int       4

          irGetVarParam
                    irGetVarParam(IRVP_DIALTONE_DISCONNECT, int *dial-
                    tonedisc);

          irSetVarParam
                    irSetVarParam(IRVP_DIALTONE_DISCONNECT, int dial-
                    tonedisc);

          irPrintVarParam
                    irPrintVarParam(IRVP_DIALTONE_DISCONNECT, char
                    *buffer, int buffer_size);

          IRVP_STUTTERDIALTONE_DISCONNECT     int       4

          irGetVarParam
                    irGetVarParam(IRVP_STUTTERDIALTONE_DISCONNECT, int
                    *stutterdialtonedisc);

          irSetVarParam
                    irSetVarParam(IRVP_STUTTERDIALTONE_DISCONNECT, int
                    stutterdialtonedisc);

          irPrintVarParam
                    irPrintVarParam(IRVP_STUTTERDIALTONE_DISCONNECT,
                    char *buffer, int buffer_size);

          IRVP_CHAN_RESCHAN             int       4

          Description
                    this field is not currently used, but is here for
                    future use with hot swap.

          irGetVarParam
                    irGetVarParam(IRVP_CHAN_RESCHAN, int chan, int
                    *resChan);

          irSetVarParam
                    irSetVarParam(IRVP_CHAN_RESCHAN, int chan, int
                    resChan);

          irPrintVarParam
                    irPrintVarParam(IRVP_CHAN_RESCHAN, int chan, char
                    *buffer, int buffer_size);

     SEE ALSO
          irVarParam(3IRAPI), irParam(3IRAPI), irGlobalParam(3IRAPI),
          irAPI.rc(4IRAPI).

     VERSION
          This is version 8/31/00 of this man page.