Guardian Procedure Calls Reference Manual

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.
Returned Value
INT
A file-system error code that indicates the outcome of the call:
Successful call; the specified data was moved.0
Either source-seg-id or dest-seg-id specified a nonexistent extended data segment, or the destination
data segment has read-only access.
2
One of the parameters specifies an address that is out of bounds.22
Either source-seg-id or dest-seg-id specified a privileged segment ID (greater than 2047), but the
caller was not privileged.
24
A required parameter is not supplied.29
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 must 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
◦ the currently in-use selectable segment and flat extended data segments
◦ nonextended relative locations
◦ extended and nonextended relative locations
• If the caller is privileged, no bounds checking is performed.
MOVEX Procedure 839