next up previous contents
Next: Purge Drop all Up: Process Support Subprograms Previous: Define Create a

Drop a Process

This Subprogram may be used to drop a previously created Subprocess or Detached Process. Any Viewports assigned to this Process will be removed from the screen.

Short Name Calling Sequence

STATUS = UIDRPC(PRCNAM)

Long Name Calling Sequence

STATUS = UI_DROP_PROCESS(...)

Input Arguments

PRCNAM (Character) Process Name

Output Arguments

None

Function Value

UI__SUCCESS ) Success UISUCC )

UI__NOT_INITIALIZED ) Package Not Initialized UININI )

UI__ILLEGAL_PROCESS ) Illegal Process 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 System Service SYS$DELPRC is used to stop the Client process.


Liz Buckle
Fri Jan 13 17:46:53 CST 1995