HP RPG/iX Reference Manual MPE/iX 5.0 Documentation
HP RPG/iX Reference Manual
Table of Contents
HP RPG/iX Reference Manual
HP RPG/iX Reference Manual : COPYRIGHT NOTICE
Ch 1. Introduction to RPG
The Components of RPG
Using RPG
Step 1: Analyze the Task
Step 2: Plan the Program
Step 3: Create the Source Program
Step 4: Compile the Source Program
Step 5: Prepare the Object Program for Execution
Step 6: Execute the Object Program
Ch 2. General Specifications
Sequence Number (Columns 1-5)
Specification Type (Column 6)
Program Name (Columns 75-80)
Ch 3. Header Specifications
The Header Specification Fields
Sequence Number (Columns 1-5)
Specification Type (Column 6)
Error Dump File Name (Columns 7-14)
Debug (Column 15)
USWITCH Source (Column 16)
UDATE Source (Column 17)
Line Number Option (Column 20)
Inverted Print (Column 21)
Record Number Adjust (Column 22)
Program Name Logging (Column 25)
Alternate Collating Sequence (Column 26)
BUFCHK Defaults (Column 28)
The Header Specification Fields (Cont)
Table/Array Look-Up (Column 34)
EBCDIC Zone/Digit Tests (Column 39)
Sign Processing (Column 40)
Form Positioning (Column 41)
Indicator Setting (Column 42)
File Translation (Column 43)
Non-Numeric Digits (Column 44)
Dollar Sign Substitute (Column 46)
Skip-Suppress (Column 47)
DSPLY Options (Column 48)
Record Length Check (Column 49)
Page Overflow Test (Column 50)
*PLACE Method (Column 51)
Cross-Reference Listing (Column 52)
Carriage Control Type (Column 53)
Textfile Sequence Check (Column 54)
Error Log (Column 55)
Error Response (Columns 56-71)
Program Name (Columns 75-80)
The Header Specification Default Summary
Ch 4. File Description Specifications
The File Description Specification Fields
Sequence Number (Columns 1-5)
Specification Type (Column 6)
File Name (Columns 7-14)
File Type (Column 15)
File Designation (Column 16)
End-of-File (Column 17)
Input Sequence (Column 18)
Record Format (Column 19)
Block Length (Columns 20-23)
Logical Record Length (Columns 24-27)
Processing Mode (Column 28)
Record Address or Key Field Length (Columns 29-30)
Record Address Type (Column 31)
File Organization/Additional I/O Area (Column 32)
Overflow Indicator (Columns 33-34)
Key Field Starting Location (Columns 35-38)
Extension Code (Column 39)
Device Class Name (Columns 40-46)
Interface Type (Column 47)
Interface Control (Columns 48-52)
Disk Labels (Column 53)
Name of Label Exit (Columns 54-59)
File Addition (Column 66)
Extents (Columns 68-69)
File Conditioner (Columns 71-72)
Program Name (Columns 75-80)
The File Description Continuation Line
Sequence Number (Columns 1-5)
Specification Type (Column 6)
Long Name Option Target (Columns 20-51)
Continuation Code (Column 53)
General Fields (Columns 54-74)
Option Type (Columns 54-59)
File-Sharing Fields (Columns 54-74)
Database Fields (Columns 54-74)
Database Name (IMAGE) Line
Item Name (ITEM) Line
Password (LEVEL) Line
Data Set Name (DSNAME) Line
Input/Output Status Array (STATUS) Line
Key File Name (KEYFL) Line
WORKSTN Interface Fields (Columns 54-74)
Program Name (Columns 75-80)
The File Description Specification Default Summary
Ch 5. File Extension Specifications
The File Extension Specification Fields
Sequence Number (Columns 1-5)
Specification Type (Column 6)
Chaining File Record Sequence (Columns 7-8)
Chaining Code Identifier (Columns 9-10)
From File Name (Columns 11-18)
To File Name (Columns 19-26)
Table/Array Name (Columns 27-32)
Entries Per Record (Columns 33-35)
Entries Per Table/Array (Columns 36-39)
Entry Length (Columns 40-42)
Data Format (Column 43)
Decimal Positions (Column 44)
Table/Array Sequence (Column 45)
Alternating Table/Array Name (Columns 46-51)
Entry Length (Columns 52-54)
Data Format (Column 55)
Decimal Positions (Column 56)
Table/Array Sequence (Column 57)
Comments (Columns 58-74)
Program Name (Columns 75-80)
Tables and Arrays
Creating Tables and Arrays
Creating Compile-Time and Preexecution-Time Tables and Arrays
Defining Tables and Arrays
Defining Compile-Time and Preexecution-Time Tables and Arrays
Defining Execution-Time Arrays
Loading Tables and Arrays
Loading Compile-Time Tables and Arrays
Loading Preexecution-Time Tables and Arrays
Loading Execution-Time Arrays
Searching Tables
Searching Arrays
Changing Table and Array Entries During Execution
Writing Tables and Arrays
The File Extension Specification Required Entries
The File Extension Specification Default Summary
Ch 6. Line Counter Specifications
The Line Counter Specification Fields
Sequence Number (Columns 1-5)
Specification Type (Column 6)
File Name (Columns 7-14)
Channel Number Fields (Columns 15-74)
Line Number (Columns 15-17)
Channel Number/OL (Columns 18-19)
Line Number and Channel Number/OL (Columns 20-74)
Line Number Fields (Columns 15-24)
Line Number (Columns 15-17)
OL/FL (Columns 18-19)
Line Number and OL/FL (Columns 20-24)
Program Name (Columns 75-80)
The Line Counter Specification Default Summary
Ch 7. Input Specifications
The Input Specification Fields
Sequence Number (columns 1-5)
Specification Type (Column 6)
File and Record Description Fields (columns 7-41)
File Name (columns 7-14)
AND/OR (columns 14-16)
Group Sequence (Columns 15-16)
Number of Records (Column 17)
Option/LDA (Column 18)
Record Indicator/Look-Ahead/Trailer/Data Structure (Columns 19-20)
The Input Specification Fields (Cont)
File and Record Description Fields (columns 7-41) (Cont)
Record Identification Codes (Columns 21-41)
Field Description Fields (Columns 43-70)
Data Format (Column 43)
From Field Position (Columns 44-47)
To Field Position (Columns 48-51)
Decimal Positions (Column 52)
Field Name (Columns 53-58)
Control Level (Columns 59-60)
The Input Specification Fields (Cont.)
Field Name (Columns 53-58) (Cont.)
Matching/Chaining Fields (Columns 61-62)
Field Record Relation (Columns 63-64)
Field Indicators (Columns 65-70)
Program Name (Columns 75-80)
The Input Specification Default Summary
Ch 8. Calculation Specifications
Introduction
The Calculation Specification Fields
Sequence Number (Columns 1-5)
Specification Type (Column 6)
Control Level(Columns 7-8)
Indicators (Columns 9-17)
Factor 1 (Columns 18-27)
Operation (Columns 28-32)
Arithmetic Operations
Move Operations
Move Zone Operations
Compare and Test Operations
Branching Operations
Internal Subroutine Operations
External Subroutine Operations
Structured Programming Operations
Indicator and Bit Setting Operations
Table and Array Operations
File Operations
Display Operations
Debugging Operation
System Operations
Operation Definitions
ADD
BEGSR
BITOF
BITON
CABxx
CASxx
CHAIN
CLOSE
COMP
DEBUG
DIV
DO
Operation Definitions (Cont)
DOUxx
DOWxx
DSPLM
DSPLY
ELSE
END
ENDSR
EXCPT
Operation Definitions (Cont.)
EXIT
EXSR
FNDJW
FNUM
FORCE
GOTO
IFxx
INTR
IPARM
Operation Definitions (Cont)
LOCK, UNLCK
LOKUP
MHHZO
MHLZO
MLHZO
MLLZO
MOVE
MOVEA
MOVEL
MSG
MULT
MVR
PARM
Operation Definitions (Cont.)
PUTJW
READ
READE
READP
RESET
RLABL
SET
SETLL
SETOF
SETON
SORTA
SQRT
SUB
SUSP
TAG
TESTB
TESTN
TESTZ
TIME
TIME2
UNLCK
XFOOT
Z-ADD
Z-SUB
Factor 2 (Columns 33-42)
Field, Table, Array, Subroutine, and Label Names
Alphanumeric Literals
Numeric Literals
Figurative Constants
Result(Columns 43-48)
Field Length(Columns 49-51)
Decimal Positions(Column 52)
Half Adjust(Column 53)
Resulting Indicators(Columns 54-59)
High Subfield(Columns 54-55)
Low Subfield(Columns 56-57)
Equal Subfield(Columns 58-59)
Comments(Columns 60-74)
Program Name (Columns 75-80)
The Calculation Specification Default Summary
Ch 9. Output Specifications
The Output Specification Fields
Sequence Number (Columns 1-5)
Specification Type (Column 6)
Record Description Fields (Columns 7-31)
File Name (Columns 7-14)
AND/OR (Columns 14-16)
Type (Column 15)
Record Addition/Deletion (Columns 16-18)
Fetch Overflow/Release (Column 16)
Space (Columns 17-18)
Skip (Columns 19-22)
Output Indicators (Columns 23-31)
The Output Specification Fields (Cont)
Field Description Fields (Columns 32-70)
Field Name (Columns 32-37)
Edit Code (Column 38)
Blank After (Column 39)
End Position (Columns 40-43)
Packed/Binary (Column 44)
The Output Specification Fields (Cont.)
Field Description Fields (Columns 32-70) (Cont.)
Constant/Edit Word (Columns 45-70)
Comments (Columns 71-74)
Program Name (Columns 75-80)
The Output Specification Default Summary
Ch 10. RPG Interface to VPLUS
Using the RPG Interface to VPLUS
Using FORMSPEC
Entering the Header Specification
Handling Run-Time Errors
Requesting an Error Dump
Entering File Description Specifications
Defining VPLUS Files
Specifying the Error Message Display Interval
Enabling the BREAK Key
Enabling the Function Key Labels
Downloading VPLUS Forms
Using the STATUS Array
Entering Input Specifications
VPLUS Event Codes
VPLUS Input Record Formats
Entering Calculation Specifications
Initiating VPLUS Actions
Returning VPLUS Events
Entering Output Specifications
VPLUS Action Codes
VPLUS Output Record Formats
Sample VPLUS Program
Ch 11. RPG Screen Interface (RSI)
Using the RPG Screen Interface (RSI)
Using SIGEDITOR
Redefining Function Key Labels
Using the RSI Application Help Facility
Entering File Description Specifications
Using the STATUS Array
Entering Input and Output Specifications
Entering Calculation Specifications
Executing an RSI Program
Using Messages with RSI
Displaying an End-of-Program Form
Sample RSI Programs
Using RSI CONSOLE Files
Entering File Description and Input Specifications
Entering Calculation Specifications
Compiling an RSI CONSOLE Program
Executing an RSI CONSOLE Program
Sample RSI CONSOLE Program
Using Different Terminals
Improving Performance Under PROCMON
Ch 12. RPG Compiler
The Compiler Commands
Entering Command Parameters
Listing Command Error Messages
Listing the Compiler Version Number
Listing Compiler Error Messages
Files Used by the Compiler
The Source Program File
The Relocatable Object File
The List File
The Compiler Commands Reference
:RPGXL
:RPGXLGO
:RPGXLLK
The Compiler Subsystem Commands
Entering Subsystem Command Parameters
Entering Subsystem Command Comments
Entering Subsystem Command Continuation Lines
The Compiler Subsystem Commands Reference
$CONTROL
$COPY
$IF
$INCLUDE
$INCLUDENOW
$PAGE
$SET
$TITLE
Ap A. RPG Compiler Messages
Message Numbers
Message Types
Message Types (Cont)
Message Types (Cont.)
Message Types (Cont)
Message Types (Cont.)
Message Types (Cont)
Message Types (Cont.)
Ap B. Run-Time Messages
RPG Errors
USWITCH Errors
BUFCHK Errors
Ap C. ASCII and EBCDIC Character Sets
INDEX
Index
MPE/iX 5.0 Documentation