Tutorial: Automating selection of IMS logs
This tutorial shows you how to define an IMS system to Transaction Analysis Workbench, and then use that system definition to locate the related IMS log files (SLDS or OLDS) for a particular time interval.
Before you begin
- The Transaction Analysis Workbench automated file selection utility uses the IMS database recovery (DBRC) API to read RECON data sets. IMS (or at least, the IMS RESLIB library, containing the DBRC API code) must be installed on the system where you want to run the utility.
- Determine the time interval (the
from
andto
dates and times) of the IMS logs that you want to analyze. - Obtain the following details about the IMS system that created the logs. If you already
have an IMS system definition
that specifies these details (for example, your IMS system definition repository is an existing IMS Performance Analyzer profile library), skip
to step 7.
- IMS subsystem identifier (IMSID)
- IMS version
- RESLIB data set name
- Either of the following details:
- Two or three IMS RECON data set names
- Data set name of an MVS dynamic allocation (MDA) library (containing RECONn members that refer to the RECON data set names)
If you do not know these details, contact your IMS system administrator.
Procedure
- On the Transaction Analysis Workbench Primary
Option Menu, select
option 3
Systems.
The System Definitions Menu is displayed.
- Check the name of the data set for the IMS system definition repository. This is where Transaction Analysis Workbench will store the system definition that you are about to create. For this tutorial, you might choose to use a private data set rather than a data set that is shared with others.
- Select IMS.
If the repository does not yet exist, a Define Repository Data Set panel is displayed; press Enter to create the repository.
Figure 1. Panel: System Definitions Menu File Help ──────────────────────────────────────────────────────────────────────── System Definitions Menu Command ===> Select the type of system then press Enter. Systems: Groups of Systems: 1 1. IMS 6. IMS systems (IMSplexes) 2. CICS 7. CICS, DB2 and related 3. DB2 4. MQ 5. MVS Image System definition repositories: IMS . . . . . . . . FUW.ISYSDEFS + CICS, DB2, more . . FUW.CSYSDEFS +The System Definitions panel is displayed. This panel lists any existing IMS and IMS Connect system definitions in the repository.
- Enter NEW on the command line.
Figure 2. Panel: System Definitions (IMS and IMS Connect) File Menu Edit Help ────────────────────────────────────────────────────────────────────────────── System Definitions Row 1 of 1 More: < > Command ===> new Scroll ===> PAGE Specify IMS and Connect systems. / System Type VRM + Description IADJ IMS 156 IMS demonstration system ******************************* Bottom of data ********************************The IMS Subsystem panel is displayed.
- Enter the details that you have obtained for the IMS system:
- In the fields at the top of the panel, specify the following
details:
- IMS subsystem ID
- IMS version
- A description of the IMS subsystem (this description is used only for selection lists in the dialog)
- RESLIB data set name
- Select the DBRC Settings view.
- Specify either of the following details:
- Two or three IMS RECON data set names
- Data set name of an MVS dynamic allocation (MDA) library (containing RECONn members that refer to the RECON data set names)
Note:- If the RECON data sets that you want to use belong to a running
IMSplex:
- Specify the IMSplex name.
- The structured call interface (SCI) address space must be running on the system on which you want to run the automated file selection utility.
- If the RECON data sets are used by more than one IMSplex, also specify the DBRC sharing group ID.
This step assumes that you want to use cataloged, primary system log data sets (SLDS). If the SLDS are uncataloged, if you want to use secondary SLDS, or if you want to use online log data sets (OLDS) instead of SLDS, see the online help by pressing the Help function key (F1) on the related options.
Figure 3. Panel: IMS Subsystem: definition with DBRC settings for automated file selection File Menu Help ────────────────────────────────────────────────────────────────────────────── IMS Subsystem More: < > Command ===> IMS Subsystem definition: IMS Subsystem ID . . . . IADJ IMS Version (VRM) . . . 156 + Description . . . . . . . DC system RESLIB Data Set . . . . . 'IMS.SDFSRESL' ------------------------------------------------------------------------------ Specify required view . . 1 1. DBRC Settings 4. Groups 2. Log Files 5. OMEGAMON TRF Files 3. Monitor Files 6. OMEGAMON ATF Journals ------------------------------------------------------------------------------ Specify DBRC Settings for automated log file selection: DBRC Subsystem ID . . . (Specify RSENAME for XRF) DBRC IMSplex name . . . (RECON Loss Notification) DBRC Sharing Group ID . (Parallel RECON Access) RECON Data Set 1 . . . 'IADJ.RECON1' 2 . . . 'IADJ.RECON2' 3 . . . 'IADJ.RECON3' MDA Data Set . . . . . Enter "/" to select option JES2 options: Log Data Sets are Cataloged (DBRC) Node . . SYSAFF . . Use OLDS that are not Archived (SLDS) Node . . SYSAFF . . Use Secondary Log Data Sets - In the fields at the top of the panel, specify the following
details:
- Press the Exit function
key (F3) to
exit the IMS Subsystem panel. Press the Exit function
key (F3) repeatedly until you
return to the Transaction Analysis Workbench Primary
Option Menu.
The following steps use the IMS system definition that you have just created to automate selection of the related log files for a particular time interval, and then add those selected files to a problem session.
- On the primary option menu, select option 1 Sessions.
- On the command line of the Session Manager panel, enter NEW to create a new session.
- On the Problem Details panel for the
new session, specify the following details:
- A summary (for example, IMS log selection)
- The from and to dates and times of the period when the problem occurred
- The IMS system that you have just defined
Figure 4. Panel: Session Details: session that refers to an IMS system File Help ────────────────────────────────────────────────────────────────────────────── Session Details Row 1 to 1 of 1 Command ===> Scroll ===> PAGE Key . . . . : 00000001 Description . IMS log file selection Severity . . Reference . . ── When problem occurred ─── Reported by . YYYY-MM-DD HH.MM.SS.TH Assigned to . From 2010-01-28 05.00.00.00 Status . . . OPEN To 2010-01-28 06.00.00.00 Template . . + Zone LOCAL Systems involved: / System + Type + IADJ IMS ******************************* Bottom of data ******************************** - Press the Exit function
key (F3) to
save the new session. The session menu is displayed.
- Select option 3 Files.
- On the Locate and Manage Log Files panel,
run automated file selection:
- Enter AUTO on the command line.
The Automated File Selection window opens.
- Specify the IMS system that you defined previously.
By default, automated file selection spans the same date and time interval as the session; however, you can override these default values.
Figure 5. Panel: Automated IMS log file selection File Help ─────────────────────────────────────────────────────────────── Automated File Selection Command ===> Specify system and time range. Automated File System: ── Locate Files Interval ── System Name . . . IADJ + YYYY-MM-DD HH.MM.SS.TH System Type . . . IMS + From 2010-01-28 05.00.00.00 File Type . . . . LOG + To 2010-01-28 06.00.00.00 - Press Enter to generate the JCL for the automated file
selection. The JCL is displayed in a Notepad (ISPF edit) panel.
- Submit the job: enter SUB on the command line.
- Enter AUTO on the command line.
- Press the Exit function key (F3) to exit the Notepad panel and return to the Locate and Manage Log Files panel.
- When the job is complete, enter REFRESH on
the command line to refresh the list of log files and to see any files
added by the job.
You can now browse these log files, or use them to generate batch reports or extracts.
Figure 6. Panel: IMS log files located by automated file selection File Help ────────────────────────────────────────────────────────────────────────────── Locate and Manage Log Files Command ===> Scroll ===> PAGE NEW Insert a new log file. AUTO Run automated file selection to locate log files. Log Files: ──── System ──── File / Exc Data Set Name Name Type Type IADJ.SLDSP.IMSLOG.G0106V00 IADJ IMS LOG IADJ.SLDSP.IMSLOG.G0107V00 IADJ IMS LOG IADJ.SLDSP.IMSLOG.G0108V00 IADJ IMS LOG IADJ.SLDSP.IMSLOG.G0109V00 IADJ IMS LOG IADJ.SLDSP.IMSLOG.G0110V00 IADJ IMS LOG