IMAGE Focus 4.6 Patch 28 /*******************************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 to 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*****************************/ If you are expanding IFG.EXE from a CD, first move the IFG.EXE to your PC Hard Drive, then expand the IFG.EXE file. /*============= What's new in IMAGE Focus 4.6 Patch 28 =====================*/ 1. - OPSYS Simulated start of Resolver address space is now done with SUB=MSTR instead of using the primary subsystem. Resolver JCL checking, if any, will now occur after processing the BPXPRMxx member(s) instead of after processing JES2/3. 2. - JES3 level 1 keywords that do not have any parameters now do not get flagged as an error (e.g. NJECONS). 3. - JES3 DEVICE JUNIT and XUNIT statements that extend beyond one line. Corrected . /*=========================================================================*/ /*============================== IMPORTANT NOTICE =========================*/ If you are planning to upgrade to this release of IMAGE Focus it is necessary that each IMAGE Focus user Migrate their individual settings. To do this each user must EXPORT their current settings and them IMPORT them. This is accomp- lished by selecting Definitions & Settings from the Main Menu and then the Migrate Option on the panel that follows. Once in the Migrate Options Panel each user must Export ALL of their settings (since this is the default just press enter) and then Import ALL of their settings (just press enter). These actions will save your current settings and reimport them into IMAGE Focus using the new panels and options found in this new release. /*=========================================================================*/ -About this document: Users upgrading from prior releases to IMAGE FOCUS 4.6 ----------------------------------------------------------------------- If you are upgrading to IMAGE Focus 4.6 from a prior release you will need to reinstall IMAGE Focus. In addition, if you are not currently at IMAGE Focus Release 3.5 or greater, you will also need to receive new License Authorization Code(s). To receive new License Authorization Codes, you will need to provide NewEra Technical Support with the CPU MODEL and SERIAL NUMBER(s) of the CPU(s) on which you plan to install IMAGE Focus. NewEra Technical Support can be reached by phone at 408-201-7000 and by e-mail at support@newera.com. Downloading IMAGE Focus Release 4.6 from the NewEra Homepage: If you would like to download a copy of IF46 and the User's Guide you may do so by accessing the NewEra Homepage on the Worldwide Web at http://www.newera.com. Follow the link beginning with "REQUEST PRODUCT UPDATE". To reach the download area you will be prompted for "Required Information". Please make your entries as complete as possible. You may also use the Email interface or Form functions built into the Homepage. Your system will then prompt you for the path and file name under which to store the download file. Once this information is supplied the download of IF46 will begin. Total download time will be approximately 5 minutes. What you get in a download: You will receive a single self-extracting file named ifg.exe. When you execute the downloaded file on your PC, it will expand into six files labeled: ifo_46_read_me.txt, image_focus_46.doc image_focus_46.pdf, messages_image_focus_46.doc , message_image_focus_46.pdf and ifo46p28.bin. The ifo_46_read_me.txt file contains instructions on how to move the ifo46p28.bin to your MVS Host, but you can review these in the next section. If you want an extra copy of the User's Guide print it using Microsoft Word or any other word processor. In addition there is a PDF version of the User's Guide. You will need to move the ifo46p28.bin to your Host MVS system as part of the actual installation of IF46. How to use the download: Once the download is complete you will have received a single file named ifg.exe. Expanding this file will produce the ifo46p28.bin. You move ifo46p28.bin to your MVS Host using the following instructions: First, you will need to allocate a sequential dataset to receive the file where your.dsn is the name of a dataset you create for the temporary storage of ifo46p28.bin on your host and vol is the volume serial number of the DASD volume this dataset will be located on. An example follows: //ALLOC JOB ...... // EXEC PGM=IEFBR14 //FILE DD DSN=your.dsn,DISP=(,CATLG),VOL=SER=vol, // UNIT=unit,SPACE=(CYL,(20,1)),LRECL=80,RECFM=FB, // BLKSIZE=6160 //SYSPRINT DD DUMMY Second, transfer the file from the PC to the newly created dataset on your MVS Host with a file transfer program. If you are using TSO SEND/RECEIVE you would specify: SEND c:\ifo46p28.bin x:'your.dsn' Third, you will now need to edit the information contained in the dataset. Note that the resulting JCL will be just like that which appears in section (7.0) of this User's Guide with the exception that the TAPUNIT and TAPVOLU do not exist. Fourth, you are now ready to continue the IF46 installation as described in Section 7.0 of the ifo46.doc. When the installation is complete you may delete the ifo46p28.bin as it is no longer needed. IF46 Contains the following Major Enhancements: IMAGE Focus 4.6 is the foundation upon which all future releases of IMAGE Focus will be based. All Users are encouraged to migrate to 4.6 as soon as possible to take advantage of currently available and planned enhancements. Specifically in IFO 4.6 users will find the following: 1. User Interface The User Interface has been streamlined by grouping product functions into operational "VIEWS". 2. Evaluation Use All prospective users evaluating IMAGE Focus for acquisition will now be provided with a Temporary Authorization when requested from NewEra Technical Support. 3. IFOR Recovery A new application IFOR has been added to specifically support Standalone or Recovery use. 4. Documentation Product documentation has been revised to support the various interface and functional changes. This includes a separate document "IMAGE Focus Messages" that details, to the extent possible, the content and meaning of each message. 5. Status Monitors In support of the need for continual operation of the IMAGE Focus Background Task, IFOBG, and Recovery Task, IFOR, the following new functions have been added: 6. Background Task It is strongly recommended that the IMAGE Focus Background (IFOBG) be run on a continual basis. In order to provide assurance as to the integrity of IFOBG and its various required settings, the Background Status Monitor has been added. In addition, the operational status of IFOBG is displayed each time the IMAGE Focus Main Menu is accessed. 7. IFOR Recovery It is strongly recommended that the IMAGE Focus Recovery application IFOR be started with each IPL and be made continually available to assist in the event of a subsystem failure. In support of this, the operational status of IFOR is displayed each time the IMAGE Focus Main Menu is accessed. IF46 Patch 28 addresses the following items: 01/13/2004 7:30 AM 1. - OPSYS Simulated start of Resolver address space is now done with SUB=MSTR instead of using the primary subsystem. Resolver JCL checking, if any, will now occur after processing the BPXPRMxx member(s) instead of after processing JES2/3. 2. - JES3 level 1 keywords that do not have any parameters now do not get flagged as an error (e.g. NJECONS). 3. - JES3 DEVICE JUNIT and XUNIT statements that extend beyond one line. Corrected . IF46 Patch 27 addresses the following items: 12/16/2003 8:00 AM 1. - OPSYS System Symbol processing has been changed to limit the number of symbols based on storage instead of the count. A new message has been to the Static System Symbols section the report: IFO0636I xxx OUT OF A TOTAL OF xxx BYTES OF STATIC SYSTEM SYMBOL STORAGE WERE USED. 2. - OPSYS If the storage used for saving page datasets names exceeded 256 bytes then message IFO0624E REQUIRED IEASYSXX KEYWORD PAGE WAS NOT SPECIFIED would be issued erroneously. This has been corrected. 3. - OPSYS The Auto Discovery feature has been changed to always set the LOADPARM IMSI prompt character to a “.” so that no prompting will be done on the panel for system or catalog parameter values. The user is free to change the value after discovery. 4. - OPSYS A problem with system symbols in IEAOPTxx members has been corrected. 5. - VTAM Added tolerance support for NCP_BUILD_CA. IF46 Patch 26 addresses the following item: 11/20/2003 9:30 AM 1. JES3 - Tolerate JES3 Primary keywords specified without any sub-parameters. IF46 Patch 25 addresses the following items: 11/17/2003 11:30 AM 1. OPSYS - IFO0779E JCL CONVERTER FAILURE on a DD statement with VOL=REF=*.ddname. 2. JES2 - JES0162E INVALID OPERATOR FOR KEYWORD 'TRA' FOUND when TRACE= specified on a NODE definition. 3. TCPIP - Symbolic values found in INCLUDE Datasets not resolved prior to passing the Dataset name to IMAGE Focus. This has been addressed. 4. TCPIP - Certain statements found within the INTERNALCLIENTPARMS Block were not syntax checked. This has been addressed. 5. TCPIP - Symbolic values found in INCLUDE statement syntax checking resolved only to running system. This has been addressed. 6. TCPIP - The inspection of the statement BEGINROUTES. This problem is caused by the unique way in which the subnet mask is coded as values within each of the ROUTE keywords. Available documentation from IBM indicates that there should NOT BE a space or blank between the IP address and the subnet mask. The Profile TCPIP Inspector has been enhanced to accept the noted blank. 7. TCPIP - The inspection of the statement SACONFIG. This problem resulted in UNINSPECTED lines. The Profile TCPIP Inspector has been enhanced to provided the required inspections. IF46 Patch 24 addresses the following item: 11/04/2003 7:30 AM 1. OPSYS - Support for new syntax of SEND LOGNAME for IKJTSOxx due to changes in the IBM Init & Tuning reference for z/OS V1R3 and V1R4. IF46 Patch 23 addresses the folowing item: 10/27/2003 10:00 AM 1. OPSYS - The volume serial number field in the IFO parmlib member NSEDSN00 may now be a system symbolic. The symbol is limited to 6-characters so do not put a period at the end of the symbol. IF46 Patch 22 addresses the following items: 10/16/2003 11:00 AM 1. OPSYS - Catalog DSN added to IFO0781N message. 2. OPSYS - A catalog entry with many associations could result in an abend or ‘dataset not found’. This has been fixed. 3. TCPIP - Corrected syntax for z/OS V1R4 inspection level. IF46 Patch 21 addresses the following item: 10/06/2003 8:00 AM 1. OPSYS - Invalid syntax error in SMFPRMxx. 2. OPSYS - Allow VIO( ) in IKJTSOxx. 3. OPSYS - Remove duplicate listing of SMFPRMxx in report. IF46 Patch 20 addressees the following item: 09/17/2003 4:00 PM 1. OPSYS - The Background task may, in some cases, store a new package even if the package did not change. The compare routine has been corrected. IF46 Patch 19 addresses the following items: 09/04/2003 7:00 AM 1. OPSYS - EXIT with JOBNAME(*) is now valid in PROGxx. 2. OPSYS - Certain category codes in DEVSUPxx could get syntax errors due to a bad translate table. This has been corrected. 3. OPSYS - The Report Operations Panel now displays the newest report datasets first. Also the panel is no longer repositioned to the first dataset after a line command. 4. VTAM - Corrected problem with ATCSTR00. 5. TCPIP - Corrected TCPIP problems. IF46 Patch 18 addresses the following items: 08/22/2003 9:30 AM 1. Changes have been made to account for the automatic addition of SYS1.LINKLIB and SYS1.SVCLIB to the APF list by MVS: a. The Dynamic Change report no longer shows a difference between Parmlib APF entries and the running system APF entries due to SYS1.SVCLIB. b. If SYS1.LINKLIB has been defined as an APF dataset then message "IFO0632N APF ENTRY FOR SYS1.LINKLIB ON VOLUME xxxxxx IGNORED; ALREADY ADDED BY MVS" is issued. 2. CLOCKxx TIMEZONE syntax checking has been updated to reflect the latest updates to the IBM Init & Tuning Reference. 3. SMFPRMxx &SID substitution has been corrected so that &SID may be used in a DSNAME statement when the DSNAME statement appears before a SID statement. 4. Message IFO0713I CATALOG ERROR.... has been changed to IFO0713W, a warning message. 5. An OPEN error, such as a S913 abend, no longer terminates the Dataset Report. 6. The Parm portion of the ASNAME keyword in BPXPRMxx is no longer restricted by MVS release since IBM has made the support is available by PTFs. 7. VTAM - VTAM ATCSTRxx buffer specifications, position 2 8. VTAM - ES2: MEMBER_NAME=VTAM: ATCSTRXX_AUTOTI= 9. VTAM - Corrects ATCSTRxx HPR= and HPRARB= . 10. JES2 - Fix for the JES2 Inspector loop. 11. TCPIP - Fixs to TCPIP. IF46 Patch 17 addresses the following items: 7/16/2003 08:00 AM 1. IFO - The new INITIMP keyword in IEAOPTxx added by IBM APAR OW55344 is now supported for OS/390 V2R10 and z/OS inspections. 2. TCPIP - TCPIP inspections now support RESOLVER procs with a //SETUP DD statement that specifies a PATH instead of a DSNAME. 3. TCPIP - The TCPIP RESOLVER inspector now properly handles the DEFAULTTCPIPDATA statement. 4. IFO - In certain situtations a line mode TPUT followed by a TGET could cause the terminal session to be lost. This has been corrected. 5. IFO - The DATASET Report has been changed to list HFS paths as TYPE=PATH instead of TYPE=HFS. 6. IFO - If the source dataset on the Subsystem Inspection panel was an HFS path and there was no OMVS segment defined, then the panel was reporting a "dataset not found". The panel logic has been changed so that when there is an HFS path and the OMVS segment might not be available that the inspection still runs and any HFS error will show up in the report. 7. IFO - If the source dataset on the Subsystem Inspection panel was an HFS path and there was a STEPLIB dataset defined, the HFS allocation would fail. This has been corrected. 8. IFO - When processing the APF list entries the catalog is checked for informational purposes and to see if the dataset has migrated. If an APF dataset was an alias the alias information was reported and the VTOC was searched for the true name. This has been changed, for non-SMS datasets, so that the VTOC is searched for the dsname in the APF statement. IF46 Patch 16 addresses the following items: 6/06/2003 11:00 AM 1. IFO - Full color support is now available for terminals that support 3270 extended datastreams. 2. IFO - The Indexed Report members are now sorted by result so that errors, warnings, and notices appear first. The report can also be sorted my member name and by sequence (the order they show up in the report). 3. IFO - Internal changes have been made to support new functions of the Image Analyzer. 4. IFO - The Dynamic Change inspection may now be performed in batch using IFOBATA. 5. IFO - A blank userid is now allowed on the Background Options panel. 6. IFO - An Export followed by an Import of Custom Report definitions now obtains the correct title and line commands. 7. OPSYS - If any of the required IEASYSxx keywords are missing a new error message, "IFO0624E REQUIRED IEASYSXX KEYWORD xxxxxxxx WAS NOT SPECIFIED." is issued. 8. OPSYS - Several problems have been corrected in SMFPRMxx member processing. 9. JES2 - JOBCLASS_SCHENV Corrected. 10. VTAM - ATCSTRXX_HPR Corrected. 11. IFO - Fix to prevent certain line mode TPUTs from causing a terminal disconnect. 12. OPSYS - Fixed syntax errors processing SMFPRMxx SUBPARM statements. 13. IFO - Non-temporary dataset statements in NSEDSN00 will now use a unit of SYSALLDA instead of the system default unit. Temporary datasets will still use the system default unit. 14. IFO - TYPE(ZFS) is now supported in BPXPRMxx for z/OS V1R3 and higher inspections. 15. IFO - When a release inspection report is generated both the actual release level and the inspection release level are displayed. 16. IFO - Dataset Check Inspector (Demo) 17. JES2 - RRD_RD_PRTDEST NODE_TRANSMIT 18. TCPIP - Update fixes certain problems that could appear in the processing of deeply nested INCLUDEs.TCP/IP Fixes. 19. IFO - A new message IFO0628I will be issued if the target system and running systems use the same IPL parameters: IFO0628I RUNNING AND TARGET SYSTEMS APPEAR TO BE THE SAME. 20. IFO - A new message IFO0629I will be issued if the target system and running are not the same and a HFS file is allocated: IFO0629W UNABLE TO VALIDATE FILESYSTEM PATH; RUNNING AND TARGET SYSTEMS ARE DIFFERENT. The HFS file will be processed, but it may not be the desired file. 21. IFO - A new message IFO0630I will display the contents of CVTVERID for the target system if CVTVERID is non-blank. 22. IFO - Message IFO0724I has been changed from: IFO0724I CATALOG NAME IS catalog-dsn. to: IFO0724I CATALOG NAME FOR dsn IS catalog-dsn. IF46 Patch 15 addresses the following items: 5/30/2003 9:00 AM 1. OPSYS - Fixed possible ABEND0C9 when creating the Dataset Report. 2. OPSYS - Fixed possible error reading the Package Index Dataset. 3. OPSYS - Added support for the IE command for Custom Analysis. 4. JES2 - Release 0 now defaults to JES2 V2 R8 or JES2 V2 R9. 5. VTAM - Support for new release level 0. 6. JES3 – support for new release level 0. IF46 Patch 14 addresses the following items: 5/15/2003 7:00 AM 1. JES2 - Problem occurs during INCLUDE statement scanning of an empty member. 2. JES2 - Fix for RMT(xx-xx) range specification. 3. JES2 - Fix for EXIT(007) ROUtines=OPCAENT7, /* Name on $ENTRY statement wnc*/ IF46 Patch 13 addresses the following items: 05/07/2003 4:00 PM 1. OPSYS - A non-alpha character in column one of an IEASYSxx statement is now flagged as an error. 2. OPSYS - Running an inspection of a image that is not the running system now loads the proper copy of MSTJCLxx when MSTJCLxx is in LINKLIB. 3. OPSYS - The operands of the TIMEZONE statement in the CLOCKxx member are now properly checked for syntax. 4. OPSYS - The input areas on the LOGON panel have been lined up to make them easier to find. 5. VTAM - LOCAL_PU_DELAY 6. VTAM - LUGROUP_LU 7. VTAM - VBUILD TYPE=TCP 8. JES2 - Correct OWNNODE checking when multiple NJEDEF statements exist. 9. TCPIP - Procs started from AUTOLOG statements are now JCL syntax checked. This feature requires a JES2 or JES3 inspection in the same execution. 10. TCPIP - Errors with VGET/VPUT have been corrected. IF46 Patch 12 addresses the following items: 04/28/2003 1:00 PM 1. OPSYS - If a APF dataset is specified in PROGxx or IEAAPFxx as SMS and the actual dataset is not SMS managed message IFO0622W is now issued. 2. OPSYS - Package storing settings on the Image Definition Panel were sometimes were invalidly set to "N". This has been corrected. 3. OPSYS - The +KEY_RPT member is now available on the Indexed Report to view the IEASYSxx Keyword Report. 4. OPSYS - The Background Inspection cycle will now terminate if there is an error allocating a report dataset. A message 'REPORT DSN' DSN 'ALLOCATION FAILED RETURN CODE rrrrrrr' is written to the Background log (SYSTSPRT) to indicate the reason for the error. The message INSPECTION(S) TERMINATED DUE TO SERIOUS ERROR is also written to the log. 5. JES2 - Removed PRINTER MODE=FSS keyword validity checking 6. VTAM - LOCAL DLOGMOD, increased valid length of specification. 7. TCPIP - Modification to the'LUSSESSIONPEND' statement to support 'LUSSESSIONPEND' and 'LUSSESSIONPENDS'. IF46 Patch 11 addresses the following items: 04/22/2003 8:00 AM 1. TCPIP - Fix to keyword SMFCONFIG. 2. TCPDATA - Rexx messages included in background inspection report suppressed. 3. IFO - Fix for possible ABEND002 in Background attempting to process packages when no inspection has completed. 4. IFO - Fixed problem with package generation when package store was set to N. 5. IFO - Fixed problem with a COMMNDxx that had a START command with the JOBACCT keyword. 6. IFO - IEASYSxx Summary Report now fits within an 80-Column screen. 4. JES2 - Support for multiple NJEDEF statements. 5. VTAM - TYPE=CA, LINE support multiple values for READ & WRITE. 6. IMAGE Inspection Report - The Member Report enhanced to include ISPF Stats for all inspected Members. 7. IMAGE Inspection Report - Keyword Value Report added and accessible as "KEY_RPT" from Index Report. IF46 Patch 10 addresses the following item: 04/01/2003 9:00 AM 1. OPSYS - Corrected various problems when allocating an SMS dataset for LNKLST processing when inspecting a system that was not the running system. IF46 Patch 9 addresses the following items: 03/11/2003 9:00 AM 1. IFO - Possible ABEND 0C4 during termination has been fixed. 2. IFO - Message IFO0735N IFO0735N PRIV KEYWORD IS OBSOLETE AS OF Z/OS V1R3 is incorrect and has been removed. 3. IFO - Various internal changes to support Image Builder have been included. IF46 Patch 8 addresses the following items: 03/04/2003 9:00 AM 1. IFO - The dataset reports are now properly saved in stored package members. 2. IFO - Using the ATTACH command to activate a VTAM terminal could get the wrong screen size. This has been corrected. 3. IFO - Valid trial authorization codes were sometimes rejected. This has been corrected. IF46 Patch 7 addresses the following items: 02/21/2003 3:00 PM 1. JES2 - PUNCH_CREATOR. 2. JES2 - PUNCH_JOBNAME. 3. JES2 - PUNCH_PRMODE. 4. JES2 - PUNCH_WRITER. 5. JES2 - RPR. 6. JES2 - RPU. 7. JES2 - RRD. 8. JES2 - JES2INSP now only supports V2R10, V1R2 & V1R4. The older ones have been removed. 9. VTAM - ATCSTRXX BUFSIZE. 10. VTAM - X25.xxxx=(x,y). 11. IFO - Message IFO0000I has been changed to indicate that the dataset name is a report dataset. 12. IFO - Message IFO1008I has been added to some reports to provide the name of the package index dataset. IF46 Patch 6 addresses the following items: 02/19/3003 2:00 PM 1. IFO - Support has been added to the INDEX Report, IMAGE Inspection Selection Screen and IMAGE Report Operations Menu for Custom Analysis. Using the new command 'CA' on the selection line within the INDEX Report will display the IMAGE Editor Main Menu. Using the Editor you Edit, View and Inspect selected Members. Placing 'CA' on the selection line within IMAGE Inspection Selection Screen or IMAGE Report Operations Menu will display the IMAGE Analysis Tool Set. The IMAGE Editor and The IMAGE Analysis Tools can be downloaded from the NewEra Web site. Contact Technical Support for additional information. 2. IFO - When calling the IFOBAT procedure the default value of null for the ADDC keyword will result in the processing of a member with the phantom name of COMMNDCC instead of no member. This has been corrected. 3. IFO - If the resulting value of the IEASYSxx GRS= keyword is NONE then the GRSCNFxx and GRSRNLxx members will no longer be processed. Also IF GRS=NONE has been specified and GRSRNL= and/or GRSCNF= specify a member then a IFO0618W warning message will be issued. Sample below: IFO0618W GRSRNL IN IEASYSXX IGNORED DUE TO GRS=NONE IF46 Patch 5 addresses the following items: 02/11/2003 2:00 PM 1. OPSYS - Sysplex inspections may show "SUCCESS" even though there are errors in the report, Fixed. 2. OPSYS - Volume serial numbers for COUPLE datasets may not always show up in a sysplex report, Fixed. IF46 Patch 4 addresses the following item: 02/06/2003 2:00 PM 1. VTAM -VTAM fix for X.25. IF46 Patch 3 addresses the following items: 02/04/2003 8:00 AM 1. IFO - ALLOCxx keyword VERIFY_VOL is now supported for OS/390 V2R10 and above. 2. IFO - The background task has been fixed to prevent the following messages: IKJ55085I UNDEFINED USERID(S) BGU IKJ55085I USERID NOT FOUND IN MAIL DIRECTORY. IFO46 Patch 2 Addresses the following items: 01/27/2002 2:00 PM 1. IFO - Subsystem Inspections may get a dynamic allocation error if one of the datasets is SMS managed. 2. VTAM -VTAM fix for X.25.