Name

PQPAN − Returns all paths referencing the structure. 

Operating States: PHOP, ∗, ∗, ∗
PHIGS standard function

Old Syntax

PQANST (STRID, PTHORD, PTHDEP, IPTHSZ, N, ERRIND, OL, APTHSZ, PATHS)

Argument          Data Type      Access    Description
---------------------------------------------------------------------------
STRID             Integer        Read      Structure identifier
PTHORD            Integer        Read      Path order
PTHDEP            Integer        Read      Path depth to be returned
IPTHSZ            Integer        Read      Size of the path buffer, in bytes
N                 Integer        Read      Requested element of the list
                                           of paths
ERRIND            Integer        Write     Error indicator
OL                Integer        Write     Number of paths available
APTHSZ            Integer        Write     Actual size of the Nth structure
                                           path
PATHS(2, IPTHSZ)  Array of       Write     Nth structure path
                  integers
---------------------------------------------------------------------------

New Syntax

PQPAN (STRID, PTHORD, PTHDEP, IPTHSZ, N, ERRIND, OL, APTHSZ, PATHS)

Argument          Data Type      Access    Description
---------------------------------------------------------------------------
STRID             Integer        Read      Structure identifier
PTHORD            Integer        Read      Path order
PTHDEP            Integer        Read      Path depth to be returned
IPTHSZ            Integer        Read      Size of the path buffer, in bytes
N                 Integer        Read      Requested element of the list
                                           of paths
ERRIND            Integer        Write     Error indicator
OL                Integer        Write     Number of paths available
APTHSZ            Integer        Write     Actual size of the Nth structure
                                           path
PATHS(2, IPTHSZ)  Array of       Write     Nth structure path
                  integers
---------------------------------------------------------------------------

Constants

Defined Argument     Constant     Description
---------------------------------------------------------------------------
PTHORD               PPOTOP       Top first
                     PPOBOT       Bottom first
---------------------------------------------------------------------------

Description

PQPAN queries the structure state list and returns all the paths that reference the specified structure.  Each path includes an execute reference of the specified structure with element number 0.  The path order and path depth determine the section of each path to be returned, as follows:

Path Depth   Path Order   Description
0            TOP FIRST    All paths to the specified structure are
                          returned in order of traversal.
1            TOP FIRST    All structures at the top of each structure
                          network that contains the specified structure
                          are returned.
1            BOTTOM       Can be used to determine the number of
             FIRST        references to the specified structure.
2            BOTTOM       All parents of the specified structure are
             FIRST        returned.

See Also

PEXST
PQPDE