HP UX 11i v1 I/O Cards manual Terminal table, for the storage in the extension area

Threads Considerations

PARAMETERS

NOTES

ZCOM C I/F Library Routines

ZLTSTORE (3X)

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:

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	Starting byte offset, relative to the beginning logical
(Return Param)	terminal table, for the storage in the extension area.

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.

Chapter 4 235