Reports

Chapter 6 contains instructions for how to run reports in Q-Xcelerator. Sections contained in Chapter 6 include:

"Overview."

"Generating a Q-Xcelerator Configuration Report."

"Streaming the Q-Xcelerator Log Reporter in Batch."

"Generating a Q-Xcelerator Log Report."

Overview

Q-Xcelerator generates two types of reports:

Q-Xcelerator Configuration Report

Q-Xcelerator Log File Report

Both reports are generated by batch programs that are launched interactively from the Q- Xcelerator Report Menu screen.

Generating a Q-Xcelerator Configuration Report

To generate a Q-Xcelerator Configuration Report:

From the Main Menu, select Report Menu (SUBMENU).

Select Generate Configuration Report.

By default, the Q-Xcelerator Configuration report is saved to the $STDLIST as QXLCNFIG. To change the location of the output file, follow the procedure outlined in "Setting the Output File".

An example Q-Xcelerator Configuration Report is shown in Figure 6.1.

Figure 6.1 Q-Xcelerator Configuration Report File (example)

Control Information

The first section of the Configuration Report, Control Information, shows the current value of the monitor scan delay.

Queue List

The second section of the Configuration Report, Queue List, lists one line of information for each queue defined:

Queue Number

Queue Name

MPE Queue Base

MPE Queue Limit

Queue Assignment List

The Queue Assignment List provides two lines of information for each pre-defined queue assignment. The first line shows:

Assignment Number

Queue Name

Group ID

Logical Device Number

Level ("L")

Reset Percentage

Job Flag ("J")

Sessions Y/N Flag ("S")

Ignore Flag ("I")

From/To Time

Valid Days.

The second line shows the Logon ID and Programs for the assignment.

Setting the Lines per Page

To specify the number of lines on the Q-Xcelerator Configuration Report output file before a page break occurs:

From the Main Menu, select Report Menu (SUBMENU).

Select Set Lines per Page.

Enter a value. The default is 60 lines per page.

Setting the Output File

By default, the Q-Xcelerator Configuration report is saved to the $STDLIST as QXLCNFIG. To designate a different output file:

From the Main Menu, select Report Menu (SUBMENU).

Select Set Output File.

Type a name for the output file. The name should be eight characters or less, beginning with an alphabet character, not a number.

The new output file will be save to the logon group.

Streaming the Q-Xcelerator Log Reporter in Batch

The Q-Xcelerator Log Report is a record of changes that Q-Xcelerator makes to processes run during the reporting period. The report may be run as a batch job using the job stream provided with Q-Xcelerator. This job stream file will first need to be edited to set the various reporting options desired within the job stream, itself.

To stream the Q-Xcelerator Log File Reporter job:

From the Main Menu, select Report Menu (SUBMENU).

Select Generate Log Report.

At the prompt, "Stream QXL job (Y)?", reply Y (Yes).

The screen will show the Job numberand confirm that the job is launched.

Figure 6.2 Q-Xcelerator Log File Reporter job (example)

Generating a Q-Xcelerator Log Report

To generate an online Q-Xcelerator Log Report:

From the Main Menu, select Report Menu (SUBMENU).

Select Generate Log Report.

At the prompt, "Stream QXL job (Y)?", reply N (No). In a brief moment, the initial screen of the Q-Xcelerator Log File Reporter program will display.

Figure 6.3 Q-Xcelerator Log File Reporter program configuration screen (example)

Reply to a series of prompts to configure the report file:

Generate detail report (Y/N)

Generate summary report (Y/N)

Enter beginning date (00/00/00)

Enter beginning time (00:00)

Enter ending date (today’s date)

Enter ending time (23:59)

Enter up to six of the previous items to use as sort items, separated by commas and listed in major to minor order.

Enter up to ten of the previous items to report in addition to the sort items specified. (This prompt is available only when a report summary is requested at the second prompt.)

The program will generate the report and send it to the printer or print spooler.