HP 3000 Manuals

ccode [ HP C/iX Library Reference Manual ] MPE/iX 5.0 Documentation


HP C/iX Library Reference Manual

ccode 

Retrieves the condition code for the calling process.

Syntax 

     #include <mpe.h>
     int ccode();

Parameters 

None.

Return Values 

The general meanings of the values returned by ccode are described below.
The specific meaning depends upon the intrinsic called.  Refer to the
individual intrinsic descriptions in the MPE/iX Intrinsics Reference 
Manual for details on the specific meaning.

-----------------------------------------------------------------------------------------------
|          |                                |                                                 |
|  Value   |         Condition Code         |                   Description                   |
|          |                                |                                                 |
-----------------------------------------------------------------------------------------------
|          |                                |                                                 |
|    0     | Condition Code Greater Than    | A special condition occurred but may not have   |
|          | (CCG)                          | affected the execution of the request.          |
|          |                                |                                                 |
-----------------------------------------------------------------------------------------------
|          |                                |                                                 |
|    1     | Condition Code Less Than (CCL) | The request was not granted because an error    |
|          |                                | condition occurred.                             |
|          |                                |                                                 |
-----------------------------------------------------------------------------------------------
|          |                                |                                                 |
|    2     | Condition Code Equal (CCE)     | This usually indicates that a request was       |
|          |                                | granted.                                        |
|          |                                |                                                 |
-----------------------------------------------------------------------------------------------

Description 

The ccode function retrieves the two bit condition code for the calling
process.  A condition code is a process-specific value that provides
information about the completion status of system intrinsic functions
calls.  Many intrinsics use the condition code to signal success,
warning, or failure.  From the condition code value, you can learn some
basic information about what happened during execution of the intrinsic.



MPE/iX 5.0 Documentation