GPTAST - Transfer All Structures

Purpose

Use GPTAST to copy all structures from a specified structure store to the currently selected structure store. Both the source and target structure stores can reside on the same or different nuclei. If the specified structure store is the currently selected structure store, then no action is taken.

If any structure within the specified structure store already exists in the currently selected structure store, then the graPHIGS API resolves the conflict according to the conflict resolution flag. If there is a conflict and the resolution flag is set to 1=MAINTAIN , then the graPHIGS API only transfers structures that do not conflict and there is no change to any existing structure. When the conflict resolution flag is set to 2=ABANDON , the graPHIGS API does not transfer any structures and issues an error. When the flag is set to 3=UPDATE , the graPHIGS API transfers every structure. The conflicting structure replaces the new one without changing any associations to a workstation or view.

Note:

The graPHIGS API empties the structure in the target structure store 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.

When you replace a structure that is an open structure, the structure remains open and is emptied, but the graPHIGS API does not remove references to the structure. The result is as though you had issued the following:

Parameters