[ Previous | Next | Contents | Glossary | Home | Search ]
The graPHIGS Programming Interface : Subroutine Reference

GPCSRS - Change Structure References

GPCSRS (ostrid, rstrid)

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

ostrid -- specified by user, fullword integer

Original structure identifier.

rstrid -- specified by user, fullword integer

Resulting structure identifier.

Error Codes

12
FUNCTION REQUIRES STATE SSSL
129
ATTEMPTING TO HAVE THE RESULTING STRUCTURE EXECUTE ITSELF

Related Subroutines

GPARV
Associate Root with View
GPARW
Associate Root with Workstation
GPCEXS
Conditional Execute Structure
GPDRV
Disassociate Root from View
GPDRW
Disassociate Root from Workstation
GPEXST
Execute Structure

RCP code

201347074 (X'0C005002')


[ Previous | Next | Contents | Glossary | Home | Search ]