Establishes the visible process or enables/disables dynamic
    process setting.

    Used only when debugging multiprocess programs (kept debugger
    only).

    Format

      SET PROCESS  [process-spec[, . . . ]]

1  –  Parameters

 process-spec

    Specifies a process currently under debugger control. Use any of
    the following forms:

    [%PROCESS_NAME] process-  The process name, if that name does not
    name                      contain spaces or lowercase characters.
                              The process name can include the
                              asterisk (*)  wildcard character.
    [%PROCESS_NAME]           The process name, if that name contains
    "process-name "           spaces or lowercase characters. You
                              can also use apostrophes (') instead of
                              quotation marks (").
    %PROCESS_PID process_id   The process identifier (PID, a
                              hexadecimal number).
    [%PROCESS_NUMBER]         The number assigned to a process when
    process-number            it comes under debugger control. A
    (or %PROC process-        new number is assigned sequentially,
    number)                   starting with 1, to each process. If
                              a process is terminated with the EXIT
                              or QUIT command, the number can be
                              assigned again during the debugging
                              session. Process numbers appear in a
                              SHOW PROCESS display. Processes are
                              ordered in a circular list so they can
                              be indexed with the built-in symbols
                              %PREVIOUS_PROCESS and %NEXT_PROCESS.
    process-set-name          A symbol defined with the
                              DEFINE/PROCESS_SET command to represent
                              a group of processes.
    %NEXT_PROCESS             The next process after the visible
                              process in the debugger's circular
                              process list.
    %PREVIOUS_PROCESS         The process previous to the visible
                              process in the debugger's circular
                              process list.
    %VISIBLE_PROCESS          The process whose stack, register set,
                              and images are the current context for
                              looking up symbols, register values,
                              routine calls, breakpoints, and so on.

    You can also use the asterisk (*)  wildcard character to specify
    process set all.

    Do not specify a process with the /[NO]DYNAMIC qualifier.

2  –  Qualifiers

2.1    /DYNAMIC

       /DYNAMIC (default)
       /NODYNAMIC

    Controls whether dynamic process setting is enabled or disabled.
    When dynamic process setting is enabled (/DYNAMIC), whenever the
    debugger suspends execution and displays its prompt, the process
    in which execution is suspended automatically becomes the visible
    process. When dynamic process setting is disabled (/NODYNAMIC),
    the visible process remains unchanged until you specify another
    process with the SET PROCESS/VISIBLE command.

2.2    /VISIBLE

    Makes the specified process the visible process. This switches
    your debugging context to the specified process, so that symbol
    lookups and the setting of breakpoints, and so on, are done
    in the context of that process. When using /VISIBLE, you must
    specify one process.

3  –  Description

    The SET PROCESS command establishes the visible process, defines
    the current process set, or defines the visible process.

    By default, commands are executed in the context of the visible
    process (the process that is your current debugging context).
    Symbol lookups, the setting of breakpoints, and so on, are done
    in the context of the visible process.

    Dynamic process setting is enabled by default and is controlled
    with /[NO]DYNAMIC. When dynamic process setting is enabled,
    whenever the debugger suspends program execution and displays
    its prompt, the process in which execution is suspended becomes
    the visible process automatically.

    Related commands:

       CALL
       EXIT
       GO
       QUIT
       SHOW PROCESS
       STEP

4  –  Example

  all> SET PROCESS TEST_Y
  all> SHOW PROCESS
   Number   Name         State     Current PC
  *    2 TEST_Y          break     PROG\%LINE 71
  all>

      The SET PROCESS TEST_Y command makes process TEST_Y the visible
      process. The SHOW PROCESS command displays information about
      the visible process by default.