RETRIEVE STRUCTURES

PREST

CALL SEQUENCE

CALL PREST (AFID, N, LSTRID)

INPUT PARAMETERS

INTEGER AFID

Archive file identifier.

INTEGER N

Number of structures.

INTEGER LSTRID(N)

List of structure identifiers to retrieve.

PHIGS STATE

EFFECT

If the identifier of one of the structures specified in LSTRID is already present in the CSS, the conflict is processed according to the retrieval conflict resolution flag which can be:

- MAINTAIN Structure already present in the CSS is maintained.

- ABANDON Saving operation abandoned for conflicting structure.

- UPDATE Structure already present in the CSS is overwritten by the new one.

If one of the structure specified in LSTRID is not in the archive, a warning is generated and no action is taken for this structure.

ERRORS

7

Ignoring function, function requires state (PHOP, *, *, AROP)

404

Ignoring function, the specified archive file is not open

405

Ignoring function, name conflict occurred while conflict resolution flag has value ABANDON

408

Warning, some of the specified structures do not exist on the archive file. PHIGS will create empty structure in their place

SEE ALSO

open archive file, archive structures, retrieve structures identifiers, retrieve structure networks, retrieve all structures, retrieve paths to ancestors, retrieve paths to descendant, delete structures from archive