Displays information about processes that are currently under
    debugger control.

    Format

      SHOW 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 or the /ALL
    qualifier to specify all processes. Do not specify a process with
    /ALL or /DYNAMIC. If you do not specify a process or /ALL with
    /BRIEF, /FULL, or /[NO]HOLD, the visible process is selected.

2  –  Qualifiers

2.1    /ALL

    Selects all processes known to the debugger for display.

2.2    /BRIEF

    (Default) Displays only one line of information for each process
    selected for display.

2.3    /DYNAMIC

    Shows whether dynamic process setting is enabled or disabled.
    Dynamic process setting is enabled by default and is controlled
    with the SET PROCESS/[NO]DYNAMIC command.

2.4    /FULL

    Displays maximum information for each process selected for
    display.

2.5    /VISIBLE

    (Default). Selects the visible process for display.

3  –  Description

    The SHOW PROCESS command displays information about specified
    processes and any images running in those processes.

    The SHOW PROCESS/FULL command also displays information about the
    availability and use of the vector processor. This information
    is useful if you are debugging a program that uses vector
    instructions.

    A process can first appear in a SHOW PROCESS display as soon as
    it comes under debugger control. A process can no longer appear
    in a SHOW PROCESS display if it is terminated through an EXIT or
    QUIT command.

    By default (/BRIEF), one line of information is displayed for
    each process, including the following:

    o  The process number assigned by the debugger. A process number
       is assigned sequentially, starting with process 1, to each
       process that comes under debugger control. If a process is
       terminated by an EXIT or QUIT command, its process number is
       not reused during that debugging session. The visible process
       is marked with an asterisk (*)  in the leftmost column.

    o  The process name.

    o  The current debugging state for that process.

    o  The location (symbolized, if possible) at which execution of
       the image is suspended in that process.

    The SHOW PROCESS/FULL command gives additional information about
    processes (see the examples).

    Related commands:

       CONNECT
       Ctrl/C
       DEFINE/PROCESS_SET
       EXIT
       QUIT
       SET PROCESS

4  –  Examples

    1.all> SHOW PROCESS
       Number  Name             State      Current PC
      *    2 _WTA3:             break      SCREEN\%LINE 47
      all>

      By default, the SHOW PROCESS command displays one line of
      information about the visible process (which is identified
      with an asterisk (*)  in the leftmost column). The process has
      the process name _WTA3:. It is the second process brought under
      debugger control (process number 2). It is on hold, and the
      image's execution is suspended at a breakpoint at line 47 of
      module SCREEN.

    2.all> SHOW PROCESS TEST_3
       Number  Name          State       Current PC
           7 TEST_3          watch of TEST_3\ROUT4\COUNT
                                             TEST_3\%LINE 54
      all>

      This SHOW PROCESS command displays one line of information
      about process TEST_3. The image is suspended at a watchpoint of
      variable COUNT.

    3.all> SHOW PROCESS/DYNAMIC
      Dynamic process setting is enabled
      all>

      This command indicates that dynamic process setting is enabled.