You can insert a new or existing QMF report into another document.
The USEQMF option allows you to insert a QMF report into another document without leaving your QMF session. You might need to initialize the system environments.
When QMF is not active: You are using XEDIT, PROFS, ISPF-PDF, PS/TSO, or the CMS NOTE facility, and you want to generate a report from QMF and insert it into the document (or note) you are working on. For example, enter from your editor:
GETQMF DCF USEQMF
This causes the GETQMF macro (with the USEQMF option) to start an interactive QMF session. QMF uses a default initial procedure when it starts. When you are in QMF, you have the full interactive capability available to produce your report. After your report is finished, remember to print it using the PRINT REPORT command. QMF issues ISPF messages and does not allow you to leave QMF with the END command until a QMF report is printed. The ISPF messages and associated help panels tell you how to print a report for the document interface and return to your editor.
If you specified a procedure name after USEQMF, it runs as an initial procedure when you start QMF. You must specify an EXIT command in the procedure to end QMF, or you must manually exit from the QMF session. The END command runs the procedure again.
When QMF is active: You are using QMF, and you want to insert a report into a document outside the QMF environment.
While you are still in QMF, access an ISPF-PDF or XEDIT session through the ISPF bridge or with a CMS XEDIT command. Then, edit your target document outside the QMF environment. After you start the editor, prepare it to receive the new report in the proper place in the document. (This procedure is discussed in Information about your editor.)
With QMF active, you must enter a QMF procedure name after the USEQMF option. For example, enter from your editor:
GETQMF DCF USEQMF MYPROC
Where MYPROC is the name of a QMF procedure that runs through the QMF command interface and generates a report. If you want to run a shared procedure that you do not own, specify it as owner.yourproc. You must specify USEQMF to use the procedure. To call the document interface, enter GETQMF. If your procedure printed a report, the report appears in your document. You can save the document and return to QMF.
Your QMF session ends if you use a procedure that issues the EXIT command.
You must use a QMF procedure to produce your QMF report. When you get to your edit session from the QMF document interface, you cannot then produce a query in QMF.
Use FILE if you are using VM and want to insert an existing QMF report. You must follow FILE with the file name, file type, and file mode. For example, enter from your editor:
GETQMF DCF FILE fn ft fm
Where fn ft fm is the name of the filethat contains the chart or report to insert. (If file mode is not specified, it defaults to A1.) Lines in the inserted file might be truncated or wrapped.
You can also create a report interactively and direct it to a file (which becomes an existing report) in one step by including USEQMF before the FILE option:
GETQMF DCF USEQMF FILE fn ft fm
The report is then inserted into your document.
Use DSN if you are using OS/390 and want to insert an existing QMF report. You must follow DSN by the fully-qualified data set name. For example, enter from your editor:
GETQMF ASIS DSN dataset name
Where dataset name is the name of the data set that contains the chart or report to be inserted. Lines in the inserted file might be truncated or wrapped.
You can also create a report interactively and export it to a data set (which becomes an "existing" report) in one step by including USEQMF before the DSN option:
GETQMF ASIS USEQMF DSN dataset name
The report is then inserted into your document.