MPE/iX Intrinsics Reference Manual (32650-90875)

446 Chapter8
Command Definitions (HPMERGEEND-LOGSTATUS)
HPSWITCHTOCM
fretlen 32-bit signed integer by value (optional)
The length in bytes of the optional functional return value.
fretval record by value (optional)
NM pointer to the beginning of the area to which the optional functional
return value is returned.
condcode 16-bit signed integer by reference (optional)
Returns the condition code that the target CM procedure returns. Valid
values are in the range 0..2.
NOTE If a call to HPSWITCHTOCM fails, the value of the condcode parameter becomes
undefined. Before attempting to use the
condcode , first check the value of the
status parameter.
status 32-bit signed integer by reference (optional)
Returns the status of the HPSWITCHTOCM intrinsic call. If no errors or
warnings are encountered,
status returns 32 bits of zero. If errors or
warnings are encountered,
status is interpreted as two 16-bit fields.
Bits (0:16) comprise
status.info . A negative value indicates an error
condition, and a positive value indicates a warning condition. Refer to the
MPE/iX Error Message Manual Volumes 1, 2 and 3 for a description of its
value.
Bits (16:16) comprise
status.subsys . The value represented by these bits
defines the subsystem that set the status information. The subsystem
identifier for HPSWITCHTOCM is 100.
Operation Notes
There are differences in data and variable representations between NM and CM.
Programs that switch from NM to CM must use the HPSWITCHTOCM intrinsic which
provides mixed-mode execution access and performs the necessary parameter translation
between the two modes of execution.
Related Information
Manual Switch Programming Guide