The Linkage view provides analysis of all functions and Global Logic objects which call or are called by the currently open function. The central column of the display initially contains the open function. The left hand column, headed Linked From, shows all the functions and Global Logic objects that call or link to the current function and the right hand column headed Linked To, shows all the functions and Global Logic objects that the current function calls or links to.

You can filter objects by selecting the check boxes next to the legend on the right hand side of the view.

You can also see immediately if you have a function or Global Logic booked out for edit , or if that object is booked out to another developer .

Navigating the Linkage Tree

At either side of the linked-to and linked-from lists is a thermometer bar that shows the relative position within these lists of the objects visible in the view. Above and below each bar are s to permit navigation through the lists one page at a time. Alternatively open the Quick List window by clicking the and then double click on a function or Global Logic to navigate to.

Click on an object in the linked-from or link-to list to move that object to the centre column and the view will refresh to show all functions and Global Logic objects that call or are called by that object.

Opening an object for Edit

Once a function or Global Logic appears in the central column, it may be opened for editing without leaving the linkage view by clicking the icon. This icon only appears if source is available for the central object and note that the open process itself is always subject to a locking and access privilege check.

Function Parameters

If the central function has input parameters then the icon will be shown.

Click Function Parameters iconto view the parameters, and if the central object is the open function for edit then these parameters can also be maintained.

Interface Maps

If a called Global Function has an interface map the icon will be shown.

Click interface map iconto view the data passed to the function by the Global Function call. If the central object is the open function for edit then these interface maps can also be maintained.

Linkage Information

Click on theicon on the corner of a linked-from or linked-to object to display the context of the call. The linkage information window will open and describes how the objects are linked – for example if the function is linked to via the calling function’s Exit link, or if the function is called using an interface map – from a logic routine, by attaching a window to a field, or by using a Function Key.

Filtering and Refreshing the View

The key on the far right of the screen indicates the significance of the colours used in the display. Tool tips tell you the colour used for the current function, the colours used to indicate that a function is available in PROIV Developer, the colour used if a function cannot be found, and so on.

Alongside the majority of the items in the key are select boxes which can be clicked to include or exclude each item type from the linkage tree. For example, the view can be tailored to exclude Global Logic objects, runtime-only functions, updates or any combination of items.

Below the central object, there are four more view control icons:

Click this icon to return the view to home – where the open for edit function is the central object in the tree.

Click this icon to refresh the view for the central object. This may be of use to developers using multiple sessions and on multi-developer systems when it is thought or known the linked-from and/or linked-to lists have changed for the central object and the information shown has become aged.

Click this icon to search for a specific Function or Global Logic. A window is popped that allows the selection of the required object. This object is placed in the centre of the view. It does not change the object being edited, and this can be returned to by pressing the ‘Home’ icon.

Click this icon to rebuild the linkage information for the open for edit function when it is the central object. This is not normally necessary, but is provided in case a user has had a network problem, or the server computer has crashed and linkage information is incomplete. The view will refresh upon completion.

Comment on this topic

Topic ID: 500213