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 |
| 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
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 |