PowerHouse Rules Type the text for the HTML TOC entry Type the text for the HTML TOC entry Type the text for the HTML TOC entry PowerHouse Rules POWERHOUSE RULES Cognos(R) Application Development Tools PowerHouse(R) 4GL VERSION 8.4E POWERHOUSE RULES Product Information This document applies to PowerHouse(R) 4GL Version 8.4E and may also apply to subsequent releases. To check for newer versions of this document, visit the Cognos Global Customer Services Web site (http://support.cognos.com). Copyright Copyright (C) 2007 Cognos Incorporated. Portions of Cognos(R) software products are protected by one or more of the following U.S. Patents: 6,609,123 B1; 6,611,838 B1; 6,662,188 B1; 6,728,697 B2; 6,741,982 B2; 6,763,520 B1; 6,768,995 B2; 6,782,378 B2; 6,847,973 B2; 6,907,428 B2; 6,853,375 B2; 6,986,135 B2; 6,995,768 B2; 7,062,479 B2; 7,072,822 B2. Cognos and the Cognos logo are trademarks of Cognos Incorporated in the United States and/or other countries. All other names are trademarks or registered trademarks of their respective companies. While every attempt has been made to ensure that the information in this document is accurate and complete, some typographical errors or technical inaccuracies may exist. Cognos does not accept responsibility for any kind of loss resulting from the use of information contained in this document. This document shows the publication date. The information contained in this document is subject to change without notice. Any improvements or changes to either the product or the document will be documented in subsequent editions. U.S. Government Restricted Rights. The software and accompanying materials are provided with Restricted Rights. Use, duplication, or disclosure by the Government is subject to the restrictions in subparagraph (C)(1)(ii) of the Rights in Technical Data and Computer Software clause at DFARS 252.227-7013, or subparagraphs (C) (1) and (2) of the Commercial Computer Software - Restricted Rights at 48CFR52.227-19, as applicable. The Contractor is Cognos Corporation, 15 Wayside Road, Burlington, MA 01803. This software/documentation contains proprietary information of Cognos Incorporated. All rights are reserved. Reverse engineering of this software is prohibited. No part of this software/documentation may be copied, photocopied, reproduced, stored in a retrieval system, transmitted in any form or by any means, or translated into another language without the prior written consent of Cognos Incorporated. Table of Contents About this Book 13 Overview 13 Conventions in this Book 13 Getting Help 13 Cognos PowerHouse 4GL Documentation Set 14 Cognos PowerHouse Web Documentation Set 15 Cognos Axiant 4GL Documentation Set 16 Chapter 1: Running PowerHouse 17 Before Running PowerHouse 17 Getting Help 17 Setting Up the PowerHouse Environment 18 MPE/iX 18 OpenVMS 18 UNIX 18 Windows 19 Running QDESIGN 20 Running QUICK 21 Running QUIZ 22 Running QTP 24 Running PDL 27 Running PHDPDL (OpenVMS) 28 Running QSHOW 29 Running QUTIL 30 PowerHouse Commands (OpenVMS) 31 @SETPOWERHOUSE (OpenVMS) 32 POWERHOUSE (OpenVMS) 33 SETDICTIONARY (OpenVMS) 36 SHOWDICTIONARY (OpenVMS) 38 SHOWPOWERHOUSE (OpenVMS) 39 SHOWQUOTA (OpenVMS) 40 Locating Files 41 Locating the Data Dictionary 41 How the BUILD and SAVE Statements Locate Files 41 How the EXECUTE and USE Statements and auto Program Parameter Locate Files 42 Locating Start Screens or QKGO files in QUICK 43 How the GO Statement Locates Files 44 Locating Subfiles 44 Locating ODS5 File Names (OpenVMS) 46 Designated Files 48 PDC Shared Dictionary (OpenVMS) 53 Introduction 53 Requesting Dictionary Installations 53 Shared Memory Configuration 53 PHD Shared Dictionary (OpenVMS) 55 PDL Shared Dictionary (UNIX) 56 Installing Your Dictionary 56 Shared Memory Management 58 Mailbox Support in PowerHouse (OpenVMS) 59 PowerHouse Rules 3 Creating a Temporary or Permanent Mailbox 59 Temporary Mailbox Application 59 Permanent Mailbox Application 60 Using Mailboxes to Pass Source Statements 62 Mailboxes and System Crashes 62 sitehook (OpenVMS) 63 Large File Support (UNIX, Windows) 64 DISAM Data Storage (Windows) 65 Chapter 2: Program Parameters 67 About Program Parameters 67 Summary of Program Parameters 67 auto 75 autodetach|noautodetach 76 blockmode (MPE/iX) 77 broadcast (OpenVMS) 78 bulkfetch 79 cc 80 charmode 81 checksum710 (OpenVMS) 82 close_detach 84 columnowner 85 commitpoints 87 compress_buffers 88 confirmer 89 consolekeys|noconsolekeys (Windows) 90 createall 91 createbase (MPE/iX) 92 createfile 93 cursorowner 94 dbaudit 96 dbdetach|nodbdetach 98 dbwait|nodbwait 99 dcl|nodcl (OpenVMS) 100 debug (QDESIGN) 101 debug (QUICK) 102 deleteall 103 deletebase (MPE/iX) 104 deletefile 105 designer_noretain 106 detail|nodetail 107 dictionary|dict 108 dicttype|dt (OpenVMS) 109 direct_file_base_zero (OpenVMS) 110 disable_nulls 111 dont_store_module 112 downshift|upshift|noshift 113 entryrecall 114 errlist 115 fastread (OpenVMS) 116 fdl|nofdl (OpenVMS) 117 initnulls|noinitnulls 118 intsize6|nointsize6 (OpenVMS) 119 jcwbase (MPE/iX) 120 lineread (MPE/iX) 121 list|nolist 122 lockword (MPE/iX) 123 4 PowerHouse(R) 4GL Version 8.4E moduleext (MPE/iX) 124 moduleloc (MPE/iX) 125 nls (no line split) (MPE/iX, UNIX) 126 noblobs 127 nobreakset (MPE/iX) 128 nonportable 129 nontermcompat (Windows) 130 noowner 131 noprefix_ownername 132 nosetwarnstatus (OpenVMS) 133 nouicbrackets (OpenVMS) 134 nxl (no extra line) 135 obsolete 136 omnidex|noomnidex (MPE/iX) 137 osaccess|noosaccess 138 owner 139 parmfile (OpenVMS, UNIX, Windows) 140 parmprompt 141 patch 142 pollspeed (MPE/iX) 143 pre_chooseall 144 procloc 145 prompt 146 qktrace 147 quotedproccall 149 read (MPE/iX) 150 resetbindvar|noresetbindvar 151 resource 152 restore 153 retainmark|noretainmark 154 reuse_screen_buffers|noreuse_screen_buffers 155 search 156 secured 157 setjobshow|nosetjobshow (Windows) 158 statistics|nostatistics 159 subdictionary|subdict 160 subformat 161 term 162 termpoll|notermpoll (MPE/iX, OpenVMS) 165 timezone|notimezone (MPE/iX) 166 tpi|notpi (MPE/iX, HP-UX, Windows) 167 trusted|notrusted (OpenVMS) 168 update 170 version 171 vmsdate (OpenVMS) 172 Chapter 3: Resource File Statements 173 About Resource File Statements 173 Summary of Resource File Statements 173 ALLBASE MODULE EXTENSION (MPE/iX) 180 AUTODETACH 181 BROADCAST (OpenVMS) 182 BULKFETCH n 183 CC 184 CHECKSUM710 185 CLOSE DETACH 187 COLUMNOWNER 188 PowerHouse Rules 5 COMMITPOINTS OBSOLETE 190 COMPRESS BUFFERS 191 CONSOLE KEYS (Windows) 192 DATABASE 193 DBAUDIT 195 DBDETACH 197 DBWAIT 198 DEBUG 199 DEFAULT CURSOR OWNER 200 DESIGNER NORETAIN 201 DICTIONARY 202 DIRECTORY (UNIX, Windows) 204 DISABLE NULLS 205 ENTRY RECALL 206 EXIT 207 HPSLAVE EXTRA LINE 208 HPSLAVE SPLIT LINES (MPE/iX, UNIX) 209 INITIALIZE NULLS 210 INTEGER SIZE 6 (OpenVMS) 211 JCWBASE (MPE/iX) 212 LIST 213 LOCATION MODULE (MPE/iX) 214 LOCATION PROCESS 215 LOCKWORD (MPE/iX) 216 NOBLOBS 217 NONPORTABLE 218 NOOWNER 219 NOSET WARN STATUS (OpenVMS) 220 OBSOLETE 221 OMNIDEX (MPE/iX) 222 OSACCESS 223 OWNER 224 PREFIX ORACLE OPEN NAME 225 PROMPT 226 QUIT 227 RESET BIND VARIABLES 228 RESTORE LINES 229 RETAIN MARK 230 REUSE SCREEN BUFFERS 231 RMS FAST READ (OpenVMS) 232 RMS FILE BASE (OpenVMS) 233 SET 234 SETJOBSHOW (Windows) 235 SHIFT 236 STATISTICS 237 STORE MODULES 238 SUBDICTIONARY 239 SUBFORMAT n 240 TERMINAL 241 TERMINAL BLOCKMODE (MPE/iX) 244 TERMINAL CHARACTERMODE 245 TERMINAL CONFIRMER 246 TERMINAL POLLING SPEED (MPE/iX) 247 TERMINAL READ (MPE/iX) 248 TERMPOLL (MPE/iX, OpenVMS) 249 TIC RESOURCE FILE (UNIX, Windows) 250 TIME ZONE (MPE/iX) 251 6 PowerHouse(R) 4GL Version 8.4E TPI (MPE/iX, HP-UX, Windows) 252 TRUNCATE PARM VALUES 253 TRUSTED (OpenVMS) 254 UIC BRACKETS (OpenVMS) 256 UPDATE ORDER 257 USE 258 VMSDATE 259 Chapter 4: Messages in PowerHouse 261 PowerHouse 4GL Messages 261 Service Layer Messages 265 How the Service Layer Locates Message Files 265 Format of a Default Message File 266 Service Message Compiler 268 Designer Messages 270 Text Order Numbering 271 Chapter 5: PowerHouse Language Rules 273 Syntax Symbols in PowerHouse 273 Uppercase and Lowercase 273 Square Brackets 273 Braces 274 Ellipsis 274 Or-Bars 274 Stacked Syntax 274 Indented Syntax 274 General Terms in PowerHouse 275 Entering Statements 281 Abbreviating Keywords 281 Avoiding Conflicts Between Keywords and Record or Item Names 281 What Happens When You Enter Statements 281 Entering Comments 281 Entering Conditional Compile Statements 282 Operating System Commands 283 Arrays in PowerHouse 284 Using Arrays in QDESIGN 284 Subscripting in QUIZ and QTP 285 Using Arrays in QUIZ 285 Using Arrays in QTP 286 Conditions in PowerHouse 289 Logical Function 289 Logical Expression 289 Predefined Conditions in QDESIGN 290 Predefined Conditions in QTP 293 Predefined Conditions in QUIZ 295 Simple Conditions 295 Compound Conditions 296 Modifying Simple and Compound Conditions 296 Conditional Command List 296 Conditions and NULL Values 297 Conditions in SQL 298 sql-expression operator {sql-expression|subquery} 298 sql-expression operator {ALL|SOME|ANY} subquery 298 columnspec [NOT] LIKE 'sql-pattern' [ESCAPE 'character'] 298 columnspec IS [NOT] NULL 299 sql-expression [NOT] IN (value, value[...])|subquery 299 [NOT] EXISTS subquery 299 Expressions in PowerHouse 300 PowerHouse Rules 7 String Expressions 300 Numeric Expressions 300 Date Expressions 301 Conditional Expressions 301 Case Processing 302 Expressions in SQL 303 String Expressions 303 Numeric-Expressions 303 Date Expressions 303 SQL Case Processing 303 Expressions within Program Variables 304 SQL