NAME

CHANGE STRUCTURE REFERENCES − change all references to a specified structure to instead refer to another specified structure

SYNOPSIS

C Syntax

void
pchange_struct_refs ( orig_struct_id, result_struct_id )
Pintorig_struct_id;original structure id
Pintresult_struct_id;result structure id

Required PHIGS Operating States

(PHOP, ∗, ∗, ∗)

DESCRIPTION

Purposer

CHANGE STRUCTURE REFERENCES modifies the arrangement of the structure network by changing all references to orig_struct_id to refer to result_struct_id instead.  The subroutine changes both EXECUTE STRUCTURE references and any posting to a workstation. 

The effect is to substitute the resulting structure for the original structure wherever it appears in a structure network or on a workstation posting. 

C Input Parameters

orig_struct_id
CHANGE STRUCTURE REFERENCES changes the references to this structure. 

result_struct_id
Specifies the structure the original structure references will point to when CHANGE STRUCTURE REFERENCES returns. 

Execution

The CHANGE STRUCTURE REFERENCES subroutine changes all references to the original structure identifier to refer instead to the resulting structure identifier.  Structure references are established by creating EXECUTE STRUCTURE elements or by posting a structure.  A single call to CHANGE STRUCTURE REFERENCES changes both types of references to the specified structure.  The following details how the subroutine changes each type of structure reference.  How EXECUTE STRUCTURE References are Changed

CHANGE STRUCTURE REFERENCES changes all EXECUTE STRUCTURE elements throughout the Central Structure Store that reference orig_struct_id so that they reference result_struct_id instead. Any references to result_struct_id that already exist when CHANGE STRUCTURE REFERENCES is called will not be changed by the subroutine. 

If the resulting structure does not exist when the subroutine is called, it will be created as an empty structure and the original structure references assigned to it. 

If orig_struct_id and result_struct_id specify the same structure, the subroutine does not take any action.  How Posted Structures are Changed

If the original structure is posted to a workstation when CHANGE STRUCTURE REFERENCES is called, the subroutine unposts it and posts the resulting structure with the same priority that the original structure had. 

If the resulting structure is posted when CHANGE STRUCTURE REFERENCES is called, it will remain posted and its priority will not change.  If the original structure is also posted, it will be unposted. 

Changes in a posted structure network are processed immediately and may immediately affect the display.  The actual visual effects that appear on the display surface will depend on the  workstation’s current display update state. 

ERRORS

002Ignoring function, function requires state (PHOP, ∗, ∗, ∗)

SEE ALSO

CHANGE STRUCTURE IDENTIFIER (3P)
CHANGE STRUCTURE IDENTIFIER AND REFERENCES (3P)

September 02, 1992