pthread_exc_get_status_np(3)				     Library Functions Manual				      pthread_exc_get_status_np(3)

NAME

       pthread_exc_get_status_np - (Macro) Obtains a system-defined error status from a DECthreads status exception object.

LIBRARY

       DECthreads POSIX 1003.1c Library (libpthread.so)

SYNOPSIS

       #include <pthread_exception.h>

       int pthread_exc_get_status_np(
			EXCEPTION	     *exception,
			unsigned long	     *code);

STANDARDS

       None

PARAMETERS

       DECthreads  status  exception object whose status code is obtained.  Receives the system-specific status code associated with the specified
       DECthreads status exception object.

DESCRIPTION

       This routine obtains and returns the system-specific status value from the DECthreads status exception object specified	in  the  exception
       argument.  This value must have already been associated with the exception object using the pthread_exc_set_status_np(3) routine.

       In a program that uses DECthreads status exceptions, use this routine within a CATCH, CATCH_ALL, or FINALLY code block to obtain the status
       code value associated with a caught exception.  Note that any exception objects set to the same status value are considered  equivalent	by
       DECthreads.

RETURN VALUES

       If  an error condition occurs, this routine returns an integer value indicating the type of error.  If the routine's exception object argu-
       ment is a DECthreads status exception, it sets the code argument and return zero (0).  Possible return values are  as  follows:	Successful
       completion.  The exception argument is not a valid DECthreads status exception object.

ERRORS

       None

RELATED INFORMATION

       Functions: pthread_exc_set_status_np(3)

       Manuals: Guide to DECthreads and Programmer's Guide delim off

														      pthread_exc_get_status_np(3)