NAME
          irSendPriMsg - Send an SP_PRI_MSG letter to send a PRI Q.931
          message

     SYNOPSIS
          #include <irapi.h>

          int irSendPriMsg (channel_id cid, int msg_type, Q931_REC
          *q931_rec);

     DESCRIPTION
          The irSendPriMsg function sends an SP_PRI_MSG letter to the
          PRI packfile telling it to send a Q.931 message (identified
          by msg_type) for the channel identified by the cid.  This
          function allows an IRAPI application to send PRI messages in
          addition to the ones used for normal call control.  This
          function is most likely to be used for sending FACILITY mes-
          sages or the response, if any, that is expected in response
          to an IRE_PRI_MSG event.

          The q931_rec buffer can be created and modified by the
          Advanced PRI functions for management of IE's.  See the
          Advanced PRI documentation for further information about
          when and what Q.931 messages may be sent.

     EVENT
          No events are directly associated with this function call,
          but depending on the msg_type, the application may receive
          an IRE_PRI_MSG event as a result of the switch seeing the
          message sent by this function.

          An IRE_NETWORK_ERROR event may report failure of the PRI
          packfile to send the message.

     RETURN VALUE
          IRR_OK is returned if the message is successfully sent to
          the PRI packfile.

          IRR_FAIL is returned if an error occurs.

     ERROR
          irError is set as follows if an error occurs:

          IRER_INVALID if the cid is invalid

          IRER_DRIVER_ERROR if a driver call failure occurs (see
          irSysError for additional information)

     CAVEAT
     SEE ALSO
          Advanced PRI documentation

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