ZCOM Status Message Routine

The zcomstatus routine returns a character string which gives an explanation of the status codes. This routine may be called to format status messages describing the reason for the status returned in a terminal request.

The format and a typical use of the zcomstatus routine is as follows:

     #include <zcom/zcomsys.h>
     #include <zcom/zcomcall.h>
 
     char        *errmsg, *statmsg, ibuf[100];
     int32       ierr, len, rlen, req, rstat;
     uint32      mode;
     zaddr_type  zaddr;
     zmhd_type   zmhd;
       
     len = 100;
     mode = 0;          /* zread 'wait' option */
     if (ierr = zread (&zaddr, mode, &zmhd, ibuf, len, &rlen, rstat))
     {
          errmsg = zcomerr (ierr);
     }
     else {
          req = zmhd.mrq.mrqstat;
          statmsg = zcomstatus (req, rstat);
       }

The two parameters of the zcomstatus call are: