Reference Guide

ZCOM C I/F Library Routines

ZCOMSTATUS (3X)

Chapter 4 189

PAR AMETER S

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 returns a message string, corresponding to either the

ZCOM status if stat is 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

Request code (from the zread header, zmhd )

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.