Phase 4:Activate BMC ThruPut Manager
To activate BMC ThruPut Manager, you IPL the system, start BMC ThruPut Manager, and verify that it is behaving correctly.
8. IPL
8.1. Prepare to IPL
Prior to IPLing, verify three critical load modules are installed correctly:
- The load module DTMJ2SV8 must reside in a linklisted data set. This module must be marked as RENT, REUS, and REFR.
- The load module DTMJ2MV8 must be installed in an APF authorized library that is available to JES2 during initialization.
- The load module DTMPRTN8 must be installed in the same library as the module above (DTMJ2MV8). This module must be marked as RENT, REUS, and REFR. A LOADMOD statement is not required for DTMPRTN8.
Add the BMC ThruPut Manager load module library DTMLINK to the APF and Linklist.
8.2. Perform an IPL and a JES2 warm start.
It is advised to implement the BMC ThruPut Manager JES2 interface by performing an IPL with a JES2 WARM START. If an IPL is not desirable, see Dynamic Activation Options.
If the BMC ThruPut Manager JES2 exits are installed correctly the following sample messages is issued at JES2 startup:
DTM2233I CPU NORMALIZATION INACTIVE
DTM2234I COMMUNICATIONS CHARACTER - /
DTM2235I OPTION JBS INSTALLED, ENABLED
DTM2235I OPTION JCS INSTALLED, ENABLED
DTM2235I OPTION JLS INSTALLED, ENABLED
DTM2235I OPTION MELLON INSTALLED, DISABLED
DTM2235I OPTION DJC INSTALLED, ENABLED
DTM2235I OPTION DCS INSTALLED, ENABLED
DTM2235I OPTION MHS INSTALLED, ENABLED
DTM2235I OPTION NET INSTALLED, DISABLED
DTM2235I OPTION UCS INSTALLED, ENABLED
DTM2235I OPTION DBS INSTALLED, ENABLED BMC AMI Ops Automation for Batch ThruPut and TM AE+ ONLY
DTM2235I OPTION JSS INSTALLED, ENABLED
DTM2235I OPTION JTS INSTALLED, ENABLED
DTM2235I OPTION UHS INSTALLED, ENABLED
DTM2235I OPTION SLM INSTALLED, ENABLED BMC AMI Ops Automation for Batch ThruPut and TM AE+ ONLY
DTM2235I OPTION PCS INSTALLED, ENABLED TM AE+ ONLY
DTM2235I OPTION JES3 INSTALLED, DISABLED
DTM3233I TM CLASS LIST
Analysis..... 9
Deferred..... None
Selectable... All
Exempt....... None
On_Demand.... None BMC AMI Ops Automation for Batch ThruPut and TM AE+ ONLY
PS.......... None BMC AMI Ops Automation for Batch ThruPut and TM AE+ ONLY
General Srvcs None BMC AMI Ops Automation for Batch ThruPut and TM AE+ ONLY
Default...... None
9. Start the BMC ThruPut Manager Started Task
9.1. Start TM Started Task and Review DTM Messages
Subsequent starts of the BMC ThruPut Manager started task result in the following messages:
$HASP100 TM ON STCINRDR
IEF695I START TM WITH JOBNAME TM IS ASSIGNED TO USER TM
, GROUP SYS1
$HASP373 TM STARTED
IEF403I TM - STARTED - TIME=15.11.36
DTM0000I BMC AMI Ops Automation for Batch ThruPut V22.4
TMT81nn (C) COPYRIGHT 2020, 2022 BMC Software, Inc
ALL RIGHTS RESERVED.
DTM0051I SNAME= ssssssssss
CODE=cc
DTM8000I DATA SPACE SERVICES SUBTASK INITIALIZED
DTM8300I DATA COLLECTION SUBTASK INITIALIZED
DTM7261I THRUPUT MANAGER XCF SERVICES SUBTASK INITIALIZATION COMPLETE
DTM0803I THE VOLUME INFORMATION FILE IS filename ON volume
DTM0832I VIF INITIALIZATION COMPLETE
DTM6016I THE CONTROL FILE IS filename ON volume
DTM6602 Initialized DBS: DRIVE BOOKING SERVICES BMC AMI Ops Automation for Batch ThruPut and TM AE+ ONLY
DTM6028I THRUPUT MANAGER IS RECONCILING JES2 member ON JES2 node
DTM7433I NO DBS CONFIGURATION IS CURRENTLY INSTALLED BMC AMI Ops Automation for Batch ThruPut and TM AE+ ONLY
DTM6029I RECONCILIATION OF JES2 member ON JES2 node IS COMPLETE
DTM6200I DATA COLLECTOR READY
DTM7150I The DCS CMF File is on VOLUME volser
Dsname: filename
DTM8139I NO ACTIVE SLM POLICY IN CONTROL FILE BMC AMI Ops Automation for Batch ThruPut and TM AE+ ONLY
DTM0023I TMSS INITIALIZATION COMPLETE
DTM6422I JLS RECONCILE COMPLETE
9.2 Define BMC ThruPut Manager Job Classes
9.2.1 BMC ThruPut Manager Reserved Classes.
BMC ThruPut Manager reserves specific classes as follows;
- Analysis Class - the class in which TM analysis processing occurs. Its default is Class 9.
- Deferred Analysis Class(es) - an optional additional analysis classes that may be activated for other purposes.
- General Services (GS) Class - required for Service Level Manager. BMC AMI Ops Automation for Batch ThruPut and TM AE+ Only.
- Production Control Services (PS) Class - BMC AMI Ops Automation for Batch ThruPut and AE+ Only.
- Default Class - Optional class defined as part of 8-character job classes with z/OS 2.1 and above.
Important
- When dynamic analyzers are not used, use standard JES2 $TI and $SI to DEFINE and ACTIVATE initiators that process these classes. See Section 5: The Job Analyzer Initiators for more details.
- Do not assign JES2/WLM initiators to process these classes. BMC ThruPut Manager will start and stop dynamic initiators to process these classes as required.
Use the TM CLASS SET command to define these specific classes, if required. See Section 2: TM CLASS Command Syntax for complete syntax and details.
9.2.2 BMC ThruPut Manager Selectable Classes
Selectable classes define what work BMC ThruPut Manager should process. With BMC ThruPut Manager 22.4, the initial setting for SELECTABLE classes is ALL, meaning all JES2 job classes will be selected.
Users new to BMC ThruPut Manager may prefer to start with no selectable classes (EXEMPT ALL) and then add them incrementally over time.
- Use TM CLASS DEL(ALL) to remove all classes from BMC ThruPut Manager analysis processing.
- Use TM CLASS ADD(class1,class2..) when you wish to indicate to BMC ThruPut Manager that a particular JES2 job class should be selected for analysis.
9.3. Issue $MJ,START Command
The first time BMC ThruPut Manager is started in a JESplex, job selection will not occur until the class list is:
- verified using TM CLASS DISPLAY
- adjusted using TM CLASS ADD or DEL
- confirmed by issuing $MJ,START
This procedure will only be required once per JESPlex. The “confirmed” indicator and the selection class list are maintained in the JES2 checkpoint so they will need to be re-established and reconfirmed after a JES2 cold-start.
This message is re-issued every 2 minutes if the $MJ,START is not issued.
To start job selection enter $MJ,START after
confirming class definitions with the
TM CLASS ADD or DELETE commands.
See class definition below (DTM3233I).
DTM3233I TM CLASS LIST
Analysis..... 9
Deferred..... D,X
Selectable... All
Exempt....... None
On_Demand.... 3
PS.......... 1
General Srvcs 2
Default...... None
Any jobs that have been submitted prior to the class confirmation via the $MJ command will either display as AW CONVERSION or CONVERTING depending upon how many jobs are submitted.
9.4 Verify BMC ThruPut Manager is Functioning
Issue the following commands to confirm BMC ThruPut Manager is installed and ready for further implementation tasks as expected. Ensure your results are similar to those shown here, and that you can account for any variations.
a. Issue TM D LEVEL command.
a. Issue TM D LEVEL command
DTM6563I TM LEVEL DISPLAY
SYSNAME=SUPP2 JES2 NODE=LONDON SYS=SUP2 BMC AMI Ops Automation for Batch ThruPut
22.4 AT PTF TMT81nn, z/OS Rn.n.0, JES2 z/OS n.n MODE=Z22
APARS APPLIED: TR81nnn
b. Issue TM OPTIONS command
Confirm the correct options are enabled.
DTM6502I TM OPTIONS DISPLAY 483
OPTION STATE STATUS
DBS ENABLED ACTIVE BMC AMI Ops Automation for Batch ThruPut and TM AE+ ONLY
DCS ENABLED ACTIVE
DJC ENABLED ACTIVE
JBS ENABLED ACTIVE
JCS ENABLED ACTIVE
JES3 DISABLED INACTIVE
JLS ENABLED ACTIVE
JSS ENABLED ACTIVE
JTS ENABLED ACTIVE
MELLON DISABLED INACTIVE
MHS ENABLED ACTIVE
NET DISABLED INACTIVE
SLM ENABLED ACTIVE BMC AMI Ops Automation for Batch ThruPut and TM AE+ ONLY
UHS ENABLED ACTIVE
c. Verify the Analyzer Process (recommended for new installations)
Issue TM CLASS command to display settings. Verify your classes have the values you expect.
DTM3233I TM CLASS LIST
Analysis..... 9 analysis class previously defined
Deferred..... D,X if previously defined
Selectable... None
Exempt....... All
On_Demand.... None
PS.......... None
General Srvcs None
Default...... None
Issue TM CLASS ADD(x) to add a Selectable class for testing, for example, Z
DTM3233I TM CLASS LIST
Analysis..... 9
Deferred..... D,X
Selectable... Z
Exempt....... A,B,C,D,E,F,G,H,I,J,K,L,M,N,O,P,Q,R,S,T,U,V,W,X
,Y,0,1,2,3,4,5,6,7,8,9
On_Demand.... None
PS.......... None
General Srvcs None
Default...... None
Ensure a JES2/WLM analyzer initiator is defined and active.
$TI(n), C=9
$SI(n)
Submit a few jobs in class Z.
/*JOBPARM S=*
//*----------------------------------------------------------------*
//* JCL TO CONFIRM REQUEUE TO CLASS Z *
//*----------------------------------------------------------------*
//S1 EXEC PGM=IEFBR14
Delete the selectable class to ensure no additional work is processed by BMC ThruPut Manager until you are ready.
d. Confirm you see DTM1460I message in the system log.
The test jobs should be requeued to same class and priority as submitted:
JOB04489 00000290 IRR010I USERID USERID1 IS ASSIGNED TO THIS JOB.
JOB04489 00000090 DTM1460I JOB BR14 REQUEUED TO CLASS=Z
JOB04489 00000281 ICH70001I USERID1 LAST ACCESS AT 17:52:19 ON MONDAY, MARCH 1
JOB04489 00000090 $HASP373 BR14 STARTED - INIT 2 - CLASS Z - SYS
JOB04489 00000281 IEF403I BR14 - STARTED - TIME=17.55.44
JOB04489 00000090 IEF404I BR14 - ENDED - TIME=17.55.44
JOB04489 00000281 $HASP395 BR14 ENDED
INTERNAL 00000290 SE ‘17.55.46 JOB04489 $HASP165 BR14 ENDED AT LONDON MAXC
LOGON,USER=(USERID1)
e. Confirm you see DTM1459I message in the job log.
The job includes a message indicating it was processed by BMC ThruPut Manager analysis:
J E S 2 J O B L O G -- S Y S T E M S U P 2 -- N O D
17.55.43 JOB04489 ---- MONDAY, 10 MAR 2014 ----
17.55.43 JOB04489 IRR010I USERID USERID1 IS ASSIGNED TO THIS JOB.
17.55.44 JOB04489 ICH70001I USERID1 LAST ACCESS AT 17:52:19 ON MONDAY, MARCH 1
17.55.44 JOB04489 $HASP373 BR14 STARTED - INIT 2 - CLASS Z - SYS
17.55.44 JOB04489 IEF403I BR14 - STARTED - TIME=17.55.44
17.55.44 JOB04489 IEF404I BR14 - ENDED - TIME=17.55.44
17.55.44 JOB04489 $HASP395 BR14 ENDED
------ JES2 JOB STATISTICS ------
10 MAR 2014 JOB EXECUTION DATE
6 CARDS READ
35 SYSOUT PRINT RECORDS
0 SYSOUT PUNCH RECORDS
2 SYSOUT SPOOL KBYTES
0.00 MINUTES EXECUTION TIME
1 //BR14 JOB (RSI),’TEST CLASS Z JOB’,NOTIFY=&SYSUID,CLASS=Z
IEFC653I SUBSTITUTION JCL - (RSI),’TEST CLASS Z JOB’,NOTIFY=USERID1,CL
2 /*JOBPARM S=*
//*--------------------------------------------------------------*
//* JCL TO CONFIRM REQUEUE TO CLASS Z *
//*--------------------------------------------------------------*
3 //S1 EXEC PGM=IEFBR14
DTM1459I 2014.069 17:55:43 JOB BR14 REQUEUED TO CLASS=Z
ICH70001I USERID1 LAST ACCESS AT 17:52:19 ON MONDAY, MARCH 10, 2014
IEF142I BR14 S1 - STEP WAS EXECUTED - COND CODE 0000
IEF373I STEP/S1 /START 2014069.1755
IEF032I STEP/S1 /STOP 2014069.1755
This completes the installation process. Jobs can now be processed by BMC ThruPut Manager. Your technical support person or system programmer is now able to perform tasks such as adding classes for BMC ThruPut Manager processing, adding JAL rules, or using the dialog to set up BMC ThruPut Manager-specific constructs. BMC ThruPut Manager AE+ installations should continue the installation process with details found in the BMC ThruPut Manager AE+ Installation Companion Guide, which is available upon request.