[ Previous |
Next |
Contents |
Glossary |
Home |
Search ]
The graPHIGS Programming Interface : Subroutine Reference
GPQCNA - Inquire Conflicting Structures in Network in Archive
| GPQCNA
(arid,
strid,
source,
start,
number,
errind,
totnum,
istrid) |
Note:
This subroutine is an Archive inquiry.
For an overview, see
"Archive Inquiries"
Purpose
Use
GPQCNA to inquire a list of structure identifiers
from a specified structure network that exists in both the
currently selected structure store and the specified open archive
file.
The value for the source determines whether the structure
network originates from the currently selected structure
store or from the archive file.
If the inquired information is available, then the graPHIGS API
sets the error indicator to zero and returns the values in
the output parameters.
If the error indicator is
543 (the
start value exceeds the extent of the available data),
then only the total number (totnum) parameter is set.
If the inquired information is unavailable, then the error
indicator (errind) contains an error number indicating the
reason, and the values returned in the output parameters are
unpredictable.
Parameters
arid -- specified by user, fullword integer
Archive file identifier.
strid -- specified by user, fullword integer
Structure identifier of the root structure.
source -- specified by user, fullword integer
The source of the structure network to be searched:
| Value |
Meaning |
| 1 |
Currently selected structure store |
| 2 |
Archive file |
start -- specified by user, fullword integer
The starting member of the list of structure identifiers
(>=1)
number -- specified by user, fullword integer
Number of entries requested (>=0)
errind -- returned by the graPHIGS API, fullword integer
Error indicator. If the error indicator is zero, the request has been
completed. Otherwise, one of the following errors exists:
- 7
- FUNCTION REQUIRES STATE AROP
- 12
- FUNCTION REQUIRES STATE SSSL
- 122
- STRUCTURE IDENTIFIER DOES NOT EXIST
- 135
- VALUE OF SOURCE IS INVALID
- 220
- SPECIFIED ARCHIVE FILE DOES NOT EXIST
- 538
- START VALUE < ONE
- 539
- REQUESTED NUMBER < ZERO
- 543
- START EXCEEDS DATA EXTENT. TOTAL NUMBER AVAILABLE RETURNED
totnum -- returned by the graPHIGS API, fullword integer
Total number of conflicting structures in the network.
istrid -- returned by the graPHIGS API, array of fullword
integers
List of conflicting structure identifiers.
Error Codes
None
Related Subroutines
- GPQACA
- Inquire All Conflicting Structures in Archive
RCP code
201347593
(X'0C005209')
[ Previous |
Next |
Contents |
Glossary |
Home |
Search ]