INQUIRE PATHS TO ANCESTORS
-
CALL SEQUENCE
CALL PQPAN (STRID, PTHORD, PTHDEP, IPTHSZ, N, ERRIND, OL, APTHSZ, PATHS).
INPUT PARAMETERS
- INTEGER STRID
- Structure identifier
- INTEGER PTHORD
- Path order (PPOTOP, PPOBOT)
- INTEGER PTHDEP
- Path depth
- INTEGER IPTHSZ
- Size of PATHS buffer
- INTEGER N
- Element of the list of paths
OUTPUT PARAMETERS
- INTEGER ERRIND
- Error indicator
- INTEGER OL
- Number of paths available
- INTEGER APTHSZ
- Actual size of the Nth structure path
- INTEGER PATHS(2,IPTHSZ)
- Nth structure path.
PHIGS STATE
(PHOP, *, *, *).
EFFECT
Returns the number of paths and the Nth path in the list of paths which refer
to structure STRID. Each path is a maximum path.
A maximum path for a structure ancestor is a series of pairs ((A1,
E1), (A2, E2), ... (AN,
EN), (S, O)) where A1 is a structure which is not referenced by any
EXECUTE STRUCTURE in the centralized structure store (CSS).
If PTHDEP = 0, then the path is returned in its totality.
ERRORS
- 2
Ignoring function, function requires state (PHOP, *,*,*)
- 201
- Ignoring function, the specified structure does not exist
- 207
- Ignoring function, the specified path depth is less than zero (0)
-
SEE ALSO
retrieve paths to ancestors, inquire descendants of structure.