CHANGE STRUCTURE IDENTIFIER AND REFERENCES(3P) — Kubota Pacfic Computer Inc. (29 February 1991)

NAME

CHANGE STRUCTURE IDENTIFIER AND REFERENCES − change the identifier assigned to a structure and all references to it

SYNOPSIS

C Syntax

void
pchange_struct_id_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

Purpose

CHANGE STRUCTURE IDENTIFIER AND REFERENCES changes the identifier of a specified structure and all references to the original identifier to the new identifier. References may be both EXECUTE STRUCTURE elements and workstation postings.

C Input Parameters

orig_struct_id
Specifies the structure for which the identifier and references are to be changed.

result_struct_id
Specifies the new identifier to assign to the structure.

Execution

The CHANGE STRUCTURE IDENTIFIER AND REFERENCES subroutine changes the identifier associated with orig_struct_id to result_struct_id. This subroutine also changes all references to the original structure identifier to instead refer to the resulting structure identifier. The result of CHANGE STRUCTURE IDENTIFIER AND REFERENCES varies with the state of the original and resulting structures when the subroutine is called. The possible effects on the structures are described below.

Structure references are established by creating EXECUTE STRUCTURE elements or by posting a structure. A single call to CHANGE STRUCTURE IDENTIFIER AND REFERENCES changes both types of references to the specified structure. Details of how the subroutine changes each type of structure reference are provided below.

If original structure identifier and resulting structure identifier specify the same structure, the subroutine does not take any action. The Original Structure

The structure identified by orig_struct_id will no longer exist after this subroutine is executed, unless it was the open structure. In this case, it continues to exist as the open structure after the subroutine returns, but it will be empty and the element pointer will be set to 0. The Resulting Structure

The resulting structure always exists at the end of CHANGE STRUCTURE IDENTIFIER AND REFERENCES. If result_struct_id does not exist when the subroutine is called, it is created and contains the elements of the original structure. If orig_struct_id does not exist when the subroutine is called, the resulting structure is empty.

If result_struct_id already exists before CHANGE STRUCTURE IDENTIFIER AND REFERENCES, the subroutine will replace its contents with the contents of the original structure.

If the resulting structure is the open structure when the subroutine is called, CHANGE STRUCTURE IDENTIFIER AND REFERENCES closes the structure, replaces the contents with the elements from the original structure and reopens the structure. The element pointer will be set to point to the last element. How EXECUTE STRUCTURE References are Changed

CHANGE STRUCTURE IDENTIFIER AND REFERENCES changes all EXECUTE STRUCTURE elements throughout the Central Structure Store that reference original structure identifier so that they reference resulting structure identifier instead. Any references to result_struct_id that already exist when CHANGE STRUCTURE IDENTIFIER AND REFERENCES is called will not be changed by the subroutine. How Posted Structures are Changed

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

If result_struct_id is posted when CHANGE STRUCTURE IDENTIFIER AND REFERENCES is called, it will remain posted and its priority will not change. If orig_struct_id 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, ∗, ∗, ∗)

Museum