ARCHIVE STRUCTURES

PARST

CALL SEQUENCE

CALL PARST (AFID, N, LSTRID)

INPUT PARAMETERS

INTEGER AFID

Archive file identifier.

INTEGER N

Number of structures.

INTEGER LSTRID

List of structure identifiers to be archived.

PHIGS STATE

EFFECT

The structures specified by the LSTRID list are archived in archive AFID.

Conflicts may appear during archiving when one of the structure identifiers to be saved corresponds to a structure already present in archive AFID. In this case, the archival conflict resolution flag entry in the PHIGS STATE list allows three types of action to be defined:

- MAINTAIN Structure already present in the archive is maintained.

- ABANDON Saving operation abandoned for conflicting structure.

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

If one of the structures specified in LSTRID is not in the centralized structure store (CSS), 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

200

Warning, ignoring structures that do not exist

405

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

406

Warning, the archive file is full. Any structures that were archived were archived in total

SEE ALSO

open archive file, archive structures networks, archive all structures, set conflict resolution, retrieve structures, delete structures from archive, inquire all conflicting structures