ACC Programmer's Reference Guide

Chapter 4 235
ZCOM C I/F Library Routines
ZLTSTORE (3X)
Threads
Considerations
This routine may be called from a multi-threaded application using the
POSIX (1003.1c) kernel threads API package. This routine has the
following characteristics when called by a multi-threaded application:
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.
cancellation point Thread cancellation can occur when a thread calls this
routine.
async-cancel unsafe The calling thread’s cancelability type must be
PTHREAD_CANCEL_DEFERRED if cancellation is
enabled.
async-signal unsafe It cannot be called from a signal handler.
fork unsafe It cannot be called by a child process after fork(2) but
before exec(2).
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.