RETRIEVE STRUCTURE NETWORKS

PRESN

CALL SEQUENCE

CALL PRESN (AFID, N, LSTRID)

INPUT PARAMETERS

INTEGER AFID

Archive file identifier.

INTEGER N

Number of structures.

INTEGER LSTRID(N)

List of structure identifiers to be dearchived.

PHIGS STATE

EFFECT

The list of structures specified in LSTRID and their network are copied to the centralized structure store (CSS) from the archive AFID.

If the identifier of one of the structures specified or one of its descendants 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 networks, retrieve structures identifiers, retrieve structure, retrieve all structures, retrieve paths to ancestors, retrieve paths to descendant, delete structure network from archive