ZCOM C I/F Library Routines

PTFIND (3X)

 

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.

162

Chapter 4