ACC Programmer's Reference Guide

236 Chapter4
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 b it o f the size parameter is zero,anewstoragearea
will be allocated if it is not already assigned.
RETURN VALUE Routine zltstore returns 0 if successful. Otherwise, a non-zero error 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
SEE ALSO ltqdget(3X), ltqdput(3X), zltqueue(3X), zltup(3X)
/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).