ZCOM C I/F Library Routines

ZCOMSTATUS (3X)

 

 

 

ZCOMSTATUS (3X)

NAME

 

 

zcomstatus – Return a formatted ZCOM status or error message

SYNOPSIS

 

 

#include

<zcom/zcomsys.h>

 

#include

<zcom/zcomcall.h> /* if compiled with ANSI C (recommended) */

char

*zcomstatus (req, stat)

 

int32

req;

 

 

int32

stat;

 

 

DESCRIPTION

Routine zcomstatus returns a ZCOM status message string

 

 

 

corresponding to a specific status code. The return character string has a

 

 

 

length of 31 bytes maximum, plus a terminating zero. See Multiprotocol

 

 

 

ACC Programmers Reference Guide under ‘ZCOM Status Message

 

 

 

Routine’ in Appendix B, ZCOM Status Codes.

 

 

 

The libraries libzcom_c.a and libpthread.a must be linked into the calling

 

 

 

program by giving the options “-lzcom_c -lpthread” to cc(1) or ld(1).

Threads

 

This routine may be called from a multi-threaded application using the

Considerations

POSIX (1003.1c) kernel threads API package. This routine has the

 

 

 

following characteristics when called by a multi-threaded application:

 

 

 

not a cancellation point Thread cancellation will not occur when a

 

 

 

 

thread is calling this routine.

 

 

 

async-cancel unsafe

The calling thread’s cancelability type must

 

 

 

 

be PTHREAD_CANCEL_DEFERRED if

 

 

 

 

cancellation is enabled.

 

 

 

async-signal unsafe

It cannot be called from a signal handler.

 

 

 

fork unsafe

It cannot be called by a child process after

 

 

 

 

fork(2) but before exec(2).

188

Chapter 4