HP UX 11i v1 I/O Cards manual Zport

ZCOM C I/F Library Routines

zport (3X)

	zport (3X)
NAME	zport – ACC interface card port configuration
SYNOPSIS
#include	<zcom/zcomsys.h>
#include	<zcom/zcomstatus.h>
#include	<zcom/zcomcall.h> /* if compliled with ANSI C (recommended) */

int32 zport (iftno, portno, rcode, action, cnfg, stat)

uint32 iftno;

uint32 portno;

uint32 rcode;

uint32 action; zpconf_type cnfg

int32 *stat;

DESCRIPTION Routine zport (action 0-3) configures the datacomm ports on an ACC interface card. This configuration is generally specific to the particular hardware implementation of the card and will vary depending on the card type. It is not usually called from application programs. The calling program (or thread) is suspended while this function is executed. All terminals on the port being changed must be disabled before the port configuration takes place. For example, use zcntl to disable a terminal using rcode 8. Examine your TTGEN configuration file to determine which ports are defined for which ACC interface cards and the terminals associated with each port.

Action 4 is used to activate the Port Break Routine of a the protocol specific firmware. Since Port configuration by-passes the normal terminal transmit queues, this function is used as a software interrupt to the protocol firmware to initiate a recovery process whenever there is a protocol problem and the transmit queues are “blocked up”. If the protocol for the specified port does not support this facility, error status 8 is returned in stat.

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).

254 Chapter 4