Reference Guide

ZCOM C I/F Library Routines
ZPORT (3X)
Chapter 4276
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).