ZCOM Tables and Data Structures

ZCOM Kernel Data

SYS

The SYS structure (ZCOM system global information, zsys_type) contains software status information about the ZCOM subsystem. For example, it indicates whether ZCOM is running and when it was last started up. It is updated by the LDM based on requests from ZMON.

Table 3-46

SYS structure (ZCOM system global information,

 

 

zsys_type)

 

 

 

 

 

 

 

Field Name

 

Field Description

Field Type

Size

 

(Bytes)

 

 

 

 

 

 

 

 

 

STIME

 

Time when status last changed

uns.int

4

 

 

 

 

 

STATUS

 

Current system status

uns.int

4

 

 

 

 

 

DEBUG

 

Debug level, 0 = no debug

uns.int

4

 

 

 

 

 

MEMSIZE

 

Size of system memory

uns.int

4

 

 

 

 

 

MEMPTR

 

Pointer to system memory

pointer

8

 

 

 

 

 

SYSPTR

 

Pointer to ZCOM memory (aligned)

pointer

8

 

 

 

 

 

SYSSIZE

 

ZCOM system size (adjusted)

uns.int

4

 

 

 

 

 

NREQUEST

 

Number of active requests

uns.int

4

 

 

 

 

 

RTIMER

 

Reset request timer

uns.int

4

 

 

 

 

 

NSLOW

 

Number of slowdown processes

uns.int

4

 

 

 

 

 

ZSINFO

 

ZCOM system information buffer

struct

24

 

 

 

 

 

STIME - Time when status last changed

This field contains the time (in Epoch format) when the ZCOM subsystem changed to the current state. For example, in a running ZCOM subsystem, this field contains the time when the ZCOM subsystem became operative.

In addition to providing time information, this field is also used in the LDM sleeping mechanism. When a ZCOM application is awoken after waiting in the sleep state, it checks this field to determine whether the ZCOM subsystem has changed state (for example, from READY to

128

Chapter 3