etrust Cleanup for CA-Top Secret Security Product Information Bulletin r2.2 Generally Available (GA) QI75686

etrust Cleanup for CA-Top Secret Security Product Information Bulletin r2.2 Generally Available (GA) QI75686

This documentation and related computer software program (hereinafter referred to as the "Documentation") is for the end user's informational purposes only and is subject to change or withdrawal by Computer Associates International, Inc. ("CA") at any time. THIS DOCUMENTATION MAY NOT BE COPIED, TRANSFERRED, REPRODUCED, DISCLOSED, OR DUPLICATED, IN WHOLE OR IN PART, WITHOUT THE PRIOR WRITTEN CONSENT OF CA. THIS DOCUMENTATION IS PROPRIETARY INFORMATION OF CA AND PROTECTED BY THE COPYRIGHT LAWS OF THE UNITED STATES AND INTERNATIONAL TREATIES. TO THE EXTENT PERMITTED BY APPLICABLE LAW, CA PROVIDES THIS DOCUMENTATION "AS IS" WITHOUT WARRANTY OF ANY KIND, INCLUDING WITHOUT LIMITATION, ANY IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NONINFRINGEMENT. IN NO EVENT WILL CA BE LIABLE TO THE END USER OR ANY THIRD PARTY FOR ANY LOSS OR DAMAGE, DIRECT OR INDIRECT, FROM THE USE OF THIS DOCUMENTATION, INCLUDING WITHOUT LIMITATION, LOST PROFITS, BUSINESS INTERRUPTION, GOODWILL, OR LOST DATA, EVEN IF CA IS EXPRESSLY ADVISED OF SUCH LOSS OR DAMAGE. THE USE OF ANY PRODUCT REFERENCED IN THIS DOCUMENTATION AND THIS DOCUMENTATION IS GOVERNED BY THE END USER'S APPLICABLE LICENSE AGREEMENT. The manufacturer of this documentation is Computer Associates International, Inc. Provided with "Restricted Rights" as set forth in 48 C.F.R. Section 12.212, 48 C.F.R. Sections 52.227-19(c)(1) and (2) or DFARS Section 252.227.7013(c)(1)(ii) or applicable successor provisions. Support Information Call Computer Associates Customer Support for any information not covered in this or the related publications. You can find the appropriate direct telephone number for Customer Support for each CA product under the Support button at http://www.ca.com/ on the Internet. Alternately, in North America, you may call 1-800-645-3042 or 1-631-342-4683 and your call will be returned as soon as possible. Outside North America, contact your local Computer Associates Customer Support center for assistance. r2.2, GA, January 2006 2006 Computer Associates International, Inc., One Computer Associates Plaza, Islandia, NY 11749 All rights reserved. All trademarks, trade names, service marks, and logos referenced herein belong to their respective companies.

Preface Enclosed is a Product Information Bulletin (PIB) along with any high-impact APARs relevant to the accompanying product tape. You should review this document before installing etrust Cleanup r2.2 for CA-Top Secret Security. The PIB provides additional product information that is not yet incorporated into documentation. If you have any questions concerning the enclosed material, contact your Computer Associates Customer Support group for etrust Cleanup r2.2 for CA-Top Secret Security. Refer to CA Product Support Directory or the CA Support Resources web site at http://supportconnect.ca.com for the appropriate telephone numbers for direct support. PIB List: QI75686: etrust Cleanup r2.2 for CA-Top Secret Security Generally Availably (GA) Product Information Bulletin

END OF SECTION

CA 2400 Cabot Drive Lisle, IL 60532-3652 1-630-505-6000 FAX: 1-630-505-6097 To: From: etrust Cleanup for CA-Top Secret Security Customers The Product Group Date: January 12, 2006 Subject etrust Cleanup r2.2 for CA-Top Secret Security Generally Available (GA) Dear Valued Customer: CA is pleased to present you with the generally available (GA) release of etrust Cleanup r2.2 for CA-Top Secret Security (etrust Cleanup), an integral component of the family of solutions we provide for the z/os operating system. Beginning with this release, etrust Cleanup will be maintained by the CA Licensed Management Program (LMP). LMP provides a standardized, automated approach to license management and is designed to eliminate the difficulties inherent in tracking the accurate, licensed use of CA products. Refer to the CAIRIM and LMP Keys under the Installation Section for more details on LMP. Software Prerequisites Your IBM software must meet these minimum requirements to use this version of etrust Cleanup: z/os Version 1.4 etrust CA-Top Secret Security r5.3 for z/os CA Common Services for z/os Prerequisites 1. Before you install the etrust Cleanup r2.2 product tape (22SP0033B00), we highly recommend that you install CA Common Services r11 for z/os. CA Quality Assurance performed final integration tests at this level. Minimally, you must have CA Common Services r2.2 installed at SP2 Service pack before applying this etrust Cleanup product tape. 2. See "CAIRIM and LMP Keys" for more information.

Documentation 1. The documentation set for etrust Cleanup r2.2 for CA-Top Secret Security includes the latest technology available for online viewing, keyword searching, bookmarking, and printing. Use the following job in CAI.SAMPJCL to download the file: For Adobe Acrobat Reader, the CAI.SAMPJCL (ISI22ACR) job unloads the Adobe Acrobat PDF files. Modify the JCL to comply with your site's standards. After you unload the file, move the archive files using a binary transfer method to a platform that supports Adobe Acrobat Reader. See the http://www.adobe.com web site for a list of supported platforms and more information. To unload the archive, use utilities native to that platform. This is a Gzipped-TAR archive or TGZ file. For Windows users, several utilities exist, for example, WinZip 6.3 or higher. UNIX platforms can use gzip and tar. Note: To process the PDF files, your Adobe Acrobat Reader software must be at the Release 5.0 or higher level. For further information on supported releases, please see the http://www.adobe.com web site. 2. Documentation is also available on SupportConnect. To locate the guides, follow these instructions: On the Web, go to http://ca.com/supportconnect. The CA Online Support page opens. Enter a SupportConnect user ID and password, and click Login. The CA Online Support page re-opens, and you are logged into SupportConnect. Select Documentation from the Downloads section. The Copyright Permission to Download CA Product Documentation page opens. After reviewing the agreement, click I Agree. The Documentation page opens. Select the following options from the drop-down lists, and click Go. Brand = etrust Product = Cleanup for CA-Top Secret Security Language = English Release = 2.2 The Product Search Results opens. The Product Search Results page displays all of the etrust guides for the release. You can open or download the most current version of each guide in the documentation set from this page. Getting Started 1. Check the contents of this package against the enclosed packing list. Call your Customer Support group for etrust Cleanup if you encounter any discrepancies. 2. The installation of etrust Cleanup r2.2 must be performed using SMP/E. We recommend that the installation be done into a new SMP/E zone.

3. Please read the General Information section through the Summary of Changes and then proceed to Section A Installation for additional instructions. 4. Each upgrade requires that CAI.SAMPJCL (file 1) be downloaded and tailored to meet your site requirements. The JCL to unload the SAMPJCL file may be found in Section A of this document, and in the Installation chapter of the etrust Cleanup r2.2 for CA-Top Secret Security Getting Started guide. 5. Obtaining Maintenance for etrust Cleanup r2.2 We encourage you to use our Customer Support services on the SupportConnect web site at http://supportconnect.ca.com. By enrolling in hyper subscription delivery, you can automatically receive electronic notification of hyper solutions that are considered critical for the operation of your CA product solution, in this case, etrust Cleanup. This also provides you with notification of new product releases, new product service packs, and any other critical informational solution provided by CA Customer Support. The SupportConnect Download function may be used to view and download any published product solutions. The Compatibilities function can be used to provide guidance on necessary product maintenance levels to accommodate, such as a new z/os. General Information Please note the label information on your tape. The number 22SP0033B00 denotes the level of the tape. The volume serial number for this tape is T62200. The easiest way to obtain a list of all General Availability solutions beyond a service level is to visit our Product Home Page under Solutions and Patches, just click on the desired service pack. The Product Home Page has also been enhanced to provide you with all hyper solutions for a particular release. We encourage you to visit: http://supportconnectw.ca.com/public/ca-topsecret/ca-topsecretos390supp.asp. This service pack supports the following IBM software releases: z/os Version 1.4 and above When IBM releases a new version of z/os, CA provides an upgrade solution. This solution describes the maintenance required in etrust Cleanup to make it compatible with the new release of z/os. Upgrade (UPGRAD) solutions exist for each GA release of z/os. To receive the latest updates, download them from http://supportconnect.ca.com or call CA Customer Support and request the specific z/os upgrade solution.

Summary of Changes Name Changes Programs, messages, REXX scripts, JCL procedures and jobs that began with TASA have been renamed to ETCL. All sample jobs in SAMPJCL have been updated to reference CA software installation libraries. Sample JCL procedure TASA and input parameter member TASAPARM are no longer provided in the SAMPJCL. New JCL ETCL procedure and ETCLPARM input parameter member are installed directly into the target CA software CAIPROC library. New Report Option PARM= BOTH The new report option PARM= BOTH reports both referenced and unreferenced items from the tracking database. The current UNREF parameter does not show a newly added item because it is too new (PARM= UNREF=30 shows only after 30 days has passed). The current REF parameter does not show it because it has not been used (unless REF=999 is specified). PARM= BOTH shows everything in the cleanup file. Automatic REINIT The etrust Cleanup r2.2 main task now detects new maintenance levels and automatically performs a REINIT if required. The previous release required the customer to manually issue the following command: S ETCL,,,REINIT command. This caused out-of-sync problems if it wasn t known or remembered to use REINIT. LMP Key Support CA LMP Key Certificate is now required. LMP key validation is performed for the main task and required for running the Report and Command Utility. SAMPJCL Improvements New sample SMP/E jobs for installation of the product into CA software libraries. These include the following: CAIALLOC A sample ALLOCATE job for creating SMP/E CAI product libraries. ISI22ACR A sample job to unload the etrust Cleanup r2.2 for CA-Top Secret Security documentation. ISI22ALL A sample JCL ALLOCATE job for SMP/E etrust Cleanup r2.2 libraries. ISI22APP A sample JCL SMP/E APPLY job for installing etrust Cleanup r2.2. ISI22REC A sample JCL SMP/E RECEIVE job for installing etrust Cleanup r2.2. ISI22ACC A sample JCL SMP/E ACCEPT job for installing etrust Cleanup r2.2. ISI22DEL A sample JCL SMP/E DELETE job for de-installing etrust Cleanup r2.2. ISI21DEL A sample JCL SMP/E DELETE job for de-installing etrust Cleanup r2.1. Additional sample jobs are provided DBRPT01 Provides selective reporting by group identifier. Grouping can be by department, division, zone, or user defined, and each group report is directed to a separate output file. DBRPT02 Provides selective reporting by group identifier. Grouping can be by department, division, zone, or user defined, and each group report is directed to a single output file with page breaks separating the groups. DBRPT03 Provides selective reporting and cleanup by user ID, resource class, or resource name. DBRPT04 Provides selective reporting and cleanup by group name. Group name can be a department, division, or zone name.

FB2VB Creates a variable-blocked command file from the standard fixed-blocked command output. Performance and Reliability Improvements The ETCL Report run time has been enhanced to improve performance in the report and command generation. The currently processed database record now appears in LOGREC data to assist debugging. If etrust Cleanup r2.2 abends for any reason, this additional information will be beneficial to speed up problem determination. Migration Considerations The etrust Cleanup r2.1 tracking database used by the tracking database load utility, the long-running ETCL main task and the report and command utility is compatible with etrust Cleanup r2.2. Installations using etrust Cleanup r2.1 may choose to skip Step 10: Create the etrust Cleanup r2.2 Tracking File of the Installation procedures in Chapter 3 of the etrust Cleanup r2.2 for CA-Top Secret Security Getting Started. Installations utilizing any special modification of REXX scripts should examine the code for possible impact from this change and take appropriate corrective actions (if necessary) prior to migration to r2.2. Section A - Installation Follow the installation procedures documented in the etrust Cleanup r2.2 for CA-Top Secret Security Getting Started. The JCL necessary to perform the installation is located in CAI.SAMPJCL (file 1). For the JCL to unload CAI.SAMPJCL please use the following sample: //UNLOAD JOB <-- Customize as appropriate //COPY EXEC PGM=IEBCOPY //SYSPRINT DD SYSOUT=* //CART DD DISP=OLD,DSN=CAI.SAMPJCL, // UNIT=CART, // VOL=SER=T622nn, <-- Set "nn" to Service Pack level // LABEL=(1,SL,EXPDT=98000) //SAMPJCL DD DISP=(,CATLG,DELETE), // DSN=CAI.ETCL.SAMPJCL, <-- Your DSN // UNIT=SYSDA, <-- Your generic DASD // VOL=SER=xxxxxx, <-- Permanent DASD volser // SPACE=(3120,(125,5,5)), <-- Minimum space required // DCB=(RECFM=FB,LRECL=80,BLKSIZE=3120) //SYSIN DD * COPY INDD=CART,OUTDD=SAMPJCL /* Note regarding etrust Cleanup r2.2 for CA-Top Secret installation processing, ISI22ACC ACCEPT job: You can expect to see IEW2454W warning messages for program object bind processing. These are normal and can be ignored.

CAIRIM and LMP Keys etrust Cleanup r2.2 for CA-Top Secret Security is maintained by the CA License Management Program (LMP). LMP provides a standardized, automated approach to license management and is designed to eliminate the difficulties inherent in tracking the accurate licensed use of CA products. LMP runs as a component of CAIRIM. CAIRIM must be installed prior to initializing etrust Cleanup. You should already have received an LMP Product Key Certificate. If you do not have a valid LMP Key for the CPU on which you are running, CA Common Services message CAS9180E appears on your system console. If you have any questions about LMP and CAIRIM call the CA License Management Program Hotline at 1-800-338-6720 in North America (24 hours a day, 7 days a week). Outside of North America, contact your local CA Customer Support group during local business hours. We are dedicated to ensuring that your use of etrust Cleanup is successful and we want to thank you for your continued support of CA.

END OF PIB