|GPARSN (arid, number, lstrid)|
Use GPARSN to store one or more structure networks from the currently selected structure store into the specified open archive file.
If any of the specified root structures do not exist in the currently selected structure store, then the graPHIGS API issues a warning and no action is taken for the non-existing root structures. If any of the specified structures in the structure networks already exists in the archive file, then the graPHIGS API resolves the conflict according to the value of the archive conflict resolution flag specified by the Set Conflict Resolution (GPCNRS) subroutine.
If an error occurs during the archival process, then the graPHIGS API issues a message and terminates the archival process. Any structures that were successfully transferred to the archive file are archived in their entirety.
The graPHIGS API empties the structure in the archive file before it copies the source structure. If an error occurs (such as the copying of a structure cannot be completed), then the original structure cannot be reconstructed.Currently, the archive file resource and structure store must reside on the same nucleus. If the two resources are on different nuclei, then the graPHIGS API issues error 1109