Previous Next Up Title Contents Index Functions Index Top Library

CHANGE STRUCTURE REFERENCES

PCSTRF


CALL SEQUENCE

CALL PCSTRF (OLDSID, NEWSID)

INPUT PARAMETERS

INTEGER OLDSID
Old structure identifier.
INTEGER NEWSID
New identifier.

PHIGS STATE

(PHOP, *, *, *).

EFFECT

This function changes all the references made to the OLDSID structure. The references are both modified in the execute structure OLDSID and in the posted structures.

execute structure OLDSID

All the EXECUTE STRUCTURE elements in the CSS referring to OLDSID are replaced by NEWSID .

If result_struct_id does not exist, NEWSID is created as an empty structure.

posted structure

If OLDSID is posted on a workstation, it is unposted, and NEWSID is posted in its place with the same priority.

If the two structures OLDSID and NEWSID are posted, then OLDSID is unposted.

These modifications are immediately taken into account. The visual effect of this function depends on the current state of the workstation update.

ERRORS

2
Ignoring function, function requires state (PHOP, *,*,*)

SEE ALSO

open structure, copy all elements from structure, change structure identifier, change structure identifier and references, inquire structure identifiers, inquire structure status


Previous Next Up Title Contents Index Functions Index Top Library