Joining data items (STRING)
Use the STRING statement to join all
or parts of several data items or literals into
one data item. One STRING statement can take the
place of several MOVE statements.
About this task
The STRING statement transfers data
into a receiving data item in the order that you indicate. In the STRING statement
you also specify:
- A delimiter for each set of sending fields that, if
encountered, causes those sending fields to stop being transferred
(
DELIMITED BYphrase) - (Optional) Action to be taken if the receiving field is filled
before all of the sending data has been processed (
ON OVERFLOWphrase) - (Optional) An integer data item that indicates the
leftmost character position within the receiving field into which
data should be transferred (
WITH POINTERphrase)
The receiving data item must not be an edited item, or a display or national floating-point item. If the receiving data item has:
USAGE DISPLAY, each identifier in the statement except thePOINTERidentifier must haveUSAGE DISPLAY, and each literal in the statement must be alphanumericUSAGE NATIONAL, each identifier in the statement except thePOINTERidentifier must haveUSAGE NATIONAL, and each literal in the statement must be nationalUSAGE DISPLAY-1, each identifier in the statement except thePOINTERidentifier must haveUSAGE DISPLAY-1, and each literal in the statement must be DBCS
Only that portion of the receiving field into
which data is written by the STRING statement is
changed.