Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (M)
Guardian Procedure Calls Reference Manual—522629-013
9-67
MOVEX Procedure
24 Either source-seg-id or dest-seg-id specified a privileged
segment ID (greater than 2047), but the caller was not privileged.
29 A required parameter is not supplied.
source-seg-id input
INT:value
specifies the segment ID of the extended data segment referenced by
source. If
the relative segment in
source does not indicate an extended data segment,
source-seg-id is ignored and may be omitted; otherwise it is required and must
indicate an existing extended data segment.
source input
STRING .EXT:ref
specifies the relative extended address of the source of the first byte to be moved.
dest-seg-id input
INT:value
specifies the segment ID of the extended data segment referenced by
dest. If the
relative segment in
dest does not indicate an extended data segment,
dest-seg-id is ignored and may be omitted. Otherwise, dest-seg-id is
required and must indicate an existing extended data segment.
dest input
STRING .EXT:ref
specifies the relative extended address of the first byte in the destination location.
byte-count input
INT (32):value
specifies the number of bytes to be moved from
source to dest.
Considerations
•
MOVEX works properly only on completely separate selectable segments. The
result from a MOVEX operation is undefined if the source and destination ranges
overlap. If these ranges overlap, then the move statements ':=' from TAL and '=:'
from pTAL should be used instead.
•
Segment moves can be performed more efficiently using programming language
statements than using MOVEX to move data between:
•
Areas within the same extended data segment
•
Flat extended data segment