Reference Guide

ZCOM C I/F Library Routines
ZRNTIMER (3X)
Chapter 4304
ZRNTIMER (3X)
NAME zrntimer – Set timeout for remote node access
SYNOPSIS
#include <zcom/zcomsys.h>
#include <zcom/zcomcall.h> /* if compiled with ANSI C (recommended) */
int32 zrntimer (node, time)
int32 node;
int32 time;
DESCRIPTION Routine zrntimer is used to change the ZCOM request timeout value for
requests sent to a remote ZCOM system node. The new timeout only
affects the calling program, and is effective for all subsequent requests
for that node until another zrntimer call changes the timeout or
whenever the program is restarted. In the latter case, the timeout is
reset to the default value as defined in the TTGEN configuration file.
The libraries libzcom_c.a and libpthread.a must be linked into the calling
program by giving the options “-lzcom_c -lpthread” to cc(1) or ld(1).
Threads
Considerations
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:
not a cancellation point It has no cancellation point and does not call any
function with cancellation point. Thread cancellation
will not occur when a thread is calling 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).