condition subcommand for dbx: Display a list of active condition variables

Format

Description

The condition subcommand displays a list of active condition variables for the application program. All active condition variables are listed unless you use the number parameter to specify the condition variables you want listed. You can also select condition variables with or without waiters by using the wait or nowait options.

In order to capture the condition variables, dbx must be debugging your program before the condition variable is created. You must have coded your application in one of the following ways:
  • Add the following line at the top of the C program:
    &numsign;pragma runopts(TEST(ALL))

    Or:

  • Start of changeCode an assembler program, CEEUOPT, to invoke the CEEXOPT macro, which specifies TEST(ALL). For examples of how to code this program, see z/OS Language Environment Programming Guide.End of change

Usage notes

The condition subcommand can be run only while the dbx debug program is running.

Examples

  1. To display all condition variables, enter:
    condition
  2. To display condition variables number 1 and number 4, enter:
    condition 1 4
  3. To display all condition variables with waiters, enter:
    condition wait
  4. To display all condition variables without waiters, enter:
    condition nowait