Inquire Name of Connected Process

This Subprogram allows the Name of the currently Connected Process to be determined.

Short Name Calling Sequence

STATUS = UIIQPC(PRCNAM[,PRCLEN,VPRTID])

Long Name Calling Sequence

STATUS = UI_INQUIRE_PROCESS_CONNECTED(...)

Input Arguments

None

Output Arguments

PRCNAM (Character) Process Name PRCLEN (Integer) Name Length (Optional) VPRTID (Integer) Viewport ID (Optional)

Function Value

UI__SUCCESS ) Success UISUCC )

UI__NOT_INITIALIZED ) Package not Initialized UININI )

UI__ILLEGAL_PROCESS ) Illegal Process Name UIILPC )

Note:

1. The PRCNAM Argument will be set to ASCII spaces if no Client Process is currently connected. Function Value UI__ILLEGAL_PROCESS will also be returned, where this is informational only, no error message being displayed.
2. The PRCLEN Argument is optional and, if present, will be set to the length of the Process Name following any truncation. It will be set to Zero if no Process is currently connected.
3. The VPRTID Argument is optional and, if present, will be set to the Viewport directly associated with the creation of the Process. It will be set to UI_INPUT_VIEWPORT (UIINPT) if no Process is currently connected.