SCRIPT/VS 4.0.0: DEVICE 1403N8 CHARS MONO » Program Directory for AFP Conversion & Indexing Facility Version 3 Release 1, Modification Level 0  Program Number 5655-B17  FMID HQN2110  for Use with MVS OS/390 CBPDO Level SMC9846 Service Level 9846 Document Date: January 8, 1999  GI10-0225-01 » Ð××× NOTE! ×××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | | | Before using this information and the product it supports, be sure | | to read the general information under "Notices" on page v. | | | ¿×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ר  A form for reader's comments appears at the back of this publication. When you send information to IBM, you grant IBM a nonexclusive right to use or distribute the information in any way it believes appropriated without incurring any obligation to you. (C) COPYRIGHT INTERNATIONAL BUSINESS MACHINES CORPORATION 1993,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. » CONTENTS  NOTICES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . V Trademarks . . . . . . . . . . . . . . . . . . . . . . . . . . . v 1.0 INTRODUCTION . . . . . . . . . . . . . . . . . . . . . . . . 1 1.1 ACIF Description . . . . . . . . . . . . . . . . . . . . . 1 1.2 ACIF FMID . . . . . . . . . . . . . . . . . . . . . . . . . 2 2.0 PROGRAM MATERIALS . . . . . . . . . . . . . . . . . . . . . 3 2.1 Basic Machine-Readable Material . . . . . . . . . . . . . . 3 2.2 Optional Machine-Readable Material . . . . . . . . . . . . . 4 2.3 Program Publications . . . . . . . . . . . . . . . . . . . . 4 2.3.1 Basic Program Publications . . . . . . . . . . . . . . . 4 2.3.2 Optional Program Publications . . . . . . . . . . . . . 4 2.4 Program Source Materials . . . . . . . . . . . . . . . . . . 4 2.5 Publications Useful During Installation . . . . . . . . . . 4 3.0 PROGRAM SUPPORT . . . . . . . . . . . . . . . . . . . . . . 5 3.1 Program Services . . . . . . . . . . . . . . . . . . . . . . 5 3.2 Preventive Service Planning . . . . . . . . . . . . . . . . 5 3.3 Statement of Support Procedures . . . . . . . . . . . . . . 5 4.0 PROGRAM AND SERVICE LEVEL INFORMATION . . . . . . . . . . . 7 4.1 Program Level Information . . . . . . . . . . . . . . . . . 7 4.2 Service Level Information . . . . . . . . . . . . . . . . . 7 4.3 Cumulative Service Tape . . . . . . . . . . . . . . . . . . 7 5.0 INSTALLATION REQUIREMENTS AND CONSIDERATIONS . . . . . . . . 9 5.1 Driving System Requirements . . . . . . . . . . . . . . . . 9 5.1.1 Machine Requirements . . . . . . . . . . . . . . . . . . 9 5.1.2 Programming Requirements . . . . . . . . . . . . . . . . 9 5.2 Target System Requirements . . . . . . . . . . . . . . . . . 9 5.2.1 Machine Requirements . . . . . . . . . . . . . . . . . . 9 5.2.2 Programming Requisites . . . . . . . . . . . . . . . . . 9 5.2.2.1 Minimum Requisites . . . . . . . . . . . . . . . . . 10 5.2.2.2 Functional Requisites . . . . . . . . . . . . . . . 10 5.2.2.3 Toleration/Coexistence Requisites . . . . . . . . . 10 5.2.2.4 Incompatibility (Negative) Requisites . . . . . . . 10 5.2.3 DASD Storage Requirements . . . . . . . . . . . . . . . 11 5.3 FMIDs Deleted . . . . . . . . . . . . . . . . . . . . . . . 13 5.4 Special Considerations . . . . . . . . . . . . . . . . . . . 13 6.0 INSTALLATION INSTRUCTIONS . . . . . . . . . . . . . . . . . 15 6.1 Installing ACIF . . . . . . . . . . . . . . . . . . . . . . 15 6.1.1 SMP/E Considerations for Installing ACIF . . . . . . . . 15 6.1.2 SMP/E Environment . . . . . . . . . . . . . . . . . . . 15 6.1.3 SMP/E Options Subentry Values . . . . . . . . . . . . . 16 6.1.4 Unload Sample Jobs from Product Tape . . . . . . . . . . 16 6.1.5 Perform SMP/E RECEIVE . . . . . . . . . . . . . . . . . 17 6.1.6 RECEIVE Cumulative Service Tape, if applicable . . . . . 17 6.1.7 Allocate SMP/E Target and Distribution Libraries . . . . 18 6.1.8 Create DDDEF Entries . . . . . . . . . . . . . . . . . . 20 6.1.9 Perform SMP/E APPLY CHECK . . . . . . . . . . . . . . . 22 6.1.10 Perform SMP/E APPLY . . . . . . . . . . . . . . . . . . 23 6.1.11 Perform SMP/E ACCEPT CHECK . . . . . . . . . . . . . . 24 6.1.12 Perform SMP/E ACCEPT . . . . . . . . . . . . . . . . . 25 6.2 Activating ACIF . . . . . . . . . . . . . . . . . . . . . . 26 6.2.1 Update Link List in SYS1.PARMLIB (Optional) . . . . . . 26 6.2.2 ACIF Installation Verification Procedure . . . . . . . . 26 APPENDIX A. ACIF INSTALL LOGIC . . . . . . . . . . . . . . . . . 29 A.1 SMP/E Modification Control Statements . . . . . . . . . . . 29 A.1.1 For FMID HQN2110 . . . . . . . . . . . . . . . . . . . . 29 A.2 SMP/E JCLIN . . . . . . . . . . . . . . . . . . . . . . . . 30 APPENDIX B. READER'S COMMENTS . . . . . . . . . . . . . . . . . 31 (C) Copyright IBM Corp. 1993,1998 iii » FIGURES  1. Basic Material: Program Tape . . . . . . . . . . . . . . . . 3 2. Program Tape: File Content . . . . . . . . . . . . . . . . . 3 3. Basic Material: Unlicensed Publications . . . . . . . . . . 4 4. Publications Useful During Installation . . . . . . . . . . 4 5. PSP Upgrade and Subset ID . . . . . . . . . . . . . . . . . 5 6. Component ID . . . . . . . . . . . . . . . . . . . . . . . . 5 7. Driving System Software Requirements . . . . . . . . . . . . 9 8. Minimum Requisites . . . . . . . . . . . . . . . . . . . . . 10 9. Functional Requisites . . . . . . . . . . . . . . . . . . . 10 10. Total DASD Space Required (in 3390 tracks) by ACIF . . . . . 11 11. Storage Requirements for SMP/E Work Data Sets . . . . . . . 11 12. Storage Requirements for SMP/E Data Sets . . . . . . . . . . 12 13. Storage Requirements for ACIF Target Libraries . . . . . . . 12 14. Storage Requirements for ACIF Distribution Libraries . . . . 13 15. Storage Requirements for ACIF Non-SMP/E Data Sets . . . . . 13 16. SMP/E Options Subentry Values . . . . . . . . . . . . . . . 16 17. Unload - Sample Unload tape job . . . . . . . . . . . . . . 16 18. Sample SMP/E RECEIVE Job . . . . . . . . . . . . . . . . . . 17 19. RECEIVE Job for Cumulative Service Tape . . . . . . . . . . 18 20. Sample Allocate Job for ACIF . . . . . . . . . . . . . . . . 19 21. JCL to Create Target and Distribution DDDEFs for ACIF . . . 21 22. Sample SMP/E APPLY CHECK Job . . . . . . . . . . . . . . . . 23 23. Sample SMP/E APPLY Job . . . . . . . . . . . . . . . . . . . 24 24. Sample SMP/E ACCEPT CHECK Job . . . . . . . . . . . . . . . 25 25. Sample SMP/E ACCEPT Job . . . . . . . . . . . . . . . . . . 26 26. APKIVP Job for ACIF IVP . . . . . . . . . . . . . . . . . . 27 iv ACIF Program Directory » NOTICES  References 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 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. Evaluation and verification of operation in conjunction with other products, except those expressly designated by IBM, is the user's responsibility. APAR numbers are provided in this document to assist in locating PTFs that may be required. Ongoing problem reporting may result in additional APARs being created. Therefore, the APAR 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. 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, NY 10504-1785 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. THERE ARE NO WARRANTIES, EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. Some jurisdictions do not allow the exclusion of implied warranties, so the above exclusion may not apply to you. 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: AFP Print Services Facility CBIPO ProductPac(R) CBPDO PSF IBM(R) SP IBMLink S/390(R) MVS/ESA RETAIN OS/390(R) (C) Copyright IBM Corp. 1993,1998 v »  vi ACIF Program Directory » 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 AFP Conversion & Indexing Facility. This publication refers to AFP Conversion & Indexing Facility as ACIF. You should read all of this program directory before installing the program and then keep it for future reference. The program directory contains the following sections: ® 2.0, "Program Materials" on page 3 identifies the basic and optional program materials and documentation for ACIF. ® 3.0, "Program Support" on page 5 describes the IBM support available for ACIF. ® 4.0, "Program and Service Level Information" on page 7 lists the APARs (program level) and PTFs (service level) incorporated into ACIF. ® 5.0, "Installation Requirements and Considerations" on page 9 identifies the resources and considerations for installing and using ACIF. ® 6.0, "Installation Instructions" on page 15 provides detailed installation instructions for ACIF. ® 6.2, "Activating ACIF" on page 26 provides information on activating the functions of ACIF, and also provides information on the installation verification procedures. ® Appendix A, "ACIF Install Logic" on page 29 provides the install logic for ACIF. Before installing ACIF, read 3.2, "Preventive Service Planning" on page 5. This section tells you how to find any updates to the information and procedures in this program directory. Do not use this program directory if you are installing ACIF with an MVS Custom-Built Installation Process Offering (CBIPO), 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. If you are installing ACIF using the MVS Custom-Built Product Delivery Offering (CBPDO) (5751-CS3), use the softcopy program directory provided on the CBPDO tape. Your CBPDO contains a softcopy preventive service planning (PSP) upgrade for this product. All service and HOLDDATA for ACIF are included on the CBPDO tape.  1.1 ACIF DESCRIPTION ACIF is a tool that lets you convert an S/390 line-data print file into a MO:DCA××P document, retrieve resources used by the document, and index the file for later retrieval and viewing. ACIF provides these functions across systems and platforms: ® converts line-format print files to MO:DCA××P documents. ® Adds indexing tags to MO:DCA××P documents. ® Creates a separate index object file from the indexing tags in a MO:DCA××P document. ® Retrieves and packages AFP resources needed for printing or viewing a MO:DCA××P document. (C) Copyright IBM Corp. 1993,1998 1 » 1.2 ACIF FMID ACIF consists of the following FMID: HQN2110 2 ACIF Program Directory » 2.0 PROGRAM MATERIALS  An IBM program is identified by a program number and a feature number. The program number for ACIF when ordered as a feature of PSF V3 for OS/390 is 5655-B17. Basic Machine-Readable Materials are materials that are supplied under the base license and feature code, and are required for the use of the product. Optional Machine-Readable 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 ACIF. Ask your IBM representative for this information if you have not already received a copy.  2.1 BASIC MACHINE-READABLE MATERIAL The distribution medium for this program is 9-track magnetic tape (written at 6250 bpi), 3480 cartridge, or 4mm cartridge. The tape or cartridge contains all the programs and data needed for installation. It is installed using SMP/E, and is in SMP/E RELFILE format. See 6.0, "Installation Instructions" on page 15 for more information about how to install the program. Figure 1 describes the tape or cartridge. Figure 2 describes the file content of the program tape or cartridge. NOTE: If you are installing ACIF using the MVS Custom-Built Product Delivery Offering (CBPDO) (5751-CS3), some of the information in these figures may not be valid. Consult the CBPDO documentation for actual values. Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | Figure 1. Basic Material: Program Tape |  Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | ¯ ¯ ¯ ¯ | | | FEATURE | PHYSICAL | EXTERNAL LABEL | | | MEDIUM | NUMBER | VOLUME | IDENTIFICATION | VOLSER |  Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | | | | | | | 6250 tape | 5831 | 1 | PSF.ACIF.V310 | QN211A |  Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | | | | | | | 3480 cart. | 5832 | 1 | PSF.ACIF.V310 | QN211A |  Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | | | | | | | 4mm cart. | 6132 | 1 | PSF.ACIF.V310 | QN211A |  ¿×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ר ¿ ¿ ¿ ¿ Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | Figure 2. Program Tape: File Content |  Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | ¯ ¯ ¯ ¯ ¯ ¯ | | | | | DIST | | | BLK | | VOLSER | FILE | NAME | LIBRARY | RECFM | LRECL | SIZE |  Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | | | | | | | | | QN211A | 1 | SMPMCS | -- | FB | 80 | 8800 |  Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | | | | | | | | | | 2 | IBM.HQN2110.F1 | JCLIN | FB | 80 | 8800 |  Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | | | | | | | | | | 3 | IBM.HQN2110.F2 | AAPKMOD1| U | 0 | 6144 |  Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | | | | | | | | | | 4 | IBM.HQN2110.F3 | AAPKSAM1| FB | 80 | 8800 |  Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | | | | | | | | | | 5 | IBM.HQN2110.F4 | AAPKSAM2| FB | 80 | 8800 |  Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | | | | | | | | | | 6 | IBM.HQN2110.F5 | AAPKULIB| VBM | 8205 | 8209 |  Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | | | | | | | | | | 7 | IBM.HQN2110.F6 | AAPKSAM3| FBA | 200 | 8000 |  ¿×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ר ¿ ¿ ¿ ¿ ¿ ¿ (C) Copyright IBM Corp. 1993,1998 3 » 2.2 OPTIONAL MACHINE-READABLE MATERIAL No optional machine-readable materials are provided for ACIF.  2.3 PROGRAM PUBLICATIONS The following sections identify the basic and optional publications for ACIF.  2.3.1 BASIC PROGRAM PUBLICATIONS Figure 3 identifies the basic program publication for ACIF. This publication is included when you order the basic materials for ACIF. For additional copies, contact your IBM representative. Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | Figure 3. Basic Material: Unlicensed Publications |  Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | ¯ | | PUBLICATION TITLE | FORM NUMBER |  Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | | | | AFP Conversion & Indexing Facility: User's Guide | S544-5285 |  ¿×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ר ¿  2.3.2 OPTIONAL PROGRAM PUBLICATIONS No optional publications are provided for ACIF.  2.4 PROGRAM SOURCE MATERIALS No program source materials or viewable program listings are provided for ACIF.  2.5 PUBLICATIONS USEFUL DURING INSTALLATION The publications listed in Figure 4 may be useful during the installation of ACIF. To order copies, contact your IBM representative. Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | Figure 4. Publications Useful During Installation |  Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | ¯ | | PUBLICATION TITLE | FORM NUMBER |  Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | | | | OS/390 SMP/E Commands | SC28-1805 |  Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | | | | OS/390 SMP/E Reference | SC28-1806 |  Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | | | | OS/390 SMP/E User's Guide | SC28-1740 |  Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | | | | OS/390 SMP/E Messages and Codes | SC28-1738 |  Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | | | | SMP/E Reference | SC28-1107 |  Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | | | | SMP/E User's Guide | SC28-1302 |  Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | | | | SMP/E Messages and Codes | SC28-1108 |  Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | | | | OS/390 MVS JCL Reference | GC28-1757 |  Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | | | | MVS/ESA V5 JCL Reference | GC28-1479 |  ¿×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ר ¿  4 ACIF Program Directory » 3.0 PROGRAM SUPPORT  This section describes the IBM support available for ACIF.  3.1 PROGRAM SERVICES Contact your IBM representative for specific information about available program services.  3.2 PREVENTIVE SERVICE PLANNING Before installing ACIF, you should review the current Preventive Service Planning (PSP) information. If you obtained ACIF as part of a CBPDO, there is HOLDDATA and PSP information included on the CBPDO tape. If you obtained ACIF on a product tape, or if the CBPDO 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". PSP Buckets are identified by UPGRADEs, which specify product levels, and SUBSETs, which specify the FMIDs for a product level. The UPGRADE and SUBSET values for ACIF are: Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | Figure 5. PSP Upgrade and Subset ID |  Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | ¯ ¯ | | UPGRADE | SUBSET | DESCRIPTION |  Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | | | | | ACIF | HQN2110/9846 | ACIF |  ¿×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ר ¿ ¿  3.3 STATEMENT OF SUPPORT PROCEDURES Report any difficulties you have using this program to your IBM Support Center. If an APAR is required, the Support Center will provide the address to which any needed documentation can be sent. Figure 6 identifies the component ID (COMPID) for ACIF. Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | Figure 6. Component ID |  Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | ¯ ¯ ¯ | | | | | RETAIN | | FMID | COMPID | COMPONENT NAME | RELEASE |  Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | | | | | | HQN2110 | 564806201 | ACIF | 110 |  ¿×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ר ¿ ¿ ¿ (C) Copyright IBM Corp. 1993,1998 5 »  6 ACIF Program Directory » 4.0 PROGRAM AND SERVICE LEVEL INFORMATION  This section identifies the program and any relevant service levels of ACIF. The program level refers to the APAR fixes incorporated into the program. The service level refers to the PTFs integrated. Information about the cumulative service tape is also provided. This program is at Service Level 9846.  4.1 PROGRAM LEVEL INFORMATION The following APAR fixes against this release of ACIF have been incorporated into this Service Update, Service Level 9846. ® FMID HQN2110 PN39451 PN71191 PN81527 PQ03511 PN41826 PN71324 PN81807 PQ03981 PN44241 PN71614 PN82198 PQ04391 PN50104 PN71815 PN82368 PQ04429 PN51017 PN71931 PN83160 PQ05167 PN51229 PN71974 PN83206 PQ05444 PN51925 PN72026 PN83976 PQ05547 PN53621 PN72249 PN84413 PQ06691 PN53710 PN72359 PN84835 PQ06946 PN53970 PN73470 PN85097 PQ07139 PN55008 PN73683 PN85104 PQ07492 PN55288 PN74886 PN86494 PQ07682 PN56431 PN74914 PN86722 PQ08772 PN57157 PN74930 PN87787 PQ09307 PN57547 PN75027 PN88223 PQ09450 PN57555 PN75544 PN89280 PQ10246 PN58891 PN76385 PN89594 PQ12428 PN60317 PN76494 PN90324 PQ12989 PN60697 PN77224 PN90477 PQ12991 PN61520 PN77365 PN90981 PQ12992 PN61785 PN77537 PN91087 PQ13152 PN62706 PN77694 PN91414 PQ14778 PN63713 PN77727 PN91731 PQ15334 PN64032 PN78463 PN91755 PQ16410 PN64873 PN79096 PN92289 PQ16628 PN64974 PN79174 PN92597 PQ16927 PN66286 PN79284 PN92805 PQ17591 PN67316 PN79946 PQ00237 PQ17846 PN67591 PN79985 PQ00618 PQ17921 PN67746 PN80074 PQ01362 PQ18095 PN67975 PN80401 PQ01497 PQ18417 PN69691 PN80403 PQ01904 PQ19344 PN70849 PN81336 PQ02026 PQ19896 PN70919 PN81380 PQ02350 PQ20852 4.2 SERVICE LEVEL INFORMATION PTFs containing APAR fixes against this release of ACIF have been incorporated into this product tape. For a list of included PTFs, please refer to Appendix A, "ACIF Install Logic" on page 29.  4.3 CUMULATIVE SERVICE TAPE A cumulative service tape, containing PTFs not incorporated into this release, might be included with this program. Installation instructions for cumulative service tapes can be found in the SMP/E publications. If you received this product as part of a CBPDO or a ProductPac, PTFs not incorporated into this release are provided on the tape, and a separate cumulative service tape will not be provided. (C) Copyright IBM Corp. 1993,1998 7 »  8 ACIF Program Directory » 5.0 INSTALLATION REQUIREMENTS AND CONSIDERATIONS  The following sections identify the system requirements for installing and activating ACIF. 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/E updates, copies of the SMP/E CSI data sets that describe the system libraries, and your PARMLIB and PROCLIB. 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 REQUIREMENTS This section describes the environment of the driving system required to install ACIF.  5.1.1 MACHINE REQUIREMENTS The driving system can run in any hardware environment that supports the required software as described in 5.2, "Target System Requirements."  5.1.2 PROGRAMMING REQUIREMENTS Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | Figure 7. Driving System Software Requirements |  Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | ¯ | | PROGRAM | PRODUCT NAME AND | | NUMBER | MINIMUM VRM/SERVICE LEVEL |  Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | | | | 5668-949| System Modification Program/Extended (SMP/E) Release 8.1 | | | or higher |  ¿×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ר ¿  5.2 TARGET SYSTEM REQUIREMENTS This section describes the environment of the target system required to install and use ACIF.  5.2.1 MACHINE REQUIREMENTS The target system can run in any hardware environment that supports the required software.  5.2.2 PROGRAMMING REQUISITES  (C) Copyright IBM Corp. 1993,1998 9 » 5.2.2.1 MINIMUM REQUISITES A minimum requisite is defined as one of the following: 1. Installation Requisite: A product that is required at installation time. i.e. this product WILL NOT INSTALL successfully unless this requisite is met. This includes products that are specified as REQs, PREs, or CALLLIBs. 2. Run Time Requisite: A product that is NOT required for the successful installation of this product, but IS needed at run time in order for this product to work. Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | Figure 8. Minimum Requisites |  Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | ¯ ¯ | | | PRODUCT NAME AND | INSTALL | | PROGRAM NUMBER | MINIMUM VRM/SERVICE LEVEL | REQ? |  Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | ¿ ¿ | | Any ONE of the following: |  Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | ¯ ¯ ¯ | | | 5655-068 | MVS/ESA SP JES2 Version 5 Release 2.2 | No | | | | or higher | |  Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | | | | | | | 5655-069 | MVS/ESA SP JES3 Version 5 Release 2.2 | No | | | | or higher | |  Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | | | | | | | 5645-001 | OS/390 Version 1 Release 1 or higher | No |  Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | | | | | | | 5647-A01 | OS/390 Version 2 Release 4 or higher | No |  ¿×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ר ¿ ¿ ¿  5.2.2.2 FUNCTIONAL REQUISITES A functional requisite is defined as a product that is not required for the successful installation of this product or for the base 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 REQs. Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | Figure 9. Functional Requisites |  Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | ¯ ¯ ¯ | | | PRODUCT NAME AND | | | | PROGRAM | MINIMUM VRM/SERVICE | | INSTALL | | NUMBER | LEVEL | FUNCTION | REQ? |  Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | | | | | | 5655-B17 | PSF Version 3.1.0 | To print output from | No | | | for OS/390 | ACIF | |  ¿×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ר ¿ ¿ ¿  5.2.2.3 TOLERATION/COEXISTENCE REQUISITES 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 difference time intervals. ACIF has no toleration/coexistence requisites.  5.2.2.4 INCOMPATIBILITY (NEGATIVE) REQUISITES A negative requisite identifies products which must not be installed on the same system as this product. ACIF has no negative requisites. 10 ACIF Program Directory » 5.2.3 DASD STORAGE REQUIREMENTS ACIF libraries can reside on any IBM MVS supported DASD. Figure 10 on page 11 lists the total space required for each type of library. Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | Figure 10. Total DASD Space Required (in 3390 tracks) by ACIF |  Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | ¯ | | LIBRARY TYPE | TOTAL SPACE REQUIRED |  Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | | | | Target | 25 tracks |  Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | | | | Distribution | 38 tracks |  ¿×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ר ¿ NOTES: 1. The data set sizes specified contain 15% extra space. You may wish to revise these numbers based on your plans for adding additional function or service. 2. IBM recommends use of system determined blocksizes for efficient DASD utilization for all non-RECFM U data sets. For RECFM U data sets, IBM recommends a blocksize of 32760, which is the most efficient from a performance and DASD utilization perspective. If you choose not to use system determined blocksizes, use the blocksizes and numbers of blocks specified to allocate the data sets. Data sets can be reblocked to a larger size. Please note that the maximum allowable blocksize will depend on the type of DASD on which the dataset will reside; for example, the blocksize of datasets on a 3350 DASD cannot exceed 19,069. 3. Abbreviations used for the data set type are: U Unique data set used by only the FMIDs listed. In order 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. S Shared data set used by more than the FMIDs listed. In order 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. 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.7, "Allocate SMP/E Target and Distribution Libraries" on page 18. Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | Figure 11 (Page 1 of 2). Storage Requirements for SMP/E Work Data | | Sets |  Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | ¯ ¯ ¯ ¯ ¯ ¯ ¯ | | | | D | R | L | NO. | | | | | T | S | E | R | OF | NO. | NO. | | | Y | O | C | E | 3380/| OF | OF | | LIBRARY | P | R | F | C | 9345 | 3390 | DIR | | DDNAME | E | G | M | L | TRKS | TRKS | BLKS |  Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | | | | | | | | | | SMPWRK1 | S | PO | FB | 80 | 75 | 75 | 50 |  Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | | | | | | | | | | SMPWRK2 | S | PO | FB | 80 | 75 | 75 | 50 |  ¿×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ר ¿ ¿ ¿ ¿ ¿ ¿ ¿  Installation Requirements and Considerations 11 » Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | Figure 11 (Page 2 of 2). Storage Requirements for SMP/E Work Data | | Sets |  Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | ¯ ¯ ¯ ¯ ¯ ¯ ¯ | | | | D | R | L | NO. | | | | | T | S | E | R | OF | NO. | NO. | | | Y | O | C | E | 3380/| OF | OF | | LIBRARY | P | R | F | C | 9345 | 3390 | DIR | | DDNAME | E | G | M | L | TRKS | TRKS | BLKS |  Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | | | | | | | | | | SMPWRK3 | S | PO | FB | 80 | 75 | 75 | 50 |  Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | | | | | | | | | | SMPWRK4 | S | PO | FB | 80 | 75 | 75 | 50 |  Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | | | | | | | | | | SMPWRK6 | S | PO | FB | 80 | 75 | 75 | 50 |  Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | | | | | | | | | | SYSUT1 | U | PS | -- | -- | 75 | 75 | 0 |  Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | | | | | | | | | | SYSUT2 | U | PS | -- | -- | 75 | 75 | 0 |  Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | | | | | | | | | | SYSUT3 | U | PS | -- | -- | 75 | 75 | 0 |  Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | | | | | | | | | | SYSUT4 | U | PS | -- | -- | 75 | 75 | 0 |  ¿×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ר ¿ ¿ ¿ ¿ ¿ ¿ ¿ The following table provides an estimate of the storage needed in the SMP/E data sets for ACIF. 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 Requirements for SMP/E Data Sets |  Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | ¯ ¯ ¯ ¯ ¯ ¯ ¯ | | | | D | R | L | NO. | | | | | T | S | E | R | OF | NO. | NO. | | | Y | O | C | E | 3380/| OF | OF | | LIBRARY | P | R | F | C | 9345 | 3390 | DIR | | DDNAME | E | G | M | L | TRKS | TRKS | BLKS |  Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | | | | | | | | | | SMPLTS (not used) | S | PO | U | 0 | 0 | 0 | 0 |  Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | | | | | | | | | | SMPMTS | S | PO | FB | 80 | 0 | 0 | 0 |  Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | | | | | | | | | | SMPPTS | S | PO | FB | 80 | 2 | 2 | 1 |  Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | | | | | | | | | | SMPSCDS | S | PO | FB | 80 | 2 | 2 | 1 |  Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | | | | | | | | | | SMPSTS | S | PO | FB | 80 | 0 | 0 | 0 |  ¿×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ר ¿ ¿ ¿ ¿ ¿ ¿ ¿ The following figures list the target and distribution libraries (data sets) and their attributes required to install ACIF. The storage requirements of ACIF must be added to the storage required by other programs having data in the same data set (library). A 10% additional growth factor has been added into the library size. Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | Figure 13. Storage Requirements for ACIF Target Libraries |  Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | ¯ ¯ ¯ ¯ ¯ ¯ ¯ | | | | D | R | L | NO. | | | | | T | S | E | R | OF | NO. | NO. | | | Y | O | C | E | 3380/| OF | OF | | LIBRARY | P | R | F | C | 9345 | 3390 | DIR | | DDNAME | E | G | M | L | TRKS | TRKS | BLKS |  Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | | | | | | | | | | SAPKMOD1 | U | PO| U | 0 | 18 | 16 | 2 |  Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | | | | | | | | | | SAPKSAM1 | U | PO| FB | 80 | 1 | 1 | 2 |  Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | | | | | | | | | | SAPKSAM2 | U | PO| FB | 80 | 1 | 1 | 2 |  Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | | | | | | | | | | SAPKSAM3 | U | PO| FBA | 200 | 6 | 5 | 2 |  Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | | | | | | | | | | SAPKULIB | U | PO| VBM | 8205 | 2 | 2 | 2 |  ¿×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ר ¿ ¿ ¿ ¿ ¿ ¿ ¿  12 ACIF Program Directory » Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | Figure 14. Storage Requirements for ACIF Distribution Libraries |  Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | ¯ ¯ ¯ ¯ ¯ ¯ ¯ | | | | D | R | L | NO. | | | | | T | S | E | R | OF | NO. | NO. | | | Y | O | C | E | 3380/| OF | OF | | LIBRARY | P | R | F | C | 9345 | 3390 | DIR | | DDNAME | E | G | M | L | TRKS | TRKS | BLKS |  Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | | | | | | | | | | AAPKMOD1 | U | PO | U | 0 | 30 | 29 | 28 |  Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | | | | | | | | | | AAPKSAM1 | U | PO | FB | 80 | 1 | 1 | 2 |  Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | | | | | | | | | | AAPKSAM2 | U | PO | FB | 80 | 1 | 1 | 2 |  Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | | | | | | | | | | AAPKSAM3 | U | PO | FBA | 200 | 6 | 5 | 2 |  Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | | | | | | | | | | AAPKULIB | U | PO | VBM | 8205 | 2 | 2 | 2 |  ¿×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ר ¿ ¿ ¿ ¿ ¿ ¿ ¿ The following figures list data sets that are not used by SMP/E, but are required for ACIF to execute. Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | Figure 15. Storage Requirements for ACIF Non-SMP/E Data Sets |  Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | ¯ ¯ ¯ ¯ ¯ ¯ ¯ | | | | D | R | L | NO. | | | | | T | S | E | R | OF | NO. | NO. | | | Y | O | C | E | 3380/| OF | OF | | DATA SET | P | R | F | C | 9345 | 3390 | DIR | | NAME | E | G | M | L | TRKS | TRKS | BLKS |  Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | | | | | | | | | | APK.ACIF.IVPSAMP.INDEX | U | PS | VBM | 32756| 15 | 15 | 0 |  Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | | | | | | | | | | APK.ACIF.IVPSAMP.OUTPUT | U | PS | VBM | 32756| 150 | 150 | 0 |  Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | | | | | | | | | | APK.ACIF.IVPSAMP.RESLIB | U | PO | VBM | 12284| 51 | 38 | 15 |  ¿×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ר ¿ ¿ ¿ ¿ ¿ ¿ ¿  5.3 FMIDS DELETED Installing ACIF will not delete any existing FMIDs.  5.4 SPECIAL CONSIDERATIONS If you have installed Enhanced ACIF (FMID HQN2220), DO NOT INSTALL ACIF (FMID HQN2110). FMID HQN2220 deletes and supercedes FMID HQN2110. Enhanced ACIF provides additional indexing capabilities not available with the HQN2110 level of ACIF. Enhanced ACIF is shipped with RMDS, program number 5648-048. ACIF (FMID HQN2110) is a service update of the ACIF FMID that was available with PSF/MVS Version 2 (5695-040). If you have already installed FMID HQN2110 and your service level is at least Service Level 9846, then you do not need to reinstall ACIF. It is possible to install the service listed in 4.0, "Program and Service Level Information" on page 7 for FMID HQN2110 to receive the same function as this service-updated level of ACIF.  Installation Requirements and Considerations 13 »  14 ACIF Program Directory » 6.0 INSTALLATION INSTRUCTIONS  This chapter describes the installation method and the step-by-step procedures to install and to activate the functions of ACIF. Please note the following: ® If you want to install ACIF into its own SMP/E environment, consult the SMP/E manuals for instructions on creating and initializing the SMPCSI and the SMP/E control data sets. ® Sample jobs have been provided to help perform some or all of the installation tasks. The SMP/E jobs assume that all DDDEF entries required for SMP/E execution have been defined in the appropriate zones. ® The SMP/E dialogs may be used instead of the sample jobs to accomplish the SMP/E installation steps.  6.1 INSTALLING ACIF  6.1.1 SMP/E CONSIDERATIONS FOR INSTALLING ACIF This release of ACIF is installed using the SMP/E RECEIVE, APPLY, and ACCEPT commands. The SMP/E dialogs may be used to accomplish the SMP/E installation steps.  6.1.2 SMP/E ENVIRONMENT All SMP/E installation jobs provided assume that all necessary DD statements for the execution of SMP/E are defined using DDDEFs. Sample jobs are provided to assist you in installing ACIF. After the RECEIVE step has been completed, the sample jobs can be found in SMPTLIB: IBM.HQN2110.F3. Make a copy of these jobs in your own library and modify them to use during the installation of ACIF. The sample jobs are: APKQRCV Sample RECEIVE job APKQRCVC Sample RECEIVE job for cumulative service APKQALOC Sample job to allocate target and distribution libraries APKQDDEF Sample job to define SMP/E DDDEFs APKQAPCK Sample APPLY CHECK job APKQAP Sample APPLY job APKQACCK Sample ACCEPT CHECK job APKQAC Sample ACCEPT job In the sample SMP/E jobs provided, the name of the SMP/E CSI is "#globalcsi". The global zone name in the SMP/E 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. (C) Copyright IBM Corp. 1993,1998 15 » Ð××× IMPORTANT - INSTALLATION CHANGES ××××××××××××××××××××××××××××××ׯ | | | The sample jobs provided with ACIF are shared with another | | product. The sample jobs on the tape REQUIRE MODIFICATION before | | you can run them. | | | | ® Only FMID HQN2110 is provided with ACIF. Remove all | | references to FMID HQN2112. | | | | ® Change all tape volser references from QN2110 to QN211A. | | | | ® Replace the references to a started procedure called SMPPROC | | with the following execute statement: | | | | //STEP1 EXEC PGM=GIMSMP,PARM='CSI=#globalcsi' | | | | replacing "#globalcsi" with the name of your SMP/E CSI. | | | | The sample jobs shown in this program directory have been | | corrected for ACIF installation. You may use them as a model for | | modifying the jobs on the tape. | | | ¿×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ר  6.1.3 SMP/E OPTIONS SUBENTRY VALUES The recommended values for some SMP/E CSI subentries are shown in Figure 16. Use of values lower than these may result in failures in the installation process. DSSPACE is a subentry in the GLOBAL options entry. PEMAX is a subentry of the GENERAL entry in the GLOBAL options entry. Refer to the SMP/E manuals for instructions on updating the global zone. Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | Figure 16. SMP/E Options Subentry Values |  Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | ¯ ¯ | | SUB-ENTRY | VALUE | COMMENT |  Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | | | | | DSSPACE | (35,10,35)TRK | Recommended value for ACIF |  Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | | | | | PEMAX | 9999 | The SMP/E default is larger than | | | | what can be specified here |  ¿×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ר ¿ ¿  6.1.4 UNLOAD SAMPLE JOBS FROM PRODUCT TAPE Sample installation jobs are provided on the distribution tape to help you install ACIF. The following sample job will copy the ACIF installation jobs from the tape. Add a job card and modify the parameters in boldface to uppercase values to meet your site's requirements before submitting. Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | | | //UNLOAD JOB 'account #','name',MSGLEVEL=(1,1) | | //STEP1 EXEC PGM=IEBCOPY | | //SYSPRINT DD SYSOUT=A | | //IN DD DSN=IBM.HQN2110.F3,UNIT=TUNIT,VOL=SER=QN211A, | | // LABEL=(4,SL),DISP=(OLD,KEEP) | | //OUT DD DSNAME=APK.JCLLIB, | | // DISP=(NEW,CATLG,DELETE), | | // VOL=SER=DASDVOL,UNIT=SYSALLDA, | | // DCB=*.STEP1.IN,SPACE=(8800,(5,2,5)) | | //SYSUT3 DD UNIT=SYSDA,SPACE=(CYL,(1,1)) | | //SYSIN DD * | | COPY INDD=IN,OUTDD=OUT | | /* | | | ¿×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ר Figure 17. Unload - Sample Unload tape job where TUNIT is the unit value matching the product tape or cartridge, APK.JCLLIB is the name of the data set where the sample jobs will  16 ACIF Program Directory » reside, and DASDVOL is the volume serial of the DASD device where the data set will reside. All future references will be to the sample data set name APK.jcllib in this program directory. You can also access the sample installation jobs by performing an SMP/E RECEIVE for FMID HQN2110, and then copying the jobs from data set HLQ.IBM.HQN2110.F3 to a work dataset for editing and submission.  6.1.5 PERFORM SMP/E RECEIVE Edit and submit sample job APKQRCV in APK.jcllib to perform the SMP/E RECEIVE for ACIF. Make the following modifications to the job before submitting it: 1. Modify the job card to meet your local requirements. 2. Replace the reference to a started procedure called SMPPROC with the following execute statement: //RECEIVE EXEC PGM=GIMSMP,PARM='CSI=#globalcsi' where "#globalcsi" is the name of your SMP/E CSI. 3. Modify the SMPPTFIN DD statement to specify the appropriate value for "tape", and change the tape volser to QN211A. 4. Specify the appropriate "UNIT" and "VOLSER" for the SMPTLIB data sets, or, delete the SMPTLIB DD statement and use a previously-defined DDDEF. 5. Change the SELECT operand on the RECEIVE statement to specify "S(HQN2110)", removing references to HQN2112. The APKQRCV job shown in Figure 18 has been modified as described in the steps above. You may use it as a model for your receive job. NOTE: If you obtained ACIF as part of a CBPDO, you can use the RCVPDO job found in the CBPDO RIMLIB data set to RECEIVE the ACIF 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. EXPECTED RETURN CODES AND MESSAGES: A return code of "0" should be received from this job. Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | | | //APKQRCV JOB 'account #','name',MSGLEVEL=(1,1) | | //RECEIVE EXEC PGM=GIMSMP,PARM='CSI=#globalcsi' | | //SMP.SMPPTFIN DD DSN=SMPMCS,DISP=(OLD,PASS), | | // VOL=SER=QN211A,LABEL=(1,SL), | | // UNIT=(tape,,DEFER) | | //SMPTLIB DD UNIT=xxxx,DISP=OLD,VOL=SER=nnnnnn | | //SMP.SMPCNTL DD * | | SET BDY(GLOBAL). | | RECEIVE S(HQN2110) SYSMOD . | | /* | | | ¿×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ר Figure 18. Sample SMP/E RECEIVE Job  6.1.6 RECEIVE CUMULATIVE SERVICE TAPE, IF APPLICABLE A cumulative service tape may be shipped with the product package. If no cumulative service tape is shipped or if the product is received by CBPDO, disregard this section. Edit and submit the sample job APKQRCVC to RECEIVE the PTFs and HOLDDATA from the cumulative service tape. The APKQRCVC job is shown in Figure 19 on page 18. Installation Instructions 17 » Modify the job card to meet your local requirements and specify the appropriate value for "tape". Replace the reference to a started procedure called SMPPROC with the following execute statement: //APSWRCVC EXEC PGM=GIMSMP,PARM='CSI=#globalcsi' where "#globalcsi" is the name of your SMP/E CSI. If any of the PTFs on the tape have a system hold by the ++HOLD SYSTEM modification control statement with a reason ID equal to UCLIN, file 6 of the cumulative service tape will contain the UCLIN for that PTF. The instructions for the UCLIN are contained in the cover letter of the PTF. EXPECTED RETURN CODES AND MESSAGES: A return code of "0" should be received from this job. Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | | | //APKQRCVC JOB 'account #','name',MSGLEVEL=(1,1) | | //*************************************************** | | //* RECEIVE CUMULATIVE SERVICE DATA. THE UNIT * | | //* AND SOURCEID FIELDS MUST BE FILLED IN. * | | //* SOURCEID IS A UNIQUE NAME THAT ASSIGNS * | | //* A COMMON IDENTIFIER TO THE SYSMODS RECEIVED. * | | //*************************************************** | | //APSWRCVC EXEC PGM=GIMSMP,PARM='CSI=#globalcsi' | | //SMPHOLD DD UNIT=tape,LABEL=(4,NL),DISP=SHR, | | // VOL=SER=CUMTAP, | | // DCB=(RECFM=FB,LRECL=80,BLKSIZE=7200) | | //SMPPTFIN DD UNIT=tape,LABEL=(1,NL),DISP=SHR, | | // VOL=SER=CUMTAP, | | // DCB=(RECFM=FB,LRECL=80,BLKSIZE=7200) | | //SMP.SMPCNTL DD * | | SET BDY(GLOBAL). | | RECEIVE SYSMODS HOLDDATA SOURCEID(sssssss). | | /* | | | ¿×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ר Figure 19. RECEIVE Job for Cumulative Service Tape  6.1.7 ALLOCATE SMP/E TARGET AND DISTRIBUTION LIBRARIES Edit and submit sample job APKQALOC in APK.jcllib to allocate the SMP/E target and distribution libraries for ACIF. Modify the job card to meet your local requirements and specify the appropriate parameters for your installation, using the comments in the job as a guide. Also, modify the high level qualifier prefix, "PSF.ACIF", to be a valid high level qualifier for your installation. EXPECTED RETURN CODES AND MESSAGES: A return code of "0" should be received from this job.  18 ACIF Program Directory » Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | | | //APKQALOC JOB 'account #','name',MSGLEVEL=(1,1) | | //* | | //*********************************************************** | | //* ALLOCATE TARGET AND DISTRIBUTION DATA SETS FOR * | | //* ACIF. * | | //* CHANGE xxxx TO BE A VALID UNIT NAME FOR YOUR * | | //* INSTALLATION. * | | //* CHANGE tttttt TO BE A VALID VOLUME SERIAL NUMBER FOR * | | //* THE TARGET LIBRARIES. * | | //* CHANGE dddddd TO BE A VALID VOLUME SERIAL NUMBER FOR * | | //* THE DISTRIBUTION LIBRARIES. * | | //*********************************************************** | | //ALLOC PROC ACIFPFX='PSF.ACIF', | | // UNIT=xxxx,TVOL=tttttt,DVOL=dddddd | | //ALLOC1 EXEC PGM=IEFBR14 | | //* | | //*********************************************************** | | //* ALLOCATE TARGET DATA SETS FOR ACIF. * | | //*********************************************************** | | //* | | //SAPKMOD1 DD DSN=&ACIFPFX..SAPKMOD1,DISP=(NEW,CATLG), | | // DCB=(RECFM=U,LRECL=0,BLKSIZE=6144), | | // UNIT=&UNIT,VOL=SER=&TVOL,SPACE=(6144,(144,14,2)) | | //* | | //SAPKSAM1 DD DSN=&ACIFPFX..SAPKSAM1,DISP=(NEW,CATLG), | | // DCB=(RECFM=FB,LRECL=80,BLKSIZE=6160), | | // UNIT=&UNIT,VOL=SER=&TVOL,SPACE=(6160,(16,2,2)) | | //* | | //SAPKSAM2 DD DSN=&ACIFPFX..SAPKSAM2,DISP=(NEW,CATLG), | | // DCB=(RECFM=FB,LRECL=80,BLKSIZE=6160), | | // UNIT=&UNIT,VOL=SER=&TVOL,SPACE=(6160,(16,2,2)) | | //* | | //SAPKSAM3 DD DSN=&ACIFPFX..SAPKSAM3,DISP=(NEW,CATLG), | | // DCB=(RECFM=FBA,LRECL=200,BLKSIZE=8000), | | // UNIT=&UNIT,VOL=SER=&TVOL,SPACE=(8000,(36,3,2)) | | //* | | //SAPKULIB DD DSN=&ACIFPFX..SAPKULIB,DISP=(NEW,CATLG), | | // DCB=(RECFM=VBM,LRECL=8205,BLKSIZE=8209), | | // UNIT=&UNIT,VOL=SER=&TVOL,SPACE=(8209,(18,2,2)) | | //* | | //*********************************************************** | | //* ALLOCATE DISTRIBUTION DATA SETS FOR ACIF. * | | //*********************************************************** | | //* | | | ¿×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ר Figure 20 (Part 1 of 2). Sample Allocate Job for ACIF Installation Instructions 19 » Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | | | //AAPKMOD1 DD DSN=&ACIFPFX..AAPKMOD1,DISP=(NEW,CATLG), | | // DCB=(RECFM=U,LRECL=0,BLKSIZE=6144), | | // UNIT=&UNIT,VOL=SER=&DVOL,SPACE=(6144,(256,26,28)) | | //* | | //AAPKSAM1 DD DSN=&ACIFPFX..AAPKSAM1,DISP=(NEW,CATLG), | | // DCB=(RECFM=FB,LRECL=80,BLKSIZE=6160), | | // UNIT=&UNIT,VOL=SER=&DVOL,SPACE=(6160,(16,2,2)) | | //* | | //AAPKSAM2 DD DSN=&ACIFPFX..AAPKSAM2,DISP=(NEW,CATLG), | | // DCB=(RECFM=FB,LRECL=80,BLKSIZE=6160), | | // UNIT=&UNIT,VOL=SER=&DVOL,SPACE=(6160,(16,2,2)) | | //* | | //AAPKSAM3 DD DSN=&ACIFPFX..AAPKSAM3,DISP=(NEW,CATLG), | | // DCB=(RECFM=FBA,LRECL=200,BLKSIZE=8000), | | // UNIT=&UNIT,VOL=SER=&DVOL,SPACE=(8000,(36,3,2)) | | //* | | //AAPKULIB DD DSN=&ACIFPFX..AAPKULIB,DISP=(NEW,CATLG), | | // DCB=(RECFM=VBM,LRECL=8205,BLKSIZE=8209), | | // UNIT=&UNIT,VOL=SER=&DVOL,SPACE=(8209,(18,2,2)) | | //* | | //EALLOC PEND | | //* | | //ALLOCAT EXEC ALLOC | | /* | | | ¿×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ר Figure 20 (Part 2 of 2). Sample Allocate Job for ACIF 6.1.8 CREATE DDDEF ENTRIES Edit and submit sample job APKQDDEF in APK.jcllib to create DDDEF entries for the SMP/E target and distribution libraries for ACIF. The APKQDDEF job is shown in Figure 21 on page 21. Make the following modifications to the APKQDDEF job: 1. Modify the job card to meet your local requirements. 2. Replace the reference to a started procedure called SMPPROC with the following execute statement: //DDDEFS EXEC PGM=GIMSMP,PARM='CSI=#globalcsi' where "#globalcsi" is the name of your SMP/E CSI. 3. Modify the high level qualifier of "PSF.ACIF" to be a valid high level qualifier for your installation. 4. Modify the "tgtzone", "dlibzone", "uuuu", "tvol", and "dvol" names in lower case as appropriate for your installation. If the target and distribution data sets that correspond to the DDDEFs will be cataloged, the UNIT and VOLUME parameters can be be deleted before the jobs are run. EXPECTED RETURN CODES AND MESSAGES: A return code of "4" and the message GIM27701W should be received from this job if the DDDEFs have never been created. A return code of "0" should be received if the DDDEFs were created previously or the jobs are rerun.  20 ACIF Program Directory » Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | | | //APKQDDEF JOB 'acct. no.','name',MSGLEVEL=(1,1) | | //DDDEFS EXEC PGM=GIMSMP,PARM='CSI=#globalcsi' | | //* | | //************************************************* | | //* Allocate SMP/E DDDEFS for ACIF. | | //* Modify the tgtzone, dlibzone, uuuu, tvol, | | //* and dvol names in lower case as appropriate | | //* for your installation. | | //* The distribution library DDDEFS are defined | | //* to the target zone for RESTORE purposes. | | //************************************************* | | //SMP.SMPCNTL DD * | | SET BDY(tgtzone) . | | UCLIN . | | REP DDDEF(SAPKMOD1) | | DATASET(PSF.ACIF.SAPKMOD1) | | UNIT(uuuu) VOLUME(tvol) | | OLD . | | REP DDDEF(SAPKSAM1) | | DATASET(PSF.ACIF.SAPKSAM1) | | UNIT(uuuu) VOLUME(tvol) | | OLD . | | REP DDDEF(SAPKSAM2) | | DATASET(PSF.ACIF.SAPKSAM2) | | UNIT(uuuu) VOLUME(tvol) | | OLD . | | REP DDDEF(SAPKSAM3) | | DATASET(PSF.ACIF.SAPKSAM3) | | UNIT(uuuu) VOLUME(tvol) | | OLD . | | REP DDDEF(SAPKULIB) | | DATASET(PSF.ACIF.SAPKULIB) | | UNIT(uuuu) VOLUME(tvol) | | OLD . | | REP DDDEF(AAPKMOD1) | | DATASET(PSF.ACIF.AAPKMOD1) | | UNIT(uuuu) VOLUME(dvol) | | OLD . | | REP DDDEF(AAPKSAM1) | | DATASET(PSF.ACIF.AAPKSAM1) | | UNIT(uuuu) VOLUME(dvol) | | OLD . | | | ¿×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ר Figure 21 (Part 1 of 2). JCL to Create Target and Distribution DDDEFs for ACIF  Installation Instructions 21 » Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | | | REP DDDEF(AAPKSAM2) | | DATASET(PSF.ACIF.AAPKSAM2) | | UNIT(uuuu) VOLUME(dvol) | | OLD . | | REP DDDEF(AAPKSAM3) | | DATASET(PSF.ACIF.AAPKSAM3) | | UNIT(uuuu) VOLUME(dvol) | | OLD . | | REP DDDEF(AAPKULIB) | | DATASET(PSF.ACIF.AAPKULIB) | | UNIT(uuuu) VOLUME(dvol) | | OLD . | | ENDUCL. | | SET BDY(dlibzone) . | | UCLIN . | | REP DDDEF(AAPKMOD1) | | DATASET(PSF.ACIF.AAPKMOD1) | | UNIT(uuuu) VOLUME(dvol) | | OLD . | | REP DDDEF(AAPKSAM1) | | DATASET(PSF.ACIF.AAPKSAM1) | | UNIT(uuuu) VOLUME(dvol) | | OLD . | | REP DDDEF(AAPKSAM2) | | DATASET(PSF.ACIF.AAPKSAM2) | | UNIT(uuuu) VOLUME(dvol) | | OLD . | | REP DDDEF(AAPKSAM3) | | DATASET(PSF.ACIF.AAPKSAM3) | | UNIT(uuuu) VOLUME(dvol) | | OLD . | | REP DDDEF(AAPKULIB) | | DATASET(PSF.ACIF.AAPKULIB) | | UNIT(uuuu) VOLUME(dvol) | | OLD . | | ENDUCL . | | /* | | // | | | ¿×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ר Figure 21 (Part 2 of 2). JCL to Create Target and Distribution DDDEFs for ACIF  6.1.9 PERFORM SMP/E APPLY CHECK Edit and submit sample job APKQAPCK in APK.jcllib to perform an SMP/E APPLY CHECK for ACIF. Make the following modifications to the APKQAPCK job before submitting it: 1. Modify the job card to meet your local requirements. 2. Replace the reference to a started procedure called SMPPROC with the following execute statement: //APPLYCK EXEC PGM=GIMSMP,PARM='CSI=#globalcsi' where "#globalcsi" is the name of your SMP/E CSI. 3. Specify the appropriate "UNIT" and "VOLSER" for the SMPTLIB data sets, or, delete the SMPTLIB DD statement and use a previously-defined DDDEF. 4. Change "tgtzone" to be the appropriate SMP/E target zone name for your installation. 5. Change the SELECT operand on the APPLY CHECK statement to specify "S(HQN2110)", removing references to HQN2112. 6. Add the "FORFMID(HQN2110)" parameter to the APPLY CHECK statement to install service along with the base FMID. 22 ACIF Program Directory » 7. If HQN2110 is already installed, you must add the REDO parameter to the APPLY CHECK statement. The APKQAPCK job shown in Figure 22 has been modified as described in the steps above. You may use it as a model for your apply check job. To receive the full benefit of the SMP/E Causer SYSMOD Summary Report, do not bypass the following on the APPLY CHECK: PRE, ID, REQ, and IFREQ. This is because the SMP/E root cause analysis identifies the cause only of ERRORS and not of WARNINGS (SYSMODs that are bypassed are treated as warnings, not errors, by SMP/E). The GROUPEXTEND operand indicates that SMP/E apply all requisite SYSMODs. The requisite SYSMODS might be applicable to other functions. EXPECTED RETURN CODES AND MESSAGES: A return code of "0" should be received from this job. Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | | | //APKQAPCK JOB 'account #','name',MSGLEVEL=(1,1) | | //APPLYCK EXEC PGM=GIMSMP,PARM='CSI=#globalcsi' | | //SMPTLIB DD UNIT=xxxx,DISP=OLD,VOL=SER=nnnnnn | | //SMP.SMPCNTL DD * | | SET BDY(tgtzone). | | APPLY CHECK S(HQN2110) | | FORFMID(HQN2110) | | BYPASS(HOLDCLASS(UCLREL,ERREL)) GROUPEXTEND. | | /* | | | ¿×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ר Figure 22. Sample SMP/E APPLY CHECK Job  6.1.10 PERFORM SMP/E APPLY Edit and submit sample job APKQAP in APK.jcllib to perform an SMP/E APPLY for ACIF. Make the following modifications to the APKQAP job before submitting it: 1. Modify the job card to meet your local requirements. 2. Replace the reference to a started procedure called SMPPROC with the following execute statement: //APPLY EXEC PGM=GIMSMP,PARM='CSI=#globalcsi' where "#globalcsi" is the name of your SMP/E CSI. 3. Specify the appropriate "UNIT" and "VOLSER" for the SMPTLIB data sets, or, delete the SMPTLIB DD statement and use a previously-defined DDDEF. 4. Change "tgtzone" to be the appropriate SMP/E target zone name for your installation. 5. Change the SELECT operand on the APPLY statement to specify "S(HQN2110)", removing references to HQN2112. 6. Add the "FORFMID(HQN2110)" parameter to the APPLY statement to install service along with the base FMID. 7. If HQN2110 is already installed, you must add the REDO parameter to the APPLY statement. The APKQAP job shown in Figure 23 on page 24 has been modified as described in the steps above. You may use it as a model for your apply job. EXPECTED RETURN CODES AND MESSAGES: A return code of "0" should be received from this job.  Installation Instructions 23 » Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | | | //APKQAP JOB 'account #','name',MSGLEVEL=(1,1) | | //APPLY EXEC PGM=GIMSMP,PARM='CSI=#globalcsi' | | //SMPTLIB DD UNIT=xxxx,DISP=OLD,VOL=SER=nnnnnn | | //SMP.SMPCNTL DD * | | SET BDY(tgtzone). | | APPLY S(HQN2110) | | FORFMID(HQN2110) | | BYPASS(HOLDCLASS(UCLREL,ERREL)) | | GROUPEXTEND. | | /* | | | ¿×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ר Figure 23. Sample SMP/E APPLY Job  6.1.11 PERFORM SMP/E ACCEPT CHECK Edit and submit sample job APKQACCK in APK.jcllib to perform an SMP/E ACCEPT CHECK for ACIF. Consult the instructions in the sample job for more information. Make the following modifications to the APKQACCK job before submitting it: 1. Modify the job card to meet your local requirements. 2. Replace the reference to a started procedure called SMPPROC with the following execute statement: //ACCEPTCK EXEC PGM=GIMSMP,PARM='CSI=#globalcsi' where "#globalcsi" is the name of your SMP/E CSI. 3. Specify the appropriate "UNIT" and "VOLSER" for the SMPTLIB data sets, or, delete the SMPTLIB DD statement and use a previously-defined DDDEF. 4. Modify the "dlibzone" to be the appropriate SMP/E distribution zone name for your installation. 5. Change the SELECT operand on the ACCEPT CHECK statement to specify "S(HQN2110)", removing references to HQN2112. 6. Add the "FORFMID(HQN2110)" parameter to the ACCEPT CHECK statement to install service along with the base FMID. 7. If HQN2110 is already installed, you must add the REDO parameter to the ACCEPT CHECK statement. The APKQACCK job shown in Figure 24 on page 25 has been modified as described in the steps above. You may use it as a model for your accept check job. To receive the full benefit of the SMP/E Causer SYSMOD Summary Report, do not bypass the following on the ACCEPT CHECK: PRE, ID, REQ, and IFREQ. This is because the SMP/E root cause analysis identifies the cause only of ERRORS and not of WARNINGS (SYSMODs that are bypassed are treated as warnings, not errors, by SMP/E). The GROUPEXTEND operand indicates that SMP/E accept all requisite SYSMODs. The requisite SYSMODS might be applicable to other functions. EXPECTED RETURN CODES AND MESSAGES: A return code of "0" should be received from this job. 24 ACIF Program Directory » Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | | | //APKQACCK JOB 'account #','name',MSGLEVEL=(1,1) | | //ACCEPTCK EXEC PGM=GIMSMP,PARM='CSI=#globalcsi' | | //SMPTLIB DD UNIT=xxxx,DISP=OLD,VOL=SER=nnnnnn | | //SMP.SMPCNTL DD * | | SET BDY(dlibzone). | | ACCEPT CHECK S(HQN2110) | | FORFMID(HQN2110) | | BYPASS (HOLDCLASS(UCLREL,ERREL)) GROUPEXTEND. | | /* | | | ¿×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ר Figure 24. Sample SMP/E ACCEPT CHECK Job  6.1.12 PERFORM SMP/E ACCEPT Edit and submit sample job APKQAC in APK.jcllib to perform an SMP/E ACCEPT for ACIF. Make the following modifications to the APKQAC job before submitting it: 1. Modify the job card to meet your local requirements. 2. Replace the reference to a started procedure called SMPPROC with the following execute statement: //ACCEPT EXEC PGM=GIMSMP,PARM='CSI=#globalcsi' where "#globalcsi" is the name of your SMP/E CSI. 3. Specify the appropriate "UNIT" and "VOLSER" for the SMPTLIB data sets, or, delete the SMPTLIB DD statement and use a previously-defined DDDEF. 4. Modify the "dlibzone" to be the appropriate SMP/E distribution zone name for your installation. 5. Change the SELECT operand on the ACCEPT statement to specify "S(HQN2110)", removing references to HQN2112. 6. Add the "FORFMID(HQN2110)" parameter to the ACCEPT statement to install service along with the base FMID. 7. If HQN2110 is already installed, you must add the REDO parameter to the ACCEPT statement. The APKQAC job shown in Figure 25 on page 26 has been modified as described in the steps above. You may use it as a model for your accept job. Before using SMP/E 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 ACCEPTed. For more information on the ACCJCLIN indicator, see the description of inline JCLIN in the SMP/E manuals. EXPECTED RETURN CODES AND MESSAGES: A return code of "0" should be received from this job. If PTFs containing replacement modules are being ACCEPTed, SMP/E ACCEPT processing will linkedit/bind the modules into the distribution libraries. During this processing, the Linkage Editor or Binder may issue IEW0461 or IEW2454W messages documenting unresolved external references, resulting in a return code of 4 from the ACCEPT 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.  Installation Instructions 25 » Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | | | //APKQAC JOB 'account #','name',MSGLEVEL=(1,1) | | //ACCEPT EXEC PGM=GIMSMP,PARM='CSI=#globalcsi' | | //SMPTLIB DD UNIT=xxxx,DISP=OLD,VOL=SER=nnnnnn | | //SMP.SMPCNTL DD * | | SET BDY(dlibzone). | | ACCEPT S(HQN2110) | | FORFMID(HQN2110) | | BYPASS(HOLDCLASS(UCLREL,ERREL)) | | GROUPEXTEND COMPRESS(ALL). | | /* | | | ¿×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ר Figure 25. Sample SMP/E ACCEPT Job  6.2 ACTIVATING ACIF This section describes the procedures for activating the functions of ACIF.  6.2.1 UPDATE LINK LIST IN SYS1.PARMLIB (OPTIONAL) You may wish to add the ACIF load library to the system link list so that the ACIF program can be executed without using a steplib. To do this, update the LNKLSTxx member of SYS1.PARMLIB to include the data set PSF.ACIF.SAPKMOD1.  6.2.2 ACIF INSTALLATION VERIFICATION PROCEDURE The IVP job supplied for ACIF processes a sample bank statement. To run the IVP, modify the APKIVP job shown in Figure 26 on page 27. This job exists in the data set PSF.ACIF.SAPKSAM2(APKIVP). Add a job card that contains the appropriate information for your installation, then submit the job. NOTE: The control statement input to the APKACIF program must not contain sequence numbers in column 73-80. Message APK402S and a return code 16 will be received if sequence numbers are included in the input. 26 ACIF Program Directory » Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | | | //APKACIF EXEC PGM=APKACIF,REGION=3M | | //*===========================================================* | | //* RUN APK, CREATING OUTPUT AND A RESOURCE LIBRARY * | | //*===========================================================* | | //STEPLIB DD DSN=PSF.ACIF.SAPKMOD1,DISP=SHR | | //INPUT DD DSN=PSF.ACIF.SAPKSAM3(APKBANK),DISP=SHR | | //SYSIN DD * | | /* 1-up,80 lines norm dup, port, front/back offset */ | | CC = YES /* carriage control used */ | | CCTYPE = A /* carriage control type */ | | CPGID = 500 /* code page identifier */ | | FDEFLIB= PSF.ACIF.SAPKULIB | | PDEFLIB= PSF.ACIF.SAPKULIB | | FONTLIB= PSF.ACIF.SAPKULIB | | PSEGLIB= PSF.ACIF.SAPKULIB | | OVLYLIB= PSF.ACIF.SAPKULIB | | FIELD1 = 0,9,3 /* 1st field */ | | FIELD2 = 1,50,35 /* 2nd field */ | | FIELD3 = 3,23,8 /* 3rd field */ | | FORMDEF = F1A18D1 /* formdef name */ | | IMAGEOUT = ASIS /* Input image unconverted */ | | INDEX1 = 'Report Number',field1 /* 1st index */ | | INDEX2 = 'Report Title',field2 /* 2nd index */ | | INDEX3 = 'Date',field3 /* 3rd index */ | | INDEXDD= INDEX /* index file ddname */ | | INDEXOBJ = ALL /* index level group or page */ | | INPUTDD= INPUT /* input file ddname */ | | OUTPUTDD = OUTPUT /* output file ddname */ | | PAGEDEF = P1A18D /* pagedef name */ | | RESFILE = PDS /* resource file type */ | | RESOBJDD = RESLIB /* resource file ddname */ | | RESTYPE = ALL /* resource type selection */ | | TRIGGER1 = *,1,'1' /* 1st trigger */ | | TRIGGER2 = 0,2,'REPORT' /* 2nd trigger */ | | USERLIB= PSF.ACIF.SAPKULIB | | /* | | | ¿×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ר Figure 26 (Part 1 of 2). APKIVP Job for ACIF IVP Installation Instructions 27 » Ð×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | | | //OUTPUT DD DSN=PSF.ACIF.IVPSAMP.OUTPUT,DISP=(NEW,CATLG), | | // SPACE=(32760,(150,150),RLSE),UNIT=SYSDA, | | // DCB=(LRECL=32756,BLKSIZE=32760,RECFM=VBM,DSORG=PS) | | //INDEX DD DSN=PSF.ACIF.IVPSAMP.INDEX,DISP=(NEW,CATLG), | | // SPACE=(32760,(15,15),RLSE),UNIT=SYSDA, | | // DCB=(LRECL=32756,BLKSIZE=32760,RECFM=VBM,DSORG=PS) | | //RESLIB DD DSN=PSF.ACIF.IVPSAMP.RESLIB,DISP=(NEW,CATLG), | | // SPACE=(12288,(150,15,15),RLSE),UNIT=SYSDA, | | // DCB=(LRECL=12284,BLKSIZE=12288,RECFM=VBM,DSORG=PO) | | //SYSPRINT DD SYSOUT=* | | //SYSUDUMP DD SYSOUT=* | | | ¿×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ר Figure 26 (Part 2 of 2). APKIVP Job for ACIF IVP  This job creates the following data sets: ® PSF.ACIF.IVPSAMP.INDEX ® PSF.ACIF.IVPSAMP.OUTPUT ® PSF.ACIF.IVPSAMP.RESLIB  The data set PSF.ACIF.IVPSAMP.INDEX is a sequential file that contains the indexes to the output data set PSF.ACIF.IVPSAMP.OUTPUT. The data set PSF.ACIF.IVPSAMP.RESLIB contains the following resources: ® C0D0GT18 ® F1A18D1 ® O1A183 ® O1A184 ® T1D0BASE SYSPRINT contains a list of all the input parameters that are defined in the APKIVP job, and the ACIF default parameters. The last statement is a message that the return code is "0". If the return code is "0", the IVP is completed successfully. To print the sample output data set, Print Services Facility (PSF) is required. Use your installation's normal process to print documents using the resources saved in the data set PSF.ACIF.IVPSAMP.RESLIB. NOTE: If you try to print the ACIF IVP job on a 3800 printer with other than large wide forms (14.88 by 11 inches), the IVP will not print and you will receive message APS743I.  28 ACIF Program Directory » APPENDIX A. ACIF INSTALL LOGIC  A.1 SMP/E MODIFICATION CONTROL STATEMENTS The SMP/E Modification Control Statements (SMPMCS) for ACIF are contained in the SMPMCS file on the installation tape. The SMPMCS for the FMID in the product will be loaded to the SMPPTS dataset, with a member name matching the FMID, when the FMID is SMP/E RECEIVEd. You may browse or print these members using TSO/E, ISPF, or IEBGENER (or IEBPTPCH).  A.1.1 FOR FMID HQN2110 ++FUNCTION(HQN2110 ) REWORK(1998313 ) RFDSNPFX(IBM ) FILES(6) /*********************************************************/ /* */ /* 5695-040, 5655-B17 (C) COPYRIGHT IBM CORP. */ /* 1993, 1998 */ /* */ /* ALL RIGHTS RESERVED */ /* */ /* US GOVERNMENT USERS RESTRICTED RIGHTS */ /* - USE, DUPLICATION OR DISCLOSURE */ /* RESTRICTED BY GSA ADP SCHEDULE */ /* CONTRACT BY IBM. */ /* */ /* LICENSED MATERIALS - PROPERTY OF IBM */ /* */ /* */ /*********************************************************/ . ++VER(Z038 ) SUP(AN39451 AN41826 AN44241 AN50104 AN51017 AN51229 AN51925 AN53621 AN53710 AN53970 AN55008 AN55288 AN56431 AN57157 AN57547 AN57555 AN58891 AN60317 AN60697 AN61520 AN61785 AN62706 AN63713 AN64032 AN64873 AN64974 AN66286 AN67316 AN67591 AN67746 AN67975 AN69691 AN70849 AN70919 AN71191 AN71324 AN71614 AN71815 AN71931 AN71974 AN72026 AN72249 AN72359 AN73470 AN73683 AN74886 AN74914 AN74930 AN75027 AN75544 AN76385 AN76494 AN77224 AN77365 AN77537 AN77694 AN77727 AN78463 AN79096 AN79174 AN79284 AN79946 AN79985 AN80074 AN80401 AN80403 AN81336 AN81380 AN81527 AN81807 AN82198 AN82368 AN83160 AN83206 AN83976 AN84413 AN84835 AN85097 AN85104 AN86494 AN86722 AN87787 AN88223 AN89280 AN89594 AN90324 AN90477 AN90981 AN91087 AN91414 AN91731 AN91755 AN92289 AN92597 AN92805 AQ00237 AQ00618 AQ01362 AQ01497 AQ01904 AQ02026 AQ02350 AQ03511 AQ03981 AQ04391 AQ04429 AQ05167 AQ05444 AQ05547 AQ06691 AQ06946 AQ07139 AQ07492 AQ07682 AQ08772 AQ09307 AQ09450 AQ10246 AQ12428 AQ12989 AQ12991 AQ12992 AQ13152 AQ14778 AQ15334 AQ16410 AQ16628 AQ16927 AQ17591 AQ17846 AQ17921 AQ18095 AQ18417 AQ19344 AQ19896 AQ20852 BN50104 BN67975 CN67975 UN43866 UN47897 UN47898 UN56430 UN56866 UN57483 UN58647 UN58768 UN59731 UN60091 UN60300 UN61596 UN62288 UN62317 UN62584 UN64299 UN65383 UN66555 UN67105 UN67839 UN68866 UN70075 UN71127 UN71368 UN74316 UN75909 UN76335 UN76505 UN76812 UN76817 UN77324 UN77786 UN77944 UN78051 UN78208 UN79291 UN79642 UN80468 UN80637 UN80718 UN80816 UN81322 UN81433 UN81657 UN81782 UN82066 UN82315 UN82319 UN83113 UN83595 UN84246  (C) Copyright IBM Corp. 1993,1998 29 » UN85046 UN85845 UN86422 UN86445 UN86632 UN86704 UN86801 UN87089 UN87167 UN87534 UN87667 UN87886 UN88107 UN88268 UN88710 UN88848 UN88953 UN89414 UN89630 UN89700 UN90765 UN91058 UN91188 UN91598 UN91870 UN92022 UN92477 UN94103 UN94199 UN95050 UN95621 UN96088 UN96775 UN97148 UN97475 UN97959 UN97989 UN98253 UN98425 UN99330 UN99473 UN99738 UQ00149 UQ00304 UQ00309 UQ00659 UQ01519 UQ01699 UQ02401 UQ04032 UQ04323 UQ04725 UQ05687 UQ05982 UQ06095 UQ06456 UQ06743 UQ07893 UQ07942 UQ08405 UQ09481 UQ10488 UQ11007 UQ11373 UQ12700 UQ15040 UQ16187 UQ16878 UQ17581 UQ17745 UQ18435 UQ18931 UQ19532 UQ20123 UQ20488 UQ20712 UQ20893 UQ21930 UQ22235 UQ23079 UQ23109 ) . ++IF FMID(HPRF220) THEN REQ (UW20252). ++IF FMID(HPRF102) THEN REQ (UW20251). ++JCLIN RELFILE(1) .  A.2 SMP/E JCLIN The JCLIN for ACIF is contained in the RELFILEs on the installation tape. These files will be loaded to disk by SMP/E when the product is SMP/E RECEIVEd. You may browse or print these files using TSO/E, ISPF, or IEBGENER (or IEBPTPCH). The files containing JCLIN are: FMID HQN2110: 'high-level-qualifier.HQN2110.F1(HQN2110) NOTE: The high-level qualifier is the qualifier specified as the DSPREFIX in the SMP/E OPTIONS. 30 ACIF Program Directory » APPENDIX B. READER'S COMMENTS  PROGRAM DIRECTORY FOR AFP CONVERSION & INDEXING FACILITY VERSION 3 RELEASE 1, MODIFICATION LEVEL 0 SERVICE LEVEL 9846 You may use this form to comment about this document, its organization, or subject matter with the understanding that IBM may use or distribute whatever information you supply in any way it believes appropriate without incurring any obligation to you. For each of the topics below please indicate your satisfaction level by circling your choice from the rating scale. If a statement does not apply, please circle N. Ð××× RATING SCALE ××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | | | very very not | | satisfied <=====================> dissatisfied applicable | | 1 2 3 4 5 N | | | ¿×××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ר  Ð××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ ¯ | | SATISFACTION |  Ð××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | | ¯ ¯ ¯ ¯ ¯ | | Ease of product installation | 1 | 2 | 3 | 4 | 5 | N |  Ð××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | | | | | | | | | Contents of program directory | 1 | 2 | 3 | 4 | 5 | N |  Ð××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | | | | | | | | | Installation Verification Programs | 1 | 2 | 3 | 4 | 5 | N |  Ð××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | | | | | | | | | Time to install the product | 1 | 2 | 3 | 4 | 5 | N |  Ð××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | | | | | | | | | Readability and organization of program | 1 | 2 | 3 | 4 | 5 | N | | directory tasks | | | | | | |  Ð××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | | | | | | | | | Necessity of all installation tasks | 1 | 2 | 3 | 4 | 5 | N |  Ð××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | | | | | | | | | Accuracy of the definition of the | 1 | 2 | 3 | 4 | 5 | N | | installation tasks | | | | | | |  Ð××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | | | | | | | | | Technical level of the installation | 1 | 2 | 3 | 4 | 5 | N | | tasks | | | | | | |  Ð××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ׯ | | | | | | | | | Ease of getting the system into | 1 | 2 | 3 | 4 | 5 | N | | production after installation | | | | | | |  ¿××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××××ר ¿ ¿ ¿ ¿ ¿ ¿ How did you order this product? __ CBIPO __ CBPDO __ CustomPac __ ServerPac __ Independent __ Other Is this the first time your organization has installed this product? __ Yes __ No Were the people who did the installation experienced with the installation of MVS products? __ Yes __ No  (C) Copyright IBM Corp. 1993,1998 31 »  If yes, how many years? __ If you have any comments to make about your ratings above, or any other aspect of the product installation, please list them below: ____________________________________________________________ ____________________________________________________________ ____________________________________________________________ ____________________________________________________________ ____________________________________________________________ ____________________________________________________________ ____________________________________________________________ ____________________________________________________________ ____________________________________________________________ ____________________________________________________________ ____________________________________________________________ ____________________________________________________________  32 ACIF Program Directory » Please provide the following contact information: ____________________________________________________________ Name and Job Title ____________________________________________________________ Organization ____________________________________________________________ ____________________________________________________________ Address ____________________________________________________________ Telephone Thank you for your participation. Please send the completed form to (or give to your IBM representative who will forward it to the AFP Conversion & Indexing Facility Development group): IBM Printing Systems Company Box 1900 Boulder, Colorado 80301-9191 USA Attention: Dept. RJXA/003G FAX Number: (800) 524-1519 E-Mail: printpub@us.ibm.com  Appendix B. Reader's Comments 33 » IBM Program Number: 5655-B17 5831 5832 6132  Printed in U.S.A.