GPCSRS - Change Structure References

Purpose

Use GPCSRS to change all execute structure-type elements which reference a structure (called the original structure) with elements which reference a specified structure (called the resulting structure) This subroutine does not affect any references to the resulting structure that existed before the call.

If the identifier of the original structure and the identifier of the resulting structure are identical, then no action occurs. If the resulting structure references the original structure, then the graPHIGS API issues an error message and does not perform the change.

If there are references to the original structure and the resulting structure does not exist, then the graPHIGS API creates an empty structure with the identifier of the resulting structure. If the original structure does not exist or if there are no references to the original structure, then no action occurs.

If the original structure and resulting structure are both associated to a workstation (or a view), then the original structure is disassociated and the resulting structure remains associated to the workstation (or the view). If the original structure is associated to a workstation (or view) but the resulting structure is not associated, then the original structure is disassociated and the resulting structure is associated to the workstation, or in the case of a view, the original structure is disassociated and the resulting structure is associated to the view with the same priority that the original structure had.

Parameters