IBM Rational Developer for System z Version 7.6.x release notes

Hardware Requirements

For hardware and software requirements, see the following documents:

• z/OS® host requirements: Rational Developer for System z Host Configuration Guide
• AIX® and Linux® requirements: Rational Developer for System z RSE Server Installation Guide: AIX and Linux
• Linux on System z requirements: Rational Developer for System z RSE Server Installation Guide: Linux on System z
• Client requirements: Rational Developer for System z Installation Guide

Installation and Configuration

For information on installing and configuring Rational Developer for System z, see the following documents:

• z/OS host installation: Program Directory for Rational Developer for System z
• z/OS host configuration (basic): Rational Developer for System z Host Configuration Quick Start Guide
• z/OS host configuration (detailed): Rational Developer for System z Host Configuration Guide
• AIX and Linux installation: Rational Developer for System z RSE Server Installation Guide: AIX and Linux
• Linux on System z installation: Rational Developer for System z RSE Server Installation Guide: Linux on System z
• Client installation: Rational Developer for System z Installation Guide

For the most up to date versions of the complete documentation, including installation instructions, white papers, podcasts and tutorials, see the library page of the Rational Developer for System z website (http://www-01.ibm.com/software/awdtools/rdz/library/).

Version 7.6.1 Updates

For information on new features and limitations in the Rational Developer for System z version 7.6.1, see the following summary:

Enhancements for version 7.6.1

• Application Deployment Manager
• BMS Map Editor
• C/C++ Editing Support
• Common Access Repository Manager
• Debugger
• Enterprise Service Tools
• File Manager Integration
• Remote Systems
• Service Component Architecture
• z/OS Integrated Development Environment (zIDE)

Limitations for version 7.6.1

Enterprise Service Tools

• For single-service project tools:
  • Limitation: PL/I Compiled XML Conversion does not support generating or honoring the whiteSpace attribute
  • Limitation: PL/I Compiled XML Conversion does not support mapping or generation of XML attributes

Compiled language debugger

• Limitation: When starting a Debug session in a perspective other than the Debug perspective, pressing F5 to refresh causes debugger to do a Step Into

C/C++ Language Support

• Limitation: When editing C/C++ sequential data sets, language functions such as content assist, open definition, open declaration, open header file, and outline view are not functional in either Remote C/C++ Editor or System z LPEX Editor.

Version 7.6.0.1 Updates

For information on new features in the Rational Developer for System z version 7.6.0.1, see the following summary:

z/OS Integrated Development Environment

• Rational Developer for System z 7.6.0.1 integrates with Rational Team Concert™ for System z 2.0.0.2. Customers who have installed Rational Developer for System z 7.6.0.1 and want to integrate with Rational Team Concert for System z need to install Rational Team Concert for System z 2.0.0.2.
• You can save a remote z/OS search query that contains a file content search string.
• The JES Purge and Cancel operations require the user to manually refresh the Remote Systems view or Remote System Details view to remove the purged or canceled jobs from these views. Messages for the Cancel, Hold, Purge, and Release menu items have been changed as follows:

  Table 1. Updated messages for Cancel, Hold, Purge and Release

  Version 7.6.0 Message	Version 7.6.0.1 Message
  CRRZI9005I Job {0} has been canceled.	CRRZI9005I Cancel has been issued for job {0}.
  CRRZI9008I Job {0} has been held.	CRRZI9008I Hold has been issued for job {0}.
  CRRZI9016I Job {0} has been purged.	CRRZI9016I Purge has been issued for job {0}.
  CRRZI9017I Job {0} has been released.	CRRZI9017I Release has been issued for job {0}.

• JES job and step output are opened using the System z LPEX Editor. When you double-click a job or step output file (.spool file) in the Remote Systems view or Remote System Details view, the file opens in the System z LPEX editor.
• Local syntax check now works with linked resources. When your copy files or include files reside in a linked folder, such as on a LAN drive, you do not need to make a separate copy of these files in your workspace. When you specify your SYSLIB concatenation in the property group for a compilation, you can use paths relative to the workspace.
• z/OS UNIX® subprojects have an import/export mechanism that is different from the import/export mechanism for z/OS projects. z/OS UNIX subprojects will not be included in an exported z/OS project and must be imported and exported separately using the context menu item for z/OS UNIX subprojects.
• The following help topics have been updated for this release. The topics are included in this readme for your information. Because they are included here outside of the context of the information center, the links in the topics will not work.
  • Remote z/OS search does not support regular expression searches.
  • The ISPF BOUNDS command does not affect commands entered in the prefix area.

Enterprise Service Tools

The following updates should be made to the online help for the Enterprise Service Tools component:

• For single-service project tools:
  • In the two topics titled "XML Converters tab", in the description of the XMLPARSE option, in the sentence "This option is valid only if Compiler Level is set to 4.1", add "or higher" to the end of the sentence.
  • In the topic "XML Transformation for CICS® project", in the last bullet, Scenario: Create New XML Transformation (bottom-up) XML Transformation for CICS only, replace "bottom-up" with "top-down".
• For service flow project tools:
  • In the topic "Screen Operation":
    1. Delete the second and third paragraphs.
    2. Add the following sentence as the new second paragraph:

       This information can be accumulated during screen operations recording or flow recording or can be created manually using the screen operations editor.

  • In the topic "Step 5.4, Run the Generate Runtime Code wizard for each of the two generation properties files":
    1. a) Add the following note after Figure 1:
       Note: The warning message CRRZE7329W indicates that a particular type of descriptor is not supported in the current runtime. This warning can usually be ignored, but since the Generate Runtime Code wizard skips this descriptor without processing it, it is best to make sure that the affected screen can be identified using only the other descriptors defined for that screen.
    2. Add the following note after both Figure 1 and Figure 2:
       Note: If an error message indicates that the CICS Resource Definition (CRD) server encountered a problem then follow the instructions in the User response section of topic "CRRZE7206E " in the online help for the Application Deployment Manager.
       Also add the following text to topic "CRRZE7206E" in the online help for the Application Deployment Manager:

       User response: If the trailing error message (represented by the words "{error message}" at the end of this message) indicates that the error occurred in the CICS Resource Definition (CRD) server then follow these steps:

       1. Find the CICS Resource Definition server reason code and the CICS RESP2 code corresponding to the error. These codes begin with the letters CRRZA (new style) or WZAD (old style).
          • Typically the reason code and the CICS RESP2 code are included in the "{error message}" section of this message.
          • If not, then examine the CICS MSGUSR log for error details and determine the reason code and the CICS RESP2 code.
       2. See the online help for the CICS Resource Definition server reason code and the CICS RESP2 code for steps to resolve the error.
  • In the topic "Troubleshooting information for service flow projects", after the subtopic "Terminal applications -- troubleshooting", add the following short subtopic:
    Using the Generate Runtime Code wizard -- troubleshooting: See the following topics:

    • "Step B9. Check the results from running the Generate Runtime Code wizard"
    • "Step 5.6: Troubleshooting" in the first tutorial.
  • In the topic "Overview of the logic of the service flow", in the next-to-last bullet, change "loopEnd_strLoopVar" to "loopEnd_variable0".
  • In the topic "C. Record the flow information", in Step 5.a.ii, in the second bullet, in the sentence beginning "So far the only such variable is available0", change "available0" to "variable0".
  • In the topic "Step 3.4: Add logic to CheckItemAvailability.seqflow", in the subtopic "Add an alternate path for remaining screens", add the following sentence as the second paragraph:

    The current version of the flow works correctly when the While loop does not find the requested item number, but it works incorrectly when the While loop does find the requested item number.

  • In the topic "Creating and starting a connection to a CICS Resource Definition server", in the subtopic "Creating a connection to a CICS Resource Definition server", in Step 2, in the sentence "Select CICS Resource Definition server", change "CICS Resource Definition server" to "CICS Resource Definition server via Web Services".

org.xml.sax.SAXParseException errors in local helps

org.xml.sax.SAXParseException: The value of attribute "content" associated with an 
																	element type "meta" must not contain the '<' character.

Web-based help

When you upgrade from Rational Developer for System z v7.5 to Rational Developer for System z v7.6, the installation program automatically sets your help access preferences to Access the helps remotely and automatically sets up the help system to point to the correct Rational Developer for System z v7.6 remote help site. If you do not have internet access or you prefer accessing the help content using another access method, then you need to change your access method.

To change your access method, see Changing the way that you access help content.

To download the help content and install locally, see Downloading help content with the Local Help System Updater site.

To install the help content using the provided zip file, see Installing help content locally using the Local Help Updater and the RDz7.6_updateSite.zip file.

Version 7.6.0 Features and Limitations

For information on new features and limitations in the Rational Developer for System z, see the following summary:

z/OS Integrated Development Environment

• CICS 4.1 support for Content Assist
• Content assist for commands in the LPEX command line
• Enhanced support for non-round-trip characters
• Obtain up-to-date output for active jobs
• Performance enhancements on file transfer and content assist
• Remote Resource Access API
• PL/I enhanced editing support
• Property Group editor
• Support for multiple local preprocessors
• IBM Rational Developer for System z Version 7.6 - IBM Rational Team Concert for System z Version 2.0 Integration
• Limitation: PL/I syntax is incorrectly marked with warnings
• Limitation: Getting the active job output is not supported for JES3 releases earlier than z/OS V1R10

CA Endevor Software Change Manager Release 12

• Interface for CA Endevor® Software Change Manager Release 12

Service Component Architecture

• Support for the Service Component Architecture
• Limitation: Editing the URI of the web service binding and saving the resource does not update the WSDL file

CICS

• Error messages that you can ignore
• Errors that do not cause a message

COBOL for Windows

• Local syntax-checking support, and the level of Enterprise COBOL for z/OS
• Object-oriented syntax, and Java 5 or Java 6 SDKs
• Runtime message traceback information

Debug Tool for z/OS

• Documentation updates for Debug Tool for z/OS Version 10

PL/I Enhanced Editing

• Limitation: Syntax checking incorrectly identifies errors

File Manager Integration

• File Manager Integration has renamed some of the views found within the Formatted Data Editor
• Limitation: File Manager Integration requires File Manager Server Version 10.1
• Limitation: Certain complex criteria created in the Build Criteria editor are not supported
• Limitation: Data is lost when saving a dataset and the RSE connection is lost
• Limitation: Creating templates with COBOL copybooks containing a COPY command with a REPLACING clause
• Limitation: When the network connection to the host is lost abnormally during an edit session, the data set can be locked and cannot be opened again. Contact your system administrator to release the data set.

MFS Editor

• Copybook generation support for MFS files

C/C++ Language Support

• Enhanced makefile editing support
• The Make with target action has been added to z/OS Unix subprojects and files
• Predefined LPEX command support
• Macro support for assembly language
• F1 help support for assembly language

Advanced COBOL Editor

• Enhanced content assist to include data items declared in EXEC SQL INCLUDE statements (for example, SQLCA) and implicitly linked CICS data structures (for example, DFHEIBLK).
• Improved support for the COBOL LPEX Editor IMS™ snippets have been introduced to aid in the development of COBOL IMS applications.
• Enabled open declarations, hover help, and other features for data items referenced in EXEC SQL and EXEC CICS statements.
• Added support for real-time syntax checking of CICS and SQL code embedded in COBOL programs
• Enhanced the navigation in the COBOL LPEX Editor to use the F3 key and hyperlinking
• Enhanced content assist to include information about variable declarations
• Limitation: The grammar used for parsing embedded SQL in COBOL programs is not a complete DB2® for z/OS grammar and can show incorrect warning annotations. Parsing embedded SQL using this limited grammar is optional and can be enabled on the preferences page LPEX Editor>System z LPEX Editor>COBOL Parser>COBOL Annotations and Tools.
• Limitation: Refactor operations are not atomic and cannot be undone.
• Limitation: The Open Perform Hierarchy operation will not be in sync if the source file is modified or closed.

Application Deployment Manager

• Added functions to create an empty Application Deployment Manager manifest in Eclipse projects and z/OS projects.
• Enhanced Application Deployment Manager to handle a subset of new functions supported by CICS Explorer.
• Created a connection type for REST to allow use of both REST and SOAP protocols and CICS Resource Definition server connections.
• Limitation: Filtering resources within CICS Explorer views when connected to a CICS Resource Definition server is limited to the name of the resource.
• Limitation: Connections to a CICS Resource Definition server using the Web services connection type do not support new CICS resource types
• Limitation: Only regions that host a CICS Resource Definition server are listed in dialogs that generate code or CICS resources
• Limitation: Changing the password of an existing connection to a CICS Resource Definition (CRD) server

Software Configuration Library Manager (SCLM) Developer Toolkit

• Limitation: 'SCLM Search' and 'SCLM member security' are not supported for z/OS 1.8

Host Integration

• A version of Perl must be installed to start the IBM Rational Developer for System z Remote Systems Explorer (RSE) server.

AIX, Linux, and Linux on System z

• Update: AIX, Linux, and Linux on System z installation
• A version of Perl must be installed to start the IBM Rational Developer for System z Remote Systems Explorer (RSE) server.
• Linux on System z host prerequisites
• Linux on System z RSE server prompts the user twice to log in to the system
• Limitation: Run Installation Manager as the root user

Help Updates

• The following helps have been updated to reflect last minute changes:
  • Screen operation
  • Implementation of Extract actions and Insert actions

Web-based helps

• Web-based help content
  • Accessing Web-based help
  • Downloading help content with the Local Help System Updater site
  • Installing help content locally using the Local Help Updater and the RDz7.6_updateSite.zip file
  • Updating help content
  • Removing help content
  • Setting up an intranet server for help content
  • Changing the way that you access help content

Enterprise Service Tools

• Single-service projects
  • XML TRANSFORM resources in the CICS TS 4.1 runtime
  • Generating PL/I language data structures and runtime-specific XML message processing
  • Generating WSBind with the new WSBind parameters introduced in CICS TS 4.1
  • Mapping XML attributes to language structure members
  • Creating MTOM/XOP-based Web service providers
  • XML and Web Services batch processor: Specifying directory for input language file location
  • XML and Web Services batch processor: Specifying data names in mixed case
  • Compiled XML Conversion issues the message IRZ9999S
  • Limitation: 01 level scalar element is not supported
  • Limitation: PL/I Compiled XML Conversion does not honor the optional "aligned" or "unaligned" attributes
  • Limitation: Meet-In-Middle import source files (resolved in v7.6.1)
  • Limitation: Bottom-Up conflict with old WSDL/XSD files and new WSDL files and XSD files
  • Limitation: COBOL conversion routines generated by single-service wizards run in z/OS only
  • Limitation: The Top-down and Meet-in-middle scenarios with importing remote (z/OS UNIX) WSDL file which includes, imports, or redefines a schema is not supported
  • Limitation: XML Element nesting depth
  • Limitation: OPT compiler option conflict
  • Limitation: Case sensitivity of certain text entry fields in XML Enablement wizards
  • Limitation: Invalid pointers cause infinite loop
  • Limitation: FILLER items in COBOL data structures
  • Limitation: Automatic Match Mapping of COBOL groups containing OCCURS DEPENDING ON items
  • Limitation: Generate>XML File menu item does not honor XSD schema restrictions
  • Limitation: XML and Web Services batch processor: Invalid entries in configuration XML may cause null pointer exceptions during the batch process
  • Limitation: Restriction on figurative constants LOW-VALUES and HIGH-VALUES
  • Limitation: GB18030 characters in an Enterprise Service Tools single-service project name
  • Limitation: Temporary files not always cleaned up
  • Limitation: Temporary project not always cleaned up
  • Limitation: When migrating version 6.0 mapping files (.cmx files) source files referenced by the .cmx file must be in the same folder
  • Limitation: Support for DBCS data members with SOAP for CICS and Web Services for CICS
  • Limitation: DBCS characters are not allowed in the name of the generated XML converter files
  • Limitation: Global element names in generated XML schemas are not consistent between Interpretive and Compiled XML conversion types
  • Limitation: Enterprise COBOL issues message IGYOP3094 when compiling COBOL XML Converters using the OPTIMIZE (OPT) option.
• Service flow projects
  • Expanded runtime support for CICS Transaction Server for z/OS
  • Improvements for Extract actions, Insert Actions, and loop variables
  • Limitation: A Web service generated from a service flow project cannot call itself (recursive call)
  • Limitation: A limitation on a flow with a connection wired back onto itself
  • Limitation: Importing a COBOL copy book file fails when the path or file name contains non-English characters
  • Limitation: Conflicting message and field names cause compile error
  • Limitation: A limitation on imported source code with a usage clause of POINTER
  • Limitation: Screen messages are not easily replaced
  • Limitation: Importing a COBOL program for use as a LINK with Channel node and opening the operation in the operations editor prevents modifying the generation properties
  • Limitation: Flow plays back incorrectly if it contains a while loop that exits from a node other than the last node