Guide to DECthreads

Index

• Address exceptions
• Addressing
  • 64-bit
  • 64-bit, for DECthreads
• API
  • See Application Programming Interface (API)
• Application programming interface (API)
  • DECthreads error conditions from
• ASTs
  • See Asynchronous system traps
• Asynchronous cancelation
  • of threads
    • cleanup from
• Asynchronous programming techniques
  • in a multithreaded program
• Asynchronous system traps (AST)
  • DECthreads's delivery of
  • restrictions on use with DECthreads
• Asynchronous thread cancelation
  • cleanup from
• Asynchronous user interface example program
• Attributes
  • of condition variables
  • of mutexes
    • mutex type
  • of threads
    • contention scope
    • guardsize
    • inherit scheduling
    • scheduling policy
    • scheduling priority
    • stack address
    • stack size
• Attributes objects
  • creating
  • destroying

• Background scheduling policy
  • of threads
• Boss/worker functional model
  • work queue variation
• Bugchecks
  • configuring output
  • contents of dump file
  • forming dump file name
  • interpreting output

• Cancelability state
  • of threads
• Cancelability state attribute
  • of thread attributes object
    • setting #1
    • setting #2
• Cancelability type
  • of threads
• Cancelability type attribute
  • of thread attributes object
    • setting
• Cancelation points
  • DECthreads routines that provide #1
  • DECthreads routines that provide #2
  • in DECthreads under OpenVMS Alpha
  • in multithreaded code
  • system service routines that provide
    • under DIGITAL UNIX
    • under OpenVMS Alpha
• Cancelation requests
  • delivering #1
  • delivering #2
  • delivering #3
  • sending
• CATCH macro
• CATCH_ALL macro
• Cleanup handlers
  • executing
  • of threads
  • registering
• cma interface
  • See DIGITAL-proprietary CMA (cma) interface #1
  • See DIGITAL-proprietary CMA (cma) interface #2
• Compiling applications
  • under DIGITAL UNIX
  • under OpenVMS
  • under Windows NT
• Concurrency level
  • of threads
    • getting
    • setting
• Condition handlers
  • declaring for DECthreads
• Condition handlers (OpenVMS)
  • declaring
• Condition values (OpenVMS)
  • used by DECthreads
• Condition variable attributes objects #1
• Condition variable attributes objects #2
  • creating
  • destroying
  • initializing
• Condition variables
  • creating #1
  • creating #2
  • destroying #1
  • destroying #2
  • distinguishing from mutexes
  • initializing #1
  • initializing #2
  • naming #1
  • naming #2
  • signaling #1
  • signaling #2
  • under the DECthreads thread-independent services (tis) interface
  • using in thread-safe library code
  • waiting a specified time interval for #1
  • waiting a specified time interval for #2
  • waiting indefinitely for #1
  • waiting indefinitely for #2
  • waiting indefinitely for #3
  • wakeups for waiting threads #1
  • wakeups for waiting threads #2
  • wakeups for waiting threads #3
  • wakeups for waiting threads #4
  • wakeups for waiting threads #5
• Contention scope
  • interaction with thread scheduling attributes
  • of threads
• Contention scope attribute
  • of thread attributes object
    • getting
    • setting

• d4 interface
  • See POSIX 1003.4a/Draft 4 (d4) interface #1
  • See POSIX 1003.4a/Draft 4 (d4) interface #2
• Data
  • See Thread-specific data
• Deadlocks #1
• Deadlocks #2
  • among threads
  • avoiding
• Debugging tools
  • for DECthreads applications
  • metered mode
  • under DIGITAL UNIX
  • under OpenVMS
  • under Windows NT
• DECthreads
  • 64-bit addressing
  • application programming interface error conditions
  • blocking OpenVMS system services
  • blocking system services
  • bugcheck feature
    • See Bugchecks
  • cancelability of system services #1
  • cancelability of system services #2
  • cancelability of system services #3
  • compiling applications
    • under DIGITAL UNIX
    • under OpenVMS
    • under Windows NT
  • condition values used
  • debugging applications
  • declaring OpenVMS condition handlers
  • delivery of OpenVMS ASTs
  • dynamic activation
    • under DIGITAL UNIX
    • under OpenVMS
  • effects of DCL commands
  • effects of OpenVMS DCL commands
  • error conditions
    • application programming interface level
    • internal
  • exiting from images
  • exiting from OpenVMS images
  • global lock
    • avoiding software that lacks thread safety
    • using from the tis interface
  • header files
    • under DIGITAL UNIX
    • under OpenVMS
  • interactions with OpenVMS
  • interfaces
    • DIGITAL-proprietary CMA (cma)
    • in C language
    • in languages other than C
    • obsolete
    • POSIX 1003.4a/Draft 4 (d4)
    • POSIX.1c (pthread)
    • thread-independent services (tis)
    • undocumented but supported
  • internal error conditions
  • interoperability
    • with errno variable #1
    • with errno variable #2
    • with POSIX for OpenVMS layered product
    • with signals (DIGITAL UNIX)
    • with Win32 application programming interface
  • libraries
  • linking applications
    • under DIGITAL UNIX
    • under Windows NT
  • linking with shared libraries (DIGITAL UNIX)
  • platform dependencies
    • for DIGITAL UNIX
    • for OpenVMS
    • for Windows NT
  • POSIX.1003.4a/Draft 4 (d4) interface
  • POSIX.1c (pthread) interface
  • real-time scheduling
  • thread-independent services (tis) interface #1
  • thread-independent services (tis) interface #2
  • thread-independent services (tis) interface #3
  • two-level scheduling #1
  • two-level scheduling #2
    • under DIGITAL UNIX
    • under OpenVMS Alpha
  • use of kernel threads
    • under DIGITAL UNIX
    • under OpenVMS Alpha
  • virtual processors
  • virtual processors (OpenVMS)
• DECthreads exceptions package
• DECthreads global mutex
  • locking #1
  • locking #2
  • unlocking #1
  • unlocking #2
• Default mutexes
• Detachstate attribute
  • of thread attributes object
    • getting
    • setting
• DIGITAL-proprietary CMA (cma) interface #1
• DIGITAL-proprietary CMA (cma) interface #2
• DIGITAL UNIX operating system
  • using DECthreads with
• Dynamic activation
  • of DECthreads
    • under DIGITAL UNIX
    • under OpenVMS
• Dynamic memory
  • using from threads

• errno variable #1
• errno variable #2
• Error conditions
  • detecting
  • from DECthreads application programming interface
  • internal to DECthreads
• Errorcheck mutexes
• Event flags
• Event flags (OpenVMS)
• Example programs
  • asynchronous user interface
  • multithreaded asynchronous user interface
  • multithreaded prime number search
  • prime number search
• Exception scopes
• Exceptions
  • address
  • cancelation of threads
  • CATCH macro
  • catching
    • all
    • specific
  • CATCH_ALL macro
  • conventions for modular use
  • debugging when unhandled (OpenVMS)
  • DECthreads-defined objects
  • DECthreads exceptions package
  • DECthreads package
  • epilogue actions for
  • failing
    • due to condition handlers
  • FINALLY macro #1
  • FINALLY macro #2
  • importing error status into
  • interoperability of
  • language-specific
  • matching two #1
  • matching two #2
  • naming conventions for
  • obtaining error status from #1
  • obtaining error status from #2
  • operations on
  • programming for
  • programming languages supported for
  • pthread_exc_get_status_np() routine #1
  • pthread_exc_get_status_np() routine #2
  • pthread_exc_matches_np() routine #1
  • pthread_exc_matches_np() routine #2
  • pthread_exc_report_np() routine #1
  • pthread_exc_report_np() routine #2
  • pthread_exc_set_status_np() routine #1
  • pthread_exc_set_status_np() routine #2
  • purpose of
  • RAISE macro
  • raising
  • referencing when caught
  • relation to return codes and signals
  • reporting
  • reporting when caught
  • RERAISE macro #1
  • RERAISE macro #2
  • reraising
  • scope of
  • setting error status in
  • status
  • synchronous signals reported as
  • termination of
  • THIS_CATCH exception object
  • TRY macro
  • unhandled
• Expiration time
  • obtaining