HP UX 11i v1 I/O Cards manual

Models: UX 11i v1 I/O Cards

1 298
Download 298 pages 31.75 Kb
Page 177
Image 177

ZCOM C I/F Library Routines

ZCOMSTATUS (3X)

PARAMETERS

req Request code (from the zread header, zmhd )

 

stat Status (ZCOM error code if < 0)

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

177

Page 177
Image 177
HP UX 11i v1 I/O Cards manual