ACC Programmer's Reference Guide

234 Chapter4
ZCOM C I/F Library Routines
ZLTSTORE (3X)
ZLTSTO RE (3X)
zltstore – Logical data storage allocation
#include <zcom/zcomsys.h>
#include <zcom/zcomcall.h> /* if compiled with ANSI C (recommended) */
int32 zltstore (appln, label, size, offsetp
uint32 appln;
char *label;
uint32 size;
int32 *offsetp;
Routine zltstore requestsadataareainthelogicalterminaltable
extension for terminals of a specific application number. Each data area
is identified by the terminal application group and a user defined label.
The returned offset (on successful completion) could then be used in
subsequent data storing and retrieval calls (zltup). For data update and
retrieval, using data storage is relatively more efficient than using a
data queue. However, due to the limited usable area in the terminal
tables,adataqueueshouldbeusedforlargeamountsofdata.Seeunder
zltqueue for how to allocate a data queue.
The libraries libzcom_c.a and libpthread.a must be linked into thecalling
program by giving the options “-lzcom_c -lpthread” to cc(1) or ld(1).