Library View Topics Framed Contents Revised Topics Previous Topic Next Topic Search Search ResultsPrevious Topic MatchNext Topic Match Notes List Notes Print Download No PDF Handheld DisconnectedHandheld ConnectedHelp

6.2.37 STRING Statement



The STRING statement strings together the partial or complete contents of two or more data items or literals into one single data item.

One STRING statement can be written instead of a series of MOVE statements.


    ___ Format _____________________________________________________________ 
   |                                                                        |
   | >>__STRING___________________________________________________________> |
   |                                                                        |
   |    <___________________________________________________________        |
   |      <__________________                                       |       |
   | >______ _identifier-1_ _|__DELIMITED__ ____ __ _identifier-2_ _|_____> |
   |        |_literal-1____|               |_BY_|  |_literal-2____|         |
   |                                               |_SIZE_________|         |
   |                                                                        |
   | >__INTO__identifier-3__ _________________________________ ___________> |
   |                        |_ ______ __POINTER__identifier-4_|             |
   |                          |_WITH_|                                      |
   |                                                                        |
   | >__ __________________________________________ ______________________> |
   |    |_ ____ __OVERFLOW__imperative-statement-1_|                        |
   |      |_ON_|                                                            |
   |                                                                        |
   | >__ _______________________________________________ _________________> |
   |    |_NOT__ ____ __OVERFLOW__imperative-statement-2_|                   |
   |           |_ON_|                                                       |
   |                                                                        |
   | >__ ____________ ___________________________________________________>< |
   |    |_END-STRING_|                                                      |
   |                                                                        |
   |________________________________________________________________________|

X None of the identifiers in a STRING statement can be windowed date fields.

identifier-1
Represents the sending field(s).

All identifiers (except identifier-4, the POINTER item) must have USAGE DISPLAY, explicitly or implicitly.

When the sending field or any of the delimiters is an elementary numeric item, it must be described as an integer, and its PICTURE character-string must not contain the symbol P.

literal-1
Represents the sending field(s).

All literals must be nonnumeric literals; each may be any figurative constant except the ALL literal. When a figurative constant is specified, it is considered a 1-character nonnumeric literal.


X identifier-1 through identifier-3

X May be DBCS data items. If one of these identifiers is a DBCS item,
X then all of them, and all literals, must be DBCS items. May not be
X external floating-point items.


X literal-1 and literal-2

X May be DBCS literals. If one of these is a DBCS literal, then all of
X them must be DBCS literals, and identifier-1 through identifier-3 must
X be DBCS items.


X SPACE is the only figurative constant allowed for DBCS items.

Subtopics:



Previous Topic Next Topic Copyright IBM Corp. 1991, 1998

IBM Library Server Copyright 1989, 2005 IBM Corporation. All rights reserved.





Return to library:   z/OS | z/OS.e | TPF | z/VSE | z/VM | IBM Hardware | IBM System z Redbooks
Glossary:   IBM terminology
Publications:   How to order publications
Readers:   Download IBM Library Reader | Download IBM Softcopy Reader | Download Adobe® Acrobat® Reader®
Library management:   Download IBM Softcopy Librarian
Contacts:   Contact z/OS


Adobe, the Adobe logo, Acrobat, the Acrobat logo, and Acrobat Reader are registered trademarks of Adobe Systems incorporated.