ACC Programmer's Reference Guide

Chapter 4 177
ZCOM C I/F Library Routines
ZCOMSTATUS (3X)
PARAMETERS
NOTES This routine reads a message file for the status message text. It uses the
file zstatmsg.msg in /opt/acc/msg (ZCOM_MESSAGE_PATH). If not
found, it uses the default message file default.msg.
RETURN VALUE Routine zcomstatus returnsa message string, correspondingto either the
ZCOM status if stat i s non-negative, or the ZCOM error if stat is
negative.
EXAMPLE
#include <zcom/zcomsys.h>
#include <zcom/zcomcall.h>
char *statmsg; /* Returned message string */
int32 req;
int32 stat;
statmsg = zcomstatus (req, stat);
FILES
req Request code (from the zread header, zmhd )
stat Status (ZCOM error code if < 0)
/opt/acc/include/zcom/zcomsys.h ZCOM subsystem general include file,
containing data types, data structures,
constants, error codes, masks, etc. Note that
this must be the first include file before any
other ZCOM include files.
/opt/acc/include/zcom/zcomcall.h ZCOM routine function prototypes (requires
ANSI C compilation).
/opt/acc/msg/zstatmsg.msg ZCOM status messages.
/opt/acc/msg/default.msg Master message text file.