ZX25INT_CONF (3X) — ACC X.25

NAME

zx25int_conf - Send acknowledgment for a received interrupt packet

SYNOPSIS

#include     <zcom/zcomsys.h>
#include     <zcom/zcomx25.h>
 
int zx25int_conf (zxip, vzap)
zx25info_type    *zxip;
zaddr_type       *vzap;

DESCRIPTION

Routine zx25int_conf requests that an Interrupt Confirmation packet be sent in response to an inbound interrupt message. This function should only be called if the Virtual Circuit has have been configured for application handling of Interrupt Confirmations by setting the INTC bit in the VC's option word. If the INTC bit in the option word has not been set, then the Interrupt Confirmation packet is sent automatically by the X.25 firmware running on the ACC card whenever interrupt data arrives. When application handling of Interrupt Confirmations has not been configured, the zx25int_conf function returns immediately without taking any action.

This function must be called once for each interrupt data message received (using zread). Failure to acknowledge each and every inbound interrupt data message will result in the VC being reset (when T26 expires, which is normally 180 seconds).

The libraries libzx25.a, libzcom_c.a, and libpthread.a must be linked into the calling program by giving the "-lzx25 -lzcom_c -lpthread" options 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. It has the following characteristics when called by multi-threaded applications:

See the NOTES section that follows for more information on using this routine in a multi-threaded application.

PARAMETERS:

RETURN VALUE

Routine zx25int_conf returns a 0 when successful. If there was a ZCOM error, it returns a negative value. See /opt/acc/include/zcom/zcomsys.h for the list of ZCOM error codes and their meanings. If zx25int_conf itself failed, one of the following positive error codes is returned:

NOTES

The calling program (or thread) must call zx25info before calling this routine. In a multi-threaded application, each thread must make a separate call to zx25info using a per-thread ZCOM X.25 access data buffer zxip. The per-thread data buffer can then be used to call this routine.

EXAMPLE

#include    <zcom/zcomsys.h>
#include    <zcom/zcomx25.h> 
int            ierr;
zx25info_type  zxi;
 
if (ierr = zx25int_conf (&zxi, &vzaddr)) {
    /* error return code */
}
else {
    /* good return code */
}
 

FILES

SEE ALSO

zx25info(3x)