On this page...
IBM RPG II
VAX RPG II
- Software Maintenance
- Documentation & Media
- Hardware Requirements
- Prerequisite Software
- License Information
- Ordering Information
- Software Warranty
- Usage Information
Migration RPG Software Product Description
Migration RPG is a programming language oriented for use in business data processing operations involving data file manipulation and report generation. User application programs are developed within defined specifications that describe data file, workstation, input, output, calculation, and control parameters.
Migration RPG compiles a set of program specifications into machine language instructions, which are then linked together with the Migration RPG runtime system for execution under the OpenVMS operating system.
Migration RPG is an extended implementation of the RPG II programming language, originally developed by IBM for commercial applications. It supports most of the features found in the IBM System/3, System/34, and System/36 RPG II, and includes Migration Specialties extensions for integration with the OpenVMS operating system.
Migration RPG was developed to make the porting of IBM RPG II applications to the OpenVMS operating system possible. Migration RPG can also be used to port other vendor RPG's, such as WANG, Sperry, Burroughs, and Digital PDP and VAX RPG. Migration RPG offers varying degrees of compatibility with these versions of RPG.
Migration RPG Compiler
- Language implementation that includes features of RPG II, such as table and array handling, multiple input file processing, and the ability to perform input/output operations during the calculation cycle. CHAIN, EXCPT, READ, READE, READP, DSPLY, MOVE, MOVEA, SET, KEY, SQRT, CASxx, DEFN, DO, DOUxx, DOWxx, ELSE, END/DO, END/DOU, END/DOW, END/IF, END/CAS, IFxx, test/move zones, fetch overflow, look ahead, bit text/clear/set, data structures, 512-byte local data area, full procedural files, and help screens are supported.
- RED, a full-screen, interactive RPG source statement editor for RPG program development and modification.
- The ability to access and maintain data files with RPG programs in a batch or indirect command operation mode. The same data files can be accessed with programs written in other languages which use RMS file support, such as HP COBOL.
Migration RPG Screen Format Generator
The Migration RPG Compiler Kit includes a Screen Format Generator. This utility is used to compile screen specifications to generate interactive workstation display screens for entering and viewing data. Screen specifications are also used to define user menus and prompt screens.
The Screen Format Generator supports the following screen specifications:
Describes the screen size, starting line, and available command and function keys.
Describes help screens which can be associated to individual fields, portions of a screen, or an entire screen.
Describes input fields, output fields, and constant data which appear on the screen. Description specifications include indicator-based control of how and when data is displayed. Control options include highlighting, underlining, blinking, non-display, and cursor positioning.
Migration RPG Compiler Kit Components
RPG - RPG Compiler
Generates an object module from RPG source specifications.
SFG - Screen Format Generator
Generates a screen object module from S, H, and D screen format specifications.
AUTOC - Auto Report Utility
Used to assemble an RPG program which contains /COPY members and compiler directives.
RPGCON - Console Utility
Generates screen S & D specifications for files containing console specifications.
RDP - File Dump Utility
Used to generate a hexadecimal dump of a file which contains ASCII or EBCDIC data.
RPGMSG - Message File Utility
Used to create and maintain files containing text that may be accessed by an RPG program through message identification codes (MIC).
RED - Full-Screen RPG Editor
A full-screen editor designed for the entry, manipulation, and modification of RPG source code.
REX - External Indicator and Date Utility
Allows the setting of external indicators (U1 - U8) and the definition of a date other than the system date.
PROMPT - Prompt Screen Utility
Allows a DCL command file to display a screen that was defined using Migration RPG S, H, and D specifications. The data keyed into the screen by the user is used to maintain and update the local symbols P1 - P64.
MENU - Menu Utility
Supports menus using Migration RPG S, H, and D specifications to generate the menu screen.
DFU - Data File Utility
Allows the user to create, maintain, and display indexed or direct data files, using DFU ENTER, UPDATE, and INQUIRY functions.
Migration RPG Program Specifications
A Migration RPG program is developed by a programmer through the specification of input and output data and processing steps using pre-defined coding templates. The following RPG coding specification formats are supported by Migration RPG:
Furnishes control information including listing, debug, date, currency, and form positioning parameters.
Identifies data file parameters including file name, record size, media type, file organization, and file access mode. File specifications are also used to identify workstation and disk devices.
Provides detailed descriptions of arrays, record address files, and tables.
Line Counter Specification
Defines the number of available print lines and identifies the overflow line for printer files.
Describes data records and indicates field locations, names, formats, control levels, and other information related to input data files. Each record description in the Input specifications corresponds to an input or update file in the File specifications. Input specifications also describe data structures and a special external data structure, the Local Data Area (LDA).
Defines factors, relationships, control indicators, branching, and other options related to operations performed on data within the program.
Output Format Specification
Describes output file and print records including fields, edit operations, forms spacing, and constants. Each output record defined in the Output specifications corresponds to an output, update, or add file defined in the File specifications.
Migration RPG Service Options
Migration Specialties software specialists are available on a per-call or resident basis to help in all phases of software development, migration, or implementation. Specialists are available to serve as technical consultants, decision support consultants, or business system analysts. Resources are available to:
- Provide software migration services.
- Provide OpenVMS support and management services.
- Supplement programming staff.
- Assume project management responsibility.
- Develop software.
- Augment system start-up service packages with tailored services to meet specific needs.
Differences between Migration RPG & VAX RPG II
VAX RPG II was Digital Equipment Corporation's interpretation of the RPG programming language. VAX RPG II was only available on VAX/VMS systems. It is no longer supported and is not fully IBM RPG II compatible.
In many respects, VAX RPG II is a subset of Migration RPG. The major difference between the two RPG's is the methods used to support workstation screens. VAX RPG II used FMS and DECforms, two other DEC products. Migration RPG uses IBM compatible S & D screen specifications, which greatly simplified migrating IBM RPG II applications.
The following table compares the features of Migration Specialties' Migration RPG and the last release of DEC VAX RPG II, version 2.1:
Comparison of Features in Migration RPG and VAX RPG II
|Feature||Migration RPG||VAX RPG II|
|Full (99%+) System/3, /34, /36 compatibility||√||-|
|Figurative constants (*BLANK, *ZERO, etc.)||√||-|
|Structured opcodes (CABxx, CASxx, DOUxx, DOWxx, ELSE, IFxx, etc.)||√||-|
|READP (Read Prior)||√||-|
|Basic WORKSTN subset via FMS||-||√|
|S & D specification support||√||-|
|FMS conversion utility/aid||√||√|
|Exception time processing routines||√||-|
|Function key support (Help, Roll-Up, Roll-Down, Clear, Home)||√||-|
External CALL Support
|By descriptor ||√||√|
|By reference/value ||-||√|
|Access to DECforms/Rdb/etc. via CALL||√||√|
|Access to DECforms/Rdb/etc. via EXIT/RLABL||√||-|
Local Data Area
|Set via a file||√||-|
|Set via symbols||-||√|
|Set via a file||√||-|
|Set via RPG$EXT_INDS logical||-||√|
File I/O Extensions
|Multi-key ISAM (key computed from F spec)||√||√|
|Multi-key ISAM (key of reference specified)||√||-|
|Multiple keys to same file in same program||√||√|
|Word/longword keys for ISAM files||-||√|
|Record lock indicator on READ and CHAIN||√||√|
File Continuation Options
|INFDS data structure||√||√|
|SLN variable start line||√||√|
|Automatic blank to zero numeric data conversion||√||√|
|/CHECK (EXSR recursion or array/table bounds)||-||√|
|/COPY statement support within RPG source code||√||√|
|Compiler-generated cross reference||√||√|
|Machine code annotated with RPG cycle||√||√|
|Auto Report Utility (AUTOC)||√||-|
|RPG full-screen Editor||√||√|
|TPU-based including spec help||√||√|
|Compile and error review within editor||-||√|
|Full customization via TPU/EVE code additions||√||√|
 The compilers implement argument passing mechanisms with different language syntax.
 Option is recognized as valid by the Migration RPG Compiler, but no action is taken in response to the option.
Differences between IBM System/36 RPG II and Migration RPG:
Migration RPG was specifically designed to be compatible with IBM RPG II, allowing IBM System/3, System/34, and System/36 applications to be ported to OpenVMS systems. The following IBM RPG II functionality is not directly supported by Migration RPG under OpenVMS:
- RMS under OpenVMS does not support relative (direct) access to an indexed file. Supporting the functionality under OpenVMS requires modifications to the converted RPG programs and data files.
- RMS under OpenVMS does not support multiple updates to a file after a single read. Converted RPG programs using this feature must be modified to perform a read before each update.
- Multiple Requester Terminal (MRT) programs do not exist in the OpenVMS environment. MRT code can be removed from converted RPG programs.
- Read-under-format is not supported under OpenVMS. Converted RPG programs using this feature are modified to bring up the read-under-format screen as the first data entry screen.
- Telecommunication specifications are not supported by Migration RPG.
RPG Opcode Comparison
The following table compares the RPG opcodes supported by Migration RPG, IBM RPG II, and VAX RPG II:
|RPG Opcodes||Migration RPG||IBM RPG II||VAX RPG II|
no-op: The opcode is recognized by the compiler, but is not acted upon.
The following table compares the devices supported by Migration RPG, IBM RPG II, and VAX RPG II:
Devices Supported by Migration RPG, IBM RPG II, and VAX RPG II
|Device Type||Migration RPG||IBM RPG II||VAX RPG II|
*Accepted by VAX RPG II with a warning and treated as a disk device unless column 15 is D, in which case TTY device is assumed.
Software Maintenance Services
The Migration RPG Compiler Kit includes software maintenance services for one (1) year. Maintenance services include:
Software Media & Documentation Updates
The customer automatically receives any new software release with corresponding documentation.
Migration Specialties can be contacted by telephone with questions concerning the use of Migration RPG or to report problems with the product. Migration Specialties can be reached by telephone between the hours of 8:00AM and 5:00PM MST, Monday through Friday, excluding U.S. holidays.
Migration Specialties can be contacted electronically via the Internet using email with questions concerning the use of Migration RPG or to report problems with the product. Migration Specialties can be reached by email 24 hours a day, seven days a week.
Critical Problem Resolution
The following are defined as critical problems:
- The Migration RPG Compiler encounters a fatal run-time error.
- The installation of the Migration RPG Compiler for a new site fails.
If, at any time during the software license period, the customer experiences a problem with the licensed software, a Software Problem Report which describes the nature of the problem may be sent to Migration Specialties. The customer will receive a written response from Migration Specialties. This response will either:
- Acknowledge that the reported problem is a software error and provide an immediate work-around; or
- Acknowledge that the reported problem is a software error and provide an estimated date of the next software release which will fix the software error; or
- Acknowledge that the reported problem is a known restriction; or
- Explain why the reported problem is not considered a software error by Migration Specialties and, if possible, provide a work-around.
Documentation & Media
The Migration RPG Compiler Kit includes the following documentation:
- Migration RPG User's Guide
- Migration RPG Language Reference Manual
- Migration Screen Format Reference Manual
- Migration Installation Guide
- Migration Release Notes
The Migration RPG Compiler Kit is distributed on the following media:
- CD-ROM (ISO-9660 Compliant)
- 1600 or 6250 BPI 9-track Magtape
- TK50 Tape Cartridge
- TK70 Tape Cartridge
- 4mm DAT Tape Cartridge
- TZ86 Tape Cartridge
- Zip Archive via E-mail
- 4,000 blocks (2MB) of disk space.
- A computer system running OpenVMS. See Prerequisite Software for the appropriate version of OpenVMS.
- A VT-compatible video terminal or terminal emulator is required for:
- Workstation programs
- MENU Utility
- PROMPT Utility
- RED Editor
- DFU Utility
The Migration RPG Compiler has been tested with, will run with, and requires the following software:
VAX Hardware or VAX Emulator
OpenVMS Operating System version 5.5 or higher.
Alpha Hardware or Alpha Emulator
OpenVMS Operating System version 6.2 or higher.
OpenVMS Operating System version 8.1 or higher.
The licensed software is furnished under the licensing provisions of Migration Specialties' Standard Terms and Conditions, which provides in part that the software and any part thereof may be executed on the designated Licensed Processor and may be copied, in whole or in part, with proper inclusion of Migration Specialties' copyright notice and any proprietary notices on the software, for execution on the same Licensed Processor.
A separate license is needed for each additional Licensed Processor or OpenVMS cluster on which Migration RPG will be executed, except as otherwise specified.
For any executable images produced with the Migration RPG Compiler that are exported to a non-licensed processor, a Migration RPG Runtime License must be purchased for that processor.
Migration Specialties International, Inc.
217 West 2nd Street
Florence, CO 81226-1403
Phone: +1 719-784-9196
MIGRATION SPECIALTIES INTERNATIONAL, INC. WILL NOT BE LIABLE IN ANY EVENT FOR ANY DAMAGES INCLUDING ANY LOSS OF DATA, PROFITS OR SAVINGS, CLAIMS AGAINST YOU BY ANY OTHER PARTY OR ANY OTHER INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF YOUR USE OF OR INABILITY TO USE THE SOFTWARE OR MEDIA, EVEN IF MIGRATION SPECIALTIES IS ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
This software kit is intended for use with a customer's own software or software for which the customer obtained proper rights and interests. Any use of this software with software proprietary to a third party is prohibited under the terms of this license agreement.
The Customer agrees to indemnify and hold Migration Specialties harmless from any loss, damage or liability, including reasonable attorneys' fees, arising from any claim that the conversion of Customer's software infringes any United States patent, copyright, trademark, trade secret or other proprietary right of any third party.
MSI, Migration RPG, S/3X Conversion Tools, and CVTFILE are registered trademarks of Migration Specialties International. IBM, System/3, System/34, and System/36 are registered trademarks of International Business Machines Corporation. Digital, HP, VAX, VAX RPG, VMS, DECforms, and OpenVMS are registered trademarks of HP.