Inquire VAX VMS PID for a Process

This Subprogram allows the VAX/VMS PID (Process id) associated with a UIPACK Process to be determined. Standard System Services or Run Time Library Subprograms may then be used to alter the attributes of the process (e.g. its priority).

Short Name Calling Sequence

STATUS = UIIQPP(PRCNAM,VAXPID)

Long Name Calling Sequence

STATUS = UI_INQUIRE_PROCESS_PID(...)

Input Arguments

PRCNAM (Character) Process Name

Output Arguments

VAXPID (Integer) Vax/VMS PID

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 VAXPID Argument will be set to Zero if the specified Process does not exist.