HP 3000 Manuals HP 3000 Manuals
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 Figure 4-2 , 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 . ___________________________________________________________ | | | | | 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 +--------------+ | | | | | ___________________________________________________________ Figure 4-2. DMOVOUT Data Movement. 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)