 |
» |
|
|
|
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 Figure 4-2 “DMOVOUT Data Movement.”, 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 ARA[13],
are moved to half word offset 201 through 204 of the data
segment, as shown in Figure 4-2 “DMOVOUT Data Movement.”. Figure 4-2 DMOVOUT Data Movement.
ARA[1..n] Extra Data Segment
1 +--------------+ 0 +--------------+
2 |--------------| 1 |--------------|
3 |--------------| 2 +--------------+
4 |--------------| .
5 |--------------| .
6 |--------------| .
7 |--------------|
8 |--------------| 199 +--------------+
9 |--------------| 200 |--------------|
10 |--------------| ------> 201 |--------------|
11 |--------------| ------> 202 |--------------|
12 |--------------| ------> 203 |--------------|
13 |--------------| ------> 204 +--------------+
14 +--------------+ +--------------+
+--------------+ .
. .
. .
+--------------+ +--------------+
n +--------------+ 209 +--------------+
|
Condition Codes | |
- CCE (2)
Request granted. - CCG (0)
Request denied. Out of bounds-check failure. - CCL (1)
Request denied. Illegal index or number parameter.
Related Information | |
- Intrinsics
DMOVIN - Commands
None - Manuals
Introduction to MPE XL for MPE V Programmers (30367-90005)
|
