Chapter 8. Display Subroutines

The data stored in a structure store or image board resource cannot be displayed until an affiliation is created that ties the data together with a view in a workstation. The subroutines in this chapter are used to create and delete these ties.

For structure store resources, this bond is created and deleted by associating and disassociating structure networks to a view. To associate a structure network to a view, the owning structure store resource must first be associated to the workstation (either by using the Associate Structure Store with Workstation [GPASSW] [page GPASSW - Associate Structure Store with Workstation] subroutine or by automatic structure store association by the Open Workstation [GPOPWS] [page GPOPWS - Open Workstation] subroutine)

For image board resources, the association is formed and dispelled by creating and deleting image mappings. This view association can only occur if the Define Image (GPDFI) subroutine has been used to define an image on a workstation.

In addition to the subroutines that perform the above ties, this chapter also defines those subroutines that associate and disassociate structure networks to a workstation (useful only to preload data into those workstations that require a special data format) and those subroutines that empty one or more views of a workstation.

GPARV - Associate Root with View

Purpose

Use GPARV to add a structure network to the traversal list for the specified view at the location defined by the priority parameter.

This subroutine implicitly performs an Associate Root with Workstation (GPARW) subroutine.

This subroutine is necessary because the association of a structure network to a view is required in order to actually display the data in the structures in the network.

The specified structure is searched for in the structure store associated with the workstation. If there is no structure store associated with the workstation, an error is generated. If the specified structure does not exist in the associated structure store, an empty structure is created. If the specified structure is already associated with the workstation, its location in the traversal list is modified according to the specified priority.

Parameters