MULTIPROCESS

Controls the behavior of z/OS® Debugger when a new POSIX process is created by a fork() or exec() function in the application.

With the MULTIPROCESS command, you can instruct z/OS Debugger to perform any of the following tasks when a new POSIX process is created:
  • Continue debugging the current process. The current process is also referred to as the PARENT process.
  • Stop debugging the current process and start debugging the newly created process. The newly created process is also referred to as the CHILD process.
  • Prompt you to decide whether to follow the PARENT or CHILD process.
Note: The MULTIPROCESS command applies only to remote debug mode.
The following diagram describes the syntax of the MULTIPROCESS command:
Read syntax diagramSkip visual syntax diagramEQAXOPTMULTIPROCESS, PARENTCHILDPROMPT ,EXEC=NONEANY
The following list describes the parameters of the MULTIPROCESS command:
PARENT
Indicates that z/OS Debugger continues with the current debug session; that is, z/OS Debugger follows the PARENT process.
CHILD
Indicates that z/OS Debugger stops debugging the current process and starts debugging the newly created process; that is, z/OS Debugger follows the CHILD process.
PROMPT
Indicates that the remote debug GUI prompts you to decide whether to follow the PARENT or CHILD process.
EXEC=ANY
Indicates that z/OS Debugger debugs any process that is reinitialized by the exec() function.
EXEC=NONE
Indicates that z/OS Debugger does not debug a process that is reinitialized by the exec() function. If you do not specify the EXEC option, the default setting is EXEC=NONE.

Examples

  • Specify that z/OS Debugger follows the PARENT process and debugs the new process that is created by the exec() function.
    EQAXOPT MULTIPROCESS,PARENT,EXEC=ANY
  • Specify that z/OS Debugger follows the CHILD process and does not debug the new process that is created by the exec() function.
    EQAXOPT MULTIPROCESS,CHILD,EXEC=NONE
  • Specify that you are prompted to choose whether to follow the PARENT or CHILD process and z/OS Debugger does not debug the new process that is created by the exec() function.
    EQAXOPT MULTIPROCESS,PROMPT