Assigns a symbolic name to a list of process specifications.

    Format

      DEFINE/PROCESS_SET  process-set-name =process-spec[, . . . ]

1  –  Parameters

 process-set-name

    Specifies a symbolic name to be assigned to a list of process
    specifications. The symbolic name can be composed of alphanumeric
    characters and underscores. The debugger converts lowercase
    alphabetic characters to uppercase. The first character must not
    be a number. The symbolic name must be no more than 31 characters
    long.

 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.

    If you do not specify a process, the symbolic name is created but
    contains no process entries.

2  –  Description

    The DEFINE/PROCESS_SET command assigns a symbol to a list of
    process specifications. You can then use the symbol in any
    command where a list of process specifications is allowed.

    The DEFINE/PROCESS_SET command does not verify the existence of a
    specified process. This enables you to specify processes that do
    not yet exist.

    To identify a symbol that was defined with the DEFINE/PROCESS_SET
    command, use the SHOW SYMBOL/DEFINED command. To delete a symbol
    that was defined with the DEFINE/PROCESS_SET command, use the
    DELETE command.

    Related commands:

       DELETE
       (SET,SHOW) DEFINE
       SHOW SYMBOL/DEFINED

3  –  Examples

    1.all> DEFINE/PROCESS_SET SERVERS=FILE_SERVER,NETWORK_SERVER
      all> SHOW PROCESS SERVERS
       Number  Name               State   Current PC
      *    1 FILE_SERVER          step    FS_PROG\%LINE 37
           2 NETWORK_SERVER       break   NET_PROG\%LINE 24
      all>

      This DEFINE/PROCESS_SET command assigns the symbolic name
      SERVERS to the process set consisting of FILE_SERVER and
      NETWORK_SERVER. The SHOW PROCESS SERVERS command displays
      information about the processes that make up the set SERVERS.

    2.all> DEFINE/PROCESS_SET G1=%PROCESS_NUMBER 1,%VISIBLE_PROCESS
      all> SHOW SYMBOL/DEFINED G1
      defined G1
          bound to: "%PROCESS_NUMBER 1, %VISIBLE_PROCESS"
          was defined /process_set
      all> DELETE G1

      This DEFINE/PROCESS_SET command assigns the symbolic name G1 to
      the process set consisting of process 1 and the visible process
      (process 3). The SHOW SYMBOL/DEFINED G1 command identifies the
      defined symbol G1. The DELETE G1 command deletes the symbol
      from the DEFINE symbol table.

    3.all> DEFINE/PROCESS_SET A = B,C,D
      all> DEFINE/PROCESS_SET B = E,F,G
      all> DEFINE/PROCESS_SET E = I,J,A
      %DEBUG-E-NORECSYM, recursive PROCESS_SET symbol definition
           encountered at or near "A"

      This series of DEFINE/PROCESS_SET commands illustrate valid and
      invalid uses of the command.