NAME
          irFAXJobIDStatus - determine the status of a FAX job

     SYNOPSIS
          #include <irapi.h>

          int irFAXJobIDStatus (int faxtype, const char *job_id, int
          *status);

     DESCRIPTION
          The function irFAXJobIDStatus returns the status of a FAX
          request queued for transmission.  The job is identified
          through faxtype which is the IRP_FAX_TYPE of the fax and the
          job_id which is obtained through a call to
          irFAXOutOfCall(3IRAPI) or through an IRE_FAXPRINT_PROG
          event.

          status is set as follows:

          IRD_FAX_PRINT_READY if the job is ready for transmission

          IRD_FAX_PRINT_XMITTING if the job is currently transmitting

          IRD_FAX_PRINT_WAITING if the job is waiting for retry due to
          a prior failure

          IRD_FAX_PRINT_DELAYED if the job has been delayed

          IRD_FAX_PRINT_FAILED if the job failed

     EVENTS
          There are no events associated with this function.

     RETURN VALUE
          IRR_OK is returned upon success.

          IRR_FAIL is returned on error.

     ERROR
          irError is set as follows on error:

          IRER_INVALID if job_id is invalid or if status is the NULL
          pointer

          IRER_SYSERROR if a driver call or system call failure occurs
          (see irSysError for additional information)

     SEE ALSO
          irFAXPrint(3IRAPI), irFAXOutOfCall(3IRAPI),
          IrDEFINES(3IRAPI).

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