NAME
          irChan2Cid - convert a channel number to a channel identif-
          ier

     SYNOPSIS
          #include <irapi.h>

          channel_id irChan2Cid (int channel_no);

     DESCRIPTION
          The irChan2Cid function returns a channel identifier (cid)
          associated with the channel_no. cids primarily handle all
          channel based activities.

     EVENT
          No event results from the call to irChan2Cid.

     RETURN VALUE
          A valid cid is returned if the request is successful.

          IRR_NULL is returned if an error occurs.

     ERROR
          irError is set as follows if an error occurs:

          IRER_INVALID if the cid is not owned by the process

     SEE ALSO
          irCid2Chan(3IRAPI)

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