DBG$HELP.HLB  —  DEBUG  SET  EVENT_FACILITY
    Establishes the current event facility.

    Event facilities are available for programs that call Ada or SCAN
    routines or that use POSIX threads services.

    Format

      SET EVENT_FACILITY  facility-name

1  –  Parameters

 facility-name

    Specifies an event facility. Valid facility-name keywords are as
    follows:

    ADA        If the event facility is set to ADA, the (SET,CANCEL)
               BREAK and (SET,CANCEL) TRACE commands recognize Ada-
               specific events as well as generic, low-level task
               events. (Ada events consist of task and exception
               events.)

               You can set the event facility to ADA only if the main
               program is written in Ada or if the program calls an
               Ada routine.
    THREADS    If the event facility is set to THREADS, the
               (SET,CANCEL) BREAK and (SET,CANCEL) TRACE commands
               recognize POSIX threads-specific as well as generic,
               low-level task events. All POSIX threads events are
               task (thread) events.

               You can set the event facility to THREADS only if
               the shareable image CMA$RTL is currently part of the
               program's process (if that image is listed in a SHOW
               IMAGE display).

2  –  Description

    The current event facility (ADA, THREADS, or SCAN) defines the
    eventpoints that you can set with the SET BREAK/EVENT and SET
    TRACE/EVENT commands.

    When started with a program that is linked with an event
    facility, the debugger automatically sets the facility in a
    manner appropriate for the type of program. For example, if the
    main program is written in Ada or SCAN, the event facility is set
    to ADA or SCAN, respectively.

    The SET EVENT_FACILITY command enables you to change the event
    facility and thereby change your debugging context. This is
    useful if you have a multilanguage program and want to debug
    a routine that is associated with an event facility but that
    facility is not currently set.

    Use the SHOW EVENT_FACILITY command to identify the event
    names associated with the current event facility. These are the
    keywords that you can specify with the (SET,CANCEL) BREAK/EVENT
    and (SET,CANCEL) TRACE/EVENT commands.

    Related commands:

       (SET,CANCEL) BREAK/EVENT
       (SET,CANCEL) TRACE/EVENT
       SHOW BREAK
       SHOW EVENT_FACILITY
       SHOW IMAGE
       SHOW TASK
       SHOW TRACE

3  –  Example

  DBG> SET EVENT_FACILITY THREADS

      This command establishes THREADS (POSIX threads) as the current
      event facility.
Close Help