Manuals / IBM / Kitchen Appliance / Frozen Dessert Maker

IBM AS/400 manual

Models: AS/400

1 489

Download 489 pages 47.95 Kb

Page 478

indicators

interlanguage

calls

146

See

alsoindividual

operation

codes

Intersystem

Communications Function (ICF) 331

as

error

indicators

227

displaying

while

debugging

204

J

error

227

function

key

(KA-KN,

KP-KY)

job

attributes

with

WORKSTN

file

334

See *JOBRUN

halt

(H1-H9)

used

to

end

a

program/procedure

152,

153,

154

last

record

(LR)

K

key

general

description

5

See

alsosearch

argument

used

to

end

a

program/procedure

152,

153,

154

286

overflow

composite

for

a

record or a file 285

examples

319, 320

partial

286

fetch

overflow

logic

320

key

field information in compiler listing 434

general

description

316

keyed

processing

presence

or

absence

of

317

access

path

282

relation

to

program

cycle 320

indexed file

288

setting

of 320

record-address limits file 290

with

PRINTER

file

316

sequential-within-limits 300

return

(RT)

keyed-sequence access path 282

used

to

end

a

program/procedure

152,

153,

154

using

5

keywords

DDS

281

INFDS

EXPORT

84

See file

information

data

structure

for

continuation

line

281

INFSR

CLEAR

334

See file

exception/error

subroutine

(INFSR)

HELP

334

input

HOME

334

file

341

PRINT

334

input

record

ROLLDOWN

334

unblocking

287

ROLLUP

334

input

specifications

for

display

device

file

See

alsoindicators

CLEAR

334

general

description

3

HELP

334

inquiry

messages

HOME

334

list

of

108

PRINT

334

replying

to

108

ROLLDOWN

334

inserting

specification

templates

390

ROLLUP

334

INSRTPL

parameter

386,

390

NOOPT

87, 226

integer

format

*OMIT

140

TRUNCNBR

parameter

416

Integrated

Language

Environment

(ILE)

L

effect

on

OPM-compatible

program

24

LANGID

parameter

program

using

CRTBNDRPG

26

CRTBNDRPG

command

58,

415

ending

an

ILE

program

109

CRTRPGMOD

command

74

family

of

ILE

compilers

17

languages,

ILE

17

interlanguage

calling

considerations

147

last

record

(LR)

indicator

interlanguage

calls

146

used

to end a program/procedure 152, 153, 154

internal

structure

of

program

81

length

of

record

in

a

file, conversion

overview

17

considerations

380

program

call

19

level

checking

270

program

creation

17

library,

creating

51

program

creation

strategies

23,

25,

27

limits

records

283

program

management

19

454 ILE RPG for AS/400 Programmer's Guide

Image 478

IBM AS/400 manual

Contents

AS/400e ILE RPG for AS/400 Programmers GuideVersion Page AS/400e ILE RPG for AS/400 Programmers GuideVersion 1999 ThirdEdition commentsContents RPG Introductionwith Chapter a Service ProgramCreating Debugging vi ILEHandling 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 Guide About This GuideWho Should Use This How to Send Your Comments Prerequisite and Related Informations New This WhatRelease? 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 sectionRPG IV Overview Cycle ProgrammingFigure 1. RPG Program Logic Cycle RPG IV Overview Subprocedure logicIndicators The firstExample of an ILE RPG Operation CodesProgram Example of an ILE RPG ProgramControl Specifications ProgramFile 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 weekFigure 4 Part 2 of 3. A Sample Payroll Calculation Program Example of an ILE RPG 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 GuideProgram Creation Chapter 2. RPG Programming in ILERPG Programming in ILE or CRTSRVPGM RPG Programming in ILEFigure 5. Program Creation in ILE Program Call Program Managementin 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 ApplicationEffect of ILE Example of OPM-Compatible ProgramOPM-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 ApplicationILE Application Using CRTRPGMOD Mixed-Language ILE Application ScenarioFigure 8. Single-Language Application Using CRTRPGMOD and CRTPGM ILE Application Using CRTRPGMOD Advanced Application ScenarioMixed-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 ModuleMultiple Procedures Module Prototyped CallsMODULE 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 ARRSRPTGeneral Considerations Coding ConsiderationsCoding Considerations Program Creation Main Procedure ConsiderationsSubprocedure Considerations Coding ConsiderationsSubprocedures Main ProceduresFor 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 CreationUsing the CRTBNDRPG Command Creating a Program for Source DebuggingConsiderations Creating a Program with Static BindingUsing 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 a Using In-Line Diagnostic MessagesCompiler 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 ChapterUsing the CRTRPGMOD CommandCreating a Module Object Creating a NOMAIN Module Creating a Module ObjectCOPY TRANSP Creating a Module ObjectFigure 36 Part 1 of 3. Source for TRANSSVC member Source for TRANSSVC member Creating a Module ObjectPart PartCreating a Module Object Creating a Module forDebugging Source for TRANSRPT module Creating a Module ObjectOFLIND*INOF Modules Related CL CommandsAdditional Examples Behavior of Bound ILEProgram Binding Modules into aBinding Modules into a Program into a UsingCRTPGM Group Binding Modules into a ProgramValue 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 GuideService Program Overview Chapter 8. Creating a Service ProgramService Program Overview Creating a Service Program Using CRTSRVPGM Strategies for Creating Service ProgramsCreating a Service Program Related CL commands Changing A Service Programa Service Program Using CRTSRVPGM Sample Service Program Sample Service ProgramFigure 42 Part 1 of 2. Source for Service Program CvtToHex Sample Service ProgramChapter 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 anChapter 8. Creating a Service Program101 Sample Service ProgramBasic 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 ProgramCALL Passing Parameters using theRunning a Program Using the CL CALL Command ILE RPG Program that Requires Parameters at Run Time Running a Program Using the CL CALL CommandPart PartRunning a Program From a Menu-Driven Application 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 ProgramReplying to Run-Time Inquiry Messages CommandReplying to Run-Time Inquiry Groups Ending an ILE ProgramManaging Activation Specifying an Activation Managing Activation GroupsGroup Compatibility DefaultRunning in the OPM Group Reclaim Resources CommandDeleting an Activation Managing Activation GroupsManaging Dynamically-Allocated Managing the Default Heap Using RPG OperationsStorage Name? Managing Dynamically-Allocated StorageENDDO Chapter 9. Running a Program115 Managing Dynamically-Allocated Storagenext@ 116 ILE RPG for AS/400 Programmers Guide Managing Dynamically-Allocated Storagename@ 4 of 5. Memory Management - Build a Linked List of Names Managing Dynamically-Allocated Storage52 Part Chapter 9. Running a Program117Managing Dynamically-Allocated Storage Heap Storage Problemsof 5. Memory Management - Build a Linked List of Names Managing Dynamically-Allocated Storage Managing Your Own HeapBindable APIs SeeAPI theReference Managing Dynamically-Allocated Storage54. /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 StorageProgram/Procedure Call Overview Chapter 10. Calling Programs and ProceduresProgram/Procedure Call Overview Program/Procedure Call Overview Calling ProceduresCalling Programs callsThe call stack The Call StackProgram/Procedure Call Overview stackProgram/Procedure Call Overview Recursive Calls59. Three Modules, each with subprocedures Program/Procedure Call Overview Parameter-Passing Considerations60. Recursive Call Stack To Be Avoided Program/Procedure Call Overview 132 ILE RPG for AS/400 Programmers GuideUsing a Prototyped Using the CALLP OperationCall Using a Prototyped Call Calling within an ExpressionParameter Passing Styles Examples of Free-Form CallPassing Prototyped Parameters Passing by ReferencePassing Prototyped Parameters Passing by Value2 * MinLengthFirst + LengthLast + 1 %sizeName Passing Prototyped Parameters PassingPassing Prototyped Parameters Using Operational DescriptorsPrototype 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 ParameterPassing Prototyped Parameters Checking for the NumberPassed 3. Concatenate the complete address 4. Return Source for procedure FMTADDRPassing Prototyped Parameters 68 Part69. Source for /COPY member with Prototype for Procedure FMTADDR Figure 68 Part 2 of 2. Source 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 Called Program or Procedure Returning from a Subprocedurewithout Returning using ILE Bindable Using Bindable APIsAPIs Calling a Graphics Routine Examples of Using Bindable APIsCalling a Graphics Routine Multithreading Considerations Calling Special RoutinesMultithreading Considerations Across How toShare Data Multithreading Considerations to Avoid DeadlockModules 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 The ILE Source Debugger Chapter 11. Debugging ProgramsThe ILE Source Debugger ATTR Debug CommandsThe ILE Source Debugger EQUATETBREAK 3. EnterPF1 HelpThe ILE Source Debugger THREADPreparing a Program for Debugging Preparing a Program forfor Debugging Creating a Root Source ViewCRTRPGMOD 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 the Program Source Viewing a DifferentModule 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 Breakpoints Setting and Removing Unconditional Thread BreakpointsFigure 81. Setting an Unconditional Job Breakpoint Setting and Removing BreakpointsSetting and Removing Breakpoints Example of Setting a Conditional Job Breakpoint Using F13Line National Language Sort Sequence NLSS CommandSetting 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*SRCSTMTUsing the Work with Module Breakpoints Display Setting and Removing Conditional Thread BreakpointsSetting 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 DisplayFigure 89. Example of a Display Watch Window Setting and Removing Watch ConditionsChapter 11. Debugging Programs191 Setting and Removing Watch Conditions Displaying Active WatchesRemoving 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 ENTRY Stepping Through the Program ObjectPLIST Figure 95. Stepping into Subprocedure Switch Displaying Data and ExpressionsStepping Through the Program Object Stepping Through the Program Object Displaying a Field using the EVAL debug commandˆ 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 ObjectUsing EVAL with Data Structures Displaying IndicatorsStepping 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 FieldsStepping Through the Program Object Figure 102. Examples of %SUBSTR using DBGEXChapter 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 withSample Source for Debug Examples ILE RPGExamples 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 *ptrException Handling Overview Chapter 12. Handling ExceptionsException 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 PercolationException Handling Overview ILE RPG Exception HandlingMain Handling Exception HandlingINFSR Exception Handling Overview HandlingException Handler Priority Using Exception HandlersUsing Exception Handlers Nested Exceptionstypes of Using Exception HandlersFor other messagesUsing Exception Handlers Example of Unhandled Function CheckNote The Optimization Considerations Using RPG-Specific Handlerskeyword, 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 spec‘*DETC’ Example of *PSSR Subroutine in Main ProcedureChapter 12. Handling Exceptions233 113. Example of Subprocedure *PSSR Subroutine with GOTO 234 ILE RPG for AS/400 Programmers GuideAvoiding MOVE Specifying a Return Point ILE Condition Handlers Using a Condition HandlerILE Condition Handlers RPGHDLR RPG exception handling procedure Action codes are ILE Condition HandlersSHOWERR 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 programIf this is CPF4906, handle the notify msg, otherwise percolate Handler definitions120. 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 InformationFeedback Areas Dumpof a Example of a Formatted Dump Figure 123. Feedback Areas section of Formatted Dumpof a Data InformationDump Figure 125 Part 1 of 2. Data section of Formatted Dump Example of a 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 Associating Files with Input/Output Devices Chapter 14. Defining FilesAssociating Files with Input/Output Devices Device Associating Files with Input/Output DevicesTypes of File Descriptions Naming FilesTypes of File Descriptions Files Using Files withProgram-Described Example of Some Typical Relationships betweenDefining Externally Described Defining Externally Described FilesFiles Renaming Field Names Renaming Record-Format NamesIgnoring Record Formats Defining Externally Described FilesDescription Using Input SpecificationsModify an Defining Externally Described FilesFiles Defining Externally DescribedFiles Using Output Specificationsediting DDS Referin the Defining Externally Described Files Level CheckingOSLSREC 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 f140. Example of a field Reference File Using Externally Described Disk Files284 ILE RPG for AS/400 Programmers Guide File Valid Keys for a RecordDisk Referring to Argumentsa Partial Using Externally Described Disk Files¹ A Record Blocking and UnblockingUsing Externally Described Disk Files Indexed File Using Program-Described Disk FilesUsing Program-Described Disk Files ArgumentsFiles Chapter 16. Accessing Database 289FilesHandling 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 fileMethods for Processing Disk Files Chapter 16. Accessing Database 295FilesSequential-by-Key Processing, Example Methods for Processing Disk Files Sequential-by-Key Using READ296 ILE RPG for AS/400 Programmers Guide for Processing Disk Files ENUMMethods for Processing Disk Files 298 ILE RPG for AS/400 Programmers GuideExample of Random-by-Key Processing Random-by-Key ProcessingMethods for Processing Disk Files Sequential-within-Limits Processing Methods for Processing Disk FilesExamples of Sequential-within-Limits Processing Disk FilesMethods for Processing Disk Files 2 Sequential-within-Limits ProcessingDDS for record address file LIMITS physical file Relative-Record-Number Processing Methods for Processing Disk FilesValid File Operations Valid File OperationsValid File Operations Chapter 16. Accessing Database 305Filesan 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 forSpecifying Using theFiles 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 Attached319DevicesAccessing Printer Devices Using the Fetch-OverflowPrinting 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 OverflowFile Changing Forms ControlInformation in Forms Accessing Printer DevicesLayout 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 SpecificationsUser-written program USERIO Using SPECIAL FilesPLISTSPCL Using Externally Described WORKSTN Files Chapter 18. Using WORKSTN FilesUsing Externally Described WORKSTN Files FunctionUsing Externally Described WORKSTN Files ¹ OutputChapter 18. Using WORKSTN Files333 Using Externally Described WORKSTN FilesR RESPONSE Device Specifying Function Key Indicators on Display Device FilesUsing Externally Described WORKSTN Files Using Externally Described WORKSTN Files Using SubfilesProcessing an Externally Described WORKSTN File Chapter 18. Using WORKSTN Files335field Using Externally Described WORKSTN FilesSubfile Display Using Externally Described WORKSTN Files Use of SubfilesData 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 GuideDatabase Physical File Chapter 19. Example of an Interactive ApplicationDatabase Physical File Display Device InquiryDDS for a Main Menu InquiryIn addition CUSMAIN RPG SourceMain Menu Inquiry to describing the constants, fields, line numbers, and hoSource for module CUSMAIN Main Menu Inquiry348 ILE RPG for AS/400 Programmers Guide CUSMSTL1 DDS for a File MaintenanceFile Maintenance LogicalFile DisplayFile Maintenance DeviceFigure 174 Part 2 of 2. DDS for display device file MNTMENU File MaintenanceChapter 19. Example of an Interactive 351Application File Maintenance CUSMNT RPG SourceDSPATRPR Chapter 19. Example of an Interactive 353Application File MaintenanceADD NEW CUSTOMER TO FILE SET MAINTENANCE MODE File Maintenance354 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 GuideYORKTOWN File MaintenanceChapter 19. Example of an Interactive 357Application Search by Zip Code Search byFile File SZIPMENU DDSDisplay Device14DSPATRHI Search by Zip CodePROMPT Search by Zip Code SCHZIP RPG SourceChapter 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 367ApplicationSearch and Inquiry by Name ¹ ToSUBROUTINE more The userrequests information by192. Customer Search and Inquiry by Name detailed information screen Search and Inquiry by Name370 ILE RPG for AS/400 Programmers Guide Appendixes  Copyright IBM Corp. 1994372 ILE RPG for AS/400 Programmers Guide AS/400 RPG/400and ILE AppendixDifferences Between OPM RPG/400 and ILE RPG RunningDebugging and Exception RPG/400 ILE RPG Differences Between OPM RPG/400ILE RPG DBCS Data in Character FieldsDBCS 378 ILE RPG for AS/400 Programmers Guide ILE RPGDifferences Between OPM RPG/400 Conversion Appendix B. UsingConversion Overview Conversion OverviewFile Record Length File ConsiderationsConversion 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 Converting a Member Using DefaultsSource 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 pageFigure 195. Converted RPG IV Source for TEST1 Example of Source ConversionARR1 Analyzing Your Conversion Analyzing Your ConversionReport Using the ConversionAnalyzing Your Conversion Sample Source Section of Conversion Report YourSample Message Summary of Conversion Report Analyzing Your Conversion Using the Log FileCPYF FROMFILEQRPGLE/QARNCVTLG TOFILEMYLIB/QRNCVTLG CRTFILE*YES Analyzing Your Conversion Appendix B. Using the RPG III to RPG IV397 Conversion Aid200. DDS for model log file QARNCVTLG in library QRPGLE Unsupported RPG III Features Resolving Conversion ProblemsCompilation Errors in Existing RPG III Code Resolving Conversion ProblemsRPG III Source for TEST2 ConversionRPG III Source for COPYDS1 Context-Sensitive Problems Resolving Conversion ProblemsStructures Use of ExternallyResolving 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 3description32CRTBNDRPG Command Description of the CRTBNDRPG CommandOPTION Details CURLIB CRTBNDRPG CommandLIBL SRCMBRCRTBNDRPG Command 410 ILE RPG for AS/400 Programmers GuideStatementNumber = sourceID * 1000000 + sourceSEUsequencenumber DEBUGIODBGVIEW CommandEVENTF STMTcharacter-value CRTBNDRPG CommandEXPDDS, and LANGIDUNQ CRTBNDRPG Commandsort-table-name LANGIDSHRCRTBNDRPG Command REPLACE416 ILE RPG for AS/400 Programmers Guide CRTBNDRPG CommandLIBCRTAUT target-release V2R3M5binding-directory-name CommandUSRCTL 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/ SourceCompiler Listings SectionSample Section of the Listing with OPTION*NOSRCSTMT Listings Appendix D. Compiler Listings427Figure 217 Part 1 of 3. Sample Source Part of the Listing Compiler Listings428 ILE RPG for AS/400 Programmers Guide Figure 217 Part 2 of 3. Sample Source Part of the Listing Compiler ListingsAppendix 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 InformationCompiler Listings External References ListFigure 224. Sample Cross-Reference Table with OPTION*NOSRCSTMT Compiler Listings Message SummaryFinal Summary Figure 225. Sample External ReferencesCompiler Listings Code Generation and Binding ErrorsFigure 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 continued SpecialSee 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.A ÉÂÔÙ99H3778 SC09-2507-02