Support email

Contact Us

SQL iQuery Logo

SQL iQuery

Macro Support

Normally, to run an SQL statement, you specify it on the SQL parameter of the RUNIQRY command as follows:


You can also save the SQL statement in a source member and recall it later, using the following syntax:


A great feature in SQL iQuery allows users to store SQL statements in source member and more easily recall them. We call this our "SQL Macro" feature or simply, Macros.

Using the RUNIQRY command, users may run pre-defined SQL statements using the member name as a "macro" identifier. To do so, the member name is specified on the SQL parameter, prefixed with an asterisk. User-defined macros are stored in QSQLMACRO on the library list, whereas SQL iQuery's built-in macros are stored elsewhere. For example to run the SQL iQuery-provided USRPRF (User Profile Listing) macro, type the following:


This statement runs the SQL statement stored in the source member named USRPRF in the source file named QIQMACRO in the SQL iQuery product library.

There are a number of macros shipped with SQL iQuery (see below) and end-users may create their own. User-created Macros should be stored in source file QSQLMACRO in a library on the library list.

For example, if the source member named SAMPLE is created in source file QSQLMACRO and contains: SELECT * FROM QIWS/QCUSTCDT; then following RUNIQRY command could be used to run that SQL statement as follows:


When RUNIQRY is run, it first checks for the macro name as a member in QSQLMACRO on the library list. If it does not locate a member with that name, it then searches source file QIQMACROS in the SQL iQuery product library for the member.

The SQL iQuery product ships with the following Macros. Some are for testing/debugging the product as well as providing information on your system, but most are for daily use.

Click the Macro name to view the SQL iQuery statement behind the macro.

Powered by COZTOOLS find out more

Click on a name in the list to view its contents.
Source Viewer © 2004 Robert Cozzi, Jr. All rights reserved.

MemberLast ModifiedViewsText
ACTJOB2018-05-15 15.22.43788List Active Jobs
ALLUSR2018-05-15 15.22.43717List User Profiles
CACHE2018-05-15 15.22.4318Display the Cache Batteries status
CACHEBAT2018-05-15 15.22.4318Display the Cache Batteries status
CMPDUPOBJ2018-05-15 15.22.435Check for Duplicated Objects in 2 libraries
DB2PTF2018-05-15 15.22.43739DB2 Group PTF Level
DEMO2018-05-15 15.22.43178SQL iQuery simple demo using QIWS.QCUSTCDT
DFTPWD2018-05-15 15.22.43654Check for Users Potentially with Default Password
DMGOBJ2018-05-15 15.22.43577Damaged Objects Report
DSK2018-05-15 15.22.43700Disk Unit Report
DSPJRN2018-05-15 15.22.43456Display Journal
GRPPRF2018-05-15 15.22.43695Group Profile Membership list
HIST2018-05-15 15.22.43178IBM History Log
IBMBLOG2018-05-15 15.22.43847IBM Db2 for i Blog Article Links
INTERACT2018-05-15 15.22.43517All Interactive Jobs
IQVER2018-05-15 15.22.4317SQL Macro to display the current SQL iQuery Versio
IQVRM2018-05-15 15.22.4318SQL Macro to display the current SQL iQuery Versio
JOBATTR2018-05-15 15.22.43330Job Attributes
JOBLOG2018-05-15 15.22.432897Joblog table Function QSYS2.JOBLOG_INFO(...)
JOBSCD2018-05-15 15.22.43706Check Job Scheduler Entry Last Submitted Status
JOBSCDE2018-05-15 15.22.43705List Job Scheduler Entries
JRNDBF2018-05-15 15.22.4348List User *FILE's being Journalled (long running)
KEYFLD2018-05-15 15.22.43228Key Fields List SETVAR((FILE MYFILE) (LIB MYLIB))
LASTUSED2018-05-15 15.22.43566Program Last Used Date/Time -- iQuery OBJ_LIST
LIBL2018-05-15 15.22.43704Current Job''s Library List
LICPGM2018-05-15 15.22.43556Installed License Programs (a better view)
LOG2018-05-15 15.22.43166SQL iQuery Log File query SETVAR((USER xxxxx))
MBRLIST2018-05-15 15.22.43408MBRL SETVAR((LIB ll) (FILE ff) (MBR mm) (TEXT tt))
MCHINFO2018-05-15 15.22.43236Machine Type,Model,Proc Group,Feature Code,Serial
MSGW2018-05-15 15.22.43738List Jobs in MSGW (Message Wait) Status
OBJLIST2018-05-15 15.22.437195Object list using IBM's Object Statistics UDTF
OBJSTRUCT2018-05-15 15.22.43591Exploded Object List (*MODULE and *SRVPGM list)
PTFBKPLVL2018-05-15 15.22.43643Back-level Group PTFs
PTFGRP2018-05-15 15.22.43683PTF Group Levels
RPGFREE2018-05-15 15.22.4317Search for COZTOOLS/RPGFREE *SRVPGM Where Used
SIGNON2018-05-15 15.22.4310SQL iQuery macro to list recent User Sign On/Off
SPCVAL2018-05-15 15.22.43734Special Values Query
SYS2018-05-15 15.22.43614System Information
SYSVAL2018-05-15 15.22.43656System Values Listing
TCPIP2018-05-15 15.22.43704TCP/IP Info
TOPHOGS2018-05-15 15.22.43688Top Storage Hogs
TOPLIMITS2018-05-15 15.22.43588Top 3 Consumption Points
USERS2018-05-15 15.22.4399List Non-IBM User Profiles
USRGRP2018-05-15 15.22.43684List User Profile Group Profiles
USRPRF2018-05-15 15.22.43678List Non-IBM User Profiles
VER2018-05-15 15.22.4310Display IBM i VxRyMz & TR level along w/iQuery ver
VERSION2018-05-15 15.22.439Verbose macro name for *VER macro

Copyright © 2015 Cozzi Productions, Inc. All Rights Reserved.