IBM

IBM DOS/VS RPG II Version 1 Release 3 Program Number 5746-RG1

DOS/VS RPG II is a commercially oriented programming language specifically designed for writing application programs that meet business data processing requirements. To write a program, the user describes an application either online via a VM/CMS or VSE/ICCF display terminal, or offline with preprinted specification forms. The DOS/VS RPG II compiler produces an object program from this source program, using a fixed logic cycle to perform the defined job. In the online environment, the source code entry and/or modification are performed interactively using the RPG II Source Entry Facility (RSEF). A displayed template aids the source entry: The user may also choose to be prompted for source statement creation. During source entry, error messages are displayed to inform the user of statement syntax errors. Source program compilation can also be invoked from the display terminal. Any errors during compilation can be displayed at the terminal after compilation. The statement number where the error occurred is included to allow online debugging (message crossreferencing). Printouts may also be obtained, supplying the same error information for offline debugging. Provision is made for the display texts and messages to be translated by the user into a local language. In the CMS environment with Display Management System (DMS/CMS) and/or VM Interactive File Sharing (VM/IFS) installed, those functions are also available with RPG II. With DMS/CMS the user can create and use his own display panels. With VM/IFS several RPG II programs can share common data. The following specification types are used in either the online or offline entry method: Header and File Description Specifications Input Specifications

Licensed Program Specifications

Calculation Specifications Output Specifications Extension and Line Counter Specifications Option and Select/Sort Specifications The Option and Select/Sort specifications are used with the Auto Report function. This is a simplified method for producing reports, which can also copy existing RPG II source programs from a library into a new program. It also includes a means to select and/or sort a number of records from a file and then process them. DOS/VS RPG II supports file creation and maintenance applications for IBM file organization methods (virtual storage access methods, sequential access method, indexed sequential access method). It can also be used for the retrieval and maintenance of direct access files and allows the user to provide I/O management for special file organization or devices. Files created by DOS/VS RPG II can be retrieved using other IBM languages, such as PL/I, COBOL, and Assembler. DOS/VS RPG II programs can also retrieve files created by these languages. Other significant features provided by DOS/VS RPG II include support of operation codes for arithmetic, move, compare, and branching operations. Levels of totals can be accumulated for individual records and for associated groups of records. Page formatting of output can be accomplished by entering specifications for skipping and spacing, forms alignment, page overflow, and editing. Data communication (DC) support is provided by the command-level interface to CICS/DOS/VS (EXEC command). Application programs written in RPG II may run as transactions under CICS/DOS/VS. Before compilation a translation step is required (translator provided by CICS/DOS/VS). Data base (DB) support is provided by an interface to DL/I calls. Before compilation a translation

step is required. The batch translator is part of the RPG II compiler.

Specified Operating Environment

Machine Requirements The DOS/VS RPG II Release 3.0 compiler will operate on any IBM 4300 series processor, System/370 supported by DOS/VSE, or IBM 3031. For RSEF, an interactive partition of 140K bytes is required if operating with VSE/ICCF. Two work files on disk are necessary; tape work files are not supported. The Decimal Arithmetic Feature must be installed. Programming Requirements The DOS/VS RPG II Release 3.0 compiler and its object program execute under the control of DOS/VSE with VSE/Advanced Functions (with the SYSFIL generation option if system files on disk or diskette are to be used), or of VM/BSEPP Release 2 with a DOSLIB. VM/CMS of VSE/ICCF is required for the online environment. DOS/VS RPG II DC and/or DB requests require the IBM CICS/DOS/VS Program Product (5746-XX3) Version 1 Release 4 and/or the IBM DL/I Program Product (5746-XX1) Version 1 Release 4. For use of the Select/Sort function, Auto Report is designed to operate with the IBM DOS/VS Sort/Merge program product (Program Number 5746-SM1 or 5746-SM2); but for Select/Sort with RRDS, Auto Report is designed to operate only with the IBM DOS/VS Sort/Merge II program product (Program Number 5746-SM2). Compatibility Source Programs: Source program written for the DOS RPG II Compiler and the DOS/VS RPG II Compiler Release 1 and 2 will be accepted without modification by the DOS/VS RPG II Release 3.0 compiler.

Object Programs: DOS/VS RPG II Release 3.0 object programs will execute under DOS/VSE. If the Formatted Dump is to be used, the core image library must contain transient Formatted Dump routines from the same RPG II release as the related object programs. Licensed Program Materials Availability Restricted Materials: Yes. This licensed program is available with source licensed program materials for some modules designated as RESTRICTED MATERIALS OF IBM. The remaining licensed program materials are available and are not designated as RESTRICTED MATERIALS OF IBM.

Supplemental Terms
Installation/Location License Not applicable. A separate license is required for each designated machine on which the licensed program material will be used. Usage License Not applicable. Type/Duration of Program Services: Central Service Until discontinued by IBM with a minimum of twelve months written notice.

Warranty
This program is warranted as specified in the IBM license. Licensed Program Specifications may be updated from time to time and such updates may constitute a change in specifications. For Distributed Systems License Option (DSLO) Licenses, warranty service, if any, will be provided only through the Basic License location. Following the discontinuance of all program services, this program will be provided As Is as specified in the IBM license.

IBM

References in this publication to IBM products, programs, or services do not imply that IBM intends to make these available in all countries in which IBM operates. Any reference to an IBM product, program, or service is not intended to state or imply that only IBM's product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any of IBM's intellectual property rights may be used instead of the IBM product, program, or service. Any other documentation with respect to this licensed program, including any documentation referenced herein, is provided for reference purposes only and does not extend or modify these specifications. June 2003 Printed in U.S.A.

GC33-6 29- 3