Copy Bytes (CPYBYTES)

Instruction Syntax

Bound Program Access

Bound Program Access
`Built-in number for CPYBYTES is 9. CPYBYTES ( target_string : address of aggregate() source_string : address of aggregate() copy_length : unsigned binary(4,8) value which specifies the number of bytes to copy )`

Built-in number for CPYBYTES is 9.
CPYBYTES (                                                                      
          target_string   : address of aggregate(*)                             
          source_string   : address of aggregate(*)                             
          copy_length     : unsigned binary(4,8) value which specifies the         
                            number of bytes to copy                             
)

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 locations specified by source string and target string.

Pointers cannot be copied using this instruction.

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

Authorization Required

None

Lock Enforcement

None

Exceptions

06 Addressing
- 0601 Space Addressing Violation
- 0602 Boundary Alignment
1C Machine-Dependent
- 1C03 Machine Storage Limit Exceeded
20 Machine Support
- 2002 Machine Check
- 2003 Function Check
24 Pointer Specification
- 2401 Pointer Does Not Exist
2E Resource Control Limit
- 2E01 User Profile Storage Limit Exceeded
44 Protection Violation
- 4401 Object Domain or Hardware Storage Protection Violation
- 4402 Literal Values Cannot Be Changed