INDEX. *AND (See logical variables)

Transcription

1 *AND (See logical variables) *BCAT (See concatenating strings) *CAT (See concatenating strings) *NOT (See logical variables) *OR (See logical variables) * to designate comment lines in code, *TCAT (See concatenating strings) / symbol as operator and in qualified names, 40 %BIN/%BINARY, %SST/%SUBSTRING, %SWITCH function, &QUOTE variable, A activation groups, create new group, 272 default activation group, 272, 275 destroy groups, 273 identify/name group, 272 name/identify groups, 278 Reclaim Activation Group (RCLACTGRP), run program in group, 273 Add Breakpoint (ADDBKP), Add Library List Entry (ADDLIBLE), Add Logical File Member (ADDLFM), 164 Add Message Description (ADDMSGD), 78 Add Physical File Member (ADDPFM), 164 Add Reply List Entry (ADDRPYLE), 114 Add Trace (ADDTRC), 422 adopting authority, alert options, messages, 105 align similar lines of code, Allocate Object to Job (ALCOBJ), AND operator, 47, 48, apostrophes, 177 arithmetic operators, precedence of operators, 48 arrays, simulating arrays using strings, 44 AS/400 and CL, 1-3, 267 AS/400 model numbers, 414 ASCII, translate ASCII/EBCDIC characters (QDCXLATE), assignment statements, Change Variable (CHGVAR), attributes of jobs, , 192,

2 authorities adopting authority, , 227 Edit Object Authority (EDTOBJAUT), 226, 412 Grant Object Authority (GRTOBJAUT), 226 ILE, 278 PUBLIC authorities, 227 Revoke Object Authority (RVKOBJAUT), 226 authorization lists, Retrieve Authorization List (RTVAUTLE), 157 automatic allocation of objects, 192 automatic configuration, 414 automating AS/400 programs with CL, 1 B backups, Retrieve Backup (RTVBCKUP), 157 batch processing, 3, data queues, 145 debugging one job running in another, interactive processing vs., 195 job queues, 196 problems with SBMJOB, QSYSOPR message queue, Retrieve Job Attribute (RTVJOBA), self-submitting programs, Submit Job (SBMJOB), Work with Job Queue (WRKJOBQ), 201 Work with Submitted Jobs (WRKSBMJOB), 201 Work with Subsystem Jobs (WRKSBSJOB), 201 Work with User Jobs (WRKUSRJOB), 201 beginning of program, Program (PGM) command, 6-7 binary conversion, binding, Create Bound CL Program (CRTBNDCL), blank lines in program code, 19-20, body of typical CL program, 9, 9 branching, 3 break messages, breakpoint insertion, (BREAK), 248, 254, C C language, 2, 267 Call Bound Procedure (CALLPRC), passing program information, 124 CALL command, 3, 19, 62, adopted authority in call stack, 229 dynamic call, 270 passing constants as parameters, 70 passing program information, 124 passing variables as parameters, Transfer Control (TFRCTL) and, Call Procedure (CALLPRC), Call Program, self-submitting programs, calling programs, 3 capabilities of CL, 2-3 CASE, 3, 57 simulating CASE with ELSE and IF, case sensitivity, 14, Change Command (CHGCMD), 230 Change Current Library (CHGCURLIB), , 411 Change Data Area (CHGDTAARA), 127 Change Job (CHGJOB), , 154 Change Job Description (CHGJOBD), 234 Change Library List (CHGLIBL), , 411 Change Logical File Member (CHGLFM), 164 Change Message Description (CHGMSGD), 78 Change Message Queue (CHGMSGQ), 75 Change Object Description (CHGOBJD), 191 Change Object Owner (CHGOBJOWN), 227 Change Password (CHGPWD), 411 Change Physical File Member (CHGPFM), 164 Change Profile (CHGPRF), 156 Change Program (CHGPGM), 229 Change Program Variable (CHGPGMVAR), 421 Change Reply List Entry (CHGRPYLE), 114 Change Shared Pool (CHGSHRPOOL),

3 Change System Library List (CHGSYSLIBL), , 239 Change System Value (CHGSYSVAL), 152 Change User Profile (CHGUSRPRF), 156, 230 Change Variable (CHGVAR), 13, 16, arithmetic operators, character constants, 23, 24 character data type, 3, 8, 14, 28 character variables, arrays, simulating arrays using strings, 44 binary conversion, concatenating strings, Find String Using PDM (EFNDSTRPDM), 412 quotation mark use, 178, 179 substrings (%SST/%SUBSTRING), translate ASCII/EBCDIC characters (QDCXLATE), Check Object (CHKOBJ), 92, , 228 escape messages, 186 Check Password (CHKPWD), 412 Check Record Lock (CHKRCDLCK), 412 cleanups, Retrieve Cleanup (RTVCLNUP), 157 Clear Data Queue (CLRDTAQ), Clear Message Queue (CLRMSGQ), 113 Clear Physical File Member (CLRPFM), 164 Clear Trace Data (CLRTRCDTA), 423 Close File (CLOF), 168 CLRDTAQ clear data entries utility, 144 COBOL, 1, 2, 37, 59, 144, 267 coding style, command entry screen, System/38 differences, 415 command line security, command processing programs (CPPs), binary conversion (%BIN) function, 46 command prompter formatting (See also formatting the program), 12-13, 12, 13, command-level MONMSG, 94 commands & statements, 5 case sensitivity, 14 Change Command (CHGCMD), 230 command line security, comments on command lines, Create Command (CRTCMD), 230 Display Command (DSPCMD), 216, 231 dynamic execution, 33 dynamic execution, QCMDEXC, 33, installing utility commands, 281 keywords, 15 positional parameters, 15 quotation mark use, 179 S/36 OCL statements, CL equivalents, Select Command (SLTCMD), 413 selective prompting, System/38 differences, utility commands, COMMENT command, , 355 comment lines in program code, 20-22, , communications, 3 Compare Source Members (CMPSRCMBR), comparison operators, compiled languages, compiling a program, 12, Create Bound CL Program (CRTBNDCL), OPTION parameter, 275 Completion messages, 76, 84 Compress Object (CPROBJ), 412 concatenating strings, 42-44, 48 quotation mark use, conditional breakpoints, configuration (See system configuration) console, 414 constants & literals, character constants, 23, 24 continuing code onto next line, 17 decimal constants, 23, 25 expressions, 48 floating-point data types, 69 hexadecimal constants, 23, invalid characters, 24, 25, 26 length maximum, decimal constants, 25 logical constants, 23, 27 passing constants as parameters, CALL,

4 constants & literals, continued passing program information, continuing code onto next line, control statements, CALL command, Call Procedure (CALLPRC), comparison operators, DO/ENDDO commands, ELSE command, End Program (ENDPGM), 70-71, 71 GOTO command, IF command, logical expressions, 53 nesting DO/ENDDO commands, nesting IF commands, RETURN command, 70, 71 Transfer Control (TFRCTL), Convert Date (CVTDAT), 59-51, 49 Convert Print to Physical File (CVTPRTF), 174 Copy From Query File (CPYFRMQRYF), 412 Copy Library (CPYLIB), 412 copy screen, Start Copy Screen (STRCPYSCN), 413 Copy Spooled File (CPYSPLF), 173 Copyright (COPYRIGHT) command, 7 Count Objects (CNTOBJ), Create Bound CL Program (CRTBNDCL), 18-19, 270, 271 Create CL Module (CRTCLMOD), 270 Create Command (CRTCMD), 230 Create Data Area (CRTDTAARA), 127, 129, 184 Create Data Queue (CRTDTAQ), Create Duplicate Object (CRTDUPOBJ), 15, Create Job Description (CRTJOBD), 234 Create Menu Object (CRTMNU), 412 Create Message File (CRTMSGF), 78 Create Message Queue (CRTMSGQ), 74 Create Output Queue (CRTOUTQ), 183 Create Physical File (CRTPF), 164 Create Program (CRTPGM), 270, 271 Create Service program (CRTSRVPGM), Create Table (CRTTBL), 219 Create Work File (CRTWRKF), , creating objects (CRTxxx commands), D data areas Change Data Area (CHGDTAARA), 127 Create Data Area (CRTDTAARA), 127, 129, 184 Delete Data Area (DLTDTAARA), 127, 129 Display Data Area (DSPDTAARA), 128 group data area (GDA), local data area (LDA), passing program information, 123, program initialization parameter (PIP) data area, 129 Retrieve Data Area (RTVDTAARA), 128, 157 special data areas, data queues batch processing using data queues, 145 Clear Data Queue (CLRDTAQ), clear data queues, 135 CLRDTAQ clear data entries utility, 144 Create Data Queue (CRTDTAQ), Delete Data Queue (DLTDTAQ), 134, 135 FIFO data queues, 134 interactive transactions using data queues, 145 KEYED data queues, 134, LIFO data queues, 134 output queues as data queues, 144 passing program information, 123, pros and cons of data queues, QCLRDTAQ API to clear data, QMHQRDQD API program to receive data entries, QMHRDQM API program to receive data entries, 136, QRCVDTAQ API to receive data, QSNDDTAQ API program to send data entries to queue, , receive data entries from queue, 135, 136, ,

5 Receive Data Entry from Queue (RCVDTAQ), 144, Reorganize Data Queue (RGZDTAQ), 145, Retrieve Data Queue Description (RTVDTAQD), send data entries to queue, Send Data Entry To Queue (SNDDTAQ), 144, sender ID, non-keyed queue, 138 types of data queues, 134 utility commands, 144, data types, 3, 8, 28, 69 database files (See also files), 3, 159, Add Logical File Member (ADDLFM), 164 Add Physical File Member (ADDPFM), 164 Change Logical File Member (CHGLFM), 164 Change Physical File Member (CHGPFM), 164 Clear Physical File Member (CLRPFM), 164 Close File (CLOF), 168 Copy From Query File (CPYFRMQRYF), 412 Delete Override (DLTOVR), 168 Display Override (DSPOVR), 167 job descriptions, 235 locked records, 194 logical files, 164 members, 164 open data paths (ODP), 168 Open Query File (OPNQRYF), outfiles, override commands, 166 Override Database File (OVRDBF), 161, 166, 167 passing program information, 123 physical files, 164 queries, Remove Member (RMVM), 164 Reorganize Physical File Member (RGZPFM), 164 sorting with OPNQRYF, temporary files, 165 dates, Convert Date (CVTDAT), 59-51, 49 DDS, 11, 160 debugging, Add Breakpoint (ADDBKP), Add Trace (ADDTRC), 422 breakpoint insertion, BREAK, 248, 254, change breakpoint, 421 Change Program Variable (CHGPGMVAR), 421 Clear Trace Data (CLRTRCDTA), 423 commands for debugger, conditional breakpoints, debugging one job running in another, Display Program Variables (DSPPGMVAR), 421 Display Trace (DSPTRC), 422 Display Trace Data (DSPTRCDTA), Dump CL Program (DMPCLPGM), End Debug (ENDDBG), 244 EVAL command, , 253 expressions, 250, 252 ILE, 278 interactive debugging session example, line-oriented debugger, OPM programs, list view debugging, 256, 256 logical expressions, 252 message queue, Dump CL Program (DMPCLPGM), operators, 250, 252 OPM program debugging, parameters, 253 Remove Breakpoint (RMVBKP), 421 Remove Trace (RMVTRC), 422 source view debugging, Start Debug (STRDBG), , statement view debugging, 257, 257 STEP command, 254 trace, variable listing, Dump CL Program (DMPCLPGM),

6 debugging, continued views for debugging, WATCH command, 254 decimal constants, 23, 25 decimal data type, 3, 8, 28 Declaration (DCL) command, 7-8, 9, 27, sorting for easy reading, 30, Declare File (DCLF) command, 8, Delay Job (DLYJOB), , 219 Delete Data Area (DLTDTAARA), 127, 129 Delete Data Queue (DLTDTAQ), 134, 135 Delete File (DLTF), 164 Delete Override (DLTOVR), 168 Delete Spooled File (DLTSPLF), 174 deleting objects (DLTxxx commands), descriptions for messages, 78 device naming, 414 Diagnostic messages, 76, 84 Disconnect Job (DSCJOB), 412 Display Command (DSPCMD), 216, 231 Display File Field Description (DSPFFD), 172 display files Override with Display File (OVRDSPF), 166 PRTCTLMNUD, subfile example, Display Job (DSPJOB), 129 Display Library (DSPLIB), 32 Display Message (DSPMSG), 23, , 202, 240 Display Message Description (DSPMSGD), 78 Display Module (DSPMOD) command, 7 Display Object Description (DSPOBJD), 172, 358 Display Object Information (DSPOBJINF), Display Override (DSPOVR), 167 Display Program (DSPPGM), 171 Display Program Message (DSPPGMMSG), 106, Display Program Variables (DSPPGMVAR), 421 Display Record Locks (DSPRCDLCK), 194 Display Trace (DSPTRC), 422 Display Trace Data (DSPTRCDTA), Display User Profile (DSPUSRPRF), 173 Display Workstation User (DSPWSUSR), 412 Do Until, 3, 57 simulating using GOTO, Do While, 3, 57 simulating using GOTO, DO, iterative, 3, 57 simulating iterative DO, DO/ENDDO, 17, ELSE used with, nesting, 61-62, 61 double quotes, 177 Dump CL Program (DMPCLPGM), Duplicate Object (DUPOBJ), dynamic call, 270 dynamic execution (See also QCMDEXC), 33, System/36 differences, E EBCDIC, translate ASCII/EBCDIC characters (QDCXLATE), Edit Library List (EDTLIBL), 412 Edit Object Authority (EDTOBJAUT), 226, 412 editing code lines, 14 editor, code editors, ELSE command, DO/ENDDO used with ELSE, IF command with ELSE, simulating CASE with ELSE and IF, End Debug (ENDDBG), 244 End Program (ENDPGM) command, 9, 70-71, 71 environment, 414 System/36 differences, 426 System/38 differences, equal sign, Change Variable (CHGVAR), error handling command-level MONMSG, 94 forwarding error messages, generic monitoring with MONMSG, global error trapping, 8, MONMSG as global error trap, 8, program-level (global) MONMSG, 93 variable position errors,

7 Escape messages, 76, 84 escape messages, CHKOBJ, 186 EVAL command, , 253 executable code, 267 executing the program, 19 CALL command, 19 control statements, dynamic call, 270 QCMDEXC, 33, expressions, 48 debugging, 250, 252 logical expressions, 53 quotation mark use, 179 F FIFO data queues, 134 files, Add Logical File Member (ADDLFM), 164 Add Physical File Member (ADDPFM), 164 allocating objects to jobs (ALCOBJ), capturing output with *PRINT, capturing output with QTEMP, 169 Change Logical File Member (CHGLFM), 164 Change Physical File Member (CHGPFM), 164 Clear Physical File Member (CLRPFM), 164 Close File (CLOF), 168 Convert Print to Physical File (CVTPRTF), 174 Create Physical File (CRTPF), 164 Create Work File (CRTWRKF), , database file processing, 159, DDS creation of files, 160 Declare File (DCLF), Delete File (DLTF), 164 Delete Override (DLTOVR), 168 Display File Field Description (DSPFFD), 172 display files, override, 167 Display Override (DSPOVR), 167 flat files, 169 job descriptions, 235 key fields, reading key field files, logical files, 164 members, 165 Open Query File (OPNQRYF), outfiles, override commands, 166 Override Database File (OVRDBF), 161, 165, 167 Override with Display File (OVRDSPF), 166 Override with Printer File (OVRPRTF), 166 permanent work files, physical files, 164 printer files, override, 166 QTEMP library, temporary files, 169 Receive File (RCVF), record-by-record processing, Remove Member (RMVM), 164 Reorganize Physical File Member (RGZPFM), 164 Send File (SNDF), Send Receive File (SNDRCVF), sorting with OPNQRYF, System/36 differences, temporary files, 165, 169 turn indicators on/off, 163 whole-file processing, Find String Using PDM (FNDSTRPDM), 412 flat files, 169 floating-point data types, 69 Format CL Source (FMTCLSRC), formatting code, align similar lines, blank lines in program code, 19-20, case sensitivity, 14, character strings, 14 coding style, command prompter formatting, 12-13, 12, 13, COMMENT command, comment lines in program code, 20-22, continuing code onto next line, editing code lines,

8 formatting code, continued editor, code editors, Format CL Source (FMTCLSRC), HELLO program sample, formatting example, 11-12, 11, 12 identifiers in lowercase for easy reading, indent lines of code, 13, 17-18, insert/delete blank lines, 13 keywords, 13, 15-16, labels & tags, 13, leading blanks, removal, positional parameters, QCMDCHK syntax checker, quotation marks, 14, Source Entry Utility (SEU), , syntax checker, 13, FORTRAN, 2 Forward Program Messages (FWDPGMMSG), 188, forwarding error messages, G generic messages, global error trapping, 8, GOTO, 3, 16, labels & tags, 9, program-level (global) MONMSG, 93 simulating Do While/Do Until, 59 simulating iterative DO, Grant Object Authority (GRTOBJAUT), 226 group data area (GDA), passing program information, H HELLO program sample, formatting example, 11-12, 11, 12 hexadecimal constants, 23, hierarchy of operators, 48 I identifiers in lowercase for easy reading, IF command, comparison operators, complex logical expressions, ELSE used with, logical expressions, 53 nested IFs, simulating CASE with ELSE and IF, testing logical variables, If/Then/Else, 3 impromptu messages, 73, 77, 81, 87-88, indent lines of code, 13, 17-18, Informational messages, 77, 84, 87, 88 Initialize Library (INZLIB), Inquiry messages, 76, 84, 87, 88, 202 insert/delete blank lines in code, 13 integrated language environment (ILE), ACTGRP parameter, 278 activation groups, AUT parameter, 278 binding by copy, binding by reference, 269 binding, compiling a program, Create Bound CL Program (CRTBNDCL), 270, 271 Create CL Module (CRTCLMOD), 270 Create Program (CRTPGM), 270, 271 Create Service program (CRTSRVPGM), DBGVIEW, 278 default activation group, 275 DFTACTGRP parameter, 275 dynamic call, 270 ENBPFRCOL parameter, 278 executable code, 267 LANGID parameter,

9 LOG parameter, 276 object code, OPTIMIZE parameter, 279 OPTION parameter, 275 Original Program Model, parameters, PGM parameter, 274 procedures, 267 programs, 267 REPLACE parameter, SRCFILE parameter, 274 SRCMBR parameter, 274 SRTSEQ parameter, 278 System/38 differences, 416 TEXT parameter, 275 TGTRLS target release parameter, 277 USRPRF parameter, 276 interactive processing, 195 interactive transactions using data queues, 145 interpreted vs. compiled languages, interprogram/intermodule communication, Call Bound Procedure (CALLPRC), 124 CALL command, 124 constants as parameters, data areas, 123, data queues, 123, database files, 123 group data area (GDA), limitations of parameters, 126 local data area (LDA), 123, messages, 123, parameters, 123, , 125 Receive Message (RCVMSG), Send Program Message (SNDPGMMSG), switches, 123, Transfer Control (TFRCTL), 124, 126 variables as parameters, IPLs, 414 iterative DO, 3, 57 simulating iterative DO, J jobs &QUOTE variable, allocating objects to jobs (ALCOBJ), attributes of jobs, , 192, 236 automatic allocation of objects, 192 batch processing (See batch processing), 195 Change Job (CHGJOB), 154 Change Job Description (CHGJOBD), 234 Create Job Description (CRTJOBD), 234 Deallocate Objects (DLCOBJ), 192 debugging one job running in another, Delay Job (DLYJOB), descriptions, job descriptions, Disconnect Job (DSCJOB), 412 Display Record Locks (DSPRCDLCK), 194 interactive processing, 195 job queues, 196 job scheduler using RTVSYSVAL, job/system interface, library lists, lock states, 192 members, 165 network attributes, 156 priority of jobs, 154 retrieve commands, Retrieve Job Attribute (RTVJOBA), , 157, , 236 Submit Job (SBMJOB), system values, user profiles, Work with Job Queue (WRKJOBQ), 201 Work with Object Locks (WRKOBJLCK), 194 Work with Submitted Jobs (WRKSBMJOB), 201 Work with Subsystem Jobs (WRKSBSJOB), 201 Work with User Jobs (WRKUSRJOB),

10 K key fields, reading key field files, key, message key, 86-87, keyboards, 414 KEYED data queues, 134, keywords, 8, 13, 15-16, L labels & tags, 9, 13, GOTO command, 9, lowercase for easy reading, language support with CL, 1, 278 interpreted vs. compiled languages, leading blanks in code, removal, levels of security, 225 libraries, 3, 19 Change Current Library (CHGCURLIB), 411 Change Library List (CHGLIBL), 411 Copy Library (CPYLIB), 412 Display Library (DSPLIB), 32 Initialize Library (INZLIB), installing utility commands, 281 message file library, 105 QTEMP library, temporary files, 169 replace existing member, , 276 Retrieve Library Description (RTVLIBD), 413 scratch library creation, 239 Work with System Values (WRKSYSVAL), 281 library lists, Add Library List Entry (ADDLIBLE), Change Current Library (CHGCURLIB), Change Library List (CHGLIBL), Change System Library List (CHGSYSLIBL), , 239 Edit Library List (EDTLIBL), 412 job descriptions, 234 Remove Library List Entry (RMVLIBLE), Restore Library List (RSTLIBL), Retrieve Library Description (RTVLIBD), 157 Save Library List (SAVLIBL), scratch library, 234 licensing for CL, 2 LIFO data queues, 134 limitations of CL, 3 line-oriented debugger, OPM programs, list view debugging, 256, 256 literals (See constants & literals) Load Tape and Run (LODRUN), 412 local data area (LDA) passing program information, 123, System/36 differences, lock states, 192 locked records, Display Record Locks (DSPRCDLCK), 194 log command, ILE, 276 logical constants, 23, 27 logical data type, 3, 8, 28 logical expressions, 53 debugging, 252 logical files, 164 logical variables, testing, IF command, loops, 57 M members, 165 memory pools, 3 Change Shared Pool (CHGSHRPOOL), 412 menu objects, Create Menu Object (CRTMNU), 412 message files, 78, 105 messages, , Add Message Description (ADDMSGD), 78 Add Reply List Entry (ADDRPYLE), 114 alert options, 105 break messages, , 110 Change Message Description (CHGMSGD), 78 Change Message Queue (CHGMSGQ), 75 Change Reply List Entry (CHGRPYLE),

11 Clear Message Queue (CLRMSGQ), 113 color of text of message, 84 Completion messages, 76, 84 content of message, Create Message File (CRTMSGF), 78 Create Message Queue (CRTMSGQ), 74 defining a message, 77 descriptions for messages, 78 destination of message, 82-83, 82 Diagnostic messages, 76, 84 display file PRTCTLMNUD, subfile example, Display Message (DSPMSG), 23, 90, , 202, 240 Display Message Description (DSPMSGD), 78 Display Program Message (DSPPGMMSG), 106, erasing messages from queue (F11, F13, F16 function keys), Escape messages, 76, 84 escape messages, CHKOBJ, 186 first-level text of message, 100 Forward Program Message (RWDPGMMSG), 188, forwarding error messages, generic messages, global error trapping with MONMSG, 8, ID for message, 77, 79, 101 impromptu messages, 73, 77, 81, 87-88, information about message, Informational messages, 77, 84, 87, 88 Inquiry messages, 76, 84, 87, 88, 202 job message queues, length of message, 101 library containing message file, 105 message files, 78, 105 message key, 86-87, Monitor Message (MONMSG) command, 8, Monitor Messages (MONMSG) CMPDTA compare data parameter, 91 command-level MONMSG, 94 EXEC execution parameter, 92 generic monitoring with MONMSG, MSGID message ID list parameter, 91 program-level (global) MONMSG, 93 source file test with CHKOBJ, 92 specific monitoring with MONMSG, new messages, 75 Notify messages, 76, 84 old messages, 75 parts of message, passing program information, 123, permanent message queues, 74 predefined messages, 73, 74, 77-80, 81, 88 program message queues, program messages, 81-87, 188, 237, , QSYSOPR message queue, queues, message queues, 73, 74-75, 106, 107, 113 Receive Message (RCVMSG), 75, , 240 alert options, 105 first-level text of message, 100 from which program message queue (PRMQ), ID of message, 101 information about message, length of message, 101 library containing message file, 105 message files, 105 message key, 100 passing program information, remove message from queue, 106 return type, second-level text of message, 101 sender ID, 101, 102, severity level, 101 wait for message, which message to receive (MSGTYPE/ MSGKEY combinations), 98 receiving a message, 73 receiving a reply, 85-86, 89 recipient of message, 88 recipient of message, TOPGMQ parameters,

12 messages, continued Remove Message Description (RMVMSGD), 78 remove message from queue, 106 Remove Messages (RMVMSG), Remove Reply List Entry (RMVRPYLE), 114 Reply messages, 76 Request messages, 76, 84 Retrieve Message (RTVMSG), 157 return type, second-level text of message, 101 Send Break Message (SNDBRKMSG), Send Message (SNDMSG), Send Program Message (SNDPGMMSG), 81-87, 237 passing program information, Send Reply (SNDRPY), 109 Send Status Message (SNDSTSMSG), Send User Message (SNDUSRMSG), sender ID, 101, 102, severity levels, 80, 101 Status messages, 77, 84, 85, subfiles, message subfiles, system operator (QSYSOPR) message queue, 74 system reply list, translation tables (TRNTBL) parameter, types of messages, 75, 76, 84-85, 88, utility programs, wait for message, Work With Message Description (WRKMSGD), 78 Work with Messages (WRKMSG), Work with Reply List Entry (WRKRPYLE), 114 Monitor Message (MONMSG) command, CMPDTA compare data parameter, 91 command-level MONMSG, 94 COPYRIGHT command, 7 error trapping, 8, EXEC execution parameter, 92 forwarding error messages, MSGID message ID list parameter, 91 program-level (global) MONMSG, 93 Move Object (MOVOBJ), 191 N nesting DO/ENDDO commands, nesting IF commands, network attributes, 156 Retrieve Network Attributes (RTVNETA), 156, 158 networking, 3 NOT operator, 47, 48, Notify messages, 76, 84 O object code, ILE, object management, 3, adopting authority, Allocate Object to Job (ALCOBJ), attributes for jobs, 192 automatic allocation of objects, 192 Change Object Description (CHGOBJD), 191 Change Object Owner (CHGOBJOWN), 227 Check Object (CHKOBJ), , 228 Compress Object (CPROBJ), 412 Count Objects (CNTOBJ), Create Duplicate Object (CRTDUPOBJ), 15, Create Menu Object (CRTMNU), 412 creating objects (CRTxxx commands), Deallocate Objects (DLCOBJ), 192 deleting objects (DLTxxx commands), Display Object Description (DSPOBJD), 171, 358 Display Object Information (DSPOBJINF), Duplicate Object (DUPOBJ), Edit Object Authority (EDTOBJAUT), 226,

13 existence checking, CHKOBJ, Grant Object Authority (GRTOBJAUT), 226 lock states for jobs, 192 Move Object (MOVOBJ), 191 names, in lowercase for easy reading, ownership of objects, 227 PUBLIC authorities, 227 Rename Object (RNMOBJ), 191 Retrieve Member Description (RTVMBRD), Retrieve Object Description (RTVOBJD), 158, , 413 Revoke Object Authority (RVKOBJAUT), 226 securing an object, 226 System/38 differences, Work with Object Locks (WRKOBJLCK), 194 open data paths (ODP), Open Query File (OPNQRYF), operating system (OS/400) and CL, 2 Operational Assistant, Retrieve Power Schedule Entry (RTVPWRSCDE), 158 operators arithmetic operators, blank spaces, 40 comparison operators, debugging, 250, 252 expressions, 48 hierarchy of operators, 48 parentheses in operations, 40, 48 precedence of operators, 48 /, 40 OR operator, 47, 48, Original Program Model, 267, outfiles, Display File Field Description (DSPFFD), 172 Display Object Description (DSPOBJD), 171 output queues Create Output Queue (CRTOUTQ), 183 data queues as, 144 Override Database File (OVRDBF), 161, 166, 167 Override with Display File (OVRDSPF), 166 Override with Printer File (OVRPRTF), 166 ownership of objects, 227 P parameters (PARM), 15-16, 27-28, debugging, 253 Declare (DCL) parameter, ILE, passing constants as parameters, CALL, 70 passing parameters, 35, , 125 passing program information, 123, , 125 passing variables as parameters, positional parameters, 15 sign-on & initial programs, 233 sorting/arranging DCL commands for ease, 30, parentheses in operations, 40, 48 Pascal, 2, 37 passing parameters, 35 passwords, 414 Change Password (CHGPWD), 411 Check Password (CHKPWD), 412 pattern scan for variables, QCLSCAN, , 236 Performance Explorer, ILE, 278 permanent message queues, 74 permanent work files, physical files, 164 PL/I utility programs, 2 plus/minus sign, continuing code onto next line, positional parameters, 15 power schedule, Retrieve Power Schedule Entry (RTVPWRSCDE), 158 power up (See system power up/power down) predefined messages, 73, 74, 77-80, 81, 88 prestart jobs, 129 Print Device Addresses (PRTDEVADR), 412 printer files Convert Print to Physical File (CVTPRTF), 175 Override with Printer File (OVRPRTF),

14 printing *PRINT, Print Device Addresses (PRTDEVADR), 412 printer name, 414 spooled files, System/36 differences, prioritizing jobs, 3, 154 procedures, 267 System/36 differences, Program (PGM) command, 6-7, 9 Program Development Manager (PDM), 10 Start PDM (PDM), to start SEU, 10 Work with Members Using PDM (WRKMBRPDM), 10 program initialization parameter (PIP) data area, 129 program message queues, program messages, 188, 237, , program-level (global) MONMSG, 93 programming (See formatting code; writing CL programs) programming aid utilities, programming shortcut utilities, programs, 267 prompting, selective prompting, PUBLIC authorities, 227 Q QASTLVL, 151 QATNPGM, 151 QAUTOCFG, 414 QCLRDTAQ API to clear data queue, QCLSCAN, , 236 QCLSRC default source physical file, 10 QCMDCHK syntax checker, QCMDEXC, 33, Check Object (CHKOBJ), QCONSOLE, 151, 414 QCRTAUT, 151 QCTLSBSD, 151 QCURSYM, 151 QDATE, 151 QDATFMT, 151 QDATSEP, 151 QDAY, 151 QDCXLATE, QDEVNAMING, 151, 414 QDSPSGNINF, 414 QHOUR, 151 QIPLDATTIM, 151, 414 QIPLSTS, 414 QIPLTYPE, 414 QKBDTYPE, 414 QMHQRDQD API program to receive data entries, QMHRDQM API program to receive data entries, 136, QMINUTE, 151 QMODEL, 151, 414 QMONTH, 151 QPFRADJ, 414 QPRTDEVE, 151, 414 QPRTKEYFMT, 151 QPRTTXT, 151 QPWDEXPITV, 414 QPWRRSTIPL, 414 QRCVDTAQ API to receive data queue, QRMTIPL, 414 QSECOND, 151 QSECURITY, 151, 414 QSNDDTAQ API program to send data entries to queue, , QSPCENV, 414 QSRLNBR, 152 QSTRPRTWTR, 152, 414 QSTRUPPGM, 152, 414 QSTSMSG, 152 QSYSLIBL, 152 QSYSOPR message queue, QTEMP, 169 Create Work File (CRTWRKF), SIGNOFF command action, 169 QTIME, 152 qualified names / symbol, 40 System/38 differences, 406 variables,

15 query files, Copy From Query File (CPYFRMQRYF), 412 question mark for selective prompting, 207 queues (See data queues; jobs; messages; output queues; user queues) quotation marks, 14, character strings, 179 command strings, 179 embedded quotes, expressions, 179 multiple quotes, 180 strings delimited by quotes, 178 QUSRLIBL, 152 QYEAR, 152 R Receive Data Entry from Queue (RCVDTAQ), 144, Receive File (RCVF), Receive Message (RCVMSG), 75, , 240 Display Program Messages (DSPPGMMSG) utility command, 106 first-level text of message, 100 from which program message queue (PRMQ), ID of message, 101 information about message, length of message, 101 library containing message file, 105 message key, 100 passing program information, remove message from queue, 106 return type, second-level text of message, 101 sender ID, 101, 102, severity level, 101 wait for message, which message to receive (MSGTYPE/ MSGKEY combinations), Reclaim Activation Group (RCLACTGRP), 221, 222, Reclaim Resources (RCLRSC), record locks, Check Record Lock (CHKRCDLCK), 412 record-by-record file processing, Remove Breakpoint (RMVBKP), 421 Remove Library List Entry (RMVLIBLE), Remove Member (RMVM), 164 Remove Message Description (RMVMSGD), 78 Remove Messages (RMVMSG), Remove Reply List Entry (RMVRPYLE), 114 Remove Trace (RMVTRC), 422 Rename Object (RNMOBJ), 191 Reorganize Data Queue (RGZDTAQ), Reorganize Physical File Member (RGZPFM), 164 Reply messages, 76 Request messages, 76, 84 resource management, Reclaim Activation Group (RCLACTGRP), 221, 222, Reclaim Resources (RCLRSC), Restore Library List (RSTLIBL), Retrieve Authorization List (RTVAUTLE), 157 Retrieve Backup (RTVBCKUP), 157 Retrieve CL Source (RTVCLSRC), Retrieve Cleanup (RTVCLNUP), 157 retrieve commands, Retrieve Configuration Source (RTVCFGSRC), 412 Retrieve Configuration Status (RTVCFGSTS), 157, 413 Retrieve Data Area (RTVDTAARA), 157 Retrieve Data Queue Description (RTVDTAQD), Retrieve Job Attribute (RTVJOBA),130, , 157, , 236 Retrieve Library Description (RTVLIBD), 157, 413 Retrieve Member Description (RTVMBRD), , 413 Retrieve Message (RTVMSG), 157 Retrieve Network Attributes (RTVNETA), 156, 158 Retrieve Object Description (RTVOBJD), 158, ,

16 Retrieve Power Schedule Entry (RTVPWRSCDE), 158 Retrieve System Value (RTVSYSVAL), , 158 job scheduler program using, Retrieve System/36 Attributes (RTVS36A), 158 Retrieve User Profile (RTVURPRF), 9, , 158, 236 Return command, 70, 71 return type, message, Revoke Object Authority (RVKOBJAUT), 226 REXX Check Object (CHKOBJ), Receive Message (RCVMSG), Send Program Message (SNDPGMMSG), Send Reply (SNDRPY), 109 RGZDTAQ reorganize data queue utility, 145 RPG, 1, 2, 3, 11, 37, 59, 144, 267, 399 S S/38 Environment Programmer s Guide and Reference italics, 407 Save Library List (SAVLIBL), scratch library creation, 234, 239 security, 3, adopted authority, call stack, 229 adopting authority, Change Object Owner (CHGOBJOWN), 227 Change User Profile (CHGUSRPRF), 230 command line security, 230 Edit Object Authority (EDTOBJAUT), 226 Grant Object Authority (GRTOBJAUT), 226 levels of security, 225, 414 objects, 226 ownership of objects, 227 program object (*PGM) security, 225 PUBLIC authorities, 227 Revoke Object Authority (RVKOBJAUT), 226 user profiles, 230 Select Command (SLTCMD), 413 selective prompting, QCMDCHK use, 213 self-submitting programs, Send Break Message (SNDBRKMSG), Send Data Entry To Queue (SNDDTAQ), Send File (SNDF), Send Program Message (SNDPGMMSG), 237 passing program information, Send Receive File (SNDRCVF), Send Reply (SNDRPY), 109 Send Status Message (SNDSTSMSG), Send User Message (SNDUSRMSG), severity levels, messages, 80, 101 SIGNOFF, QTEMP library vs., 169 sign-on & initial programs, , 414 Change Job Description (CHGJOBD), 234 Create Job Description (CRTJOBD), 234 job attributes, 236 job descriptions, library lists, 239 logging for historical purposes, 235 messages, 237, 240 parameters, 233 sample program, , scratch library creation, 234, 239 user profiles, 236 single quotes, 177 SNDDTAQ send data entries utility, 144 sorting ILE, 278 OPNQRYF, System/36 differences, 454 Source Entry Utility (SEU), 10, , source files Check Object (CHKOBJ), 92 Compare Source Members (CMPSRCMBR), Format CL Source (FMTCLSRC), ILE, 274 Retrieve CL Source (RTVCLSRC), Retrieve Configuration Source (RTVCFGSRC), 412 source physical file, 10 source view debugging, spooled files,

17 Copy Spooled File (CPYSPLF), 173 Delete Spooled File (DLTSPLF), 174 Start Copy Screen (STRCPYSCN), 413 Start Debug (STRDBG), , Start PDM (PDM), Start SEU (STRSEU) command, 10, 11 statement view debugging, 257, 257 statements (See commands & statements) Status messages, 77, 84, 85, STEP command, 254 strings (See also character variables), 14 arrays, simulating arrays using strings, 44 binary conversion, concatenating strings, Find String Using PDM (FNDSTRPDM), 412 quotation mark use, 178, 179 substrings (%SST/%SUBSTRING), structure of typical CL program, 6 subfiles, message subfiles, Submit Job (SBMJOB), subroutines, 3, 57 substrings (%SST/%SUBSTRING), subsystems, 3 switches %SWITCH function to test, Display Job (DSPJOB), 129 number of switches in use, 131 passing program information, 123, Retrieve Job Attributes (RTVJOBA) to test, 130 testing switches, 130 turn on/off, Change Job (CHGJOB), syntax checker, 13, system configuration, 2 automatic configuration, 414 console, 414 Retrieve Configuration Source (RTVCFGSRC), 412 Retrieve Configuration Status (RTVCFGSTS), 157, 413 system log files, Send Message (SNDMSG), 110 system operator (QSYSOPR) message queue, 74 system power up/power down, 2 system reply list, message management, system values, Change System Value (CHGSYSVAL), 152 list of system values, 150, Retrieve System Value (RTVSYSVAL), , 158 System/38 differences, Work with System Values (WRKSYSVAL), 281 System/36 differences, CL equivalents to S/36 OCL statements, coding techniques, CL vs. S/36, control commands, CL equivalents, table, control records in a file, dynamic execution, entering and leaving S/36, 426 environment, 426 //FILE LABEL-xxx, #GSORT, indirect reference using??n??, local data areas (LDA), // PRINTER, procedure control expressions, CL equivalents, procedures, CL equivalents, table, Retrieve System/36 Attributes (RTVS36A), 158 running S/36 procedures, substitution expressions, CL equivalents, work file creation, deletion, 448 System/38 differences, 267, command changes, conversions, command entry screen, 415 converting to AS/400, 416 environment, integrated language environment (ILE), 416 new commands, object management, qualified names, 406 S/38 Environment Programmer s Guide and Reference italics, 407 system values,

18 T tags (See labels & tags) tape backups, Load Tape and Run (LODRUN), 412 target release parameter, ILE, 277 temporary files, 165, 169 job descriptions, 235 time slices, 3 trace, in debugging, Transfer Control (TFRCTL), passing program information, 124, 126 translation tables Create Table (CRTTBL), 219 translate ASCII/EBCDIC characters (QDCXLATE), TRNTBL parameter, messages, translation, translate ASCII/EBCDIC characters (QDCXLATE), true/false logical constants, 27 U upper/lowercase (See case sensitivity) user profiles, Change Profile (CHGPRF), 156 Change User Profile (CHGUSRPRF), 156, 230 Display User Profile (DSPUSRPRF), 173 ILE, 276 Retrieve User Profile (RTVURPRF), 9, , 158, 236 sign-on & initial programs, 233 utility commands, Clear Data Queue (CLRDTAQ), COMMENT command, Compare Source Members (CMPSRCMBR), Count Objects (CNTOBJ), Create Work File (CRTWRKF), data queue utilities, 338 Display Object Information (DSPOBJINF), Display Program Message (DSPPGMMSG), Duplicate Object (DUPOBJ), Format CL Source (FMTCLSRC), Forward Program Messages (FWDPGMMSG), Initialize Library (INZLIB), installing utility commands, 281 library for utility commands, 281 messages, programming aid utilities, programming shortcut utilities, Receive Data Entry from Queue (RCVDTAQ), Reorganize Data Queue (RGZDTAQ), Restore Library List (RSTLIBL), Retrieve Data Queue Description (RTVDTAQD), Save Library List (SAVLIBL), Send Data Entry To Queue (SNDDTAQ), Send Status Message (SNDSTSMSG), Start PDM (PDM), Work with System Values (WRKSYSVAL), 281 V variables, &QUOTE variable, arithmetic operators, arrays, simulating arrays using strings, 44 binary conversion, Change Program Variable (CHGPGMVAR), 421 Change Variable (CHGVAR), 13, 16, character data types, 28 character variables, concatenating strings, continuing code onto next line, data types, 8, 28, 69 decimal data types, 28 Declare variable (DCL), 27, 30 declaring variables, 7-8 Display Program Variables (DSPPGMVAR), 421 errors in variable use,

19 expressions, 48 floating-point data types, 69 hierarchy of operators, 48 invalid names, 28 length of variable, 8, 27, 28, 29, 30 listing, Dump CL Program (DMPCLPGM), logical data types, 28 logical variables, lowercase for easy reading, naming a variable, 27, 28 parameters, 27-28, passing parameters, 35 passing program information, passing variables as parameters, CALL, pseudo-variables, 46 qualified names in variables, 34 Retrieve Member Description (RTVMBRD), 413 scan for patterns (QCLSCAN), , 236 sorting/arranging DCL commands for ease, 30, substrings (%SST/%SUBSTRING), translate ASCII/EBCDIC characters (QDCXLATE), valid names, 28 value of variable, 8, 28 where variables are used, viewing program information, Display Module (DSPMOD), 7 views for debugging, W wait states, Delay Job (DLYJOB), WATCH command, 254 whole-file processing, work files (See also files; temporary files) Create Work File (CRTWRKF), job descriptions, 235 System/36 differences, 448 Work With commands (WRKxxx), 413 Work with Job Queue (WRKJOBQ), 201 Work with Members Using PDM (WRKMBRPDM), 10 Work With Message Description (WRKMSGD), 78 Work with Messages (WRKMSG), Work with Object Locks (WRKOBJLCK), 194 Work with Reply List Entry (WRKRPYLE), 114 Work with Submitted Jobs (WRKSBMJOB), 201 Work with Subsystem Jobs (WRKSBSJOB), 201 Work with System Values (WRKSYSVAL), 281 Work with User Jobs (WRKUSRJOB), 201 workstations, Display Workstation User (DSPWSUSR), 412 writing CL programs (See also formatting code) activation groups, align similar lines, binding by copy, binding by reference, 269 binding, blank lines in program code, 19-20, case sensitivity, 14, coding style, command prompter, COMMENT command, comment lines in program code, 20-22, Compare Source Members (CMPSRCMBR), compiling code, 12, 18-19, continuing code onto next line, Create Bound CL Program (CRTBNDCL), 270, 271 Create CL Module (CRTCLMOD), 270 Create Program (CRTPGM), 270, 271 Create Service program (CRTSRVPGM), dynamic call, 270 editor, code editors, executing the program, 19 Format CL Source (FMTCLSRC), formatting the program,

20 writing CL programs, continued HELLO program sample, formatting example, 11-12, 11, 12 identifiers in lowercase for easy reading, indent lines of code, 17-18, Initialize Library (INZLIB), integrated language environment (ILE), keywords, 15-16, labels & tags, leading blanks, removal, parameters, Program Development Manager (PDM), 10, programming aid utilities, programming shortcut utilities, QCLSRC default source physical file, 10 QCMDCHK syntax checker, QCMDEXC for dynamic execution, 33, selective prompting, sign-on & initial programs, 233 Source Entry Utility (SEU) to enter code, 10, , source physical file, 10 Start PDM (PDM), Start SEU (STRSEU) command, 10, 11 syntax checker, 13, Work with Members Using PDM (WRKMBRPDM),