INDEX

A%ABS, 191acclerator keys, menus, 74, 85-86activation groups, 5, 23-24, 474, 482-483

Reclaim Activation Group (RCLACTGRP)in, 484

Reclaim Resource (RCLRSC) in, 484scoping, 484shared data path restriction in, 6Start Commitment Control (STRCMTCTL)

in, 484subprocedures in ILE, 503

active windows, 87Add Binding Directory Entry (ADDBNDDIRE),

503Add Duration (ADDDUR), 214, 445, 448, 450Add Trace (ADDTRC), 313Add Validation List Entry

(QsyAddValidationLstEntry) API, 241, 292%ADDR, 191Alter Table (ALTTBL), 463Analyze User Object (ANZUSROBJ), 425

APIs, 151-167, 239-296Add Validation List Entry

(QsyAddValidationLstEntry) in, 241, 292available APIs, sources for, 240bind by reference/bind by copy and,

286-287CEEDOD, 495, 500Close Spooled File (QSPCLOSP) in, 274Command Execute (QCMDEXC) in, 151,

152-162, 241Command Line (QUSCMDLN) in, 241Convert Date to Lilian (CEEDAYS) in, 453Convert Lilian Date to Day of Week

(CEEDYWK) in, 453Create Spooled File (QSPCRTSP) in, 274Create User Space (CUSRCRTUS) in, 241,

256, 257data structures and, 212Display Access Path (DSPPATH) and, 262,

296encryption, 291-295error code parameters, optional, 244-245Free Storage (CEEFRST) for, 189

Note: Boldface numbers indicate illustrations. 513

APIs, continuedGet Heap Storage (CEEGTST) for, 189Get Spooled File (QSPGETSP) in, 274handles for, 262ILE APIs, 239, 286-289interface in, 240List APIs, 239, 259-262List Database Relations (QDBLDBR) in,

241, 262-274List Fields (QUSLFLD) in, 241, 273List ILE Program Information (QBNLPGMI)

in, 241, 287-289List Spooled File (QUSLSPL) in, 241, 274,

280-283Message APIs, 239, 249-256Move Spooled File (QSPMOVSP) in, 241,

274, 275-279, 283-285, 296Open Spooled File (QSPOPNSP) in, 274outfiles vs., 242Process Commands (QCAPCMD) in, 151,

162-165Put Spooled File (QSPPUTSP) in, 274Reallocate Storage (CEECZST) for, 189Receive Program Message (QMHRCVPM)

in, 147Remove Program Message (QMHRMVPM)

in, 241, 254-256Remove Validation List Entry

(QsyRemoveValidationLstEntry) in, 241,293

Retrieve APIs, 239, 242-243Retrieve File Description (QDBRTVFD) in,

241, 273Retrieve Job Information (QUSRJOBI) in, 242Retrieve Object Description (QUSORBJD)

in, 241, 242-243, 245-249, 490Retrieve Pointer to User Space (QUSPTRUS)

in, 241, 258Retrieve Program Information (QCLRPGMI)

in, 241, 289-290Retrieve Spooled File Attributes

(QUSRSPLA) in, 274Retrieve User Space (QUSRTVUS) in, 241,

257-258, 259, 273

Send Program Message (QMHSNDPM) in,60, 147, 241, 249-254, 495

service programs and, 289-290Spool File APIs, 239, 274-286Spool File APIs, code table for, 280System Include (QSYSINC) library of, 240Validate Validation List Entry

(QsyValidateValidationLstEntry) in, 241Verify Validation List Entry

(QsyVerifyValidationLstEntry) in, 293wrapping, 239

arrays, 169-189compile-time, 171, 184-186

LOOKUP, 186trigger (**) for, 186

concatenation (CAT) in, 193-197Cross Foot (XFOOT) in, 185defining, 170Definition Specification (D spec) to define,

170, 188dynamic, 171, 189

Free Storage (CEEFRST) API for, 189Get Heap Storage (CEEGTST) API for,

189Reallocate Storage (CEECZST) API for,

189%ELEM vs. array index errors, 182-183Extension Specification (E spec) to define,

170File Input Specifications to define, 187index error, array index error, 171, 182-183index, array index, 170-171indicator, 138-139, 142Input Specification to define, 188loading alternatives, 187-189LOOKUP, 185, 186Move Array (MOVEA) in, 138MOVE, 183-184, 185MOVEL, 183-184, 185Multiple-occurrence data structures and,

232-237number of elements in, 182-183OCCUR, 232-237runtime, 171-181

accumulating totals using, 172-175

514

INDEX ❖ A

format data for output, 179-181MOVE and MOVEL, 183-184, 185RPG op code effects, 183-184, 185sequencing for output (Sort Array),

175-178Sort Array (SORTA), 175-178

search (SCAN) in, 202-203Sort Array (SORTA) in, 175-178, 185two-dimensional, 171, 207, 232-237uses of, 170

arrival sequence of records, performance vs., 7-8ATTR, 309

BBASE memory pool, 14-15batch files/jobs, 28

debugging, 310-313performance vs., 7, 8

bind by copy, 20, 286-287, 476bind by reference, 286-287binder directories, 476, 503binder language, 474, 478, 482binding, 286-287, 473, 476

bind by copy, 20, 286-287, 476bind by reference, 286-287, 476binder directories, 476binder language, 474, 478, 482binding directories, 476, 503Call Bound (CALLB) op code, 20, 21

binding directories, 503Add Binding Directory Entry

(ADDBNDDIRE) in, 503Create Binding Directory (CRTBNDDIR) in,

503BITON/BITOFF op codes, 130, 132-133borders, window, 72, 88, 91-92BOTTOM, 309Bottom literal, subfiles, 38, 43, 47, 49, 53BREAK, 309breakpoints, 298, 301-303, 313Build Object Reference (BLDOBJREF), 362,

365-366Build Work Field (BLDWRKFLD), 391, 392,

393built-in functions, 190-193

CC functions (See system C function)Calculation (C) specification, ILE

subprocedures ILE, 487, 495Call Bound (CALLB) op code, 20, 21calls (See dynamic vs. static program calls)cascading references, 481CAT, 190, 193-197CD-ROM, companion disc

compiling power tools, 510compiling source, 110-111cross-reference, 505-508MAKECL program, 510source code for files on, 509transferring source files, 509

CEECZST API, 189CEEDAYS (See Convert Date to Lilian)CEEDOD API, 495, 500CEEDYWK (See Convert Lilian Date to Day

of Week )CEEFRST API, 189CEEGTST API, 189CenterFld subprocedure, 500-501centering text, 201-202CHAIN, 7Change Display File (CHGDSPF), 5Change Job Description (CHJOBD), 324-326Change Journal (CHGJRN), 319-320Change Physical File (CHGPF), 5, 17, 463Change Program (CHGPGM), observability

setting in, 25%CHAR, 191, 196CHECK op code, 131, 190, 197-198CHECKR op code, 190, 198Choice Accelerator Text (CHCACCEL), 74,

85-86Choice Attribute Available (CHCAVAIL)

menus, 74, 86subfiles, 36

Choice Control (CHCCTL), menus, 74, 84-86Choice Selected (CHCSLT), subfiles, 36Choice Selected Attribute (CHCSLT), menus,

74, 86

Note: Boldface numbers indicate illustrations. 515

A - C ❖ INDEX

Choice Unavailable (CHCUNAVAIL)menus, 74, 86subfiles, 36

CL programscalls, 21Find Source (FNDSRC) in, 431Scan Job Log (SCNJOBLOG) in, 418Work with Fields (WRKFLD) in, 394-395,

404Work with Object Reference (WRKOBJREF)

in, 366, 367-371Clear Memory Pool (CLRPOOL), 13-14CLEAR op code, 143-144, 309Close Spooled File (QSPCLOSP) API, 274closing files (See file management)Command Execute (QCMDEXC) API, 151,

152-162, 241Open Query File (OPNQRYF) run within

print program using, 152, 153-155overriding printer parameters with, 152,

155-158prototyping a call to, 167submitting jobs with, 152, 158-162Work with Spool Files (WRKSPLF)

embedded using, 152Command Line (QUSCMDLN) API, 241command processing

Command Execute (QCMDEXC) API, 151,152-162, 241

Command Line (QUSCMDLN) API, 241Process Commands (QCAPCMD) API, 151,

162-165system C function, 151, 165-166

commitment, Start Commitment Control(STRCMTCTL), 484

communicationsfeedback area field definitions for, 115, 115

compile-time arrays, 171, 184-186concatenation (CAT), 190, 193-197conditional breakpoints, 302-303conditioning indicators, subfiles, 52control records in subfile, 32-33, 33Convert Date to Lilian (CEEDAYS) API, 453Convert Lilian Date to Day of Week

(CEEDYWK) API, 453

Copy File (CPYF), 463-469Create Binding Directory (CRTBNDDIR),

503Create Bound RPG Program (CRTBNDRPG),

475Create Data Area (CRTDTAARA), 220Create Display File (CRTDSPF), 5Create Journal (CRTJRN), 315Create Module (CRTMOD), 475Create Physical File (CRTPF), 5, 17Create Program (CRTPGM), 475, 481

optimization levels for, 23Create RPG Module (CRTRPGMOD)

optimization levels for, 23Create Service Program (CRTSRVPGM),

478, 502, 503optimization levels for, 23

Create Spooled File (QSPCRTSP) API, 274Create User Space (CUSRCRTUS) API, 241,

256, 257, 256Create Validation List (CRTVLDL), 291Create XXX Module (CRTXXMOD), 475Cross Foot (XFOOT), 185cursor position, subfiles, 31, 42-43, 47, 49, 56,

59CUSRCRTUS (See Create User Space)“Customer Subfile” display file, 45-47

in RPG, 48-53

DDASD (disk storage)

Print Disk Information (PRTDSKINF)from, 348

Reorganize Physical File Filter(RGZPFFLTR) and, 19, 348-354

utilization of, 28Data Area Data Structures, 220-221data areas, 212, 220-229

Create Data Area (CRTDTAARA) in, 220Data Area Data Structures, 220-221Define (DEFINE) in, 222-224defining an LDA, 227-228externally described, 221-224externally described data structures and,

218-220, 228-229

516

INDEX ❖ C - D

global, 220local (LDA) in, 207, 220, 226-229program-described, 225-226program-described local data area (LDA) in,

226-227Read in Data from a Data Area (IN) in,

222-224Unlock Data Area (UNLOCK) in, 222-224Write Data Out to a Data Area (OUT) in,

222-224data decimal errors, 215-216Data definition (D) specification, ILE

subprocedures, 487Data File Utility (DFU), 98data paths

selection of, 7-9shared, 2, 4-6, 482

data structures, 207-237APIs and, 212Create Data Area (CRTDTAARA) in, 220Data Area Data Structures as, 220-221data areas in, 212, 218, 220-229data decimal errors and, 215-216date values in, calculations using, 213-214default values in, 216-218defining, 211in defining an LDA, 227-228Definition Specification for, 211dynamics of, 212-214in externally described data areas, 221-224externally described, 211, 218-220, 228-229fields and subfields for, 211File Information Data Structure as, 211-212global data areas and, 212, 220INZ keyword for, 216-218in length-of-field coding, 209-211local data areas (LDA) and, 207, 212, 218,

220, 226-229Multiple-occurrence, 207, 212, 232-237OCCUR in, 232-237Program Initialization (PIP) in, 212Program Status Data Structure as, 212program-described data areas, 225-226,

229-231

program-described local data area (LDA)as, 226-227

to reduce program parameters, 231-232RESET for, 218rules for, 211to subdivide fields, 208-209subfield initialization in, 216-218two-dimensional arrays and, 207, 232-237uses of, 208

data typesAlter Table (ALTTBL) to convert, 463Change Physical File (CHGPF) to convert,

463converting, 463-469Copy File (CPYF) to convert, 463-469performance vs. format used, 469-472

database files (See also file management)Display Access Path (DSPPATH) in, 262,

296Display Database Relations (DSPDBR) in,

262, 329feedback area field definitions for, 112, 112List Database Relations (QDBLDBR) API,

262-274multiple view processing in, 135-136Override Database File (OVRDBF) in, 153

date and time data types, 437-472%ERROR and, 444Add Duration (ADDDUR) in, 214, 445,

448, 450ALF format, 458Alter Table (ALTTBL) to convert, 463AMDY format, 458arithmetic using, 449-450, 449Change Physical File (CHGPF) to convert,

463chronological values in computation of, 440Convert Date to Lilian (CEEDAYS) API

for, 453Convert Lilian Date to Day of Week

(CEEDYWK) API for, 453converting formats of, 439, 441-443,

463-469converting to non-date data types, 463-469Copy File (CPYF) to convert, 463-469

Note: Boldface numbers indicate illustrations. 517

D ❖ INDEX

date and time data types, continueddata structure calculations and, 213-214, 213Date Format (DATFMT) in, 441, 442date input pictures for, 454-455Date or Timestamp errors, 444date windows in, 440-441DMY format, 438, 458DOW format, 458edit codes for, 458EUR format, 438, 439Extract (EXTRCT) in, 445, 448format parameters for, 458formatting dates, 440, 451-455HMS format, 439ISO format, 438, 439, 441, 442, 451, 458,

469-472JIS format, 438, 439JUL format, 438MDY format, 438, 440, 441, 442, 443, 451,

452, 458, 470-471MOVE operations in, 441-443, 451-452, 457,

471Output Format program sample, 455-463packing and unpacking, 439performance vs. format used, 469-472separators for, 438-439, 451Subtract Duration (SUBDUR) in, 445, 448,

450, 452-453Test Date Input program example, 446-448,

448USA format, 438, 439, 441, 442, 458validity of, TEST op code for, 443-445YMD format, 438, 440, 441, 452, 458

Date Format (DATFMT), 441, 442date windows, 440-441DDS

coding keywords for, 74-78Display File Description (DSPFILDSC) in,

408-409externally described data structures and, 219Lock Record program, 124-127, 125Lookup window subfile, 61-62menu bar coding keywords for, 74-78menu bar, 75-76

in menus, hardware vs. DDS functions for,71-72

Output Date/Time Format program sample,459

Return Data (RTNDTA) for, 133-135Scan Job Log (SCNJOBLOG) program, 419in subfiles, 32, 33, 50-51System Request Window program, 95,

97-98window keywords in, 88

debugging and Debug program, 297-326Add Trace (ADDTRC) in, 313alerting compiler to debug, 298-299batch programs vs., 310-313breakpoints in, 298, 301-303, 313commands for, 308, 309conditional breakpoints in, 302-303DBGVIEW options settings, 299Display Module Source panel for, 300, 300enabling debugging at compiler, 298-299End Debug (ENDDBG) in, 313EVAL command in, 308Find Source (FNDSRC) in, 328, 425-435function keys for, 301-302header specification (H spec) vs.,

OPTION(*NODEBUGIO) and, 146-147,299-300, 504

I/O processing problems and, 310job logs to track errors, 320-326journaling in, 314-320observability vs., 25OPTION(*NODEBUGIO) and, 146-147,

299-300OPTION(*SRCSTMT) and, 299-300positioning source module on screen, 308Production files and libraries, 306QUSRTOOL library and, 326running Debug, 306Scan Job Log (SCNJOBLOG) in, 328,

415-425service programs, 303-306, 305SEU source member sequence numbers

and, 299-300Start Debug (STRDBG) in, 300stepping INTO code in, 309-310

518

INDEX ❖ D

stepping OVER code in, 309-310stepping through code in, 298, 308-310Test files and libraries, 306variable display for, 306-310Work with Module displays for, 303, 303, 304

%DEC, 191%DECH, 191decimal errors, 215-216%DECPOS, 191Define (DEFINE), 222-224Define Window (WINDOW), 88, 89-90Definition Specification

data decimal errors and, 215-216Delete Journal (DLTJRN), 320deleted records, reusing, 16-17dependency logical multiple-format file, 356device-specific feedback area, File Information

Data Structure, 111-115, 111-115DISPLAY, 309Display Access Path (DSPPATH), 262, 296,

327, 328-339Display Database Relations (DSPDBR), 262, 329Display Field (DSPFLD), 327, 339-348Display File Description (DSPFD), 329Display File Description (DSPFILDSC), 328,

405-415Display File Field Description (DSPFFD), 230display files, 5

Change Display File (CHGDSPF) in, 5Create Display File (CRTDSPF) in, 5“Customer Subfile” display file, 45-47Execute Format (EXFMT) command in, 3indicatorless, 142, 143, 142

Display Job (DSPJOB), 321, 325Display Job Log (DSPJOBLOG), 321-322, 322Display Journal (DSPJRN), 316-319, 317, 318Display Module Programs (DSPMODPGM), 287Display Program (DSPPGM)

observability setting in, 25Display Program Reference (DSPPGMREF), 362%DIV, 191DOWN, 309driver programs, 137dummy format, 52dynamic arrays, 171, 189

Free Storage (CEEFRST) API for, 189Get Heap Storage (CEEGTST) API for,

189Reallocate Storage (CEECZST) API for,

189dynamic vs. static program calls, 19-22

bind by copy programs vs., 20Call Bound (CALLB) op code in, 20, 21CL program calls vs., 21Command Execute (QCMDEXC) API,

prototyping, 167in error handling, ILE vs. OPM, 124performance vs., 1reusuable code and, 19-22RPG program calls vs., 22subprocedures in ILE, 488

E%EDITC, 191, 457%EDITFLT, 191%EDITW, 191%ELEM, 182-183, 191encryption

Add Validation List Entry(QsyAddValidationLstEntry) API, 292

APIs for, 291-295Remove Validation List Entry

(QsyRemoveValidationLstEntry) API,293

Verify Validation List Entry(QsyVerifyValidationLstEntry) API, 293

End Debug (ENDDBG), 313End Journal Physical File (ENDJRNPF), 320End Program Export (ENDPGMEXP),

478-480End Service Job (ENDSRVJOB), 313%EOF, 191%EQUAL, 191EQUATE, 309error code parameters, optional, 244-245error handling

APIs for, error code parameters, optional,244-245

EVAL op code in, 60Find Source (FNDSRC) in, 328, 425-435

Note: Boldface numbers indicate illustrations. 519

D - E ❖ INDEX

error handling, continuedin Information Data Structures, 121-127job logs to track errors in, 320-326locking records, 124-127, 125message subfiles for, 57-60Monitor Message (MONMSG) in, 4OPM vs. ILE and, 124OVERLAY in, 60*PSSR subroutine for, 121-124

ENDSR statement and, 124return points for, 122-123returning from, 123-124

return points for, 122-123in RPG IV, 130Scan Job Log (SCNJOBLOG) in, 328,

415-425Send Program Message (QMHSNDPM) API

for, 60source line numbers in, 130in subfiles, 52substitution variables in error messages in, 60

%ERROR, 192, 444EVAL, 153, 190, 196, 457, 500

in debugging, 308, 309error handling messages and, 60

Execute Format (EXFMT) command, 3Exists subprocedure example, 147, 148-150,

489-491exports (EXPORT), 474, 478-480externally described data areas, 221-224, 221externally described data structures, 218-220,

229-231LDA definition using, 228-229

Extract (EXTRCT), 445, 448Extract (SUBST), 190

Ffields, Build Work Field (BLDWRKFLD), 391,

392, 393fields, Work with Fields (WRKFLD), 328,

391-405File Information Data Structure, 101-115,

211-212common fields in, 104-105

device-specific feedback area in, 111-115,111-115database files, field definitions for,112,

112ISDN ICF communications, field

definitions for, 115, 115printers, field definitions for, 111, 112workstation, field definitions for,

113-114, 114F1AccesTyp in, 109F1BlockLmt in, 109F1CBlkOvr in, 109F1CCSID in, 109F1CntlBlck in, 109F1CurOper, 111F1DevClass, 111F1DevName, 111F1DispType in, 105F1DupeKeys in, 109F1EndOfFil field in, 105F1FileLib in, 108F1FileName field in, 105F1FileName in, 108F1FileTypCd in, 109F1FmtName, 111F1KeybdTyp in, 105F1LangMode in, 105F1MaxFmtLn in, 109F1MaxKeyLen in, 109F1MbrName in, 109F1Mesageidin, 105F1NbrBased in, 109F1NbrBoth, 111F1NbrColum in, 109F1NbrDefnd in, 109F1NbrLines in, 109F1NbrOther, 111F1NbrReads in, 111F1NbrWrite in, 111F1OdpType field in, 108F1OpenCnt in, 109F1OpenId in, 109F1OpenInd field in, 105F1OperCode in, 105F1RcdCnt in, 109

520

INDEX ❖ E - F

F1RcdLen, 111F1RecordCd in, 105F1RecordLn in, 109F1ReqrName in, 109F1Routine in, 105F1sorceID in, 105F1Source in, 109F1SpoolLib in, 108F1SpoolNam in, 108F1SpoolNbr in, 109F1Status field in, 105F1StmtNbr in, 105F1VolldOff in, 109F1WkstnSiz in, 105field definitions in, 104-105*FILE for, 103function key assignment, 144I/O Feedback area in, 110-111, 110INFDS keyword for, 102*INP for, 103locking records, 125-127, 125multiple format files and, 140-141*OPCODE for, 103Open Feedback area of, 107-109, 108*OUT for, 103*RECORD for, 103, 141*ROUTINE for, 103*SIZE for, 103special field keywords for, 103, 104specifying or making available, 102status codes in, 105, 106-107*STATUS for, 103, 105, 106-107

file managementactivation groups in, 5, 23-24arrival sequence of records in, 7-8Build Work Field (BLDWRKFLD) in, 391,

392, 393Change Display File (CHGDSPF) in, 5Change Physical File (CHGPF) in, 5, 17CLEAR fields in, 143-144Create Display File (CRTDSPF) in, 5Create Physical File (CRTPF) in, 5, 17data path selection and, 7-9Display Access Path (DSPPTH) in, 327,

328-339

Display Database Relations (DSPDBR) in,329

Display Field (DSPFLD) in, 327, 339-348Display File Description (DSPFD) in, 329Display File Description (DSPFILDSC) in,

328, 405-415Execute Format (EXFMT) command in, 3Find Displaced Logical Files (FNDDSPLF)

in, 328, 355-361Find Source (FNDSRC) in, 328, 425-435Format Data (FMTDTA) vs. performance

in, 7, 8indexed reads of files and, 7, 8-9indicators as field names in, 139interactive vs. batch files in, 7, 8logical files in, 9maintenance in, Return Data (RTNDTA)

for, 133-135multiple format files and, 140-141multiple view processing in, 135-136%OPEN function in, 2Open Data Path (ODP) in, 10Open Database File (OPNDBF) in, 4Open Query File (OPNQRYF) vs.

performance in, 7, 8opening/closing files in, performance vs., 2Override Database File (OVRDBF) in, 4, 6,

10-11, 153Production files and libraries in, 306READ op code in, 4record blocking in, 9-12Reorganize Physical File Filter

(RGZPFFLTR) in, 19, 327, 348-354Reorganize Physical File Member

(RGZPFM) in, 17-18Return Data (RTNDTA) for, 133-135RETURN op code in, 4reusing deleted records in, 16-17Set Object Access (SETOBJACC) in, 11-16shared data path file opens and, 2, 4-6, 482Test files and libraries in, 306user-controlled file opens for, 2-4, 153Work with Fields (WRKFLD) in, 328,

391-405WRITE op code in, 4

Note: Boldface numbers indicate illustrations. 521

F ❖ INDEX

*FILE, 103filters, Reorganize Physical File Filter

(RGZPFFLTR) in, 19, 327, 348-354FIND, 309Find Displaced Logical Files (FNDDSPLF),

328, 355-361Find Source (FNDSRC), 328, 425-435%FLOAT, 192Format Data (FMTDTA), performance vs., 7, 8formats for file, multiple format files, 140-141%FOUND, 192Free Storage (CEEFRST) API, 189function key

definition of, 75in debugging, assignment of, 301-302soft coding, 144, 145

GGet Heap Storage (CEEGTST) API, 189Get Spooled File (QSPGETSP) API, 274GETFIL subroutine, 273global data areas, 212, 220%GRAPH, 192graphical user interfaces (GUIs) (See windows

and GUI)

Hhandles, API, 262header specification (H spec)

compile options using RPGLEHSPEC, 146,504

Debug vs., OPTION(*NODEBUGIO) and,146-147, 299-300, 504

subprocedures in ILE, 487HELP, 309hidden fields, 31, 53highlight text, 130, 132-133Hold Job Queue (HLDJOBQ), 312

II/O Feedback area, File Information Data

Structure, 110-111, 110ILE (See Integrated Language Environment)

imports (IMPORT), 474, 475index error, array index error, 171index, array index, 170-171indexed file reads, 7, 8-9indexes, Reorganize Physical File Member

(RGZPFM) in, 17-18indicators, 130, 138-139

arrays of, 138-139, 142attributes displayed without, 142, 143as field names, 139localized, 141-142Move Array (MOVEA) in, 138subfiles, 52

INFDS keyword, File Information DataStructure, 102

Information Data Structureserror handling, 121-127File Information Data Structure, 101-115,

211-212locking records, 124-127, 125OPM vs. ILE error handling, 124Program Status Data Structure, 116-121,

116, 212*PSSR subroutine for, 121-124

ENDSR statement and, 124return points for error handling in,

122-123returning from, 123-124

return points for error handling in, 122-123*INP, 103%INT, 192Integrated Language Environment (ILE),

473-504activation groups, 474, 482-483, 503APIs for, 239, 286-289bind by copy, 286-287bind by reference, 286-287binder directories, 476binder language, 474, 478binding, 473, 476binding directories, 503cascading references, 481commands, 478-480Create Bound RPG Program

(CRTBNDRPG) in, 475

522

INDEX ❖ F - I

Create Module (CRTMOD) in, 475Create Program (CRTPGM) in, 475, 481Create XXX Module (CRTXXMOD) in, 475Display Module Programs (DSPMODPGM)

in, 287End Program Export (ENDPGMEXP) in,

478-480error handling in, vs. OPM, 124exports (EXPORT) in, 474, 478-480imports (IMPORT) in, 474, 475interfaces, public, 477-478List ILE Program Information (QBNLPGMI)

API, 287-289Module Usage (MODUSAG) in, 328,

384-390modules in, 474performance issues in 1, 22-24procedures vs. subprocedures (See also

subprocedures in ILE) in, 474, 487program entry points (PEPs) in, 475program interfaces in, 474programs in, 475QTMEP library storage for, 475scoping of activation groups in, 484service programs in, 474, 477-478, 480-481Service Programs Usage (SERPGMUSAG)

in, 328, 377-383signatures, in service programs, 478Start Program Export (STRPGMEXP) in,

478-480Update Service Program (UPDSRVPGM) in,

480-481interactive programs, 28

Override Attribute (OVRATR) in, 26-27Override Data (OVRDTA) in, 26-27performance vs., 7, 8Put with Explicitly Override (PUTOVR) in,

26-27reducing screen I/O in, 26-27

interfaces, public, 477-478%INTH, 192INTO, in debugging, 309-310INZ keyword, data structures, 216-218ISDN ICF communications, feedback area field

definitions for, 115, 115

Jjob log error tracking, 320-326

batch jobs and, 321Change Job Description (CHJOBD) in,

324-326CL program commands and, 323creation of, 321Display Job Log (DSPJOBLOG) in,

321-322, 322level of detail in, 322-323, 323, 324-326message logging in, 323-324messages in, 321performance vs., 29Scan Job Log (SCNJOBLOG) in, 328,

415-425SIGNOFF command and, 325

journaling, 314-320Change Journal (CHGJRN) in, 319-320changing receivers, 319-320Create Journal (CRTJRN) in, 315Delete Journal (DLTJRN) in, 320Display Journal (DSPJRN) in, 316-319,

317, 318End Journal Physical File (ENDJRNPF) in,

320journal receivers, 314Manage Receiver (MNGRCV) in, 315performance vs., 2, 29reading journal results in, 316

justificationcentering text, 201-202left-justification, 129, 131, 198right-justification, 200

LLEFT, 309left-justification, 129, 131, 198%LEN, 192, 201-202List APIs, 239, 259-262List Database Relations (QDBLDBR) API,

241, 262-274List Fields (QUSLFLD) API, 241, 273List ILE Program Information (QBNLPGMI)

API, 241, 287-289

Note: Boldface numbers indicate illustrations. 523

I - L ❖ INDEX

List Spooled File (QUSLSPL) API, 241, 274,280-283

load-all subfiles, 38-39local data areas (LDA), 207, 212, 220, 226-229

defining an LDA, 227-228externally described data structures to define,

218-220, 228-229program-described, 226-227

local variables in ILE subprocedures, 488localized indicators, 141-142locking records, 124-127, 125logical files, 9

dependency logical multiple-format file, 356Find Displaced Logical Files (FNDDSPLF)

in, 328, 355-361outlaw logical files, 355

LOOKUP, 185, 186Lookup window subfiles, 60-68, 61

in RPG, 63-66lower- to uppercase translation (XLATE), 130,

131-132

MMAKECL program, 510Manage Receiver (MNGRCV), 315memory management, 1

BASE memory pool in, 14-15Clear Memory Pool (CLRPOOL) in, 13-14memory pools in, 13, 14-15not enough, 16, 28observability vs., 25reducing program size in, 25service programs vs., 27-28Set Object Access (SETOBJACC) in, 11-16“thrashing,” 1, 16Work with System Status (WRKSYSSTS) in,

14memory pools, 14-15

allocation of, 14-15BASE pool, 14-15Clear Memory Pool (CLRPOOL) in, 13-14initialization of, 15

Menu Bar Choice (MNUBARCHC), 74, 78, 82Menu Bar Define (MNUBAR), 74, 77Menu Bar Display (MNUBARDSP), 74, 77

Menu Bar Separator (MNUBARSEP), 72, 74Menu Bar Switch (MNUBARSW), 75Menu Cancel Key (MNUCNL), 75, 77menus and menu bars (See also windows and

GUI), 72-87, 73acclerator keys in, 74, 85-86available/unavailable choices, attributes

for, 86Choice Accelerator Text (CHCACCEL) in,

74, 85-86Choice Attribute Available (CHCAVAIL)

in, 74, 86Choice Control (CHCCTL) in, 74, 84-85, 86Choice Selected Attribute (CHCSLT) in,

74, 86Choice Unavailable (CHCUNAVAIL) in,

74, 86DDS coding keywords for, 74-78defaults for pull-down menus in, 87function key definition in, 75Menu Bar Choice (MNUBARCHC) in, 74,

78, 82Menu Bar Define (MNUBAR) in, 74, 77Menu Bar Display (MNUBARDSP) in, 74,

77Menu Bar Separator (MNUBARSEP) in, 74Menu Bar Switch (MNUBARSW) in, 75Menu Cancel Key (MNUCNL) in, 75, 77Multiple Choice Selection Field

(MLTCHCFLD) in, 74, 83multiple-choice pull-down menus in, 83-85Pull Down Menu (PULLDOWN) in, 75,

78, 82pull-down menus in, 73, 73radio push buttons in, 82in RPG, 79-80sample DDS for, 75-76Selection Field Choice (CHOICE) in, 74, 82shortcut keys for pull-down menus in, 85Single Choice Field (SNGCHCFLD) in,

75, 81-83single-choice pull-down menus in, 81-82

Message APIs, 239, 249-256

524

INDEX ❖ L - M

message handlingMonitor Message (MONMSG) in, 4OVERLAY in, 60performance vs. logging levels in, 29Send Program Message (QMHSNDPM) API

for, 60subfiles for, 57-60substitution variables in error messages in, 60

message logging, job logs, 323-324mirroring, performance vs., 2modular programming (See also Integrated

Language Environment), 286-287Module Usage (MODUSAG), 328, 384-390modules, 20, 474

cascading references, 481Create XXX Module (CRTXXMOD) in, 475

Monitor Message (MONMSG), 4MORE parameter for subfiles, in SFLEND, 43More... literal, subfile, 33, 38, 43, 47, 49, 53MOVE, 183-184

in date and time data types, 441-443,451-452, 457, 471

Move Array (MOVEA), 138Move Spooled File (QSPMOVSP) API, 241,

274, 275-279, 283-285, 296MOVEL, 183-184, 185Multiple Choice Selection Field

(MLTCHCFLD), 74, 83multiple format files, 140-141Multiple-occurrence data structure, 171, 207,

212, 232-237%ELEM and, 182-183

NNEXT, 309NOMAIN, ILE subprocedures, 487%NULLIND, 192

Oobject management

Analyze User Object (ANZUSROBJ) in, 425Build Object Reference (BLDOBJREF) in,

362, 365-366OBJMAKECL program in, 364-365

Retrieve Object Description (QUSROBJD)API, 490

Work with Object Reference(WRKOBJREF) in, 328, 362-377

OBJMAKECL program, 364-365, 364observability vs. performance, 25OCCUR, 232-237OMIT, 273*OPCODE, 103Open Data Path (ODP), 10Open Database File (OPNDBF), 4Open Feedback area, File Information Data

Structure, 107-109, 108Open Query File (OPNQRYF)

Command Execute (QCMDEXC) API and,152, 153-155

performance vs., 7, 8Open Spooled File (QSPOPNSP) API, 274%OPEN function, 2, 192opening files, user-controlled file opens (See

also file management), 2-4, 153optimization, 22-24

activation groups and, 23-24parameter values for (NONE, BASIC,

FULL) in, 23Original Program Module (OPM), 124, 473*OUT, 103outfiles, 242, 426outlaw logical files, 355OVER, in debugging, 309-310OVERLAY, error messages and, 60Override Attribute (OVRATR), 26-27Override Data (OVRDTA), 26-27Override Database File (OVRDBF), 4, 6,

10-11, 153Override Printer File (OVRPRTF), 157

Ppadding, in string manipulation, 194%PADDR, 192PAGE keyword in subfiles, 40-41Page Up/Page Down control in subfiles,

39-41, 47, 49, 67page-at-a-time subfiles, 38-39

Note: Boldface numbers indicate illustrations. 525

M - P ❖ INDEX

PAGEUP/PAGEDOWN keywords in subfiles,47

Parameter (PARM), 136Parameter List (PLIST), 136

externally described data structures and,218-220, 231-232

%PARMS, 137, 192, 490, 495*PARMS, 137

Program Status Data Structure, 118, 157passing parameters, 130, 136-137

in ILE subprocedures, 488passwords, encryption, 291-295performance issues, 1-29

activation groups and, 5, 23-24arrival sequence of records and, 7-8batch jobs in, 28CL program calls vs., 21Clear Memory Pool (CLRPOOL) in, 13-14DASD (disk storage) utilization in, 28data path selection and, 7-9date/time format used vs., 469-472debugging I/O processing and, 310driver programs and, 137dynamic vs. static programs calls vs., 1, 19-22Format Data (FMTDTA) vs., 7, 8indexed reads of files and, 7, 8-9Integrated Language Environment (ILE) vs.

22-24interactive programs and screen I/O, 26-27interactive vs. batch files in, 7, 8, 28job logs vs., 29journaling vs., 2, 29logical files vs., 9memory and, 28memory pool allocation in, 14-15message logging levels vs., 29mirroring vs., 2Module Usage (MODUSAG) in, 328,

384-390observability vs., 25Open Data Path (ODP) in, 10Open Query File (OPNQRYF) vs., 7, 8opening and closing files, 2optimization in, 22-24Override Attribute (OVRATR) in, 26-27

Override Data (OVRDTA) in, 26-27Override Database File (OVRDBF) in, 6,

10-11Put with Explicitly Override (PUTOVR) in,

26-27query vs., 29RAID systems and, 2Reclaim Activation Group (RCLACTGRP)

in, 484Reclaim Resource (RCLRSC) in, 484record blocking in, 9-12reducing program size in, 25Reorganize Physical File Filter

(RGZPFFLTR) in, 19, 327, 348-354Reorganize Physical File Member

(RGZPFM) in, 17-18Return Code (RTNCOD) parameter and,

137, 138reusing deleted records in, 16-17RPG program calls vs., 22Service Programs Usage (SERPGMUSAG)

in, 328, 377-383service programs vs., 27-28Set Object Access (SETOBJACC) in, 11-16shared data path file opens and, 4-6, 2, 482SQL vs., 29subprograms and, 137“thrashing” memory vs., 1, 16Translate (XLATE) vs., 29user-controlled file opens, 2-4, 153window response time and, 94

physical files, 5Change Physical File (CHGPF) in, 5, 17Create Physical File (CRTPF) in, 5, 17End Journal Physical File (ENDJRNPF) in,

320Reorganize Physical File Filter

(RGZPFFLTR) in, 19, 327, 348-354Reorganize Physical File Member

(RGZPFM) in, 17-18PLUS parameter for subfiles, in SFLEND, 44PREVIOUS, 309Print Disk Information (PRTDSKINF), 348

526

INDEX ❖ P

printers and print management (See also spooledfiles)feedback area field definitions for, 111, 112Override Printer File (OVRPRTF) in, 157overriding parameters with Command

Execute (QCMDEXC) API, 152, 155-158Spool File APIs, 274-286

*PROC, 118, 140procedures, 474Process Commands (QCAPCMD) API, 151,

162-165option control block format for, 164-165required input parameters for, 163-164

Production files and libraries, 306program entry points (PEPs), 475, 487Program Initialization (PIP) data structure, 212program interfaces, 474program names, 139-140Program Status Data Structure, 116-121, 116,

212Century, 117CompilDate, 117CompilLevl, 117CompilTime, 117CurrUserID, 117DateStard, 117defining, 116, 118ErrFileID, 117ErrFileSts, 117ErrFilName, 117ErrRoutine, 117ExcNumber, 117ExcType, 117field definitions for, 117JobNme, 117JobNumber, 117locking records, 125-127, 125MessageDta, 117MIObjDefTM, 117ModuleName, 117MsgWrkArea, 117NbrParms, 117parameter passing tips, 137*PARMS in, 118, 137, 157PgmLibName, 117

PrevMsgID, 117PrevStatus, 117*PROC for, 118, 140ProcName, 117program names from, 139-140ProgramName, 117*ROUTINE for, 118RunDate, 117RunTime, 117SourceFile, 117SourceLib, 117SourceMbr, 117SourceStmtProgram Status Data Structure,

117special keywords for, 118status codes for, 119-120*STATUS for, 118StatusCode, 117SystemDate, 117userProfil, 117

program-described data areas, 225-226externally described data structures and,

218-220, 229-231program-described local data area (LDA),

226-227Prototype (P) specification, ILE

subprocedures, 487, 490*PSSR subroutine

ENDSR statement and, 124error handling with, 121-124return points for error handling in, 122-123returning from, 123-124

public interfaces, 477-478Pull Down Menu (PULLDOWN), 75, 78, 82pull-down menus in, 73, 73push buttons, 82Put Spooled File (QSPPUTSP) API, 274Put with Explicitly Override (PUTOVR),

26-27

QQBNLPGMI (See List ILE Program

Information)QCLRPGMI (See Retrieve Program

Information )

Note: Boldface numbers indicate illustrations. 527

P - Q ❖ INDEX

QCMDEXC (See Command Execute)QDBLDBR (See List Database Relations)QDBRTVFD (See Retrieve File Description)QMHRMVPM (See Remove Program Message)QMHSNDPM (See Send Program Message)QRPLLIB library, program names from, 140QSPCLOSP (See Close Spooled File)QSPCRTSP (See Create Spooled File)QSPGETSP (See Get Spooled File)QSPMOVSP (See Move Spooled File)QSPOPNSP (See Open Spooled File)QSPPUTSP (See Put Spooled File)QsyAddValidationLstEntry (See Add Validation

List Entry)QsyRemoveValidationLstEntry (See Remove

Validation List Entry)QsyValidateValidationLstEntry (See Validate

Validation List Entry)QsyVerifyValidationLstEntry (See Verify

Validation List Entry)QTMEP library storage for, 475query vs. performance, 29QUSCMDLN (See Command Line)QUSLFLD (See List Fields)QUSLSPL (See List Spooled File)QUSORBJD (See Retrieve Object Description)QUSPTRUS (See Retrieve Pointer to User

Space)QUSRJOBI (See Retrieve Job Information)QUSROBJD (See Retrieve Object Description)QUSRSPLA (See Retrieve Spooled File

Attributes )QUSRTOOL library, 326QUSRTVUS (See Retrieve User Space )

Rradio push buttons, 82RAID systems, performance vs., 2Read in Data from a Data Area (IN), 222-224READ op code, 4Reallocate Storage (CEECZST) API, 189Receive Program Message (QMHRCVPM) API

triggers and, 147, 148-150receivers, journaling, 314Reclaim Activation Group (RCLACTGRP), 484

Reclaim Resource (RCLRSC), 484record blocking, 9-12*RECORD, 103, 141references, cascading references, 481%REM, 192Remove Program Message (QMHRMVPM)

API, 241, 254-256Remove Validation List Entry

(QsyRemoveValidationLstEntry) API, 241,293

Remove Window (RMVWDW), 53, 88, 89, 93Reorganize Physical File Filter

(RGZPFFLTR), 19, 327, 348-354Reorganize Physical File Member

(RGZPFM), 17-18%REPLACE, 192RESET, data structures, 218Retrieve APIs, 239, 242-243Retrieve File Description (QDBRTVFD) API,

241, 273Retrieve Job Information (QUSRJOBI) API,

242Retrieve Object Description (QUSORBJD)

API, 241, 242-243, 245-249, 490Retrieve Pointer to User Space (QUSPTRUS)

API, 241, 258Retrieve Program Information (QCLRPGMI)

API, 241, 289-290Retrieve Spooled File Attributes

(QUSRSPLA) API, 274Retrieve User Space (QUSRTVUS) API, 241,

257-258, 259, 273Return Code (RTNCOD) parameter, 137, 138Return Data (RTNDTA), 133-135RETURN op code, 4, 490return points for error handling, 122-123reusing deleted records, 16-17reusuable code, 19-22reverse color text, 130, 132-133RIGHT, 309right-justification, 200RmvErrMsg subprocedure, 494, 498-500ROLL keyword in subfiles, 40-41ROLLBACK subroutine in Customer Subfile,

49-50, 67-68

528

INDEX ❖ Q - R

ROLLDOWN/ROLLUP keywords in subfiles,47

*ROUTINE, 103in Program Status Data Structure, 118

RPG programsactivation groups, 23-24calls, 22Create RPG Module (CRTRPGMOD) in, 23“Customer Subfile,” 48-53Display Access Path (DSPPTH) in, 331-339Display Field (DSPFLD) in, 342-348Find Displaced Logical Files (FNDDSPLF)

in, 358-361List Database Relations (QDBLDBR) API,

262-274locking records, 124-127, 125Lookup window subfiles in, 63-66menu bars and pull-down menus, 79-80Module Usage (MODUSAG) in, 386-390optimization levels for, 23Output Date/Time Format program sample,

459-463Reorganize Physical File Filter

(RGZPFFLTR) in, 350-354Send Program Message (QMHSNDPM) API,

249-254Service Programs Usage (SERPGMUSAG)

in, 379-383State Lookup window subfile, 54-56System Request Window program, 96-97Work with Fields (WRKFLD) in, 396-398,

401-404Work with Object Reference (WRKOBJREF)

in, 367, 372-375RPGLEHSPEC for H spec compile options,

146, 504runtime arrays, 171-181

in accumulating totals, 172-175in formatting output data, 179-181

SSCAN, 190, 202-203Scan Job Log (SCNJOBLOG), 328, 415-425%SCAN, 192scoping of activation groups, 484

SCRBAR parameter for subfiles, in SFLEND,44-45, 53

scroll bars, in subfiles, 44-45, 44, 53, 99search (SCAN), 190, 202-203search fields in subfiles, 60-68SELECT, 273Selection Field Choice (CHOICE), menus, 74,

82Send Program Message (QMHSNDPM) API,

60, 241, 249-254, 495triggers and, 147, 148-150

separators, date and time, 438-439, 451service programs, 474, 477-478, 480-481

ALL keyword in, 27-28APIs and, 289-290binder language in, 482Create Service Program (CRTSRVPGM)

in, 23, 478, 502, 503debugging, 303-306, 305End Service Job (ENDSRVJOB) in, 313optimization levels for, 23performance vs., 27-28public interfaces for, 477-478Retrieve Program Information

(QCLRPGMI) API, 289-290Service Programs Usage (SERPGMUSAG)

in, 328, 377-383signatures in, 478Start Service Job (STRSRVJOB) in, 312,

313Update Service Program (UPDSRVPGM)

in, 480-481Service Programs Usage (SERPGMUSAG),

328, 377-383SET, 309Set Lower Limits (SETLL), 7Set Object Access (SETOBJACC), 11-16

Clear Memory Pool (CLRPOOL) in, 13-14simple use of, 12-13

SEU source member sequence numbers,debugging, 299-300

shared data path file opens, 2, 4-6, 482OPENSCOPE parameter to restrict, 6

shortcut keys for pull-down menus, 85signatures, in service programs, 478

Note: Boldface numbers indicate illustrations. 529

R - S ❖ INDEX

SIGNOFF command, job logs, 325Single Choice Field (SNGCHCFLD), menus,

81-83, 75%SIZE, 192*SIZE, 103SndErrMsg subprocedure, 494, 496-497,

499-500soft coding function keys, 144, 145Sort Array (SORTA), 175-178, 185Spool File APIs, 239, 274-286

code table for, 280spooled files

Close Spooled File (QSPCLOSP) API, 274closed status, 286Create Spooled File (QSPCRTSP) API, 274deferred status, 286Get Spooled File (QSPGETSP) API, 274hold status, 286List Spooled File (QUSLSPL) API, 274,

280-283Move Spooled File (QSPMOVSP) API, 274,

275-279, 283-285, 296Open Spooled File (QSPOPNSP) API, 274open status, 286output queues for, 286Put Spooled File (QSPPUTSP) API, 274restrictions on moving, 286Retrieve Spooled File Attributes

(QUSRSPLA) API, 274saved status, 286Spool File APIs, code table for, 280

SQL vs. performance, 29Start Commitment Control (STRCMTCTL), 484Start Debug (STRDBG), 300Start Program Export (STRPGMEXP), 478-480Start Service Job (STRSRVJOB), 312, 313State Lookup window subfile, 50-51, 53-54

in RPG, 54-56static program calls (See dynamic vs. static

program calls)%STATUS, 192*STATUS, 103, 105, 106-107

in Program Status Data Structure, 118STEP, 309

stepping through code in debugging, 298,308-310

%STR, 192string handling, 189-206

built-in functions for, 190-193centering text, 201-202%CHAR, 196concatenation (CAT) in, 190, 193-197EVAL, 190, 196extract (SUBST) in, 190highlight text, 130, 132-133left-justification (CHECK) in, 129, 131, 198%LEN, 201-202lower- to uppercase translation (XLATE)

in, 130, 131-132padding, 194remove leading blanks (CHECK) in, 131,

199remove leading/trailing blanks, 198-199remove trailing blanks, 200-201reverse color text, 130, 132-133right-justification, 200search (SCAN) in, 190, 202-203%SUBST, 202, 203-205substitute/replace single characters,

205-206Substring (SUBST) op code, 131, 203-205translate (XLATE) in, 190, 205-206%TRIM, 196, 198-199%TRIML, 199%TRIMR, 196, 200validation (CHECK) in, 190, 197-198validation/check rightmost character

(CHECKR) in, 190, 198subfiles, 31-68

Bottom literal in, 38, 43, 47, 49, 53Choice Available (CHCAVAIL) in, 36Choice Selected (CHCSLT) in, 36Choice Unavailable (CHCUNAVAIL) in,

36conditioning indicators in, 52control records, 32-33, 33controlling page display in, 41-43, 47cursor position in, 31, 42-43, 47, 49, 56, 59

530

INDEX ❖ S

“Customer Subfile” display file, 45-47, 48-53DDS for, 32, 33DDS for Lookup window, 61-62in DDS windows, 50-51dummy format for, 52error messages in, 52, 57-60hidden fields in, 31, 53keys, not unique keys and, 67-68load-all, 38-39loading options for, 38-39Lookup windows in, 60-68, 61, 63-66mandatory keywords for Subfile Control

Record Format, 34message subfiles as, 57-60MORE parameter for, in SFLEND, 43More... literal in, 33, 38, 43, 47, 49, 53optional keywords for Subfile Control Record

Format, 35-38OVERLAY in, 60PAGE keyword in, 40-41Page Up/Page Down control in, 39-41, 47,

49, 67page-at-a-time, 38-39PAGEUP/PAGEDOWN keywords in, 47PLUS parameter for, in SFLEND, 44reading changed records in, 51-52ROLL keyword in, 40-41ROLLBACK subroutine in Customer Subfile,

49-50, 67-68ROLLDOWN/ROLLUP keywords in, 47SCRBAR parameter for, in SFLEND, 44-45,

53scroll bars for, 44-45, 44, 53, 99search fields in, 60-68State Lookup window, 50-51, 53-56Subfile Clear (SFLCLR) in, 35, 41Subfile Control (SFLCTL) in, 34, 38, 54, 59Subfile Control Record (SFLCTL) in, 45-47Subfile Control Record Format (SFLCTL) in,

34-38Subfile Cursor Relative Record Number

(SFLCSRRRN) in, 35Subfile Delete (SFLDLT) in, 35Subfile Display (SFLDSP) in, 34, 38, 46-47,

54, 59

Subfile Display Control (SFLDSPCTL) in,35, 36, 47, 54

Subfile Drop (SFLDROP) in, 35, 39Subfile End (SFLEND) in, 36, 38, 41,

43-45, 47, 49, 53, 99Subfile Enter (SFLENTER) in, 36Subfile Fold (SFLFOLD) in, 36, 39Subfile Initialize (SFLINZ) in, 36, 39, 41Subfile Line (SFLLIN) in, 36, 39Subfile Message (SFLMSG) in, 37, 52, 56Subfile Message ID (SFLMSGID) in, 37, 52Subfile Message Key (SFLMSGKEY) in,

57Subfile Message Record (SFLMSGRCD)

in, 57Subfile Mode (SLFMODE) in, 37Subfile Multiple Choice (SFLMLTCHC)

in, 36Subfile Next Changed (SFLNXTCHG) in,

51-52, 53Subfile Page (SFLPAG) in, 33, 34, 38,

39-40, 46, 54, 59Subfile Program Message Queue

(SFLPGMQ) in, 57, 59Subfile Program Queue (SFLPGMQ) in, 37Subfile Record (SFLRCD) in, 45-47, 53Subfile Record Format (SFL) DDS for, 33Subfile Record Number (SFLRCDNBR)

in, 37, 39, 42, 47, 49, 54, 56Subfile Records Not Active (SFLRNA) in,

37, 39subfile records, 32-33, 33Subfile Relative Record (SFLRELRCD) in,

53Subfile Roll Value (SFLROLVAL) in, 37,

39Subfile Scroll (SFLSCROLL) in, 38, 53Subfile Single Choice (SFLSNGCHC) in,

38Subfile Size (SFLSIZ) in, 34, 38, 39-40,

46, 54, 59substitution variables in error messages in,

60windows and, 88

Submit Job (SBMJOB), 325

Note: Boldface numbers indicate illustrations. 531

S ❖ INDEX

submitting jobs, Command Execute(QCMDEXC) API for, 152, 158-162

subprocedures in ILE, 487-504activation groups, 503binding directories, 503Calculation (C) specification in, 487, 495call interface prototyping in, 488calling from within expression, 489-491CEEDOD API, 495, 500CenterFld subprocedure, 500-501compiling, 502CONST keyword in, 492Create Service Program (CRTSRVPGM) in,

502, 503Data definition (D) specification in, 487DATFMT keyword in, 492Exists subprocedure example of, 489-491EXPORT keyword in, 492, 495, 500EXTPGM keyword in, 492EXTPROC keyword in, 492header specification (H spec) in, 487, 489, 504local variables in, 488NOMAIN in, 487, 489NOOPT keyword in, 492OPDESC keyword in, 493parameter keywords in, 491-494passing parameters by value in, 488PROCPTR keyword in, 493program entry procedure (PEPs) in, 487Prototype (P) specification in, 487, 490RmvErrMsg subprocedure in, 494, 498-500Send Program Message (QMHSNDPM) API,

495SndErrMsg subprocedure in, 494, 496-497VALUE keyword in, 493VARYING keyword in, 494

subprograms, 137subroutines

error handling in, 121-124*PSSR subroutine and error handling in,

121-124return points for error handling in, 122-123

SUBST op code, 131, 190, 203-205%SUBST, 192, 202, 203-205, 500substitution variables in error messages, 60

substring (SUBST), 203-205Subtract Duration (SUBDUR), 445, 448, 450,

452-453system APIs (See APIs)system C function, 151, 165-166System Include (QSYSINC) library of APIs,

240System Request Window program, 94-99, 95

TTest files and libraries, 306TEST op code, date and time, 443-445text manipulation (See string handling)“thrashing” memory, 1, 16titles for windows, 88, 92-93toolbox, 327-435TOP, 309translate (XLATE), 29, 190, 205-206triggers, 130, 147, 148-150

compile-time arrays (**) in, 186%TRIM, 193, 196, 198-199, 457%TRIML, 193, 199%TRIMR, 193, 196, 200two-dimensional arrays, 171, 207, 232-237

U%USC2, 193Unlock Data Area (UNLOCK), 222-224%UNS, 193%UNSH, 193UP, 309Update Service Program (UPDSRVPGM),

480-481user-controlled file opens, 2-4, 153User Interface Manager (UIM), 72user interfaces (UIs) (See windows)User Restored Display (USRRSTDSP), 88,

93-94user space

Create User Space (CUSRCRTUS) API,256, 257, 256

Retrieve Pointer to User Space(QUSPTRUS) API, 258

532

INDEX ❖ S - U

user space, continuedRetrieve User Space (QUSRTVUS) API,

257-259, 273

VValidate Validation List Entry

(QsyValidateValidationLstEntry) API, 241validation (CHECK), 190, 197-198

APIs for, 291-295check rightmost character (CHECKR) in,

190, 198validation lists, 291-295

Add Validation List Entry(QsyAddValidationLstEntry) API, 292

Create Validation List (CRTVLDL) in, 291Remove Validation List Entry

(QsyRemoveValidationLstEntry) API, 293Verify Validation List Entry

(QsyVerifyValidationLstEntry) API, 293variables

debugging, 306-310local, in subprocedures, 488

Verify Validation List Entry(QsyVerifyValidationLstEntry) API, 293

views, multiple view processing, 135-136

WWindow Border (WDWBORDER), 88, 91-92window definition records, 89Window Title (WDWTITLE), 88, 92-93windowing, date windows, 440-441windows and GUI, 69-100

active windows, 87automatic placement of, system rules for, 91borders in, 72DDS keywords for, 88Define Window (WINDOW) in, 88, 89-90displaying, 93enhanced display (ENHDSP) Yes/No

parameter and, 72enhancing green screen displays with, 70

green-screen vs., 69-70hardware compatibility vs. DDS functions

for, 71-72menu bar separators in, 72menus, 72-87, 73position of, 89-90, 91Remove Window (RMVWDW) in, 53, 88,

89, 93response time in, 94saving and restoring, 93scroll bars and subfiles, 99size of, 89-90, 94State Lookup window subfile, 50-51, 53-56subfiles and, 88System Request Window program for,

94-99, 95User Interface Manager (UIM) in, 72User Restored Display (USRRSTDSP) in,

88, 93-94Window Border (WDWBORDER) in, 88,

91-92window definition records in, 89Window Title (WDWTITLE) in, 88, 92-93

Work with Active Jobs (WRKACTJOB), 311,312, 321

Work with Fields (WRKFLD), 328, 391-405Work with Object Reference (WRKOBJREF),

328, 362-377Work with Spool Files (WRKSPLF), 152Work with Submitted Jobs (WRSBMJOB),

311, 312, 321Work with System Status (WRKSYSSTS), 14workstations, feedback area field definitions

for, 113-114, 114wrapping APIs, 239Write Data Out to a Data Area (OUT), 222-224WRITE op code, 4

X%XFOOT, 193XLATE op code, 130, 131-132, 190, 205-206

Note: Boldface numbers indicate illustrations. 533

U - X ❖ INDEX