GPCSI - Change Structure Identifier

Purpose

Use GPCSI to change the identifier of a structure (called the original structure) to a specified structure identifier (called the resulting structure) This subroutine does not affect execute structure-type elements that reference the original structure.

If the identifier of the original structure is the same as the identifier of the resulting structure and the structure exists, then no action occurs. If the structure does not exist, however, then the graPHIGS API creates an empty structure with the identifier of the resulting structure.

If the original structure does not exist, then the graPHIGS API empties the resulting structure. If the original structure does exist, then the contents of the original structure replace the contents of the resulting structure and the graPHIGS API empties the original structure. If the original structure references the resulting structure, then the graPHIGS API issues an error message and does not perform the change.

At the completion of this subroutine call, the system deletes the original structure unless the original structure is the open structure, is referenced by any other structure or is associated to a view or workstation.

If the original structure is the open structure, then the graPHIGS API sets the current element pointer to zero. If the resulting structure is the open structure, then the graPHIGS API sets the current element pointer to point to the last element in the structure.

Parameters