HPlogo MPE/iX Intrinsics Reference Manual > Chapter 8 Command Definitions (HPMERGEEND-LOGSTATUS)

HPSETCCODE

MPE documents

Complete PDF
Table of Contents
Index

Edition 7 E0701 ♥
Edition 7 E0300
Edition 6 E0195

NM callable only.

Sets the condition code for the calling process.

Syntax



              I32V
  HPSETCCODE (ccodevalue);

Parameters


ccodevalue

32-bit signed integer by value (required)

Sets the condition code for the calling process.

The valid values are:

ValueMeaning
0Condition Code Greater Than (CCG). A special condition occurred but may not have affected the execution of the request.
1Condition Code Less Than (CCL). The request was not granted because an error condition occurred.
2Condition Code Equal (CCE). The request was granted.

Any other values are converted to 1 (CCL).

Operation Notes


The condition code is implemented as two bits associated with each process. From the condition code value, basic information about what happened during execution of an intrinsic can be learned.

Although Pascal\XL has a built-in function that lets you check the condition code, it does not allow you to set it. If you write procedures and want to return information through a condition code, then use the HPSETCCODE intrinsic. It is the only mechanism for setting the condition code. Only source code compatible routines (implemented in native mode or called through native mode switch stubs) should call HPSETCCODE.

The HPSETCCODE intrinsic is the only mechanism available for setting the condition code in the native mode environment.

Related Information


Intrinsics CCODE, HPGETPROCPLABEL, HPFIRSTLIBRARY, HPLOADCMPROCEDURE, HPLOADNMPROC, HPSETCCODE, HPSWITCHTOCM, HPSWITCHTONMNAME, HPSWTONMPLABEL, HPUNLOADCMPROCEDURE, LOADPROC, UNLOADPROC
Manuals Switch Programming Guide




HPSELECT


HPSETDUMP