Quick Start Tutorial

Chapter 3 contains a tutorial to assist in the quick setup and understand of Q-Xcelerator. Sections contained in Chapter 3 include:

"Overview."

"Running Q-Xcelerator."

"Adding a Subqueue."

"Associating Users and Programs to Subqueues."

"Running the Q-Xcelerator Monitor Job."

Overview

This chapter shows first-time users how to perform basic procedures in Q-Xcelerator:

Run Q-Xcelerator

Define subqueues

Associate sessions and programs with the subqueues

Run the Q-Xcelerator monitor job (QXMONJOB)

Running Q-Xcelerator

To run the Q-Xcelerator program, enter the following command from the MPE prompt:

:RUN QXL.QXL.LPS

The Main Menu will display.

Figure 3.1 Q-Xcelerator Main Menu screen

Adding a Subqueue

To add a new subqueue in Q-Xcelerator:

From the Main Menu , select Queue Definitions (SUBMENU).

Select Add. The Add Queue Definitions screen displays.

Figure 3.2 Q-Xcelerator Add Queue Definitions screen (example)

Specify the following parameters for the new subqueue:

Queue Name

A user-defined, 16-character, alphanumeric name (required).

MPE Queue

The standard MPE subqueue in which the new, user-defined subqueue will reside (required). Valid inputs are:

L for BS (linear) subqueue (100-150)

C for CS subqueue (152-200)

D for DS subqueue (202-238)

E for ES subqueue (240-253)

For information about MPE subqueues, see "Standard MPE Subqueues".

Base Priority

The three-digit subqueue priority at which jobs in the subqueue will begin. Q-Xcelerator will verify that this value falls within the current MPE Queue priority range specified in the previous step. If the Base Priority value exceeds the user-specified range, Q- Xcelerator will issue an error message and suggest a proper value.

Limit Priority

The lowest priority (largest three-digit priority number) to which jobs in the queue will decay.

If the new subqueue definition appears correct, reply to the Add Record (Y) prompt by entering Y (Yes). If it does not appear as desired, reply N (No).

Changing a Subqueue Definition

To change a previously defined subqueue:

From the Main Menu, select Queue Definitions (SUBMENU).

Select Change. The Change Queue Definitions screen displays.

Figure 3.3 Q-Xcelerator Change Queue Definitions screen (example)

Type the exact name of the subqueue. Information about that subqueue is displayed.

Change one or more of the subqueue parameters.

To save changes to the record, enter Y (Yes). If you decide to keep the original definition, reply N (No).

Deleting a Subqueue Definition

To delete a previously defined subqueue:

From the Main Menu , select Queue Definitions (SUBMENU).

Select Delete. The Delete Queue Definitions screen displays.

Figure 3.4 Q-Xcelerator Delete Queue Definitions screen (example)

Type the exact name of the subqueue. Information about that subqueue is displayed.

Enter Y (Yes) to delete the record from memory. If you decide to keep the definition, reply N (No).

Showing a Subqueue Definition

To show a list of all subqueue definitions:

From the Main Menu , select Queue Definitions (SUBMENU).

Select Show. The Queue List screen displays (Figure 3.5).

Figure 3.5 Q-Xcelerator Queue List screen

To return to the Queue Definitions screen, press any key.

To return to the Main Menu, select Exit Submenu. Save changes, if desired.

NOTE Although a subqueue definition can be added, changed, or deleted at any time, the modification will not become effective until the subqueue definitions are actually reloaded by manually selecting the Reload option in the Maintain Control Information submenu of Q-Xcelerator ("Reload Definitions"). Note also that the QXMON program (from QXMONJOB) must be running in order to use the Reload option.

Associating Users and Programs to Subqueues

Once a user-defined subqueue is established, the next step is to associate the desired sessions and programs with that subqueue.

To assign sessions and programs to a subqueue:

From the Main Menu , select User/Program Definitions (SUBMENU).

Figure 3.6 Q-Xcelerator User/Program Definitions Submenu screen

The User/Program Definitions screen will display the following options:

Add creates a user/program definition for a previously defined subqueue.

Change modifies an existing definition. The assignment number of all user/program definitions is required. Use the Show option to get a list of those assignment numbers.

Delete removes an existing definition. The assignment number is required.

Show displays all of the assignment number definitions.

Ignore causes the Q-Xcelerator monitor job to ignore this user/program definition without actually deleting the record from memory.

Recognize is the converse of the Ignore option.

Exit leaves the User/Program Definitions submenu.

Select Add. Reply to the series of prompts:

Queue Name

The 16-character, alphanumeric name defined in the Queue Definitions submenu (see "Queue Name").

Adjust Jobs, Sessions, or Both

Limits the definition to jobs, sessions, or both. Valid inputs are J (jobs), S (sessions), or B (both). The default value is S.

Logon ID

A field used to specify the logon ID. The format is: Session, User.Account, Group. In this format, User.Account is required. The default setting is @.@ (i.e., all user.accounts).

Programs

A field that specifies a program, group, and account (where the program name resided when the process was created). The format is: Program name.Group.Account. The default setting is @.@.@ (i.e., all programs on all groups under all accounts.

LDEV

A numeric field that stipulates that the process must be associated with this logical device number. A value of zero (the default) means that all logical devices qualify.

Reset percent

A numeric field with valid values from 1 through 100. If the Reset percentage is set to 0 or 100, then when a process is adjusted by the monitoring job, it will be put to the base value specified its corresponding subqueue definition. Any other valid value for the Reset percentage will cause the monitoring job to adjust the process priority by this percentage relative to its base and limit values specified in its corresponding subqueue definition.

NOTE Entering a value of 0 (zero) is the same as selecting "decay" via the MPE TUNE command. A value of 100 is the same as "oscillate." Any other valid value is equivalent to "oscillate" at a percentage.

Valid Days

A character string that specifies to which particular days of the week this User/Program definition will apply.

ALL (all days of the week)

MO (Monday)

TU (Tuesday)

WE (Wednesday)

TH (Thursday)

FR (Friday)

SA (Saturday)

SU (Sunday)

Values other than ALL must be separated by a space. Any combination of days will cause a process to be adjusted by the monitoring job only on the specified days. The default value of ALL will cause a process to always be adjusted by the monitoring job, seven days a week.

From

A numeric field for time with valid values from 0 through 2359. It stipulates that the current time of day must be equal to or greater than this value in order for a process to be adjusted by the monitoring job. A value of 0 is equivalent to 12:00 AM, and will therefore cause a process to always qualify for the monitoring job if the To time setting is also zero.

To

A numeric field for time with valid values from 0 through 2359. It stipulates that the current time of day must be equal to or less than this value in order for a process to be adjusted by the monitoring job. A value of 0 is equivalent to 00:00 AM, and will therefore cause a process to always qualify for the monitoring job if the From time setting is also zero.

Bump Queue

Specifies by queue name which queue definition to bump a process to, once the total CPU milliseconds used for that process exceeds the user-defined Bump threshold.

Bump Threshold

Specifies the total CPU time in milliseconds that must pass before a process is bumped to the Bump Queue. (This Bump Threshold prompt only displays when a Bump Queue value is entered in the previous prompt.)

To confirm the User/Program Definition, reply Y (Yes). To clear the settings, reply N (No).

Running the Q-Xcelerator Monitor Job

To run the Q-Xcelerator monitor job, QXMONJOB:

From the Main Menu, select Maintain Control Information (SUBMENU).

Select Launch Monitor Job.

For information about the control options, see "Global Controls".