ZCOM C I/F Library Routines
ZTIMR (3X)
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 |
|
|
|
| /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). |
SEE ALSO | zread(3X), zpeek(3X) |
| |
328 | Chapter 4 |