Manipulating and Controlling Groups

Event handling in NOMADS often requires manipulating groups of panel controls in order to hide/show, disable/enable or lock/unlock them. The *wingrp utility can be used to manipulate groups of controls from within your PxPlus application.

Note:
Similar functionality to *wingrp may also be handled within NOMADS using Dependency Definitions.

Controls that are grouped via NOMADS Group Assignment can be handled as if they were a single unit using the following CALL syntax:

CALL "* wingrp;action", group_name.grp$

Where:

group_name.grp$	Group name with a .grp$ extension. The dollar sign is required.
;action	Label entry point in the *wingrp program indicating which action is to be applied to the specified group: Hide | Show Controls visibility of the group of controls Enable | Disable Controls access to the (visible) group of controls Lock | Unlock Controls access to the group of multi-line fields UnlockOrEnable | LockOrDisable Controls access to a group of mixed control types by locking or disabling

If no group_name.grp$ is passed with the CALL statement, the utility returns Error #36: ENTER parameters don't match those of the CALL.

To manipulate all the groups in a NOMADS panel, use the following syntax:

PERFORM "* wingrp;action"

Where:

;action

Label entry point in the *wingrp program indicating which action is to be applied to all groups in the panel: Hide_All | Show_All Controls visibility Enable_All | Disable_All Controls access