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.39 UNSTRING Statement



The UNSTRING statement causes contiguous data in a sending field to be separated and placed into multiple receiving fields.


    ___ Format _______________________________________________________________________________________ 
   |                                                                                                  |
   | >>__UNSTRING__identifier-1_____________________________________________________________________> |
   |                                                                                                  |
   | >__ _____________________________________________________________________________________ _____> |
   |    |_DELIMITED__ ____ __ _____ __ _identifier-2_ __ ___________________________________ _|       |
   |                 |_BY_|  |_ALL_|  |_literal-1____|  | <_______________________________  |         |
   |                                                    |___OR__ _____ __ _identifier-3_ _|_|         |
   |                                                            |_ALL_|  |_literal-2____|             |
   |                                                                                                  |
   | >__INTO________________________________________________________________________________________> |
   |                                                                                                  |
   |    <____________________________________________________________________________________         |
   | >____identifier-4__ _________________________________ __ _____________________________ _|______> |
   |                    |_DELIMITER__ ____ __identifier-5_|  |_COUNT__ ____ __identifier-6_|          |
   |                                 |_IN_|                           |_IN_|                          |
   |                                                                                                  |
   | >__ _________________________________ __ ________________________________ _____________________> |
   |    |_ ______ __POINTER__identifier-7_|  |_TALLYING__ ____ __identifier-8_|                       |
   |      |_WITH_|                                       |_IN_|                                       |
   |                                                                                                  |
   | >__ __________________________________________ ________________________________________________> |
   |    |_ ____ __OVERFLOW__imperative-statement-1_|                                                  |
   |      |_ON_|                                                                                      |
   |                                                                                                  |
   | >__ _______________________________________________ __ ______________ ________________________>< |
   |    |_NOT__ ____ __OVERFLOW__imperative-statement-2_|  |_END-UNSTRING_|                           |
   |           |_ON_|                                                                                 |
   |                                                                                                  |
   |__________________________________________________________________________________________________|

X None of the identifiers in an UNSTRING statement can be windowed date
X fields.

identifier-1
Represents the sending field. Data is transferred from this field to the data receiving fields (identifier-4).

It must be an alphanumeric data item.


X As an IBM extension, identifier-1 can be reference-modified. It can
X be an alphanumeric-edited or an alphabetic data item. It can also be
X a DBCS data item.

One UNSTRING statement can take the place of a series of MOVE statements, except that evaluation or calculation of certain elements is performed only once, at the beginning of the execution of the UNSTRING statement. For more information, see "Values at the End of Execution of the UNSTRING Statement" in topic 6.2.39.7.1.

The rules for moving an alphanumeric elementary item are the same as those for the MOVE statement (see "MOVE Statement" in topic 6.2.24).

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.