Reference Guide

ZCOM C I/F Library Routines
PTFIND (3X)
Chapter 4162
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 called 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 terminal 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
assigned by TTGEN during configuration file compilation and kept in the
ptterm field of the physical terminal table.
This method is used usually when the MUX, PORT, and TERM are
known. An example is in retrieving a previously accessed physical
terminal table.