Memory Copy (MEMCPY)

Built-in number for MEMCPY is 15.
MEMCPY (
        target_string   : address of aggregate(*)
        source_string   : address of aggregate(*)
        copy_length     : unsigned binary(4) value which specifies the
                          number of bytes to copy
) :   space pointer(16) to the target string

Description

A copy from the storage specified by source string to the storage specified by target string is performed. Copy length specifies the number of bytes to copy. It is assumed that sufficient storage exists at the target string location to receive the specified number of bytes.

Pointers can be copied using this function. However, the source and target strings must be like-aligned.

Undefined results can occur if the storage locations specified by target string and source string overlap.

Copy Bytes with Pointers (CPYBWP) should be used when possible for performance reasons.

Authorization Required

• None

Lock Enforcement

• None

Exceptions

06 Addressing

• 0601 Space Addressing Violation
• 0602 Boundary Alignment

24 Pointer Specification

• 2401 Pointer Does Not Exist

44 Protection Violation

• 4401 Object Domain or Hardware Storage Protection Violation
• 4402 Literal Values Cannot Be Changed