HP UX 11i v1 I/O Cards Zcomstatus, ACC Programmers Reference Guide under ‘ZCOM Status Message

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

176 Chapter 4