Inquire Viewport ID for a Process

This Subprogram allows the Viewport directly associated with the creation of a Process to be determined. This Viewport is used as the Input Viewport for the Process.

Short Name Calling Sequence

STATUS = UIIQPV(PRCNAM,VPRTID)

Long Name Calling Sequence

STATUS = UI_INQUIRE_PROCESS_VIEWPORT(...)

Input Arguments

PRCNAM (Character) Process Name

Output Arguments

VPRTID (Integer) Viewport ID

Function Value

UI__SUCCESS ) Success UISUCC )

UI__NOT_INITIALIZED ) Package not Initialized UININI )

UI__ILLEGAL_PROCESS ) Illegal Process Name UIILPC )

Note:

1. The Process Name may be truncated relative to its full name (as specified in the call to UI_DEFINE_PROCESS that created the Process) as long as it remains unambiguous. Case (upper or lower) is ignored.
2. The VPRTID Argument will be set to UI_INPUT_VIEWPORT (UIINPT) if the specified Process does not exist.