IBM Record Generator for Java, V3.0, simplifies the development of mixed-language applications on the z/OS platform

IBM United States Software Announcement 217-295
July 17, 2017

Table of contents
Key prerequisitesKey prerequisitesTechnical informationTechnical information
Planned availability datePlanned availability dateOrdering informationOrdering information
DescriptionDescriptionTerms and conditionsTerms and conditions
Product positioningProduct positioningPricesPrices
Program numberProgram numberOrder nowOrder now

Back to topBack to top

Top rule
Bottom rule

IBM® Record Generator for Java™ is a stand-alone utility that imports the generated associated-data (ADATA) that is produced from compiling COBOL copybooks or assembler DSECTs, and generates Java helper classes. These Java helper classes can then be used in Java applications to marshal data to and from the COBOL or assembler language-specific record structures.

The Record Generator for Java, V3.0, supersedes the IBM alphaWorks® version of the JZOS Record Generator, V2.4.6 by providing a number of new and enhanced capabilities.

Record Generator for Java, V3.0, is available to existing clients of z/OS® V2.1, or later, at no additional charge. It can be downloaded from IBM.

Back to topBack to top

Top rule
Key prerequisites
Bottom rule

The IBM Record Generator for Java has the following key prerequisites:

  • The minimum required level of operating system is z/OS V2.1.
  • The minimum required level of Java is IBM 64-bit or 31-bit SDK for z/OS, Java Technology Edition, V7.0.

Back to topBack to top

Top rule
Planned availability date
Bottom rule

September 29, 2017

Back to topBack to top

Top rule
Bottom rule

The Record Generator for Java is a stand-alone Java utility that generates Java helper classes to describe the COBOL or assembler language specific record structures. These helper classes can then be used in a Java application to marshal data to and from the record orientated record structures commonly used in z/OS applications such as CICS® COMMAREAs or VSAM files.

The RecordClassGenerator reads as input the ADATA output from the IBM Enterprise COBOL for z/OS and IBM High Level Assembler compiler, and generates Java source code to map a selected language specific record structure. The generated Java source relies on the API package from the IBM JZOS batch toolkit, which contains data type converters for the elemental COBOL and assembler data types. In addition, the RecordClassGenerator can generate an XML representation of the imported language structures, which can then be modified in third-party tools, such as XSLT, and then used as input to the RecordClassGenerator to generate the Java helper classes.

When it is generated, the source code of the Java helper classes can be compiled with the package to generate a Java class with accessors for each individual field in the record. This greatly simplifies the development of Java applications that need to interact with structured enterprise data.

The Record Generator for Java, V3.0, supersedes the IBM alphaWorks version of the JZOS Record Generator, V2.4.6, and provides the following new and enhanced functions:

  • Support for ADATA files with or without an IBM Record Descriptor Word prefix. This makes it easier to transfer the ADATA files between systems for usage on distributed platforms.
  • Support for a user-supplied, Java name generator class to control the schema for generating accessor methods from field names. This maximizes the reusability of any generated code.
  • Support to ignore OCCURS 1 on COBOL single element arrays, so that fields are generated as an array of size 1.
  • Ability to set the string encoding during record generation. This provides more flexible national language support.
  • A set of new generation options to optimize the generated code:
    • Support for generating code that trims spaces from the end of string fields as they are accessed
    • Support for initializing fields with a fixed location and length
    • Support for static field variables to be generated with "public" access, rather than "protected" access
  • Integrated and updated documentation, by using IBM Knowledge Center

The Record Generator for Java V3.0 is available to clients of z/OS V2.1, or later, at no additional charge. It can be downloaded from IBM. License redistribution rights are provided for deployment to non-z/OS platforms to support distributed development and build.

Accessibility by people with disabilities

A US Section 508 Voluntary Product Accessibility Template (VPAT), containing details about accessibility compliance, can be found on the IBM Accessibility website.

Section 508 of the US Rehabilitation Act

IBM Record Generator for Java V3.0 is capable, as of July 21, 2017, when used in accordance with the associated IBM documentation, of satisfying the applicable requirements of Section 508 of the Rehabilitation Act, provided that any assistive technology used with the product properly interoperates with it.

Back to topBack to top

Top rule
Product positioning
Bottom rule

The license terms for Record Generator for Java allow it to be used by any client with a license for a supported release of z/OS. This makes it a valuable tool for z/OS-based technical roles, and also as a suitable platform for both third-party and client-developed tooling.

Back to topBack to top

Top rule
Reference information
Bottom rule

For information on the general availability of CICS® TS V5.4, refer to Software Announcement 217-113, dated May 16, 2017.

For information on the January 2017 continuous delivery update of CICS TS V5.3, refer to Software Announcement 217-006, dated January 10, 2017.

Back to topBack to top

Top rule
Program number
Bottom rule
Program number VRM Program name
5655-CI2 3.0.0 IBM Record Generator for Java

Back to topBack to top

Top rule
Offering Information
Bottom rule

Product information is available on the IBM Offering Information website.

Back to topBack to top

Top rule
Bottom rule

Product documentation is provided IBM Knowledge Center. This documentation is refreshed regularly in response to IBM service changes and client feedback.

Back to topBack to top

Top rule
Bottom rule

Software Services

IBM Software Services has the breadth, depth, and reach to manage your services needs. You can leverage the deep technical skills of our lab-based, software services team and the business consulting, project management, and infrastructure expertise of our IBM Global Services team. Also, we extend our IBM Software Services reach through IBM Business Partners to provide an extensive portfolio of capabilities. Together, we provide the global reach, intellectual capital, industry insight, and technology leadership to support a wide range of critical business needs.

To learn more about IBM Software Services, contact your Lab Services Sales or Delivery Leader.

Back to topBack to top

Top rule
Technical information
Bottom rule

Specified operating environment

Software requirements

The minimum required level of operating system is z/OS, V2.1.

Java Runtime Environment

When running RecordClassGenerator, the supported level of Java is IBM 64-bit or 31-bit JRE V7.0, V7.1, or V8.0, in conjunction with the JZOS toolkit API package at release V2.4.8, or later, provided by IBM SDK for z/OS, Java Technology Edition.

Enterprise compilers

The following IBM enterprise compiles are supported for the production of ADATA files:

  • IBM Enterprise COBOL for z/OS V4.2, V5.1, V5.2, and V6.1
  • IBM High Level Assembler for z/OS, z/VM®, and z/VSE® V1.6, and future fix packs

For the latest information, online, see the Detailed Systems Requirements web page.

Planning information

IBM Record Generator for Java is available by download only, from IBM.


Not applicable

Security, auditability, and control

The Record Generator for Java uses the security and auditability features of the operating system under which it is running.

The customer is responsible for evaluation, selection, and implementation of security features, administrative procedures, and appropriate controls in application systems and communication facilities.

Back to topBack to top

Top rule
Ordering information
Bottom rule

Charge metric

Not applicable. IBM Record Generator for Java V3.0 is available for no charge, by download only from IBM.

Back to topBack to top

Top rule
Terms and conditions
Bottom rule

The information provided in this announcement letter is for reference and convenience purposes only. The terms and conditions that govern any transaction with IBM are contained in the applicable contract documents such as the IBM International Program License Agreement, IBM International Passport Advantage® Agreement, and the IBM Agreement for Acquisition of Software Maintenance.


IBM International Program License Agreement including the License Information document and Proof of Entitlement (PoE) govern your use of the program. PoEs are required for all authorized use.

Agreement for Acquisition of Software Maintenance

This program is licensed under the IBM Program License Agreement (IPLA) and the associated Agreement for Acquisition of Software Maintenance, which provide for support with on-going access to releases and versions of the program.

Limited warranty applies


Limited warranty

IBM warrants that when the program is used in the specified operating environment, it will conform to its specifications. The warranty applies only to the unmodified portion of the program. IBM does not warrant uninterrupted or error-free operation of the program or that IBM will correct all program defects. You are responsible for the results obtained from the use of the program.

IBM provides you with access to IBM databases containing information on known program defects, defect corrections, restrictions, and bypasses at no additional charge. For further information, see the IBM Software Support Handbook.

IBM will maintain this information for at least one year after the original licensee acquires the program (warranty period).

Program technical support

Technical support of a program product version or release will be available for a minimum of three years from the general availability date, as long as your Software Subscription and Support (also referred to as Software Maintenance) is in effect.

This technical support allows you to obtain assistance (by telephone or electronic means) from IBM for product-specific, task-oriented questions regarding the installation and operation of the program product. Software Subscription and Support (Software Maintenance) also provides you with access to updates (modifications or fixes), releases, and versions of the program. You will be notified, through an announcement letter, of discontinuance of support with 12 months' notice. If you require additional technical support from IBM, including an extension of support beyond the discontinuance date, contact your IBM representative or IBM Business Partner. This extension may be available for a fee.

For additional information on the IBM Software Support Lifecycle Policy, see the IBM Software Support Lifecycle Policy website.

Money-back guarantee

If for any reason you are dissatisfied with the program and you are the original licensee, you may obtain a refund of the amount you paid for it, if within 30 days of your invoice date you return the program and its PoE to the party from whom you obtained it. If you downloaded the program, you may contact the party from whom you acquired it for instructions on how to obtain the refund.

For clarification, note that for programs acquired under any of IBM's On/Off Capacity on Demand (On/Off CoD) software offerings, this term does not apply since these offerings apply to programs already acquired and in use by you.

Volume orders (IVO)


Passport Advantage applies


IBM Operational Support Services - SoftwareXcel


Variable charges apply


Back to topBack to top

Top rule
Statement of good security practices
Bottom rule

IT system security involves protecting systems and information through intrusion prevention, detection, and response to improper access from within and outside your enterprise. Improper access can result in information being altered, destroyed, or misappropriated or can result in misuse of your systems to attack others. Without a comprehensive approach to security, no IT system or product should be considered completely secure and no single product or security measure can be completely effective in preventing improper access. IBM systems and products are designed to be part of a regulatory compliant, comprehensive security approach, which will necessarily involve additional operational procedures, and may require other systems, products, or services to be most effective.

Important: IBM does not warrant that any systems, products, or services are immune from, or will make your enterprise immune from, the malicious or illegal conduct of any party.

Back to topBack to top

Top rule
Bottom rule

Business Partner information

If you are an IBM Business Partner -- Distributor for Workstation Software acquiring products from IBM, you may link to Passport Advantage® Online for resellers where you can obtain Business Partner pricing information. An IBMid and password are required to access the IBM Passport Advantage website.

Back to topBack to top

Top rule
Order now
Bottom rule

To order, contact the Americas Call Centers, Business Partners, or your local IBM representative. To identify your local IBM representative, call 800-IBM-4YOU (426-4968). For more information, contact the Americas Call Centers.

Phone: 800-IBM-CALL (426-2255)

Fax: 800-2IBM-FAX (242-6329)

For IBM representative:

IBM Teleweb Customer Support® Sales Execution Center, Americas North
3500 Steeles Ave. East, Tower 3/4
Markham, Ontario
Canada L3R 2Z1

The Americas Call Centers, our national direct marketing organization, can add your name to the mailing list for catalogs of IBM products.

Note: Shipments will begin after the planned availability date.

IBM, alphaWorks, z/OS,, PartnerWorld, Passport Advantage, CICS, z/VM and z/VSE are registered trademarks of IBM Corporation in the United States, other countries, or both.

Oracle and Java are trademarks of Oracle and/or its affiliates in the United States, other countries, or both.

Other company, product, and service names may be trademarks or service marks of others.

Terms of use

IBM products and services which are announced and available in your country can be ordered under the applicable standard agreements, terms, conditions, and prices in effect at the time. IBM reserves the right to modify or withdraw this announcement at any time without notice. This announcement is provided for your information only. Additional terms of use are located at:

Terms of use

For the most current information regarding IBM products, consult your IBM representative or reseller, or visit the IBM worldwide contacts page

IBM United States