HP UX 11i v1 I/O Cards manual Ptfind

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.

Chapter 4 153