Purpose
Use Change Structure References 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 generates an implementation error (-129) and no action occurs. This error is generated to prevent an application from causing recursive traversal of a structure.
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 resulting structure is posted to a workstation, then the resulting structure remains posted and the original structure, if posted to the workstation, is unposted. If the original structure is posted to a workstation but the resulting structure is not, then the graPHIGS API posts the resulting structure to that workstation and unposts the original structure from the workstation.
Language Bindings
| pchange_struct_refs (orig_struct_id, result_struct_id) |
| PCSTRF (oldsid, newsid) |
Errors
Related Subroutines