Starting QMF in batch mode in ISPF

You can start QMF in batch mode to potentially save resources and time.

You can start QMF using ISPF with or without using an exec.

• Without an exec:

  ISPSTART PGM(DSQQMFE) NEWAPPL(DSQE) PARM(...DSQSMODE=B,DSQRUN=aa.bbb)

• With an exec:

  ISPSTART CMD(exec_name) NEWAPPL

  where exec_name is the name of the exec that starts QMF

PARM establishes the appropriate operating mode (DSQSMODE=B), identifies the procedure to be run (DSQSRUN=aaa.bb), and can include variables for that procedure.

The ellipsis after PARM represents optional parameter values that the user might want to include in addition to the required values for the DSQSMODE and DSQSRUN parameters. The name of the procedure, as shown in Figure 47, must contain the authorization ID of the owner. For example, assume that a procedure was named PROCA and owned by the user authorization ID, JONES.

ISPSTART PGM(DSQQMFE) NEWAPPL(DSQE) PARM(DSQSMODE=B,DSQSRUN=JONES.PROCA)

After the procedure runs, QMF ends and returns control to ISPF. ISPF can then continue with another procedure or command. On CMS, when ISPF stops, control is returned to the next line in the exec.

Examples of starting QMF under ISPF

The following examples show how to start and pass parameters to QMF under ISPF:

• Starting ISPF from an exec and specifying QMF as the initial dialog:

  ISPSTART PGM(DSQQMFE) NEWAPPL(DSQE) PARM(DSQSIROW=150,DSQSRSTG=0)

  This statement passes a value of 150 for DSQSIROW (number of rows fetched before first display of report), and passes a value of 0 for DSQSRTG (amount of reserved storage).

• Starting from an exec operating within ISPF on CMS:

  ISPEXEC SELECT PGM(DSQQMFE) NEWAPPL(DSQE) PARM(DSQSDCSS=QMF)

  This statement passes the name QMF for the QMF program segment.

• Starting from an ISPF menu:

  )PROC
  
    &SEL = TRANS( TRUNC (&OPT,'.')
                  1,'PGM(DSQQMFE) NEWAPPL(DSQE) PARM(DSQSPILL=NO)'
                  .
                  .
                  .

  This code passes NO for DSQSPILL.

• Starting from an exec and specifying an initial procedure:

  ISPSTART PGM(DSQQMFE) NEWAPPL(DSQE)
  PARM(DSQSRUN=Q.IPROC(&&&&TABLE=Q.STAFF))

  This statement uses the DSQSRUN parameter:

  • To specify an initial procedure, Q.IPROC, to run when QMF starts.
  • To pass a value, Q.STAFF, to the procedure for the variable &TABLE.

    The DSQSRUN parameter as specified in this example results in the following QMF command:

    RUN Q.IPROC(&TABLE=Q.STAFF