HP UX 11i v1 I/O Cards manual 236

ZCOM C I/F Library Routines

ZLTSTORE (3X)

Routine zltstore returns an already assigned area if the application number and storage label and storage size all match a previously assigned area. Otherwise, an error is returned. This provides a facility to share data areas between different programs and enables program restartability.

If bit ZCOM_ZLTSTORE_NA (0x8000) of the size parameter is set before zltstore is called, then zltstore will only return a previously assigned area. If a matching area of storage is not assigned, this will result in an error return. If this bit of the size parameter is zero, a new storage area will be allocated if it is not already assigned.

RETURN VALUE	Routine zltstore 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.
EXAMPLE	#include <zcom/zcomsys.h>
	#include <zcom/zcomcall.h>
	int32	ierr;
	uint32	appln;
	char	label[6];
	uint32	size;
	int32	offset;
	if (ierr = zltstore (appln, label, size, &offset)) {
		/* error return code */
	}
	else {
		/* good return code */
	}
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).
SEE ALSO	ltqdget(3X), ltqdput(3X), zltqueue(3X), zltup(3X)

236 Chapter 4