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:

Value

Meaning

0

Condition Code Greater Than (CCG). A special condition occurred but may not have 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). 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


Manual

Switch Programming Guide




HPSELECT


HPSETDUMP