Skip to main content

Software  >  Software Development  >  

Action required for users of COBOL on z/OS
 Flash (Alert)
 
Abstract
The COBOL SEARCH ALL statement behaves differently after you apply the PTFs for Language Environment(LE) APAR PQ95214 or install z/OS 1.7 or later.

PTFs for Language Environment and Enterprise COBOL for z/OS Version 3.4 are now available that:

1. Restore compatible behavior for SEARCH ALL statements in programs compiled with Enterprise COBOL for z/OS 3.3 or earlier releases of IBM COBOL.

2. Limit the new behavior for SEARCH ALL to programs compiled with Enterprise COBOL for z/OS Version 3.4 or later.

New diagnostics and documentation updates are provided to aid in the migration to Enterprise COBOL for z/OS Version 3.4.


ACTION IS REQUIRED IF ANY OF THE FOLLOWING APPLIES TO YOU:

  • If you have COBOL programs containing SEARCH ALL statements and have applied either PTF UK04867, UK04868, or UK04869 for Language Environment APAR PQ95214, perform the actions outlined in item 1 below.

  • If you have COBOL programs containing SEARCH ALL statements and you are running Language Environment for z/OS 1.7, perform the actions outlined in item 1 below.

  • If you are using the Enterprise COBOL for z/OS Version 3.4 compiler, perform the actions outlined in item 1 and item 2 below.

  • If you are planning on migrating to the Enterprise COBOL for z/OS Version 3.4 compiler, perform the actions outlined in item 3 below.

 
Content

  1. If you have COBOL programs containing SEARCH ALL statements AND have installed PTF UK04867, UK04868, or UK04869 for Language Environment APAR PQ95214

    OR

    If you have COBOL programs containing SEARCH ALL statements AND you are running Language Environment for z/OS 1.7:

    You must apply the Language Environment PTF that applies to the version of z/OS that you are using as specified below:

    APAR FMIDOperating systemPTFDownloadDocumentation
    PK15432*HLE7707 z/OS English Language Environment 1.4UK11157 Download this PTFAPAR PK15432 text
    JLE77J7z/OS Japanese Language Environment 1.4UK11158Download this PTF
    HLE7708z/OS English Language Environment 1.5UK11159 Download this PTF
    JLE77J8z/OS Japanese Language Environment 1.5UK11160 Download this PTF
    HLE7709z/OS English Language Environment 1.6UK11161 Download this PTF
    JLE77J9 z/OS Japanese Language Environment 1.6UK11162 Download this PTF
    HLE7720z/OS English Language Environment 1.7UK11163 Download this PTF
    JLE772Jz/OS Japanese Language Environment 1.7UK11164 Download this PTF

    * Note: There is no fix for APAR PK15432 for LE zOS Version 1.8 because the related code is included in the LE zOS Version 1.8 Base.


    Applying the appropriate PTF restores the previous behavior of the SEARCH ALL statement for existing applications that were compiled with earlier releases of COBOL prior to Enterprise COBOL for z/OS Version 3.4 and provides the modified behavior only for programs compiled with Version 3.4 or later.

    Top of page


  2. If you are running Enterprise COBOL for z/OS Version 3.4, apply the appropriate Language Environment PTF specified in item 1, and also apply the following PTF for Enterprise COBOL for z/OS Version 3.4:

    APAR FMIDCompiler versionPTFDownloadDocumentation
    PK16765H26L340EnglishUK13240 Download this PTFRefer to Chapter 19 in the updated Enterprise COBOL for z/OS Migration Guide GC27-1409-04 at http://www.ibm.com/software/awdtools/cobol/zos/library/ for complete information about the actions required for migration

    Refer to Chapter 21 in the updated Enterprise COBOL for z/OS Language Reference SC27-1408-04 located at http://www.ibm.com/software/awdtools/cobol/zos/library/

    APAR PK16765 text
    J26L341 UppercaseUK13241 Download this PTF
    J26L342 JapaneseUK13242 Download this PTF


    NOTE: It is recommended that COBOL programs be recompiled if they contain SEARCH ALL statements and were originally compiled with Enterprise COBOL for z/OS Version 3.4 prior to installing the PTF for APAR PK16765. Without a recompile, error checking and generation of diagnostics for potential SEARCH ALL migration considerations are not available.


    To fully correct SEARCH ALL behavior, you must apply the applicable Language Environment PTF as specified in item 1, and you must recompile your applications with an Enterprise COBOL for z/OS Version 3.4 compiler that has been updated with the PTF for APAR PK16765.

    3. Top of page


  3. If you are planning to migrate to the Enterprise COBOL for z/OS Version 3.4 compiler:

    1. Refer to Chapter 19 in the updated Enterprise COBOL for z/OS Migration Guide GC27-1409-04 at http://www.ibm.com/software/awdtools/cobol/zos/library/ for complete information about the actions required for migration.

    2. Install Enterprise COBOL for z/OS Version 3.4 in a data set separate from your production compiler.

    3. Install the PTF for APAR PK16765 as specified in item 2.

    4. Use the new diagnostic capabilities of Enterprise COBOL for z/OS Version 3.4 that are described in the Enterprise COBOL for z/OS Version 3.4 Migration Guide to identify and move your existing COBOL programs that are impacted by the updated behavior of SEARCH ALL in Version 3.4.




    4. Top of page

 
Related information
Enterprise COBOL for z/OS publications
 
 
Cross Reference information
Segment Product Component Platform Version Edition
Software DevelopmentCOBOL for OS/390 & VMOS/390, z/OS1.2, 2.1, 2.2, 1.1.1, 2.1.2, 2.1.1
 
 

Copyright and trademark information
IBM, the IBM logo and ibm.com are trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the Web at "Copyright and trademark information" at www.ibm.com/legal/copytrade.shtml.
Rate this page
Please take a moment to complete this form to help us better serve you.
This material provides me with the information I need.




This material is clear and easy to understand.




Did the information help you to achieve your goal?
What updates, improvements, or related information would you like to see in this document?
Your response will be used to improve our document content. Requests for assistance, if applicable, should be submitted through your normal support channel as we cannot respond from this site.
Input the verification number to submit feedback:
Document information
 Product categories:
 Software
 Software Development
 Traditional Progamming Language & Compilers
 COBOL for OS/390 & VM
 Operating system(s):
  z/OS
 Software version:
  3.3, 3.4
 Reference #:
  1234541
 IBM Group:
 Software Group
 Modified date:
 2007-05-07

Translate My Page
 
 

Rate this page

Help us improve this page. Your response will be used to improve our document content. Requests for assistance, if applicable, should be submitted through your normal support channel as we cannot respond from this site.