HPSWITCHTOCM

Syntax

                REC   I32V    I32V      RECA
  HPSWITCHTOCM (proc, method, numparms, parms,
                I32V     RECV     I16       I32
                fretlen, fretval, condcode, status);

Parameters

proc

record (required)

Passes the target CM procedure identifier, which you can specify either by a library to search and an ASCII name of up to 16 characters or by a CM plabel (obtained from the HPLOADCMPROCEDURE or LOADPROC intrinsic).

The structure of the proc record varies, depending on how the target procedure is identified. All variants have a p_proc_id_type field.

method

32-bit signed integer by value (required)

Passes a value indicating whether the CM target procedure runs in normal, split-stack, or no-copy mode. Valid values are:

Value	Meaning
0	Normal (non-split-stack)
1	Split-stack
2	No-copy

NOTE: If all parameters are within the CM stack or the length of the reference parameters are less than the threshold, use the normal value. If the reference parameters are outside of the CM stack (split-stack), wrap the reference parameters in an extra data segment if the reference parameters are outside of the CM stack (split-stack method). The no-copy method is the same as the split-stack method, except that the threshold check is omitted.

numparms

32-bit signed integer by value (required)

The number of parameters you are passing to the CM target procedure.

parms

array of records (required)

Passes descriptions of each parameter being passed to the CM target procedure. Each parameter is located and described by a record in this array.

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

Related Information