SAA RUN QUERY report minisession

When you write applications that produce QMF reports, you can limit users' access to QMF by using report minisessions. In a report minisession, QMF limits the commands that a user can issue while viewing a report. Valid and invalid commands for a report minisession are listed in Table 8 and Table 9.

A report minisession behaves as a nested session (a session within a session). In minisessions, your initial QMF session remains intact, but becomes temporarily unavailable while you are viewing a report. The minisession becomes your current, active session until you issue the END command (or press the End function key). When you end a minisession, you either return to the initial QMF session or to the calling application, depending on how you write the application. The application cannot continue to issue subsequent commands until the report minisession is ended.

The QMF global variable DSQDC_DISPLAY_RPT, in effect, determines whether QMF starts a report minisession. This is because DSQDC_DISPLAY_RPT determines whether QMF displays a report after running a query (set to 1 to display the report, 0 to suppress display).

When you start QMF using the callable interface:

The default value for global variable DSQDC_DISPLAY_RPT is 1. (When QMF is started with DSQQMFE, whether interactively or in Batch mode, the default value of the global variable is 0).
If you run a procedure or an application that runs a query, QMF starts a report minisession; it is in this minisession that QMF displays the report resulting from the query.
If your procedure or application does not run a query, or if you run a query from the SQL panel, QMF does not start a report minisession.

If you don't want QMF to start a report minisession, do one of the following:

Change the value of DSQDC_DISPLAY_RPT to 0.
Set the DSQADPAN parameter to 0 when you start QMF from the callable interface.

See SET GLOBAL for more information about global variables.

From a report minisession, you can issue the following commands and synonyms for those commands (restrictions noted in parentheses):

Table 8. Valid commands in a minisession
BACKWARD BOTTOM CANCEL (when pop-up window active) CICS CMS DISPLAY (Report, Chart) END ENTER	FORWARD GET GLOBAL HELP INTERACT ISPF LEFT MESSAGE PRINT (Report, Chart) QMF	RETRIEVE RIGHT SAVE (Data) SET (Profile, Global) SHOW (Report, Chart) SWITCH (when Help active) TOP TSO

Table 9 contains a list of commands that are not valid in the minisession:

Table 9. Invalid commands in a minisession
ADD CANCEL CHANGE CHECK CLEAR CONNECT CONVERT DELETE DESCRIBE DISPLAY (Query, Proc, Profile, Form) DRAW EDIT ENLARGE	ERASE EXIT EXPORT EXTRACT GETQMF IMPORT INSERT INTERACT IRM LIST NEXT PREVIOUS PRINT (Query, Proc, Profile, Form)	REDUCE REFRESH RESET GLOBAL RESET (Query, Proc, Form) RUN SAVE SEARCH SHOW SORT SPECIFY START SWITCH

QMF returns an error message when you run an exec, a CLIST, or a procedure that issues a restricted command.

[ Previous Page | Next Page | Contents | Index ]