HP UX 11i v1 I/O Cards manual 146

ZCOM C I/F Library Routines

LTQDGET (3X)

RETURN VALUE Routine ltqdget returns 0 if successful. Otherwise, a non-zeroerror code is returned. See /opt/acc/include/zcom/zcomsys.h for the list of ZCOM error codes and their meanings.

If the specified queue is empty, then the ZENODATA error (-24) is returned and ibuf contains invalid data.

EXAMPLE

#include	<zcom/zcomsys.h>
#include	<zcom/zcomcall.h>
int32	ierr;
zaddr_type	zaddr;
uint32	queue;
char	ibuf[size]; /*Where size is user-determined; must be >= len */
int32	len;
int32	rlen;

if (ierr = ltqdget (&zaddr, queue, ibuf, len, &rlen)) { /* error return code */

}

else {

/* good return code */

}
FILES
/opt/acc/include/zcom/zcomsys.h	ZCOM system 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).

SEE ALSO

ltqdput(3X), zltqueue(3X), zltstore(3X), zltup(3X)

146 Chapter 4