PROCESS

This Command defines and creates a Process

Parameters

NAME

Process Name. Process Names may be up to 32 characters long but only the first 8 characters are significant by default (although this default may be modified by an Application Program). Multiple processes must be unique in these characters.

FILNAM

Process Filename or Spawn Command. This depends on whether a Subprocess or Detached Process is being created (see the /DETACHED Qualifier). If a Subprocess is being defined then this should be a valid DCL Command, enclosed in quotes if necessary (e.g. if it contains embedded spaces). If a Detached Process is being defined then this should be an Executable Image Filename (where the filetype is assumed by default to be .EXE).

Qualifiers

/CONNECTED

Specifies that the keyboard should be logically connected to this Process when servicing of Client requests is established by the Application Program. If this Qualifier is attached to several PROCESS Keywords within a Definition File then the last such Process will be treated as being connected.

/DETACHED=<uic>

Identifies the Process as a Detached Process rather than a Subprocess, running under the specified VAX/VMS UIC. This defaults to the UIC of the current Application if the value is omitted. The UIC should be specified as a User Name or Rights Identifier (e.g. /DETACHED=MyName). If this Qualifier is absent then the Process is assumed to be a Subprocess.

/DISPLAY

This Qualifier causes the Viewport associated with the Process (see the /VIEWPORT Qualifier) to be made visible. The default is for this Viewport to be invisible until the keyboard is connected to the Process.

/VIEWPORT=<id>

Specifies the Viewport to be associated with the created Process. This defaults to the next unassigned Viewport if this Qualifier is absent or has no associated value. In this case there is no control over the size and placement of this Viewport which is positioned automatically by UIPACK. If a Viewport ID is specified the Viewport may be positioned by subsequent MODIFY Keywords etc. The syntax of the Viewport ID is described in full for the VIEWPORT Command.

Qualifiers may be only be attached to the Keyword and not to either of the Parameters. The following examples are legal:-

PROCESS/CONNECT/DETACHED=MYNAME ProcessName "MyFile.Exe"

PROCESS/DISPLAY/VIEWPORT=       ProcessName "Run MyFile.Exe"