IMAGE ANALYSIS 3.0.0 /*******************************Important Notice*****************************/ /* */ /* NewEra Software is always enhancing and updating its Software Products. */ /* If you are installing from the NewEra Product CD, it is considered best */ /* to contact NewEra Technical Support prior to installation and determine */ /* if a more current release is available. The latest product releases are */ /* always available for download from the NewEra Web Site, www.newera.com. */ /* */ /* NewEra Technical Support, 1.800.421.5035 or support@newera.com */ /* */ /*******************************Important Notice*****************************/ /*=================== What's new in IMAGE Analysis 3.0.0 ===================*/ IMAGE Analysis is a replacement for IMAGE Builder. In this release you will find the following; 1 - Redesigned User Interface 2 - LOADxx Simulation 3 - Access to IMAGE Focus Packages 4 - The IMAGE Editor 5 - Dataset Operations Menu 6 - Report Opertions Menu 7 - Integrated SMTP Mail Client 8 - Member Worksheet /*==========================================================================*/ 0-About this document: This read me file contains information that you will need to know as you plan your installation and use of IMAGE Analysis. Topics Include: 1-About IMAGE Analysis 2-What is IMAGE Analysis and what does it do for you? 3-How you might use IMAGE Analysis to Monitor Volume Usage Patterns 4-Your Inspection Report Inventory - Very Important! 5-Transferring the IMAGE Analysis Application File to your Host 6-Analysis License Authorization 7-Getting Started with IMAGE Analysis 8-Product Documentation, Panel Help and Field Help 1-About IMAGE Analysis IMAGE Analysis is a 'No-Charge' application that NewEra Software, Inc. wants to make available to those using IMAGE Focus. IMAGE Analysis is part of the NewEra IMAGE Management family of products. For more information on NewEra and NewEra Products visit - www.newera.com. 2-What is IMAGE Analysis and what does it do for you? IMAGE Analysis gives you enhanced access to IMAGE Focus Inspection Reports. From an IMAGE Inspection Report, IMAGE Analysis will extract Image Config- uration data and present it as Views or Files. Each Analysis View is fully active in that you can point-and-shoot within a view to select, sort and filter. The Analysis Selection Tool Sets are designed to fit the view giving you access to each Data Element for Image simulation, repair, maintenance or documentation. IMAGE Analysis Views include: Dataset Report View: This view displays the complete content of the IMAGE Focus Data Set Report. The data is presented in an interactive view with selectable sub-views that allow you to isolate specific data sets by Data Set Class including System, LNKLST, LPALST, PROCLIB, JES, VTAM and TCP/IP. Within the view, filtering functions allow you to drill down into specific Volumes or Data Set types including HFS, PDS, SEQ, VSAM, or PDSE. Each data set in the view can be accessed via a Selection Tool Set that supports view, edit, copy, print and more for additional detailed Information. Member Report View: This view displays only Members by Dataset used by z/OS to IPL the named System Image. Again the data is presented in an interactive state. Member name and member suffix are presented in separate columns for analytic convenience. A data set name filter allows for 'Partial Name' filtering so data sets with similar names can be grouped together into a custom view. The Selection Tool Set supports view, edit, copy, print and more for additional detailed information. Inspection Reports List: This view displays a list of available IMAGE Focus Inspection Reports based on the High Level Qualifier detected as the root of the location to be used to store the current report. The Selection Tool Set in this view allows you to select a report from the list, view and print or delete a report. The IMAGE Analysis User Interface also includes Command Line commands. Each command invokes a sub-menu or function designed to analyze or compare the content of a report, build content files for post-processing by app- lications you create, provide user assistance or Backup System Volumes. 3-How you might use IMAGE Analysis to Monitor Volume Usage Patterns Maintaining current Backups of System Volumes and Data Sets they contain is critical. Without a current Backup, it's not possible to restore the system to its current operational state. IMAGE Analysis will assist you in your efforts to create and maintain Volume Backups in two ways. First, IMAGE Analysis automatically builds a list of volumes for each System Sysplex pairing encountered. This Volume List is stored and each time Analysis reads an Inspection Report for the same System Sysplex pairing it will compare System Volumes. Changes in Volume Usage Patterns, if any, will be displayed in a pop-up window when you type 'BACKUP' on the Command Line and press enter. If changes are noted, you will want to consider updating the Job used to Backup System Volumes or updating the Volume List used in monitoring for changes. If changes are not detected, the Backup System Selection Screen is displayed. Second, IMAGE Analysis will assist you in creating a Batch Job that can be used to Backup System Volumes. Support is provided for both DFDSS and FDR. Select a system to display the Backup Tools Menu. Using the available Tool set, you def- ine site standards for Batch Job Cards, Hardware Definitions and Job Outputs. Using these standards Analysis creates a Job to Backup System Volumes. This Job is run in conjuction with your Job Scheduler. Prior to Saving the Job, you use the View and Edit Tools to make any required changes. 4-Your Inspection Report Inventory - Very Important! As you use IMAGE Focus, Inspection Reports accumulate under the HLQ that you define for report storage. IMAGE Analysis reads this accumulated report set each time you provide the HLQ upon entry or enter 'REPORTS' on the Command Line. On average, it will take IMAGE Analysis a second or two to find, read and extract needed information from a report. Once each report is processed, a list of all Inspection Reports is displayed. From this Report List you make report selections. If you have only a few reports in inventory, 25 or so, this processing cycle is no problem but if you have lots and lots of reports in your inventory, the wait for processing will be not be enjoyable. Since you will most likely be working with the most recent reports it is suggested, when possible, that you delete all unwanted older reports from your inventory before you begin. 5-Transfering the Analysis Application and Panels to your Host Note: If you are expanding ANALYSIS.EXE from a CD, first move the ANALYSIS.EXE to your PC Hard Drive. Now expand the ANALYSIS.EXE file. You will then have, on your PC Hard Drive, what you would have gotten had you downloaded from the NewEra Web Site. IMAGE Analysis and its components are available as downloads only. Once you have selected a product and downloaded it to your desktop, you must Self-Extract it and move the INSTALL component to your HOST system for execution. Normally the transfer of INSTALL to your MVS system is done using a TSO File Transfer program. This file transfer is done in BINARY and not the ASCII/EBCDIC format. Before you attempt to move INSTALL to your HOST, you will want to pre-allocate a destination dataset with the correct DCB attributes. a) Pre-allocating the destination dataset on your Host: On the HOST system, the destination dataset must be: RECFM=FB, LRECL=80, BLKSIZE=27920. The dataset will require about 10 CYL on a 3390. b) Transfer the INSTALL file to your MVS system: Normally the transfer of INSTALL to your MVS system is done using a TSO File Transfer program. When transferring the file to MVS, specify BINARY. An example of the Allocate Screen you will use is shown below: +--------------------------------------------------------------------------+ Allocate New Data Set Command ===> Data Set Name . . . : prefix.INSTALL Management class . . . (Blank for default management class) Storage class . . . . (Blank for default storage class) Volume serial . . . . (Blank for system default volume) Device type . . . . . (Generic unit or device address) Data class . . . . . . (Blank for default data class) Space units . . . . . CYLINDER (BLKS, TRKS, CYLS, KB, MB, BYTES or RECORDS) Average record unit (M, K, or U) Primary quantity . . 10 (In above units) Secondary quantity 2 (In above units) Directory blocks . . 0 (Zero for sequential data set) Record format . . . .FB Record length . . . .80 Block size . . . . .27920 Data set name type : (LIBRARY, HFS, PDS, or blank) (YY/MM/DD, YYYY/MM/DD Expiration date . . . YY.DDD, YYYY.DDD in Julian form Enter "/" to select option DDDD for retention period in days Allocate Multiple Volumes or blank) +--------------------------------------------------------------------------+ Where prefix is your TSO Prefix. If you encounter problems during the file download, you should email NewEra Technical Support at: support@newera.com c) The INSTALL job will create a Partitioned DATASET (PDSE), "Prefix.ANALYSIS" and will create a load library "Prefix.ANALYSIS.LOAD". Now that you have the file INSTALLed on your HOST, modify the JOB card, and the PROC statement with your installation specific information. ***************************** Top of Data ****************************** //INSTALL JOB 1,'INSTALL ANALYSIS', <===== MODIFY // CLASS=A, <===== MODIFY // MSGCLASS=A <===== MODIFY //******************************************************************* //* * //* JOB: INSTALL FUNCTION: INSTALL FROM INLINE DATA * //* * //* * //* STEP:LKED LINK EDITS THE LOAD PROGRAM * //* STEP:LOAD VERIFIES JOBSTREAM * //* STEP:IEBUPDTE CREATES THE TEMPLIB USING IEBUPDTE * //* * //******************************************************************* //* //* * //* BLDPRFX - PREFIX FOR ANALYSIS DATASETS * //* DSKUNIT - UNIT NAME FOR ANALYSIS DATASETS * //* DSKVOLU - VOLUME SERIAL NUMBER FOR ANALYSIS DATASETS * //* //* //INSTALL PROC BLDPRFX='prefix.BUILDER', <===== MODIFY PREFIX // DSKUNIT=3390, <===== MODIFY DISK UNIT // DSKVOLU=?????, <===== MODIFY VOL SERIAL // DSTYPE=LIBRARY //* Where BLDPRFX ='prefix' is your TSO prefix.BUILDER. Where DSKUNIT = The disk unit (Example 3390) Where DSKVOLU =????? is the volume serial number of the DASD. Where DSTYPE =LIBRARY is to generate a PDSE. Please note that Analysis will test for your SYSUID (TSO Prefix) and force it as the high-level qualifier to the PDS you select. So when you are all done, the fully qualified name of the application that we are looking for will look like this: prefix.BUILDER(BUILDER) Note that the value of 'prefix' may not exceed two high-level qualifers each of which may not exceed 8 characters. The following could be valid: HLQ00001 or HLQ00001.HLQ00002 d) If for some reason you did not use ANALYSIS and the name of the PDS: If you specify a PDSE name other than ANALYSIS you will need to make a small modification to the Application install file INSTALL. To do this, open the file in EDIT. Beginning on approximately line 199 of the INSTALL file, you will find the following configuration header: / /**********************************************************************/ /* IMAGE ANALYSIS CONFIGURATION PARAMETERS YOU MAY WANT TO MODIFY */ /**********************************************************************/ URFILE = 'BUILDER' /* <==== CHANGE VALUE AS NEEDED */ /* URFILES is the secondary HLQ of a data set used to house the */ /* IMAGE Analysis ReXX EXECT and related ISPF Application Panels */ /**********************************************************************/ /* ONLY IF MULTIPLE USERS WILL SHARE A SINGLE ANALYSIS ReXX EXECT */ /**********************************************************************/ PREFIX = 'TSO_USERID' /* <==== CHANGE VALUE AS NEEDED */ /* PREFIX is the primary HLQ of a data set used to house the IMAGE */ /* Analysis REXX EXEC and related ISPF Application Panels. It is */ /* only used you want want multiple users to share the a Analysis */ /* REXX EXEC and related Panels. If not specified, PREFIX will de- */ /* fault to your TSO USERID. Changing an install from single user */ /* to multi will have no adverse effect on existing user files. */ e) Submitting the INSTALL JOB will create a Partitioned DATASET named Prefix.BUILDER. Now you are ready to submit the INSTALL JOB. Using ISPF option 3.4 specify the file 'INSTALL', then type 'sub' to submit for execution. An example of the submit is shown below. sssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssss DSLIST - Data Sets Matching sysuid.INSTALL Row 1 of 1 Command ===> Scroll ===> PAGE Command - Enter "/" to select action Message Volume --------------------------------------------------------------------------- sub Prefix.INSTALL OS39M1 ***************************** End of Data Set list ************************ f) If you have installed before If you have installed IMAGE Analysis before, you will need to DELETE the PDSE and and the load libraries before you attempt a new install. This will have no effect on the Volume Monitors or other settings. After the JOB has finished, you should verify that the ANALYSIS PDSE and the ANALYSIS.LOAD PDS libraries, in fact, exist. If they do, you're ready to run IMAGE Analysis. If you encounter problems during the file download, you should email NewEra Technical Support at: support@newera.com 6-Analysis License Authorization. If you intend to run IMAGE Analysis outside of IMAGE Focus you will want to get an authorization code from NewEra Technical Support. support@newera.com Once you have the code you may authorize your use of IMAGE in one of two ways. First, during the installation process you can enter the code in the Install- ation Job by overtyping the value of BCODE=. If you plan to also use the IMAGE Tune-Up Workbench, you will need a separate code but both can be entered in a single IMAGE Analysis install. A segment of the Install Job is shown be- low: /****************************************************************************/ /* Authorization Control Card */ /****************************************************************************/ /* IMAGE Analysis application is automatically fully authorized for a 90day */ /* trial. You may change this default authorization by overtyping the value */ /* shown with Authorization Codes provided to you by NewEra Technical */ /* Support. */ /****************************************************************************/ BCODE=BUILDRAUTHCODE Second, if you have already installed, logon to IMAGE Analysis. When the Main Menu is displayed, place an "L" after the Analysis Selection Pointer and press enter. The Analysis License Record for the installation CPU is displayed. Now following the instructions given by Technical Support, update either or all of the Terms, Products or Authorization Code Fields and press enter. You will be asked to confirm the License Update. When you Confirm, the license will be val- idated. If the validation fails, a message will be displayed and you will be placed back in the License Record. Essssssssssssssssss The Analysis License Record - CPU 010F89 ssssssssssssssssssN e e e e e The Product Licensing Variables for the CPU noted above are shown below. e e If you would like to change the Term of your license or the Products to e e which you have access contact NewEra for a New Authorization Code. e e e e support@newera.com - 1.800.421.4035 - 1.408.201.7000 e e e e e e Product License Variables: e e e e Terms == BT Products == 0768 e e e e Authorization Code == 3CDEA875F7F532 e e e e e e Update License Now ==> N e e e e e e e e NewEra Software, Inc. e e Our Job? Help you avoid problems and improve IPL integrity. e DsssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssM 7-Getting Started with IMAGE Analysis a-To run the ANALYSIS using option 6 of ISPF, and using the following command: ex 'prefix.BUILDER(BUILDER)' the following panel will be displayed. Now see included Product Documentation. -------------------------------------------------------------------------------- -------------- Welcome to IMAGE Management by NewEra Software, Inc. ----------- IFB 3.0.0 TUESDAY, 29 APR 2003 Main Menu -------------- IMAGE Analysis, a great way to enhance IMAGE Focus ------------- To continue place the cursor under an Option Name and press enter. Reports - Access Image Inspection Reports Profile - Your IMAGE Analysis User Profile License - Your IMAGE Analysis Product License IMonitor: Stopped NewEra Software, Inc. 3CDEA875F7F532 Our Job? Help you make repairs, avoid problems & improve IPL integrity. -------------------------------------------------------------------------------- b-To run the ANALYSIS as part of your IMAGE Focus Installation: After IMAGE Analysis is installed, you access the application under IMAGE Focus by navigating to the Inspection Workbench. Once in the Workbench, select IMAGE to display the IMAGE Selection Menu. Using the "CA" Selection Command, select any IMAGE from the List. This action will display the "Custom Analysis Selection" Menu. -------------------------------------------------------------------------------- Image Focus - Custom Analysis Selection Row 1 of 8 COMMAND ===> SCROLL ===> PAGE SELECT ONE ITEM BELOW: LINE REPORT REPORT CMD NAME TITLE .. ANALYSIS IMAGE ANALYSIS TOOLS .. ANALYSIS SYSTEM LIBRARY MANAGER ******************************* Bottom of data ******************************** -------------------------------------------------------------------------------- Place an "S" on the Selection Line and press enter to begin processing the sel- ected System/Sysplex Pair. Operating under IMAGE Focus or TSO once a report is selected, IMAGE Analysis immediately begins its analysis of the report, building the IMAGE Inspection Database, and checking the IMAGE Configuration Registry. -------------------------------------------------------------------------------- ----------- IMAGE Analysis Initialization for - P390/ADCDPL ----------- ----------------- System/Sysplex Pair - P390/ADCDPL --------------- >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> 70% Loading the IMAGE Inspection Database Checking Configuration Registry Records:4992 -------------------------------------------------------------------------------- When the Inspection Database is loaded and the Configuration checked, the IMAGE Analysis Tools Menu is displayed. -------------------------------------------------------------------------------- ----------------------- IMAGE Analysis Tools ------------------------- ---------------- System/Sysplex Pair - P390/ADCDPL --------------- Delta > Yes Result > Warn Update > 32days MInBox > Run Builder Volume Repair Dataset Member Package Registry LOADxx New To Continue place the cursor under a Name & press enter. More -------------------------------------------------------------------------------- 8-Product Documentation, Panel, Command and Selection Help a) Product Documentation: IMAGE Analysis Product Documentation can be found in the analysis.doc and analysis.pdf files that were exposed as you self- extracted the download. Note: PDF documents are best viewed in Acrobat 4.0 and above. b) Panel Help: Each Analysis panel, screen or pop-up has an underlying help screen. To reach this Help Screen, press PFK3. To return to the panel, press PFK1. c) Command Line Help: Enter 'CHELP' on the command line and press enter for a menu of commands and their function. Follow the instructions in the panel for additional help. d) Line Selection Help: Each line selection is supported by an underlying Help Screen that displays available selection tools. To reach them, place an 'H' in the field and press enter. Note: Acrobat 4.0 and above required to view PDF documents. /* End Image Analysis readme.txt