MPE/iX Intrinsics Reference Manual (32650-90905)

100 Chapter4
Command Definitions (ABORTSESS - FCLOSE)
DMOVOUT
DMOVOUT
NM and CM callable.
Copies data from the data area to an extra data segment. Data segment management (DS)
capability is required.
NOTE Data segment management (DS) intrinsics are not recommended for use in
the NM programming environment; use of DS intrinsics in NM degrades the
NM program's performance.
Syntax
U16V I16V I16V U16A
DMOVOUT(
index,displacement,number,location );
Parameters
index 16-bit unsigned integer by value (required)
Specifies the index of the extra data segment, obtained from a GETDSEG
intrinsic call.
displacement 16-bit signed integer by value (required)
Specifies the displacement, in half words, of the first half word in the
string to be transferred from the first half word in the data segment. This
value must be >=0.
number 16-bit signed integer by value (required)
Specifies the size, in half words, of the data string to be passed. This value
must be >=0.
location 16-bit unsigned integer array (required)
Passes the data string to be moved to the extra data segment.
Operation Notes
When DMOVOUT is called, a bounds check is initiated to ensure that the data is taken from
within an available data area and moved to an area within the extra data segment
boundaries. For example, in <Undefined Cross-Reference>, to move four half words from
ARA[10] to the data segment whose
index is 2 (from a GETDSEG call), starting at location
201 within the segment, the intrinsic call could be:
DMOVOUT (2,201,4,ARA[10]);
The
index is 2; the displacement within the data segment is 201; the number of half
words to be moved to the data segment is 4; and the starting
location of the data is the
address of ARA[10]. If ARA is an array of half words, the four half words, from ARA[10] to