Starting QMF with ISPF

1. Start QMF from an application program using the callable interface, or issue the ISPSTART command with or without parameters. The following examples show how to use ISPSTART to override the default values for the database subsystem name (DSN) and the plan ID (QMF720).
   • With parameters:

     Choose the appropriate command for your type of install. If you are installing QMF into another DB2 UDB for OS/390 subsystem, the value for ssid must be changed to your subsystem ID value.

     • Full installs:

       ISPSTART PGM(DSQQMFE) NEWAPPL(DSQE)
        PARM(DSQSSUBS=ssid,DSQSPLAN=planid,...)
        

     • Server installs:

       ISPSTART PGM(DSQQMFE) NEWAPPL(DSQE)

     • Requester installs:

       ISPSTART PGM(DSQQMFE) NEWAPPL(DSQE) PARM(DSQSSUBS=ssid,
       DSQSPLAN=planid,DSQSDBNM=<location>,...)

     The QMF Home panel is displayed. After the QMF session ends, you are returned to TSO READY mode.

     Figure 4. QMF Home Panel

     Licensed Materials - Property of IBM
     5675-DB2 5697-F42 (C) Copyright IBM Corp. 1982, 2002
     All Rights Reserved.
     IBM is a registered trademark of International Business Machines
     _________________________________________________________________________________
      
       QMF HOME PANEL                       Query       Management    Facility
       Version 7 Release 2
                                           ******     **    **      ********* ____
       Authorization ID                  **     **   ***   ***     **        ____
         Q                              **     **   ****  ****    *******   ____
                                       **     **   ** ** ** **   **        ____
       Connected to                   **   * **   **  ****  **  **        ____
         SQLDS                         ******    **   **    ** **        _______
                                            ** _______________________________________
      
     Enter a command on the command line or press a function key.
     For help, press the Help function key or enter the command HELP.
     _________________________________________________________________________________
      1=Help        2=List        3=End         4=Show       5=Chart        6=Query
      
      7=Retrieve    8=Edit Table  9=Form       10=Proc      11=Profile     12=Report
      OK, you may enter a command.
      COMMAND ===>

   • Without parameters:

     ISPSTART

     You should now see the ISPF Master Application menu. From here, you can select QMF. After the QMF session ends, the ISPF Master Applications menu returns. The following section explains how to customize the ISPF selection menus to include QMF.

Customizing the ISPF selection menus

ISPF supplies a master application menu as part of its installation process. You can invoke QMF from the ISPF Master Application menu or from any other selection menu that you want to use. Figure 5 shows an example of how to code the ISPF Master Application menu to include QMF. The line for QMF is option 2.

You can change the program parameters you pass from TSO to QMF by using the QMF callable interface REXX procedure QMF720.SDSQEXCE(DSQSCMDE). Another method of passing program parameters is through the ISPF service call that QMF uses.

%------------------------  MASTER APPLICATION MENU  -------------------
%SELECT APPLICATION ===>_OPT     + 
%                                                           +USERID   -
%                                                           +TIME     -
%   1 +SPF        - SPF PROGRAM DEVELOPMENT FACILITY        +TERMINAL -
%   2 +QMF        - QMF QUERY MANAGEMENT FACILITY           +PF KEYS  -
%
%
%
%
%
%
%
%
%
%
%   P +PARMS      - SPECIFY TERMINAL PARAMETERS AND LIST/LOG DEFAULTS
%   X +EXIT       - TERMINATE USING LIST/LOG DEFAULTS
%
+PRESS%END KEY+TO TERMINATE + 
%
)INIT
)PROC
  &SEL = TRANS( TRUNC (&OPT,'.')
                1,'PANEL(ISR@PRIM) NEWAPPL'
                2,'PGM(DSQQMFE) NEWAPPL(DSQE)'
            /*                             */
            /* ADD OTHER APPLICATIONS HERE */
            /*                             */
                P,'PANEL(ISPOPT)'
                X,'EXIT'
              ' ',' '
                *,'?' )
)END