Program Directory for IBM Tivoli Storage Manager for Mail Data Protection for Lotus Domino. Version 5 Release 2. Program Number 5698-A12 FMID HDN5120

Transcription

1 IBM Program Directory for IBM Tivoli Storage Manager for Mail Data Protection for Lotus Domino Version 5 elease 2 Program Number 5698-A12 FMID HDN5120 for Use with OS/390 Version 2 elease 10 or Higher Document Date: July 2003 GI

2 Note! Before using this information and the product it supports, be sure to read the general information under Notices on page v. Copyright International Business Machines Corporation 1998, All rights reserved. Note to U.S. Government Users Documentation related to restricted rights Use, duplication or disclosure is subject to restrictions set forth in GSA ADP Schedule Contract with IBM Corp.

3 Contents Notices v Trademarks vi 1.0 Introduction ITSM Data Protection for Lotus Domino Description ITSM Data Protection for Lotus Domino FMIDs Program Materials Basic Machine-eadable Material Optional Machine-eadable Material Program Publications Basic Program Publications Optional Program Publications Program Source Materials Publications Useful During Installation Program Support Program Services Preventive Service Planning Statement of Support Procedures Program and Service Level Information Program Level Information Service Level Information Installation equirements and Considerations Driving System equirements Machine equirements Programming equirements Target System equirements Machine equirements Programming equirements Mandatory equisites Functional equisites Toleration/Coexistence equisites Incompatibility (Negative) equisites DASD Storage equirements FMIDs Deleted Special Considerations Installation Instructions Installing ITSM Data Protection for Lotus Domino Copyright IBM Corp. 1998, 2003 iii

4 6.1.1 SMP/ Considerations for Installing ITSM Data Protection for Lotus Domino SMP/ nvironment Sample Jobs Unload the Sample JCL from the Product Tape Perform SMP/ CIV Allocate SMP/ Target and Distribution Libraries and Paths Create DDDF ntries Perform SMP/ APPLY Perform SMP/ ACCPT Post Installation Configuration Configure Client Option Files Activating ITSM Data Protection for Lotus Domino Appendix A. ITSM Data Protection for Lotus Domino Install Logic A.1 SMP/ Modification Control Statements A.2 SMP/ JCLIN Contacting Customer Support Figures 1. Basic Material: Program Tape Program Tape: File Content Basic Material: Unlicensed Publications Publications Useful During Installation PSP Upgrade and Subset ID Component IDs Driving System Software equirements Mandatory equisites Functional equisites Total DASD Space equired by ITSM Data Protection for Lotus Domino Storage equirements for SMP/ Work Data Sets Storage equirements for SMP/ Data Sets Storage equirements for ITSM Data Protection for Lotus Domino Target Libraries ITSM Data Protection for Lotus Domino HFS Paths Storage equirements for ITSM Data Protection for Lotus Domino Distribution Libraries Sample Installation Jobs iv ITSM Data Protection for Lotus Domino Program Directory

5 Notices eferences in this document to IBM products, programs, or services do not imply that IBM intends to make these available in all countries in which IBM operates. Any reference to an IBM product, program, or service is not intended to state or imply that only IBM's product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe on any of IBM's intellectual property rights may be used instead of the IBM product, program, or service. valuation and verification of operation in conjunction with other products, except those expressly designated by IBM, is the user's responsibility. APA numbers are provided in this document to assist in locating PTFs that may be required. Ongoing problem reporting may result in additional APAs being created. Therefore, the APA lists in this document may not be complete. To obtain current service recommendations and to identify current product service requirements, always contact the IBM Customer Support Center or use S/390 SoftwareXcel to obtain the current "PSP Bucket". IBM may have patents or pending patent applications covering subject matter in this document. The furnishing of this document does not give you any license to these patents. You can send license inquiries, in writing, to the IBM Director of Licensing IBM Corporation North Castle Drive Armonk, New York USA For online versions of this book, we authorize you to: Copy, modify, and print the documentation contained on the media, for use within your enterprise, provided you reproduce the copyright notice, all warning statements, and other required statements on each copy or partial copy. Transfer the original unaltered copy of the documentation when you transfer the related IBM product (which may be either machines you own, or programs, if the program's license terms permit a transfer). You must, at the same time, destroy all other copies of the documentation. You are responsible for payment of any taxes, including personal property taxes, resulting from this authorization. TH A NO WAANTIS, XPSS O IMPLID, INCLUDING TH WAANTIS OF MCHANTABILITY AND FITNSS FO A PATICULA PUPOS. Some jurisdictions do not allow the exclusion of implied warranties, so the above exclusion may not apply to you. Copyright IBM Corp. 1998, 2003 v

6 Your failure to comply with the terms above terminates this authorization. Upon termination, you must destroy your machine readable documentation. Trademarks The following terms are trademarks of the IBM Corporation in the United States or other countries or both: CBPDO IBM Language nvironment MVS/SA OS/390 Z/OS ACF Tivoli TAIN UNIX is a registered trademark of The Open Group in the United States and other countries. Other company, product, and service names may be trademarks or service marks of others. vi ITSM Data Protection for Lotus Domino Program Directory

7 1.0 Introduction This Program Directory is intended for the system programmer responsible for program installation and maintenance. It contains information concerning the material and procedures associated with the installation of IBM Tivoli Storage Manager for Mail Data Protection for Lotus Domino Version 5 elease 1, Modification Level 5. This publication refers to IBM Tivoli Storage Manager for Mail Data Protection for Lotus Domino as ITSM Data Protection for Lotus Domino. The Program Directory contains the following sections: 2.0, Program Materials on page 3 identifies the basic and optional program materials and documentation for ITSM Data Protection for Lotus Domino. 3.0, Program Support on page 6 describes the IBM support available for ITSM Data Protection for Lotus Domino. 4.0, Program and Service Level Information on page 8 lists the APAs (program level) and PTFs (service level) incorporated into ITSM Data Protection for Lotus Domino. 5.0, Installation equirements and Considerations on page 9 identifies the resources and all for installing and using ITSM Data Protection for Lotus Domino. 6.0, Installation Instructions on page 16 provides detailed installation instructions for ITSM Data Protection for Lotus Domino. It also describes the procedures for activating the functions of ITSM Data Protection for Lotus Domino, or refers to appropriate publications. Before installing ITSM Data Protection for Lotus Domino, read the CBPDO Memo To Users and the CBPDO Memo To Users xtension that were supplied with this program softcopy as well as this Program Directory and then keep them for future reference. Section 3.2, Preventive Service Planning on page 6 tells you how to find any updates to the information and procedures in this Program Directory. ITSM Data Protection for Lotus Domino is supplied in a Custom-Built Product Delivery Offering (CBPDO, 5751-CS3). The Program Directory is provided softcopy on the CBPDO tape which is identical to the hard copy provided with your order. Your CBPDO contains a softcopy preventive service planning (PSP) upgrade for this product. All service and HOLDDATA for ITSM Data Protection for Lotus Domino are included on the CBPDO tape. Do not use this Program Directory if you are installing ITSM Data Protection for Lotus Domino with a SystemPac or ServerPac. When using these offerings, use the jobs and documentation supplied with the offering. This documentation may point you to specific sections of the Program Directory as required. Copyright IBM Corp. 1998,

8 1.1 ITSM Data Protection for Lotus Domino Description The IBM Tivoli Storage Manager for Mail Data Protection for Lotus Domino is the client portion of a client/server program that helps you protect valuable information that has been created in the client environment. Using the program you can maintain backup versions of files that can be restored quickly and easily if the original files are damaged or lost. You can also archive files and retrieve them when necessary. 1.2 ITSM Data Protection for Lotus Domino FMIDs ITSM Data Protection for Lotus Domino consists of the following FMIDs: HDN ITSM Data Protection for Lotus Domino Program Directory

9 2.0 Program Materials An IBM program is identified by a program number and a feature number. The program number for ITSM Data Protection for Lotus Domino is 5698-A12 and its feature number is Basic Machine-eadable Materials are materials that are supplied under the base license and feature code, and are required for the use of the product. Optional Machine-eadable Materials are orderable under separate feature codes, and are not required for the product to function. The program announcement material describes the features supported by ITSM Data Protection for Lotus Domino. Ask your IBM representative for this information if you have not already received a copy. 2.1 Basic Machine-eadable Material The distribution medium for this program is magnetic tape or downloadable files. It is installed using SMP/, and is in SMP/ LFIL format. See 6.0, Installation Instructions on page 16 for more information about how to install the program. Information about the physical tape for the Basic Machine-eadable Materials for ITSM Data Protection for Lotus Domino can be found in the CBPDO Memo To Users xtension. Figure 1. Basic Material: Program Tape Medium Feature Number Physical Volume xternal Label Identification VOLS 3480 cart ITSM Data Protection for Lotus Domino DN5120 Figure 2 describes the program file content for ITSM Data Protection for Lotus Domino. You can refer to the CBPDO Memo To Users xtension to see where the files reside on the tape. Notes: 1. The data set attributes in this table should be used in the JCL of jobs reading the data sets, but since the data sets are in IBCOPY unloaded format, their actual attributes may be different. 2. If any LFILs are identified as PDSs, ensure that SMPTLIB data sets are allocated as PDSs. Figure 2 (Page 1 of 2). Program Tape: File Content VOLS F i l e Name Dist Library DN SMPMCS n/a SQ FB O G C F M L C L BLK SIZ Copyright IBM Corp. 1998,

10 Figure 2 (Page 2 of 2). Program Tape: File Content VOLS F i l e Name Dist Library O G C F M L C L BLK SIZ 2 IBM.HDN5120.F1 AANSDBIN PDS VB IBM.HDN5120.F2 ASAMPLIB PDS FB Optional Machine-eadable Material No optional machine-readable materials are provided for ITSM Data Protection for Lotus Domino. 2.3 Program Publications The following sections identify the basic and optional publications for ITSM Data Protection for Lotus Domino Basic Program Publications Figure 3 identifies the basic unlicensed program publications for ITSM Data Protection for Lotus Domino. One copy of each of these publications is included when you order the basic materials for ITSM Data Protection for Lotus Domino. For additional copies, contact your IBM representative. Figure 3. Basic Material: Unlicensed Publications Publication Title ITSM ead This First Program Directory for ITSM for Mail Data Protection for Lotus Domino Form Number GI GI Optional Program Publications No optional publications are provided for ITSM Data Protection for Lotus Domino. The ITSM Data Protection for Lotus Domino Program Directory, along with other Tivoli Program Directories can be found by following links to the product from the support web site listed below: 4 ITSM Data Protection for Lotus Domino Program Directory

11 2.4 Program Source Materials No program source materials or viewable program listings are provided for ITSM Data Protection for Lotus Domino. 2.5 Publications Useful During Installation The publications listed in Figure 4 may be useful during the installation of ITSM Data Protection for Lotus Domino. To order copies, contact your IBM representative or visit the IBM Publications Center on the world wide web at: /applications/publications/cgibin/pbi.cgi Figure 4. Publications Useful During Installation Publication Title IBM SMP/ for z/os and OS/390 User's Guide IBM SMP/ for z/os and OS/390 Commands IBM SMP/ for z/os and OS/390 eference IBM SMP/ for z/os and OS/390 Messages, Codes, and Diagnosis OS/390 UNIX System Services Planning OS/390 UNIX System Services Command eference IBM Tivoli Storage Manager for UNIX: Backup-Archive Clients Installation and User s Guide IBM Tivoli Storage Manager for OS/390 and z/os Administrator's Guide Version 5 elease 2 IBM Tivoli Storage Manager for OS/390 and z/os Administrator's eference Version 5 elease 2 IBM Tivoli Storage Manager for OS/390 and z/os Quick Start Version 5 elease 2 Form Number SA SA SA GA SC SC GC GC GC GC IBM Tivoli Storage Manager Using the Application Program Interface IBM Tivoli Storage Manager Messages Version 5 elease 2 GC GC Program Materials 5

12 3.0 Program Support This section describes the IBM support available for ITSM Data Protection for Lotus Domino. 3.1 Program Services Contact your IBM and/or Tivoli representative for specific information about available program services. You can find information in the "IBM Software Support Guide" at the following Web site: The handbook provides information about how to contact Customer Support, depending on the severity of your problem, and the following information: egistration and eligibility Telephone numbers and addresses, depending on the country in which you are located What information you should gather before contact support 3.2 Preventive Service Planning Before installing ITSM Data Protection for Lotus Domino, you should review the current Preventive Service Planning (PSP) information. If you obtained ITSM Data Protection for Lotus Domino as part of a CBPDO, there is HOLDDATA and PSP information included on the CBPDO. If the CBPDO for ITSM Data Protection for Lotus Domino is more than two weeks old when you install it, you should contact the IBM Support Center or use S/390 SoftwareXcel to obtain the current "PSP Bucket". For access to TAIN, visit on the Internet. PSP Buckets are identified by UPGADs, which specify product levels, and SUBSTs, which specify the FMIDs for a product level. The UPGAD and SUBST values for ITSM Data Protection for Lotus Domino are: Figure 5. PSP Upgrade and Subset ID UPGAD SUBST Description DPM520 HDN ITSM Data Protection for Lotus Domino 6 Copyright IBM Corp. 1998, 2003

13 3.3 Statement of Support Procedures eport any difficulties you have using this program to your IBM Support Center. If an APA is required, the Support Center will provide the address to which any needed documentation can be sent. Figure 6 on page 7 identifies the component IDs (COMPID) for ITSM Data Protection for Lotus Domino. Figure 6. Component IDs FMID COMPID Component Name TAIN elease HDN ITSM Data Protection for Lotus Domino DN5120 Program Support 7

14 4.0 Program and Service Level Information This section identifies the program and any relevant service levels of ITSM Data Protection for Lotus Domino. The program level refers to the APA fixes incorporated into the program. The service level refers to the PTFs integrated. 4.1 Program Level Information No APAs have been incorporated into ITSM Data Protection for Lotus Domino. 4.2 Service Level Information No PTFs against this release of ITSM Data Protection for Lotus Domino have been incorporated into the product tape. 8 Copyright IBM Corp. 1998, 2003

15 5.0 Installation equirements and Considerations The following sections identify the system requirements for installing and activating ITSM Data Protection for Lotus Domino. The following terminology is used: Driving system: the system used to install the program. Target system: the system on which the program is installed. In many cases, the same system can be used as both a driving system and a target system. However, you may want to set up a clone of your system to use as a target system by making a separate IPL-able copy of the running system. The clone should include copies of all system libraries that SMP/ updates, copies of the SMP/ CSI data sets that describe the system libraries, and your PAMLIB and POCLIB. Some cases where two systems should be used include the following: When installing a new level of a product that is already installed, the new product will delete the old one. By installing onto a separate target system, you can test the new product while still keeping the old one in production. When installing a product that shares libraries or load modules with other products, the installation can disrupt the other products. Installing onto a test system or clone will allow you to assess these impacts without disrupting your production system. 5.1 Driving System equirements This section describes the environment of the driving system required to install ITSM Data Protection for Lotus Domino Machine equirements The driving system can run in any hardware environment that supports the required software Programming equirements Figure 7. Driving System Software equirements Program Number Any one of the following: Product Name and Minimum VM/Service Level 5647-A01 OS/390 Version 2 elease 10 or higher 5694-A01 z/os Version 1 elease 1 or higher 5655-G44 IBM SMP/ for z/os and OS/390 Version 3 elease 1 or higher Copyright IBM Corp. 1998,

16 5.2 Target System equirements This section describes the environment of the target system required to install and use ITSM Data Protection for Lotus Domino. ITSM Data Protection for Lotus Domino installs in the z/os (Z038) SL Machine equirements The target system can run in any hardware environment that supports the required software Programming equirements Mandatory equisites A mandatory requisite is defined as a product that is required without exception; this product either will not install or will not function unless this requisite is met. This includes products that are specified as Qs or Ps. Figure 8. Mandatory equisites Program Number Any one of the following: Product Name and Minimum VM/Service Level 5647-A01 OS/390 Version 2 elease 10 or higher 5694-A01 z/os Version 1 elease 1 or higher Functional equisites A functional requisite is defined as a product that is not required for the successful installation of this product or for the basic function of the product, but is needed at run time for a specific function of this product to work. This includes products that are specified as IF Qs. Figure 9. Functional equisites Program Number Product Name and Minimum VM/Service Level Function 5698-A12 ITSM,S/390 dition API V510 Application Program Interface 10 ITSM Data Protection for Lotus Domino Program Directory

17 Toleration/Coexistence equisites A toleration/coexistence requisite is defined as a product which must be present on a sharing system. These systems can be other systems in a multisystem environment (not necessarily sysplex), a shared DASD environment (such as test and production), or systems that reuse the same DASD at different time intervals. ITSM Data Protection for Lotus Domino has no toleration/coexistence requisites Incompatibility (Negative) equisites A negative requisite identifies products which must not be installed on the same system as this product. ITSM Data Protection for Lotus Domino has no negative requisites DASD Storage equirements ITSM Data Protection for Lotus Domino libraries can reside on all supported DASD types. Figure 10 lists the total space required for each type of library. Figure 10. Total DASD Space equired by ITSM Data Protection for Lotus Domino Library Type Target Distribution HFS Total Space equired 500 kb 6 mb ( blocks of 4096 block size) 5 mb Notes: 1. IBM recommends use of system determined block sizes for efficient DASD utilization for all non-cfm U data sets. For CFM U data sets, IBM recommends a block size of 32760, which is the most efficient from a performance and DASD utilization perspective. 2. Abbreviations used for the data set type are: U S Unique data set, allocated by this product and used only by this product. To determine the correct storage needed for this data set, this table provides all required information; no other tables (or Program Directories) need to be referenced for the data set size. Shared data set, allocated by this product and used by this product and others. To determine the correct storage needed for this data set, the storage size given in this table needs to be added to other tables (perhaps in other Program Directories). If the data set already exists, it must have enough free space to accommodate the storage size given in this table. Installation equirements and Considerations 11

18 xisting shared data set, used by this product and others. This data set is NOT allocated by this product. To determine the correct storage needed for this data set, the storage size given in this table needs to be added to other tables (perhaps in other program directories). This existing data set must have enough free space to accommodate the storage size given in this table. If you currently have a previous release of this product installed in these libraries, the installation of this release will delete the old one and reclaim the space used by the old release and any service that had been installed. You can determine whether or not these libraries have enough space by deleting the old release with a dummy function, compressing the libraries, and comparing the space requirements with the free space in the libraries. For more information on the names and sizes of the required data sets, please refer to 6.1.6, Allocate SMP/ Target and Distribution Libraries and Paths on page Abbreviations used for the HFS Path type are: N X P New path, created by this product. Path created by this product, but may already exist from a previous release. Previously existing path, created by another product. 4. All target and distribution libraries listed have the following attributes: The default name of the data set may be changed The default block size of the data set may be changed The data set may be merged with another data set that has equivalent characteristics The data set may be either a PDS or a PDS 5. All target libraries listed have the following attributes: The data set may be SMS managed It is not required for the data set to be SMS managed It is not required for the data set to reside on the IPL volume The values in the "Member Type" column are not necessarily the actual SMP/ element types identified in the SMPMCS. 6. All target libraries listed which contain load modules have the following attributes: The data set may be in the LPA It is not required for the data set to be in the LPA The data set may be in the LNKLST It is not required for the data set to be APF authorized Figure 11 (Page 1 of 2). Storage equirements for SMP/ Work Data Sets Library DDNAM T Y P O G C F M L C L No. of 3390 Trks SMPWK1 S PDS FB No. of DI Blks 12 ITSM Data Protection for Lotus Domino Program Directory

19 Figure 11 (Page 2 of 2). Storage equirements for SMP/ Work Data Sets Library DDNAM T Y P O G C F M L C L No. of 3390 Trks SMPWK2 S PDS FB SMPWK3 S PDS FB SMPWK4 S PDS FB SMPWK6 S PDS FB SYSUT1 U SQ SYSUT2 U SQ SYSUT3 U SQ SYSUT4 U SQ No. of DI Blks The following table provides an estimate of the storage needed in the SMP/ data sets for ITSM Data Protection for Lotus Domino. The estimates must be added to those of any other programs and service being installed to determine the total additional storage requirements. Figure 12. Storage equirements for SMP/ Data Sets Library DDNAM SMPLTS (not applicable) SMPMTS (not applicable) T Y P O G C F M L C L No. of 3390 Trks SMPPTS PDS FB SMPSCDS (not applicable) SMPSTS (not applicable) No. of DI Blks The following figures describe the target and distribution libraries and HFS paths required to install ITSM Data Protection for Lotus Domino. The storage requirements of ITSM Data Protection for Lotus Domino must be added to the storage required by other programs having data in the same library or path. Note: The data in these tables should be used when determining which libraries can be merged into common data sets. In addition, since some ALIAS names may not be unique, ensure that no naming conflicts will be introduced before merging libraries. Installation equirements and Considerations 13

20 Figure 13. Storage equirements for ITSM Data Protection for Lotus Domino Target Libraries Library DDNAM Member Type Target Volume T Y P O G C F M L C L No. of 3390 Trks SAMPLIB Sample Any PDS FB No. of DI Blks Figure 14. ITSM Data Protection for Lotus Domino HFS Paths DDNAM T Y P Path Name SANSDBIN N /usr/lpp/tivoli/tsm/client/domino/bin/ibm Figure 15. Storage equirements for ITSM Data Protection for Lotus Domino Distribution Libraries Library DDNAM T Y P O G C F M L C L No. of 3390 Trks AANSDBIN U PO VB ASAMPLIB PO FB No. of DI Blks The following figures list data sets that are not used by SMP/, but are required for ITSM Data Protection for Lotus Domino to execute. 5.3 FMIDs Deleted Installing ITSM Data Protection for Lotus Domino may result in the deletion of other FMIDs. To see what FMIDs will be deleted, examine the ++V statement in the product's SMPMCS. If you do not wish to delete these FMIDs at this time, you must install ITSM Data Protection for Lotus Domino into separate SMP/ target and distribution zones. Note: These FMIDs will not automatically be deleted from the Global Zone. Consult the SMP/ manuals for instructions on how to do this. 14 ITSM Data Protection for Lotus Domino Program Directory

21 5.4 Special Considerations When you use TCP/IP communication, the domain AF_INT must be defined to Unix System Services MVS. efer to SYS1.PAMLIB(BPXPMxx) for TCP/IP configuration. Attention HFS considerations Installation of ITSM Data Protection for Lotus Domino must be performed with a user ID for which a ACF Opendition segment with a UID(0) (i.e. root authority) has been defined. HFS files are installed into the root default directory '/usr/lpp/tivoli/tsm/client/domino/bin/ibm/'. If you want to point to alternate HFS, such as a service target library, add appropriate path, such as '/service/tzon1' as the prefix path. See 6.1.6, Allocate SMP/ Target and Distribution Libraries and Paths on page 18. Symbolic links to these directories are defined in , Post Installation Configuration on page 20. Installation equirements and Considerations 15

22 6.0 Installation Instructions This chapter describes the installation method and the step-by-step procedures to install and to activate the functions of ITSM Data Protection for Lotus Domino. Please note the following: If you want to install ITSM Data Protection for Lotus Domino into its own SMP/ environment, consult the SMP/ manuals for instructions on creating and initializing the SMPCSI and the SMP/ control data sets. Additionally, to assist you in doing this, IBM has provided samples to help you create an SMP/ environment at the following url: Sample jobs have been provided to help perform some or all of the installation tasks. The SMP/ jobs assume that all DDDF entries required for SMP/ execution have been defined in the appropriate zones. The SMP/ dialogs may be used instead of the sample jobs to accomplish the SMP/ installation steps. 6.1 Installing ITSM Data Protection for Lotus Domino SMP/ Considerations for Installing ITSM Data Protection for Lotus Domino This release of ITSM Data Protection for Lotus Domino is installed using the SMP/ CIV, APPLY, and ACCPT commands. The SMP/ dialogs may be used to accomplish the SMP/ installation steps SMP/ nvironment All SMP/ installation jobs provided assume that all necessary DD statements for the execution of SMP/ are defined using DDDFs. Sample jobs are provided to assist you in installing ITSM Data Protection for Lotus Domino. After the CIV step has been completed, the sample jobs can be found in SMPTLIB: hlq.hdn5120.f2. Note: Where hlq is the high level qualifier as defined in the DSPFIX in the CSI Sample Jobs Unload the Sample JCL from the Product Tape The following sample installation jobs are provided as part of the product to help you install ITSM Data Protection for Lotus Domino: 16 Copyright IBM Corp. 1998, 2003

23 Figure 16. Sample Installation Jobs Job Name Job Type Description LFIL ANSDCV CIV Sample CIV job IBM.HDN5120.F2 ANSDALOC ALLOCAT Sample job to allocate target and distribution libraries IBM.HDN5120.F2 ANSDMKDJ MKDI Sample job to run the XX exec ANSDMKD IBM.HDN5120.F2 ANSDMKD n/a XX exec to make the HFS installation directories IBM.HDN5120.F2 ANSDDDF DDDF Sample job to define SMP/ DDDFs IBM.HDN5120.F2 ANSDAPCK APPLY Sample APPLY CHCK job IBM.HDN5120.F2 ANSDAPLY APPLY Sample APPLY job IBM.HDN5120.F2 ANSDACCK ACCPT CHCK Sample ACCPT CHCK job IBM.HDN5120.F2 ANSDACCP ACCPT Sample ACCPT job IBM.HDN5120.F2 In the sample SMP/ jobs provided, the name of the SMP/ CSI is #globalcsi. The global zone name in the SMP/ CSI is GLOBAL. The distribution zone name is #dzone. The target zone name is #tzone. The sample jobs should be updated to reflect the CSI and zone names used at your installation. You may copy the jobs from the tape or product files by submitting the job below. Use either the //TAPIN or the //FILIN DD statement, depending on your distribution medium, and comment out or delete the other statement. Add a job card and change the lowercase parameters to uppercase values to meet your site's requirements before submitting. //STP1 XC PGM=IBCOPY //SYSPINT DD SYSOUT= //TAPIN DD DSN=IBM.HDN512.F2,UNIT=tunit,VOL=S=DN512, // LABL=(3,SL),DISP=(OLD,KP) //FILIN DD DSN=IBM.HDN512.F2,UNIT=SYSALLDA,DISP=SH, // VOL=S=filevol //OUT DD DSNAM=jcl-library-name, // DISP=(NW,CATLG,DLT), // VOL=S=dasdvol,UNIT=SYSALLDA, // SPAC=(TK,(2,1,2)) //SYSUT3 DD UNIT=SYSALLDA,SPAC=(CYL,(1,1)) //SYSIN DD COPY INDD=xxxxIN,OUTDD=OUT / In the sample above, update the statements as noted below: If using TAPIN: tunit is the unit value matching the product tape. 'DN5120' is the volume serial matching the product tape. '3' is the tape file number where the data set name is on the tape. efer to the documentation provided by CBPDO to see where IBM.HDN5120.F2 is on the tape. Installation Instructions 17

24 If using FILIN filevol is the volume serial of the DASD device where the downloaded files reside. OUT jcl-library-name is the name of the output data set where the sample jobs will be stored dasdvol is the volume serial of the DASD device where the output data set will reside SYSIN xxxxin is either TAPIN or FILIN depending on your input DD statement. You can also access the sample installation jobs by performing an SMP/ CIV and then copying the jobs from the relfiles to a work data set for editing and submission. See Figure 16 on page 16 to find the appropriate relfile data set Perform SMP/ CIV Perform an SMP/ CIV for ITSM Data Protection for Lotus Domino. Having obtained ITSM Data Protection for Lotus Domino as part of a CBPDO, use the CVPDO job found in the CBPDO IMLIB data set to CIV the ITSM Data Protection for Lotus Domino FMIDs as well as any service, HOLDDATA, or preventive service planning (PSP) information included on the CBPDO tape. For more information, refer to the documentation included with the CBPDO. You can also choose to edit and submit sample job ANSDCV to perform the SMP/ CIV for ITSM Data Protection for Lotus Domino. Consult the instructions in the sample job for more information. xpected eturn Codes and Messages: A return code of 0 is expected from this job when installing ITSM Data Protection for Lotus Domino on OS/390 release 10 or higher Allocate SMP/ Target and Distribution Libraries and Paths dit and submit sample job ANSDALOC to allocate the SMP/ target and distribution libraries for ITSM Data Protection for Lotus Domino. Consult the instructions in the sample job for more information. xpected eturn Codes and Messages: A return code of 0 is expected from this job. dit and submit sample job ANSDMKDJ to allocate the HFS paths for ITSM Data Protection for Lotus Domino. Consult the instructions in the sample job for more information. Directories '/usr/lpp' or -PathPrefix-/usr/lpp/ and '/bin' must exist prior to running ANSDMKDJ. These directories are created when running the BPXISMKD XX exec provided by Opendition MVS System Services, found in SYS1.SAMPLIB. nsure that the BPXISMKD exec has been run before executing ANSDMKDJ. 18 ITSM Data Protection for Lotus Domino Program Directory

25 xpected eturn Codes and Messages: A return code of 0 is expected from this job Create DDDF ntries dit and submit sample job ANSDDDF to create DDDF entries for the SMP/ target and distribution libraries for ITSM Data Protection for Lotus Domino. Consult the instructions in the sample job for more information. xpected eturn Codes and Messages: A return code of 0 is expected from this job Perform SMP/ APPLY dit and submit sample job ANSDAPCK to perform an SMP/ APPLY CHCK for ITSM Data Protection for Lotus Domino. Consult the instructions in the sample job for more information. To receive the full benefit of the SMP/ Causer SYSMOD Summary eport, do not bypass the following on the APPLY CHCK: P, ID, Q, and IFQ. This is because the SMP/ root cause analysis identifies the cause only of OS and not of WANINGS (SYSMODs that are bypassed are treated as warnings, not errors, by SMP/). Once you have taken any actions indicated by the APPLY CHCK, run the ANSDAPLY job to perform the APPLY. Note: The GOUPXTND operand indicates that SMP/ apply all requisite SYSMODs. The requisite SYSMODS might be applicable to other functions. xpected eturn Codes and Messages from APPLY CHCK & APPLY: A return code of 0 is expected from these jobs when installing ITSM Data Protection for Lotus Domino on OS/390 release 10 or higher, unless the BYPASS option is used. If the BYPASS option is used, rc=4 is expected Perform SMP/ ACCPT dit and submit sample job ANSDACCK to perform an SMP/ ACCPT CHCK for ITSM Data Protection for Lotus Domino. Consult the instructions in the sample job for more information. To receive the full benefit of the SMP/ Causer SYSMOD Summary eport, do not bypass the following on the ACCPT CHCK: P, ID, Q, and IFQ. This is because the SMP/ root cause analysis identifies the cause only of OS and not of WANINGS (SYSMODs that are bypassed are treated as warnings, not errors, by SMP/). Installation Instructions 19

26 Before using SMP/ to load new distribution libraries, it is recommended that you set the ACCJCLIN indicator in the distribution zone. This will cause entries produced from JCLIN to be saved in the distribution zone whenever a SYSMOD containing inline JCLIN is ACCPTed. For more information on the ACCJCLIN indicator, see the description of inline JCLIN in the SMP/ manuals. Once you have taken any actions indicated by the ACCPT CHCK, run the ANSDACCP job again to perform the ACCPT. Note: The GOUPXTND operand indicates that SMP/ accept all requisite SYSMODs. The requisite SYSMODS might be applicable to other functions. xpected eturn Codes and Messages from ACCPT CHCK & ACCPT: A return code of 0 is expected from these jobs when installing ITSM Data Protection for Lotus Domino on OS/390 release 10 or higher, unless the BYPASS option is used. If the BYPASS option is used, rc=4 is expected. If PTFs containing replacement modules are being ACCPTed, SMP/ ACCPT processing will linkedit/bind the modules into the distribution libraries. During this processing, the Linkage ditor or Binder may issue messages documenting unresolved external references, resulting in a return code of 4 from the ACCPT step. These messages can be ignored, because the distribution libraries are not executable and the unresolved external references will not affect the executable system libraries Post Installation Configuration Submit sample script dominstall to Set HFS file permission bits and symbolic links for ITSM Data Protection for Lotus Domino client. Consult the instructions in the sample job or ANSDINST for more information. The ITSM Data Protection for Lotus Domino sample shell script ANSDINST can be found in SMPTLIB: IBM.HDN5120.F2 after the CIV step has been completed. Attention This action must be done in the root default directory '/usr/lpp/tivoli/tsm/client/domino/bin' and not in a service directory such as -PathPrefix-/usr/lpp/Tivoli/tsm/client/domino/bin/. This JOB must be run from a USID that has a UID(0). It will set appropriate permissions for HFS files and set the symbolic links. Perform this procedure to run: cd into the installation directory. : un dominstall xpected eturn Codes and Messages: 20 ITSM Data Protection for Lotus Domino Program Directory

27 rc=1 means /usr/lpp/tivoli/tsm/client/domino/bin directory cannot be found. rc=0 means successful run Configure Client Option Files The file dsm.opt.smp in the directory '/usr/lpp/tivoli/tsm/client/domino/bin' is a sample client option file. Copy the sample file to dsm.sys and dsm.opt respectively and tailor the option files to your special installation needs. See Tivoli Data Protection for Lotus Domino for UNIX Installation and Users Guide Version 5 elease 2.0, SH , for instructions on how to configure the option files. Initially, the communications parameters that apply to your installation and at least one TSM server may need to be specified. 6.2 Activating ITSM Data Protection for Lotus Domino The publication Tivoli Data Protection for Lotus Domino for UNIX Installation and Users Guide Version 5 elease 2.0, SH contains the step-by-step procedures to activate the functions of ITSM Data Protection for Lotus Domino. Installation Instructions 21

28 Appendix A. ITSM Data Protection for Lotus Domino Install Logic A.1 SMP/ Modification Control Statements The SMP/ Modification Control Statements (SMPMCS) for ITSM Data Protection for Lotus Domino are contained in the SMPMCS file on the installation tape. The SMPMCS for each FMID in the product will be loaded to the SMPPTS data set, with a member name matching the FMID, when the FMID is SMP/ CIVd. You may browse or print these members using TSO/, ISPF, or IBGN (or IBPTPCH). A.2 SMP/ JCLIN The JCLIN for ITSM Data Protection for Lotus Domino is contained in the LFILs on the installation tape. These files will be loaded to disk by SMP/ when the product is SMP/ CIVd. You may browse or print these files using TSO/, ISPF, or IBGN (or IBPTPCH). The files containing JCLIN are: FMID HDN5120: 'high-level-qualifier'.hdn5120.f1(hdn5120) Note: The high-level qualifier is the qualifier specified as the DSPFIX in the SMP/ OPTIONS. 22 Copyright IBM Corp. 1998, 2003

29 Contacting Customer Support For support for this or any Tivoli product, you can contact Tivoli Customer Support in one of the following ways: Submit a problem management record (PM) electronically at IBMSV/IBMLINK. Submit a problem management record (PM) electronically from our Web site at You can also review the IBM Software Support Guide, which is available on the Web site listed above. An nd of Support Matrix is provided as well which will tell you when products you are using are nearing the end of support date for a particular version or release. When you contact Tivoli Customer Support, be prepared to provide identification information for your company so that support personnel can readily assist you. Company identification information may also be needed to access various online services available on the Web site. The support Web site offers extensive information, including a guide to support services (the IBM Software Support Guide); frequently asked questions (FAQs); and documentation for all Tivoli products, including elease Notes, edbooks, and Whitepapers. The documentation for some product releases is available in both PDF and HTML formats. Translated documents are also available for some product releases. 23

30 IBM Printed in U.S.A. GI