Manuals / IBM / Kitchen Appliance / Frozen Dessert Maker

IBM AS/400 manual Workstn

Models: AS/400

1 489

Download 489 pages 47.95 Kb

Page 486

specifying a return point 237

subfields(continued)

specifying an activation group 110

for PRTCTL

323

specifying

error

indicators

227

subfiles

specifying the format of compiler listing 64

control-record format 335

spooling

278

descriptions

335

SQL

examples

337

See DB2

for

AS/400

SQL

file operation codes allowed with 336

SRCFILE

parameter

general

description

335, 336

CRTBNDRPG

command

58,

408

record

format

335

CRTRPGMOD

command

74

uses

of

337

SRCMBR

parameter

subprocedures

CRTBNDRPG

command

58,

409

coding

considerations

46

CRTRPGMOD

command

74

debugging

198

SRTSEQ

parameter

example

9

affect on key comparisons 279

information in compiler listing 435

CRTBNDRPG

command

58,

414

local

data

in

dump

listing

258

CRTRPGMOD

command

74

logic

flow

5

debug

considerations

183

overview

33

stack,

call

129,

218

returning

from

154

Start Debug (STRDBG) command 170

scope

of

files

80

Update

Production

files

(UPDPROD)

stepping

into

196

parameter

171

stepping

over

195

starting

commitment

control

307

SUBR23R3

(message

retrieval) 157

starting the ILE source debugger 170

SUBR40R3 (manipulating Double Byte Characters vari-

statement

view

ables)

157

creating

169

SUBR41R3 (manipulating Double Byte Characters vari-

using

for

debug 185

ables)

157

static

binding

subroutines

See binding

avoiding

a

loop

235

static

calls

19,

128

calling

SUBR

routines

157

static

procedure

call

128

error

228

status

codes

file

error

(INFSR)

229

data

management

errors

376

program

error

(*PSSR)

232

STEP debug

command

substring

of

character

or

graphic literal

definition

165

ILE debug built-in %SUBSTR 207

into

196

summary

tables

over

195

file operation codes allowed with

stepping

while

debugging

DISK

304

into

a

program

or

procedure 196

PRINTER

316

over a program or procedure 195

sequential

326

through

a

program

194

SPECIAL

328

storage

management

WORKSTN

341

allocating during run-time 119

sequential

file

processing

326

dynamic

storage

113

SPECIAL

file

processing

328

managing run-time 113

syntax

diagrams

strategies for creating ILE programs 23

CRTBNDRPG

command

406

STRDBG

command

CRTRPGMOD

command

420

See Start

Debug

(STRDBG)

command

CVTRPGSRC

command

383

STRSEU (edit source) command 52

interpreting

405

structured

operations

system

functions

indenting

65

spooling

278

Structured

Query

Language

(SQL)

system

reply

list

See DB2

for

AS/400

SQL

adding

to

108

subfields

changing

109

for

file

information

data

structure

253,

255

for

program

status

data

structure

252

462 ILE RPG for AS/400 Programmer's Guide

Image 486

IBM AS/400 manual Workstn

Contents

ILE RPG for AS/400 Programmers Guide AS/400eVersion Page ILE RPG for AS/400 Programmers Guide AS/400eVersion 1999 ThirdEdition commentsContents RPG Introductionwith a Service Program ChapterCreating vi ILE DebuggingHandling Working with Files and Devices Chapter 14. Defining FilesFiles FilesChapter 19. Example of an AppendixesAppendix B. Using the RPG III to RPG RPG forIndex COPYsuch provisions Noticescountry are inconsistentTrademarks and Service Programming Interface InformationNotices xiv ILE RPG for AS/400 Programmers Guide About This Guide GuideWho Should Use This How to Send Your Comments Prerequisite and Related InformationWhat s New ThisRelease? Numbers NODEBUGIOEVAL EVALRElement About This Guidexixxx ILE RPG for AS/400 Programmers Guide Elementto this Guide Changesxxii ILE RPG for AS/400 Programmers Guide ILE RPG Introduction 2 ILE RPG for AS/400 Programmers Guide RPG IV Overview RPG IV SpecificationsChapter 1. Overview sectionCycle Programming RPG IV OverviewFigure 1. RPG Program Logic Cycle RPG IV Overview Subprocedure logicIndicators The firstExample of an ILE RPG Operation CodesProgram Example of an ILE RPG ProgramProgram Control SpecificationsFile Description Specifications NAME Output SpecificationsExample of an ILE RPG Program RATEREGISTER A SubprocedureExample of an ILE RPG Program Chapter 1. Overview of the RPG IV Programming9 LanguageThis program creates a printed output of employees pay Example of an ILE RPG ProgramThe Entire Source Program for the weekExample of an ILE RPG Program Figure 4 Part 2 of 3. A Sample Payroll Calculation ProgramChapter 1. Overview of the RPG IV Programming11Language OS/400 System UsingInteracting with the System UsingAS/400 Tools ToolsApplication Development for AS/400IBM VisualAge RPG and Cooperative Development Environment for AS/400 AS/400 ToolsAS/400 Tools ¹ Program verification- performs, at the workstation, the full range oAS/400 Tools 16 ILE RPG for AS/400 Programmers GuideChapter 2. RPG Programming in ILE Program CreationRPG Programming in ILE RPG Programming in ILE or CRTSRVPGMFigure 5. Program Creation in ILE Program Management Program Callin ILE RPG Programming in ILE Source DebuggingBindable APIs shownsuppo Multithreaded ApplicationsRPG Programming in ILE THREAD*SEREALIZERPG Programming in ILE 22 ILE RPG for AS/400 Programmers GuideMethod Chapter 3. Program Creation StrategiesStrategy 1 OPM-Compatible Application OPM-Compatible ApplicationExample of OPM-Compatible Program Effect of ILEOPM-Compatible Application Related Information UsingILE Program Using CRTBNDRPG CRTBNDRPGILE Program Using CRTBNDRPG Example of ILE ProgramUsing Figure 7. ILE Program Using CRTBNDRPGStrategy 3 ILE Application ILE Application Using CRTRPGMODCRTRPGMOD Related InformationMethod ScenarioILE Application Using CRTRPGMOD Single-Language ILE ApplicationMixed-Language ILE Application Scenario ILE Application Using CRTRPGMODFigure 8. Single-Language Application Using CRTRPGMOD and CRTPGM Advanced Application Scenario ILE Application Using CRTRPGMODMixed-Language Application Service A Strategy to AvoidA Strategy to Avoid Related InformationWhen the default activation group and any named activationA Strategy to Avoid splitChapter 4. Creating an Application Using Multiple Procedures Multiple Procedures ModulePrototyped Calls Multiple Procedures ModuleMODULE specification. It has two output parameters Multiple Procedures ModulePrototype for procedure FmtCust Note the PR on definition 13. Prototype for FmtCust ProcedureExample of Module with MultipleExample of Module with Multiple Procedures Procedures NumToCin Fmt Example of Module with Multiple Procedures moduleARRSRPT *PGM ARRSRPT *MODULE Main Procedure InArrears FmtCust The Entire ARRSRPT ProgramExample of Module with Multiple Procedures Figure 22 PartILE RPG Complete Source for ARRSRPT Module Example of Module with Multiple ProceduresFigure 22 Part 42 ILE RPG for AS/400 Programmers GuideSUBDUR Example of Module with Multiple ProceduresChapter 4. Creating an Application Using Multiple43 Procedures DaysLate*DOutput for ARRSRPT ARRSRPTCoding Considerations General ConsiderationsCoding Considerations Program Creation Main Procedure ConsiderationsSubprocedure Considerations Coding ConsiderationsMain Procedures SubproceduresFor Further Information Prototyped Call For Further InformationApplication Creating50 ILE RPG for AS/400 Programmers Guide Chapter 5. Entering StatementsFile SourceUsing the Source Entry Utility Using SEUUsing SEU type indicated by the parameter CODE Using SEUProcedure EMPTYPE returns a string representing the employee 28. Source for EMPRPT memberUsing SQL Statements Using SQL StatementsReference for more Using SQL Statementsfor AS/400 SQL Programming manual and theDB2 UDB for AS/400 SQL Refer toADTS thefor AS/400 Source EntryUsing the CRTBNDRPG CommandUsing the CRTBNDRPG Command CRTBNDRPGOptions Using the CRTBNDRPG CommandListing CreationCreating a Program for Source Debugging Using the CRTBNDRPG CommandConsiderations Binding Creating a Program with StaticUsing the CRTBNDRPG Command ¹ WRKOUTQ queue-name CommandUsing Creating an OPM-CompatibleA Sample Payroll Calculation Program Using the CRTBNDRPG CommandPart Figure 32 Part 2 of 2. A Sample Payroll Calculation ProgramListing Using a Compiler ListingUsing a Compiler Listing Obtaining a Compilera Compiler Listing Customizing a Compiler ListingCustomizing a Page Heading UsingUsing a Compiler Listing Customizing the SpacingIndenting Structured Operations The /SPACECompilation ErrorsListing UsingUsing In-Line Diagnostic Messages Using aCompiler Listing Browsing a Compiler Listing Using SEU Correcting Run-time ErrorsUsing Additional-Diagnostic Messages Using a Compiler ListingCoordinating Listing Options with Debug View Options Using a Compiler Listing forMaintenance Using a Compiler ListingArea DataAccessing the RETURNCODE Data Area Chapter 6. Creating a Program with the CRTBNDRPG Command71Accessing the RETURNCODE Data Area 72 ILE RPG for AS/400 Programmers Guidea Module Object Commands7. Creating ChapterCommand Using the CRTRPGMODCreating a Module Object Creating a NOMAIN Module Creating a Module ObjectCreating a Module Object COPY TRANSPFigure 36 Part 1 of 3. Source for TRANSSVC member Source for TRANSSVC member Creating a Module ObjectPart PartCreating a Module for Creating a Module ObjectDebugging Creating a Module Object Source for TRANSRPT moduleOFLIND*INOF Modules Related CL CommandsAdditional Examples Behavior of Bound ILEBinding Modules into a ProgramBinding Modules into a Program Using into aCRTPGM Binding Modules into a Program GroupValue CRTRPGMOD MODULEMYLIB/TRANSRPT Binding Modules into a ProgramConcepts for CRTRPGMOD MODULEMYLIB/TRANSSVCRelated CL Commands Using a Binder ListingUsing a Binder Listing Additional ExamplesBASIC Changing a Module or ProgramChanging a Module or FULLChanging the Optimization Using the UPDPGM CommandLevel Changing a Module or ProgramReducing an Objects Removing ObservabilitySize Changing a Module or ProgramChanging a Changing a Module or Program 90 ILE RPG for AS/400 Programmers GuideChapter 8. Creating a Service Program Service Program OverviewService Program Overview Strategies for Creating Service Programs Creating a Service Program Using CRTSRVPGMCreating a Service Program Changing A Service Program Related CL commandsa Service Program Using CRTSRVPGM Sample Service Program Sample Service ProgramSample Service Program Figure 42 Part 1 of 2. Source for Service Program CvtToHexChapter 8. Creating a Service Program95 42 Part Sample Service ProgramSource for Service Program CvtToHex 96 ILE RPG for AS/400 Programmers Guide43. Source for /COPY Member with Prototype for CvtToHex Creating the Service ProgramSample Service Program Figure 44. Source for Binder Language for CvtToHexMODUL Binding to a ProgramSample Service Program 98 ILE RPG for AS/400 Programmers GuideSample Service Program Program to test Service Program CVTTOHEXadd a Updating the ServiceSample Binder Listing to anSample Service Program Chapter 8. Creating a Service Program101Basic Binder listing for CVTHEXPGM Sample Service Program 102 ILE RPG for AS/400 Programmers GuideRunning a Program Using the CL CALL Command Chapter 9. Running a ProgramPassing Parameters using the CALLRunning a Program Using the CL CALL Command ILE RPG Program that Requires Parameters at Run Time Running a Program Using the CL CALL CommandPart PartApplication Running a Program From a Menu-Driven ApplicationRunning a Program From a A* CMDPROMPT Figure 50. Data Description Specification of an Application MenuRunning a Program From a Menu-Driven Application Figure 51. Source for Menu ProgramCommand Replying to Run-Time Inquiry MessagesReplying to Run-Time Inquiry Ending an ILE Program GroupsManaging Activation Managing Activation Groups Specifying an ActivationGroup Default CompatibilityRunning in the OPM Group Reclaim Resources CommandDeleting an Activation Managing Activation GroupsManaging the Default Heap Using RPG Operations Managing Dynamically-AllocatedStorage Managing Dynamically-Allocated Storage Name?ENDDO Managing Dynamically-Allocated Storage Chapter 9. Running a Program115next@ Managing Dynamically-Allocated Storage 116 ILE RPG for AS/400 Programmers Guidename@ 4 of 5. Memory Management - Build a Linked List of Names Managing Dynamically-Allocated Storage52 Part Chapter 9. Running a Program117Heap Storage Problems Managing Dynamically-Allocated Storageof 5. Memory Management - Build a Linked List of Names Managing Your Own Heap Managing Dynamically-Allocated StorageBindable APIs Managing Dynamically-Allocated Storage SeeAPI theReference54. /COPY file DYNARRI containing prototypes for DYNARRAY module of 2. Global variables and local prototypes for DYNARRAY Managing Dynamically-Allocated StoragePart Chapter 9. Running a Program121Figure 55 Part Figure 56 on page 123 shows the subprocedures in DYNARRAYManaging Dynamically-Allocated Storage 2 ofManaging Dynamically-Allocated Storage DYNARRAY SubproceduresDYNARRAY Subprocedures PartPart 3 of DYNARRAY SubproceduresManaging Dynamically-Allocated Storage 124 ILE RPG for AS/400 Programmers GuideManaging Dynamically-Allocated Storage DYNARRAY SubproceduresDYNARRAY Subprocedures PartThe logic of the subprocedures is as follows Managing Dynamically-Allocated StorageChapter 10. Calling Programs and Procedures Program/Procedure Call OverviewProgram/Procedure Call Overview Program/Procedure Call Overview Calling ProceduresCalling Programs callsThe call stack The Call StackProgram/Procedure Call Overview stackRecursive Calls Program/Procedure Call Overview59. Three Modules, each with subprocedures Parameter-Passing Considerations Program/Procedure Call Overview60. Recursive Call Stack To Be Avoided Program/Procedure Call Overview 132 ILE RPG for AS/400 Programmers GuideUsing the CALLP Operation Using a PrototypedCall Using a Prototyped Call Calling within an ExpressionParameter Passing Styles Examples of Free-Form CallPassing Prototyped Parameters Passing by ReferencePassing by Value Passing Prototyped Parameters2 * MinLengthFirst + LengthLast + 1 %sizeName Passing Prototyped Parameters PassingUsing Operational Descriptors Passing Prototyped ParametersPrototype for ILE CEE API CEETSTA with CONST Parameter Len returns a 10-digit integer value. The parameter Omitting ParametersPassing Prototyped Parameters is a character string passed by read-only referencePassing Prototyped Parameters Passing *OMITLeaving Out Parameters 67. Prototype for System API QCMDEXC with Optional ParameterChecking for the Number Passing Prototyped ParametersPassed 3. Concatenate the complete address 4. Return Source for procedure FMTADDRPassing Prototyped Parameters 68 PartFigure 68 Part 2 of 2. Source for procedure FMTADDR 69. Source for /COPY member with Prototype for Procedure FMTADDRPassing Prototyped Parameters 70 Part Source for procedure PRTADDRPassing Prototyped Parameters DIM2Passing Less Data Than Required ParametersPassing Prototyped Parameters Order of EvaluationInterlanguage Calls effectInterlanguage Calling ConsiderationsUsing Call OperationsUsing V4R4M0Using the Fixed-Form Call Operations CALLB onlyOperations Passing Parameters Using PARMExamples of CALL and CALLB PLISTUsing the PLIST Operation the Fixed-Form Call OperationsNormal End Returning from a Main ProcedureProcedure Returning from a CalledReturning from a Called Program or Procedure Abnormal EndReturning from a Subprocedure Returning from a Called Program or Procedurewithout Using Bindable APIs Returning using ILE BindableAPIs Examples of Using Bindable APIs Calling a Graphics RoutineCalling a Graphics Routine Calling Special Routines Multithreading ConsiderationsMultithreading Considerations How to AcrossShare Data to Avoid Deadlock Multithreading ConsiderationsModules Considerations Deadlock ExampleThis section describes how to Debugging and Exception Handling¹ Debug an Integrated Language Environment application by using the Language Environment source debugger162 ILE RPG for AS/400 Programmers Guide Chapter 11. Debugging Programs The ILE Source DebuggerThe ILE Source Debugger ATTR Debug CommandsThe ILE Source Debugger EQUATETBREAK 3. EnterPF1 HelpThe ILE Source Debugger THREADPreparing a Program for Debugging Preparing a Program forCreating a Root Source View for DebuggingCRTRPGMOD or Preparing a Program for Debugging a Listing ViewCreating a COPY Source CreatingProgram for Debugging a StatementView CreatingStarting the ILE Source Starting the ILE Source DebuggerStarting the ILE Source Debugger Setting Debug OptionsSTRDBG Example Display Module Source display for program DEBUGEXOPM source debug support field, and Example of Adding a ServiceExample of Removing ILE Programs from a Debug Session Adding/Removing Programs from a Debug SessionViewing the Program Source Viewing the Program SourceViewing a Different Viewing the Program SourceModule 79. Source View of ILE C procedure cproc Changing the View of aModule Viewing the Program SourceSetting and Removing Breakpoints Setting and Removing BreakpointsSetting and Removing Breakpoints Setting and RemovingBreakpoints UnconditionalSetting an BreakpointSetting and Removing Unconditional Thread Breakpoints Setting and Removing BreakpointsFigure 81. Setting an Unconditional Job Breakpoint Setting and Removing BreakpointsExample of Setting a Conditional Job Breakpoint Using F13 Setting and Removing BreakpointsLine Command National Language Sort Sequence NLSSSetting and Removing Breakpoints Setting and Removing Breakpoints 184 ILE RPG for AS/400 Programmers GuideUsing Setting and Removing JobSetting StatementFigure 84. Sample Section of the Listing with OPTION*NOSRCSTMT Setting and Removing BreakpointsSetting a Breakpoint Using Statement View Figure 85. Sample Section of the Compiler Listing with OPTION*SRCSTMTSetting and Removing Conditional Thread Breakpoints Using the Work with Module Breakpoints DisplaySetting and Removing Breakpoints Removing All Job and Debug CommandsSetting and Removing Watch Conditions ConditionsDisplay Characteristics of WatchesSetting and Removing Watch Conditions SourceSetting and Removing Watch Conditions Setting Watch ConditionsCommand Example of a Work with Watch DisplaySetting and Removing Watch Conditions Figure 89. Example of a Display Watch WindowChapter 11. Debugging Programs191 Displaying Active Watches Setting and Removing Watch ConditionsRemoving Watch Conditions Example of Setting a Watch Condition Example of Setting a Watch ConditionObject Stepping Through the Program ObjectStepping Over Call Statements STEP number-of-statements OVERStepping Into Call Statements Stepping Through the Program ObjectStepping Through the Program Object Stepping Through the Program Object ENTRYPLIST Displaying Data and Expressions Figure 95. Stepping into Subprocedure SwitchStepping Through the Program Object Displaying a Field using the EVAL debug command Stepping Through the Program Objectˆ LASTNAME = Jones Scalar Unexpected Results when Evaluating VariablesStepping Through the Program Object FieldsStepping Through the Program Object Displaying the Contents of an ArrayDisplaying the Contents of a Table variablefield-name isDisplaying Data Structures Stepping Through the Program ObjectDisplaying Indicators Using EVAL with Data StructuresStepping Through the Program Object Stepping Through the Program Object Displaying Fields as Hexadecimal Valuesin Character Format Displayingby Pointers DataDisplaying Variable-Length Fields Displaying Null-Capable FieldsFigure 102. Examples of %SUBSTR using DBGEX Stepping Through the Program ObjectChapter 11. Debugging Programs207 Fields ValueChanging the Value of Fields Displaying Attributes of a Field or CommandEquating a Name with a Field, Expression, or Command Equating a Name withILE RPG Sample Source for Debug ExamplesExamples Sample Source for Debug Examples Figure 105 Part 1 of 4. Source for Module DBGEXPointers PARM1 is used when calling RPGPROG programSample Source for Debug Examples Date, Time, TimestampSource for Module DBGEX Sample Source for Debug ExamplesFigure 105 Part 214 ILE RPG for AS/400 Programmers GuideSource for Module DBGEX. DBGEX is the main module of the Sample Source for Debug Examples105 Part 4 of programchar *cprocunsigned int size, char *inzval Figure 107. Source for C Procedure cproc. cproc is called by DBGEXSample Source for Debug Examples char *ptrChapter 12. Handling Exceptions Exception Handling OverviewException Handling Overview boundary is controlreached boundary. A Exception Handling OverviewEach 218 ILE RPG for AS/400 Programmers GuideException Handling Overview Call Stack and Exception Message PercolationILE RPG Exception Handling Exception Handling OverviewMain Exception Handling HandlingINFSR Exception Handling Overview HandlingException Handler Priority Using Exception HandlersUsing Exception Handlers Nested Exceptionstypes of Using Exception HandlersFor other messagesExample of Unhandled Function Check Using Exception HandlersNote The Using RPG-Specific Handlers Optimization Considerationskeyword, ILE Specifying Error Indicators or the E ExtenderUsing an Error Subroutine blankUsing a File Error INFSR Subroutine BEGSRTRNSUPDT This program is a simple inventory update program If unexpected error occurs, cause inquiry message to be issued Access the product master file using the transaction productIf the record is found, update the quantity in the master file numberUsing a Program Error Subroutine specExample of *PSSR Subroutine in Main Procedure ‘*DETC’Chapter 12. Handling Exceptions233 113. Example of Subprocedure *PSSR Subroutine with GOTO 234 ILE RPG for AS/400 Programmers GuideAvoiding MOVE Specifying a Return Point Using a Condition Handler ILE Condition HandlersILE Condition Handlers RPGHDLR RPG exception handling procedure ILE Condition Handlers Action codes areSHOWERR Condition CEEHDLRShow exception handling using a user-defined ILE Condition HandlersRegister the handler and generate errors ILE Condition HandlersHandlers UsingCancel APIsProcedure SubProc. Call Enabler. Since this call will fail Define the prototype for the cancel handler. This procedure isa local procedure define a local *PSSR subroutine to handle the errorFigure 118 Part Procedure Enabler. This procedure enables a cancel handlerEnabling and Coding a Cancel Handler for a Subprocedure 3 ofProblems when ILE CL Monitors for Notify and Status Messages 119. Output from CANHDLR programHandler definitions If this is CPF4906, handle the notify msg, otherwise percolate120. ILE Condition Handler that Ignores CPF4906 121. How to Ignore Status and Notify Messages Chapter 12. Handling Exceptions249250 ILE RPG for AS/400 Programmers Guide Chapter 13. Obtaining a Dump Using the DUMP Operation CodeUsing the DUMP Operation Code Obtaining an ILE RPG Formatted Dumpof a a FormattedDump Program Status InformationDump Feedback Areasof a Example of a Formatted Dump Figure 123. Feedback Areas section of Formatted DumpData Information of aDump Example of a Formatted Dump Figure 125 Part 1 of 2. Data section of Formatted Dump256 ILE RPG for AS/400 Programmers Guide Example of a Formatted Dump Example of a Formatted Dump Working with Files and Devices 260 ILE RPG for AS/400 Programmers Guide Chapter 14. Defining Files Associating Files with Input/Output DevicesAssociating Files with Input/Output Devices Device Associating Files with Input/Output DevicesNaming Files Types of File DescriptionsTypes of File Descriptions Files Using Files withProgram-Described Example of Some Typical Relationships betweenDefining Externally Described Files Defining Externally DescribedFiles Renaming Field Names Renaming Record-Format NamesIgnoring Record Formats Defining Externally Described FilesDescription Using Input SpecificationsModify an Defining Externally Described FilesFiles Defining Externally DescribedUsing Output Specifications Filesediting DDS Referin the Level Checking Defining Externally Described FilesOSLSREC RPG I/O Operations Defining Program-Described FilesData Management Operations and ILE RPG I/O Operations DataOperation Data Management Operations and ILE RPG I/O OperationsOperation 272 ILE RPG for AS/400 Programmers GuideOverriding and Redirecting File Input and Output FileConsiderations Chapter 15. GeneralInput Inputand Output OutputFile Locking File LockingRecord Locking Record LockingPath Sharing an Open DataSpooling SpoolingSRTSEQ/ALTSEQ in an Output SpoolingSRTSEQ/ALTSEQ FileSRTSEQ/ALTSEQ 280 ILE RPG for AS/400 Programmers GuideDatabase Files Chapter 16. AccessingFiles Physical Files and Logical FilesAccess Path Using Externally Described Disk FilesRecord Format Specifications Using Externally Described Disk FilesThe sample Using Externally Described Disk FilesExample of the Data Description Specifications for a Database File DDS are for the customer master logical file CUSMSTL. The fUsing Externally Described Disk Files 140. Example of a field Reference File284 ILE RPG for AS/400 Programmers Guide Valid Keys for a Record FileDisk Referring to Argumentsa Partial Using Externally Described Disk FilesRecord Blocking and Unblocking ¹ AUsing Externally Described Disk Files Indexed File Using Program-Described Disk FilesUsing Program-Described Disk Files ArgumentsChapter 16. Accessing Database 289Files FilesHandling Using Program-Described Disk Files Sequential FileRecord Address File D K1Relative Record Numbers Methods for Processing Disk FilesLimits Records Methods for Processing Disk Filessubsequent Consecutive ProcessingMethods for Processing Disk Files textExamples of Sequential-by-Key Processing DATA DESCRIPTION SPECIFICATIONS DDSFigure 144 on page 294 andSequential-by-Key Processing Disk145. DDS for database file TRWEEK physical file Methods for Processing Disk FilesFigure 144. DDS for database file EMPMST physical file 146. DDS for database file EMPL1 logical fileChapter 16. Accessing Database 295Files Methods for Processing Disk FilesSequential-by-Key Processing, Example Sequential-by-Key Using READ Methods for Processing Disk Files296 ILE RPG for AS/400 Programmers Guide for Processing Disk Files ENUMMethods for Processing Disk Files 298 ILE RPG for AS/400 Programmers GuideRandom-by-Key Processing Example of Random-by-Key ProcessingMethods for Processing Disk Files Sequential-within-Limits Processing Methods for Processing Disk FilesExamples of Sequential-within-Limits Processing Disk Files2 Sequential-within-Limits Processing Methods for Processing Disk FilesDDS for record address file LIMITS physical file Relative-Record-Number Processing Methods for Processing Disk FilesValid File Operations Valid File OperationsChapter 16. Accessing Database 305Files Valid File Operationsan A,P,G,D,T,Z Valid File Operations A record-addressUsing Commitment Control Using Commitment Controlsee theBackup and Recovery manual Commitment Control LocksUsing Commitment Control Abridged forUsing the SpecifyingFiles 2.CRTJRN JRNJOURNAL JRNRCVRECEIVER Example of Using Commitment Control1.CRTJRNRCV JRNRCV RECEIVER 3.STRJRNPF FILEMASTER TRANS JRNJOURNAL2CALL. REVISE ControlLCKLVL*ALL 3ENDCMTCTLDDM Files CycleDDM Files Commitment Control inUsing Pre-V3R1 DDMDDM Files 314 ILE RPG for AS/400 Programmers GuideDevices AccessingExternally TypesSpecifying PRINTER Files Accessing Printer DevicesAccessing Printer Devices Handling Page OverflowAccessing Printer Devices OverflowAccessing Printer Devices Accessing Printer Devices Example of Printing Headings on Every PageExample of Printing a Field on Every Page Chapter 17. Accessing Externally Attached319DevicesUsing the Fetch-Overflow Accessing Printer DevicesPrinting a Field on Every Page Accessing Printer Devices Figure 159. Overflow Printing Setting of the Overflow IndicatorAccessing Printer Devices Fetch OverflowExample of Specifying Fetch Overflow Use of Fetch OverflowChanging Forms Control FileInformation in Accessing Printer Devices FormsLayout of OPM PRTCTL Data Structure Accessing Tape Devices Accessing Tape DevicesUsing Sequential Files Accessing Display DevicesUsing Sequential Files FileUsing SPECIAL Files Using SPECIAL FilesFile Status Using SPECIAL FilesError DescriptionUsing Example of Using a Special FileSPECIAL Files SpecificationsUsing SPECIAL Files User-written program USERIOPLISTSPCL Using Externally Described WORKSTN Files Chapter 18. Using WORKSTN FilesUsing Externally Described WORKSTN Files FunctionUsing Externally Described WORKSTN Files ¹ OutputUsing Externally Described WORKSTN Files Chapter 18. Using WORKSTN Files333R RESPONSE Specifying Function Key Indicators on Display Device Files DeviceUsing Externally Described WORKSTN Files Using Externally Described WORKSTN Files Using SubfilesProcessing an Externally Described WORKSTN File Chapter 18. Using WORKSTN Files335Using Externally Described WORKSTN Files fieldSubfile Display Use of Subfiles Using Externally Described WORKSTN FilesData Description Specifications for a Subfile Record Format Using Program-Described WORKSTN Files Using Program-Described WORKSTN FilesUsing a Program-Described withUsing Program-Described WORKSTN Files Output SpecificationsName Input SpecificationsCalculation Specifications withoutOutput File Valid WORKSTN File OperationsInput File Combined FileWRITE Operation EXFMT OperationREAD Operation Multiple-Device FilesMultiple-Device Files Multiple-Device Files 344 ILE RPG for AS/400 Programmers GuideChapter 19. Example of an Interactive Application Database Physical FileDatabase Physical File Display Device InquiryDDS for a Main Menu InquiryIn addition CUSMAIN RPG SourceMain Menu Inquiry to describing the constants, fields, line numbers, and hoMain Menu Inquiry Source for module CUSMAIN348 ILE RPG for AS/400 Programmers Guide CUSMSTL1 DDS for a File MaintenanceFile Maintenance LogicalFile DisplayFile Maintenance DeviceFile Maintenance Figure 174 Part 2 of 2. DDS for display device file MNTMENUChapter 19. Example of an Interactive 351Application CUSMNT RPG Source File MaintenanceDSPATRPR File Maintenance Chapter 19. Example of an Interactive 353ApplicationADD NEW CUSTOMER TO FILE File Maintenance SET MAINTENANCE MODE354 ILE RPG for AS/400 Programmers Guide Customer File Maintenance Display Mode prompt screen File MaintenanceF6 Update F3 End JobCustomer File Maintenance Add Mode prompt screen File MaintenanceCustomer File Maintenance Display Mode screen 356 ILE RPG for AS/400 Programmers GuideFile Maintenance YORKTOWNChapter 19. Example of an Interactive 357Application Search by Search by Zip CodeFile File SZIPMENU DDSDisplay DeviceSearch by Zip Code 14DSPATRHIPROMPT SCHZIP RPG Source Search by Zip CodeChapter 19. Example of an Interactive 361Application Search by Zip Code 362 ILE RPG for AS/400 Programmers GuideThe subfile is written to the screen as shown in Figure 186 on pageFile Search and Inquiry by NameSearch and Inquiry by Name CUSMSTL3 DDSSearch and Inquiry by Name DeviceFile SNAMMENU DDS for a DisplaySCHNAM RPG Source Search and Inquiry by NameSearch and Inquiry by Name Chapter 19. Example of an Interactive 367Application¹ To Search and Inquiry by NameSUBROUTINE more The userrequests information bySearch and Inquiry by Name 192. Customer Search and Inquiry by Name detailed information screen370 ILE RPG for AS/400 Programmers Guide Appendixes  Copyright IBM Corp. 1994372 ILE RPG for AS/400 Programmers Guide AS/400 RPG/400and ILE AppendixRunning Differences Between OPM RPG/400 and ILE RPGDebugging and Exception RPG/400 ILE RPG Differences Between OPM RPG/400DBCS Data in Character Fields ILE RPGDBCS ILE RPG 378 ILE RPG for AS/400 Programmers GuideDifferences Between OPM RPG/400 Conversion Appendix B. UsingConversion Overview Conversion OverviewFile Considerations File Record LengthConversion Overview File The Log FileConversion Aid Tool Requirements OverviewConverting Your Source Wont DoConverting Your Source What the Conversionmember The CVTRPGSRC CommandConverting Your Source namessource-file-name Converting Your SourceFROMFILE LIBLQRPGLESRC Converting Your SourceTOFILE NONEConverting Your Source Defaults Converting a Member UsingSource Performing a Trial Conversion Converting All Members in a Filea File Converting Your SourceSource Members Obtaining Conversion ReportsConverting Auto Report Converting Your SourceExample of Source Conversion Inserting Specification Templatesa Data Example of Source ConversionTo convert this source, enter Exampleof Source Conversion The converted source is shown in Figure 195 on pageExample of Source Conversion Figure 195. Converted RPG IV Source for TEST1ARR1 Analyzing Your Conversion Analyzing Your ConversionUsing the Conversion ReportAnalyzing Your Conversion Your Sample Source Section of Conversion ReportSample Message Summary of Conversion Report Using the Log File Analyzing Your ConversionCPYF FROMFILEQRPGLE/QARNCVTLG TOFILEMYLIB/QRNCVTLG CRTFILE*YES Appendix B. Using the RPG III to RPG IV397 Conversion Aid Analyzing Your Conversion200. DDS for model log file QARNCVTLG in library QRPGLE Unsupported RPG III Features Resolving Conversion ProblemsCompilation Errors in Existing RPG III Code Resolving Conversion ProblemsConversion RPG III Source for TEST2RPG III Source for COPYDS1 Context-Sensitive Problems Resolving Conversion ProblemsUse of Externally StructuresResolving Conversion Problems Resolving Conversion Problems Merging an Array with an Externally Described DS SubfieldInitializing 207. RPG III source using external data structure with array210. RPG III source with renamed and initialized external subfield Run-time DifferencesResolving Conversion Problems RPG IV source with two definitions for renamed subfieldResolving Conversion Problems 404 ILE RPG for AS/400 Programmers GuideHow to Interpret Syntax Diagrams Appendix C. The Create CommandsUsing CL Commands Reading Syntax DiagramsCRTBNDRPG Command CRTBNDRPG Command3library-name/32 CRTBNDRPG CommandAppendix C. The Create Commands407 3description32Description of the CRTBNDRPG Command CRTBNDRPG CommandOPTION Details CURLIB CRTBNDRPG CommandLIBL SRCMBRCRTBNDRPG Command 410 ILE RPG for AS/400 Programmers GuideStatementNumber = sourceID * 1000000 + sourceSEUsequencenumber DEBUGIODBGVIEW CommandEVENTF STMTCRTBNDRPG Command character-valueEXPDDS, and LANGIDUNQ CRTBNDRPG Commandsort-table-name LANGIDSHRCRTBNDRPG Command REPLACECRTBNDRPG Command 416 ILE RPG for AS/400 Programmers GuideLIBCRTAUT target-release V2R3M5Command binding-directory-nameUSRCTL CRTBNDRPG Command ENTRYEXITCRTRPGMOD Command CRTRPGMOD CommandCRTRPGMOD Command Appendix C. The Create Commands421of CRTRPGMOD Description of the CRTRPGMOD commandCRTRPGMOD Command 422 ILE RPG for AS/400 Programmers GuideAppendix D. Compiler Listings Compiler ListingsReading a Compiler ListingPrologue Compiler Listings3/ Source member Compiler Listings2/ Module or Program 4/ SourceSection Compiler ListingsSample Section of the Listing with OPTION*NOSRCSTMT Listings Appendix D. Compiler Listings427Compiler Listings Figure 217 Part 1 of 3. Sample Source Part of the Listing428 ILE RPG for AS/400 Programmers Guide Compiler Listings Figure 217 Part 2 of 3. Sample Source Part of the ListingAppendix D. Compiler Listings429 Line Number Compiler Listings1a/ *NOSRCSTMT Source Heading Ruler LineSpecifications DiagnosticAdditional ListingsSample Additional Diagnostic Messages with OPTION*NOSRCSTMT Output Buffer PositionsCOPY Member Table Sample Additional Diagnostic Messages with OPTION*SRCSTMT1/ Total Number of Characters Altered Compile-Time DataCompiler Listings 2/ Character to be AlteredCompiler Listings Key Field InformationCross-Reference Table Figure 223. Sample Key Field InformationExternal References List Compiler ListingsFigure 224. Sample Cross-Reference Table with OPTION*NOSRCSTMT Compiler Listings Message SummaryFinal Summary Figure 225. Sample External ReferencesCode Generation and Binding Errors Compiler ListingsFigure 227. Sample Final Summary Compiler Listings 438 ILE RPG for AS/400 Programmers GuideProgramming BibliographyADTS/400 DevelopmentGDDM FORTRAN/400Bibliography AS/400442 ILE RPG for AS/400 Programmers Guide Special continuedSee Add Page CALL CL commands control-record format, subfile DBCS continued debugging continued NLSS 364access NOOPTsummary Page Page alsoDISK See long alsoPARM methodscontinued creationcontinuedcallcontinued alsoILE programcontinued debuggingcontinuedWORKSTN Page WORKSTN file definition 331 examples 345 externally described ÉÂÔÙ Part Number 99H3778 Program Number 5769-RG1 Printed in U.S.A99H3778 SC09-2507-02