Name

PCSTID − Changes a structure identifier. 

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

Syntax

PCSTID (OLDSID, NEWSID)

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

Description

PCSTID changes the specified original structure identifier to the specified resulting structure identifier.  It does not change references to the original structure identifier.  This function produces the following effects:
 

•The structure associated with the original structure identifier no longer exists, unless there are references to the structure.  If references to the original structure exist, the original structure continues to exist, but as an empty structure. 

•The resulting structure always exists after execution of the function.  However, if the resulting structure previously existed, its contents are replaced by the contents of the original structure. 

•If the original structure did not exist, the resulting structure is empty. 

•If the original structure identifier and the resulting structure identifier are identical, one of the following results occurs:

•If this common structure already exists, no action is taken. 

•If this common structure does not exist, an empty structure is created. 

•If the original structure identifier was posted, it remains posted, but as an empty structure. 

•If the original structure identifier was posted before this function call, the resulting structure identifier remains posted after the call.  (This is the only condition under which the PCSTID function posts the resulting structure.) 

•If the original structure is open, it is closed before the function is executed.  The structure is then reopened at the completion of the function, but exists as an empty structure.  The element pointer in the reopened original structure is set to 0. 

•If the resulting structure is open, it is closed before the function is executed.  The structure is reopened at the completion of the function.  The element pointer in the reopened resulting structure is set to the value it had at the start of the function. 

See Also

PCSTIR
PCSTRF
PEXST
PQPOST
PQSID
PQSTRS
PQSTST
POPST
PPOST