Name

PCSTRF − Replaces structure elements referencing a structure with elements referencing another structure. 

Operating States: PHOP, ∗, ∗, ∗
PHIGS standard function

Syntax

PCSTRF (OLDSID, NEWSID)

Argument        Data Type     Access   Description
---------------------------------------------------------------------------
OLDSID          Integer       Read     Original structure identifier
NEWSID          Integer       Read     Resulting structure identifier
---------------------------------------------------------------------------

Description

PCSTRF replaces structure elements that reference the specified original structure with elements that reference the specified resulting structure.  The function produces the following effects on the specified structures and the structures that reference them:

•References to the resulting structure identifier that existed before the call are not affected. 

•If references to the original structure identifier existed before the call, and the resulting structure identifier does not exist at the time of the call, an empty structure (named with the resulting structure identifier) is created. 

•If the original structure identifier and the resulting structure identifier are identical, no action is taken. 

•On all workstations where both the resulting structure and the original structure are posted, the resulting structure remains posted with an unchanged priority. The original structure is unposted. 

•On all workstations where the resulting structure is not posted and the original structure is posted, the resulting structure is posted with the priority of the original structure.  The original structure is unposted. 

•If the original structure does not exist at the time of the call, or if there are no references to the original structure identifier, no action is taken. 

See Also

PCSTID
PCSTIR
PEXST
PQPOST
PPOST