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.21.5 CONVERTING Phrase (Format 4)
This phrase converts all occurrences of specific characters in a data item to user-supplied replacement characters. It can express a string of replacement values.
identifier-6 or literal-4
Is the sending location.
Identifier-6 can be:
  • An elementary alphanumeric data item
  • A numeric data item with USAGE DISPLAY
  • X An external floating point item
Literal-4 must be nonnumeric, and can be any figurative constant that does not begin with the word ALL. If literal-4 is a figurative constant, it refers to an implicit 1 character data item.
identifier-7 or literal-5
Is the receiving location.
The receiving location (identifier-7 or literal-5) must be the same size as the sending location (identifier-6 or literal-4).
Identifier-7 can be:
  • An elementary alphanumeric data item
  • A numeric data item with USAGE DISPLAY
  • X An external floating point item
Literal-5 must be nonnumeric and can be any figurative constant that does not begin with the word ALL. When a figurative constant is used, the size should be equal to the size of literal-4 or identifier-6.
The same character must not appear more than once in either literal-4 or identifier-6.
A Format 4 INSPECT statement is interpreted and executed as if a Format 2 INSPECT statement had been written with a series of ALL phrases (one for each character of literal-4), specifying the same identifier-1. The effect is as if each single character of literal-4 were referenced as literal-1, and the corresponding single character of literal-5 referenced as literal-3. Correspondence between the characters of literal-4 and the characters of literal-5 is by ordinal position within the data item.
If identifier-4, identifier-6, or identifier-7 occupies the same storage area as identifier-1, the result of the execution of this statement is undefined, even if they are defined by the same data description entry.

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.