ACC Programmer's Reference Guide

Chapter 4 153

ZCOM C I/F Library Routines

PTFIND (3X)

NAME

ptfind – Find a physical terminal within a group

SYNOPSIS

#include <zcom/zcomsys.h>

#include <zcom/zcomcall.h> /* if compiled with ANSI C (recommended) */

int32 ptfind (zap, zskeyp, ibuf, len)

zaddr_type *zap;

zskey_type *zskeyp;

zptt_type *zptt;

int32 len;

DESCRIPTION

Routine ptfind provides special methods of accessing terminals on the

same MUX and port. The zap->zlu parameter is the ZLU of a terminal on

a particular MUX and port.

Physical terminals that are associated with the same port are cal led a

physical terminal group. They are linked together to form a circular list

via the ptpzlk and ptlist fields in the physical terminal table. This

routine provides a method to efficiently search through a group.

This routine provides three methods of finding a particular physical

terminal table entry (and relative terminal number) on the same MUX

and port as the ZLU given (zap->zlu) in the first parameter.

Method 1: Retrieve the termina l associated with a specific MUX, port,

and terminal number.

In the ZCOM subsystem, every physical terminal belongs to a single

MUX and PORT and is assigned a TERM (terminal) number, which is

unique within that port. Hence, by specifying these three numbers, a

single physical terminal table may be retrieved. The TERM number is

assignedbyTTGENduring configurationfile compilation and kept in the

ptterm fieldofthephysicalterminaltable.