Reference Guide

ZCOM C I/F Library Routines
ZLTSTORE (3X)
Chapter 4254
PAR AMETER S
NOTES The returned offset indicates the start of the usable data area, with a
size as specified in the call. The actual size of the reserved area will be
silently rounded up to a multiple of 8-byte. This is to ensure all the
storage areas are aligned on a 8-byte boundary, hence the storage may be
used to store 64-bit entity (e.g. long long type in 32-bit mode, or long and
pointer types in LP64 mode) without data alignment problem.
The data area should only be used for terminals within the specified
application group. There is NO queue ownership validation when it is
used in zltup. An application value of zero is used for terminals of ALL
application groups. A zero application value is used to store global data
for all terminals in the ZCOM subsystem.
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.
appln Application number.
label Storage label name.
size Storage size requested, in bytes. The size must be
a multiple of 4 bytes and must not exceed the
available area in logical terminal table extension
(as defined by LOGICAL-SIZE in TTGEN
configuration file). Otherwise, error ZEBADSIZE
(-63) is returned.
offsetp
(Return Param)
Starting byte offset, relative to the beginning
logical terminal table, for the storage in the
extension area.