Reference Guide

ZCOM C I/F Library Routines
ZTIMR (3X)
Chapter 4328
NOTES A timer value of zero will cancel the timer processing on the specified
ZLU. The ztimr call causes timer messages to be added regularly to the
input queue of the specified program ZLU. A zread call to that ZLU will
return a message type of 3 (in the type parameter) if it is a timer
message. Thus the waiting program (or thread) is able to take
alternative action, rather than waiting indefinitely for a response. If the
program ZLU input queue has ten or more messages in it, the ZCOM
subsystem will not add another timer message to the queue. This is to
prevent a potential problem of consuming all of the ZCOM buffers with
timer messages due to one or more applications not reading their input
queues.
EXAMPLE
#include <zcom/zcomsys.h>
#include <zcom/zcomcall.h>
int32 ierr;
zaddr_type zaddr;
int32 time;
if (ierr = ztimr (&zaddr, time)) {
/* error return code */
}
else {
/* good return code */
}
FILES
SEE ALSO zread(3X), zpeek(3X)
/opt/acc/include/zcom/zcomsys.h ZCOM system general include file,
containing data types, data
structures, constants, error codes,
masks, etc. Note that this must be the
first include file before any other
ZCOM include files.
/opt/acc/include/zcom/zcomcall.h ZCOM routine function prototypes
(requires ANSI C compilation).