ZCOM C I/F Library Routines

ZCOMSTATUS (3X)

PARAMETERS

re Request code (from the zread header, zmhd ) q

st Status (ZCOM error code if < 0) at

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

 

/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.

Chapter 4

189