GPTST - Transfer Structures

Purpose

Use GPTST to copy one or more 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 of the specified structures do not exist in the specified structure store and the specified structure identifier does not exist in the current structure store, then the graPHIGS API issues a warning and creates an empty structure. If any of the specified structures do not exist in the specified structure store and the specified structure identifier does exist in the current structure store and the conflict resolution flag is set to 3=UPDATE , then the graPHIGS API issues a warning and empties the structure.

If one of the specified structures 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 , 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