2. PERFORMANCE REPORTING ANALYSIS › 2.4 I/O Configuration Analysis › 2.4.7 Tape Drive Simulation Analysis Inquiry › 2.4.7.4 Component Operation › 2.4.7.4.4 USER Modeling Exit Panel
2.4.7.4.4 USER Modeling Exit Panel
This is the only modeling exit that is available in the Tape
Drive Simulation Analysis inquiry. You can use this exit to
select a variety of modeling capabilities whose uses are
described in Section 2.4.7.2. This exit provides a window
into the data after it is obtained either from the original
CA MICS files or from the optional alternate input file(s).
This window occurs before the Tape Drive Simulation Analysis
inquiry begins its analysis or modeling using this data.
/-------------------------------- SAS Statements -------------------------------\
| Command ===> Scroll ===> CSR |
| |
| Inquiry Step: IOA Tape Drive Simulation Analysis |
| |
| Line Cmds: I Insert D Delete R Repeat M Move C Copy |
| |
| Cmd SAS Statements for: Specifying USER exit |
| - ------------------------------------------------------------------------ |
| _ - %MACRO PERUSEL; |
| _ ________________________________________________________________________ |
| _ ________________________________________________________________________ |
| _ ________________________________________________________________________ |
| _ ________________________________________________________________________ |
| _ ________________________________________________________________________ |
| _ ________________________________________________________________________ |
| _ ________________________________________________________________________ |
| _ ________________________________________________________________________ |
| _ ________________________________________________________________________ |
| _ ________________________________________________________________________ |
| _ - %MEND PERUSEL; |
| ****************************** BOTTOM OF DATA ******************************** |
| |
\-------------------------------------------------------------------------------/
Figure 2-153. Tape Drive Simulation Analysis USER Modeling Exit Panel
Because the data elements of the original CA MICS PGM type
files and optionally certain data elements (JOBCLASS,
JOBMCLS, JOBINQTM, and JOBFETTM) from the BATJOB and BAT_TS
Files are available to the exit, it can be used for a wide
range of modifications of this data prior to analysis.
There are two cautions concerning the use of this exit:
o As mentioned in Section 2.4.7.2, the analysis makes use
of only the variables STARTTS, ENDTS, and PGMMXNTA, so
that any modifications to the data must ultimately be
reflected in these three variables.
o Prior to the invocation of the USER modeling exit, the
following data elements are initialized to zero:
- CHGMTTM (Change Mount Time)
- PCTCON2 (Percent Connect 3420)
- PCTCON8 (Percent Connect 3480)
- AVIOTM2 (Average I/O Time, 3420)
- AVIOTM8 (Average I/O Time, 3480)
The setting of any of these data elements in the exit to
to a non-zero quantity may affect the end timestamp of a
step.
Following is a description of the possible uses for each of
these data elements, examples, and the subsequent processing
that occurs for a job. It is important to note that only the
end timestamp of individual steps is affected in any of these
processes. Any adjustments of a job's subsequent steps start
and end timestamps must be implemented by inserting the
appropriate code in the USER modeling exit.
The USER modeling exit takes place after step records from
the PGM type files (BATPGM, BAT_TS, BAT_TP, and BAT_ST) and
JOB type files (BATJOB and BAT_JS) data have been merged in
order to supply the class data element, and after type 30
records have been summarized to the step level. At the point
of invocation, the records are in the following "by"
sequence: JOB, SYSID, and RDRTS (reader timestamp).
Just prior to the merge, the step records are sorted by JOB,
RDRTS, and STEPNUM. Thus observations passing through the
exit are in the following order: JOB, SYSID, RDRTS, and
STEPNUM. Prior to invocation, the Tape Drive Simulation
Analysis inquiry does the following:
RETAIN ADJUSTTM;
IF FIRST.RDRTS THEN ADJUSTTM = 0;
PCTCON2 = 0;
PCTCON8 = 0;
AVIOTM2 = 0;
AVIOTM8 = 0;
CHGMTTM = 0;
ADJUSTTM represents a total job adjustment time factor that
can be used to adjust subsequent steps within the same job.
ADJUSTTM is the sum of all execution time adjustments made to
a job. The other data elements shown above are step
adjustment factors that are used to compute execution time
differences. They are discussed below. ADJUSTTM can be used
to alter the start and end timestamps of a step based on
adjustments to earlier steps before further step adjustment
is made.
/-------------------------------- SAS Statements -------------------------------\
| Command ===> Scroll ===> CSR |
| |
| Inquiry Step: IOA Tape Drive Simulation Analysis |
| |
| Line Cmds: I Insert D Delete R Repeat M Move C Copy |
| |
| Cmd SAS Statements for: Specifying USER exit |
| - ------------------------------------------------------------------------ |
| _ - %MACRO PERUSEL; |
| _ - STARTTS = STARTTS + ADJUSTTM; |
| _ - ENDTS = ENDTS + ADJUSTTM; |
| _ - PCTCON2 = 0.10; |
| _ - %MEND PERUSEL; |
| ****************************** BOTTOM OF DATA ******************************** |
| |
| |
| |
| |
| |
| |
| |
\-------------------------------------------------------------------------------/
Figure 2-154. Tape Drive Simulation Analysis User Modeling Exit Panel Example
Prior to the invocation of the USER modeling exit, the Tape
Drive Simulation Analysis inquiry derives device type (3420
and 3480) totals for tape EXCPs, drives, and connect time by
the subtraction of PGME3480, PGMN3480, and PGMC3480 from the
total tape counters PGMETAPE, PGMMXNTA, and PGMCTAPE, thereby
creating PGME3420, PGMN3420, and PGMC3420. The device-
specific data elements (those with the suffix 3420 or 3480)
are set to zero if missing values are found.
Next, the inquiry checks for non-zero quantities in PCTCON2,
PCTCON8, AVIOTM2, AVIOTM8, and CHGMTTM. When found to be
non-zero, the step adjustment is made to the end timestamp
and the amount of time the step was adjusted is added to the
job ADJUSTTM data element.
The calculations involved in step adjustment are described by
data element below.
PCTCON2/ This decimal value set in the USER modeling exit
PCTCON8: is the multiplier of device specific connect
time. PCTCON2 is the connect time adjustment
factor operating on PGMC3420. PCTCON8 is the
connect time factor for PGMC3480. After the
increase/decrease amount of time is computed,
the end timestamp of the step is decremented by
the original device connect time and the altered
connect time is applied. Specification of
values greater than 1 cause the end timestamp to
increase, while values less than 1 cause a
decrease in the end timestamp. The connect time
for tape drives must be available in the CA MICS
variable PGMCTAPE when using this method.
AVIOTM2/ This factor should be supplied in decimal
AVIOTM8: seconds and is used to compute a connect time
adjustment value that is added to the step end
timestamp. Connect time is only available under
MVS/XA. Thus, percent connect time adjustment
is not possible under MVS/370. Under MVS/370,
code in the USER modeling exit must compute a
connect time value before any adjustment can be
made. An example of this follows:
/-------------------------------- SAS Statements -------------------------------\
| Command ===> Scroll ===> CSR |
| |
| Inquiry Step: IOA Tape Drive Simulation Analysis |
| |
| Line Cmds: I Insert D Delete R Repeat M Move C Copy |
| |
| Cmd SAS Statements for: Specifying USER exit |
| - ------------------------------------------------------------------------ |
| _ - %MACRO PERUSEL; |
| _ - PGMC3480 = PGME3480 * 0.001; |
| _ - PGMC3420 = (PGMETAPE - PGME3480 ) * 0.01; |
| _ - PGMCTAPE = PGMC3480 + PGMC3420; |
| _ - AVIOTM2 = 0.002; |
| _ - %MEND PERUSEL; |
| ****************************** BOTTOM OF DATA ******************************** |
| |
| |
| |
| |
| |
| |
\-------------------------------------------------------------------------------/
Figure 2-155. User Modeling Exit Panel Example Device Connect Time
When AVIOTM2 or AVIOTM8 is a non-zero quantity, the device
connect time is computed based on the number of device type
EXCPs. The original device type connect time is subtracted
from the end timestamp and the adjusted time is added.
AVIOTM2 applies to 3420 devices, while AVIOTM8 applies to
3480 devices.
AVIOTMx and PCTCONx cannot be used for the same step/device
type combinations. A warning message is displayed when this
condition occurs and no step adjustments are made.
The last adjustment factor is CHGMTTM, representing Change
Mount Time. The mount time a step sees is not reported by
the SMF data. An example showing a current mount time
estimate of four minutes being reduced to three minutes is
presented in figure 2-156.
/-------------------------------- SAS Statements -------------------------------\
| Command ===> Scroll ===> CSR |
| |
| Inquiry Step: IOA Tape Drive Simulation Analysis |
| |
| Line Cmds: I Insert D Delete R Repeat M Move C Copy |
| |
| Cmd SAS Statements for: Specifying USER exit |
| - ------------------------------------------------------------------------ |
| _ - %MACRO PERUSEL; |
| _ - CHGMTTM = -60; |
| _ - %MEND PERUSEL; |
| ****************************** BOTTOM OF DATA ******************************** |
| |
| |
| |
| |
| |
| |
| |
| |
\-------------------------------------------------------------------------------/
Figure 2-156. User Modeling Exit Panel Example - Reducing Mount Time
The Tape Drive Simulation Analysis inquiry will add the
nonspecific and specific tape mounts (PGMNSTMT and PGMSTMT),
multiply the result by the specified number of seconds
supplied via CHGMTTM, and add the result to the end
timestamp.
The above data elements: PCTCON2, PCTCON8, AVIOTM2, AVIOTM8,
and CHGMTTM can be selectively applied based on other
criteria (i.e., job, class, performance group, program,
etc.). At the conclusion of all possible step adjustments,
the ADJUSTTM data element is recomputed.
