ZCOM C I/F Library Routines

ZLTSTORE (3X)

PARAMETERS

 

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

 

(Return Param)

logical terminal table, for the storage in the

 

 

extension area.

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.

254

Chapter 4