Using QMF

Accessing QMF from a VM editor

The following examples issue the GETQMF macro from:

• XEDIT, the CMS NOTE facility, or PROFS
• XEDIT, PROFS, or ISPF-PDF
• XEDIT
• A PROFS NOTE screen
• A PROFS Document
• ISPF-PDF

Example 1--From XEDIT, the CMS NOTE facility, or PROFS: The existing QMF report file XX MYREPORT A1 is inserted as is. Use the FILE option to specify the name of the CMS file that contains the QMF report. The insertion occurs without a QMF session.

1. In XEDIT, position your document to insert the QMF report in the proper place (see Information about your editor.)
2. Enter the GETQMF macro on the command line.

   GETQMF ASIS FILE XX MYREPORT
   

   The report named XX MYREPORT A1 is inserted directly into the document you are working on, just after the current line. You get a message that indicates that the report is inserted.

Example 2--From XEDIT, PROFS, or ISPF-PDF: The existing QMF report named XX MYREPORT A1 is inserted into your document as is. (ASIS is the default.) The procedure is the same as in Example 1:

GETQMF FILE XX MYREPORT

Example 3--From XEDIT: This example inserts a new report into your document and shows the minimum abbreviation of the USEQMF option.

1. In XEDIT, position your document to insert the QMF report after the current line (see XEDIT).
2. Enter the GETQMF macro:

   GETQMF U
   

   (U is the minimum abbreviation for the USEQMF option.)

   Your screen is blank for a few minutes while the macro runs.

3. When the QMF Home panel appears with a document interface message, produce a report as you normally would in QMF.
4. Alter the form of the report if you want.
5. Display the report to check it.
6. Enter PRINT REPORT.
7. Enter END or EXIT to exit QMF.

   The report is inserted into your document, and you return to XEDIT where you were before you issued the GETQMF macro.

If you type EXIT on the QMF command line without printing a report, you return to XEDIT. An error message appears, and no report is inserted.

Example 4--From a PROFS NOTE screen: This example inserts the report directly into a CMS file. You do not see any QMF status panels, and you are not aware that the insertion occurred until a message appears in PROFS.

1. From a document in PROFS NOTE, press PA2 to interrupt PROFS.
2. From the PROFS interrupt screen that appears, enter the following:

   GETQMF PROFS USEQMF MYPROC2
   

   Your screen is blank for a few minutes while MYPROC2 runs the query, prints the report, and exits QMF.

   A message in PROFS indicates the QMF report has been printed to QMF REPORT A1.

3. Press the function key that returns you to the PROFS NOTE screen.
4. Position the cursor to receive the new report after the current line.
5. Enter .GF QMF REPORT

   The QMF report is inserted into the PROFS note.

Example 5--From a PROFS document: This example produces a QMF report to insert into the text part of a PROFS document.

1. Position your document to insert the QMF report after the current line.
2. Enter the GETQMF macro on the command line in the edit session:

   GETQMF PROFS USEQMF
   

   The QMF Home panel appears.

3. Produce the report in QMF as usual.
4. Print the report by using the QMF PRINT REPORT command.
5. Enter END or EXIT to exit QMF.

   The report is inserted into your document (with SCRIPT/VS control words), and you are back in PROFS.

Example 6--From ISPF-PDF: The USEQMF option specifies that QMF is used to produce a report during the edit session. The named procedure MYPROC runs to produce the report.

1. From a document in ISPF-PDF, insert a prefix command A (after) or B (before) to receive the report at the proper place (see ISPF-PDF).
2. Enter the GETQMF macro:

   GETQMF DCF USEQMF MYPROC
   

   Your screen is blank for a few minutes while MYPROC creates and prints a report.

3. When the QMF object panel appears, enter EXIT to exit QMF.

   The report is inserted into your document (with SCRIPT/VS control words) when QMF ends.

   Use EXIT to leave QMF; the END command runs the initial procedure again.