SCRIPT/VS 4.0.0: DEVICE 1403N6 CHARS MONO ¤     Program Directory for  ACIF and AFP API Functions  for PSF/MVS   Service Level SMC9617   Program Number 5695-040   FMIDs HQN2110, HQN2112   for use with  MVS   Document Date: May 1996        GI10-0204-00 ¤   ÚÄÄÄ NOTE! ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | |  | Before using this information and the product it supports, be sure |  | to read the general information under "Notices" on page vi. |  | |  ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ            This program directory, dated May 1996, applies to ACIF and AFP API  (ACIF and AFP API) , for PSF/MVS Version 2.2.0, Program Number  5695-040 for the following:  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  ¿ ¿  | FMIDS | FEATURE NUMBERS| SYSTEM NAME |  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | | | |  | HQN2110 | 5801 | MVS |  | HQN2112 | 5802 | |  | | 5337 | |  ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ  À À  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  appropriate without incurring any obligation to you.  (C) COPYRIGHT INTERNATIONAL BUSINESS MACHINES CORPORATION 1993, 1996.  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 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . VI  Trademarks and Service Marks . . . . . . . . . . . . . . . . . . vi  1.0 INTRODUCTION . . . . . . . . . . . . . . . . . . . . . . . . 1  1.1 ACIF Description . . . . . . . . . . . . . . . . . . . . . . 2  1.2 AFP API Description . . . . . . . . . . . . . . . . . . . . 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 . . . . . . . . . . . . . . . 5  2.3.2 Optional Program Publications . . . . . . . . . . . . . 5  2.4 Microfiche Support . . . . . . . . . . . . . . . . . . . . . 5  2.5 Publications Useful During Installation . . . . . . . . . . 5  3.0 PROGRAM SUPPORT . . . . . . . . . . . . . . . . . . . . . . 7  3.1 Service Instructions . . . . . . . . . . . . . . . . . . . . 7  3.2 Preventive Service Planning . . . . . . . . . . . . . . . . 7  3.3 Statement of Support Procedures . . . . . . . . . . . . . . 8  4.0 PROGRAM AND SERVICE LEVEL INFORMATION . . . . . . . . . . . 9  4.1 Program Level Information . . . . . . . . . . . . . . . . . 9  4.2 Service Level Information . . . . . . . . . . . . . . . . . 10  4.3 Cumulative Service Tape . . . . . . . . . . . . . . . . . . 12  5.0 INSTALLATION REQUIREMENTS AND CONSIDERATIONS . . . . . . . . 13  5.1 Driving System Requirements . . . . . . . . . . . . . . . . 13  5.1.1 Programming Requirements . . . . . . . . . . . . . . . . 13  5.1.2 DASD Storage Requirements . . . . . . . . . . . . . . . 13  5.2 Target System Requirements . . . . . . . . . . . . . . . . . 13  5.2.1 Operating System Requirements . . . . . . . . . . . . . 13  5.2.2 Machine Requirements . . . . . . . . . . . . . . . . . . 14  5.2.3 Programming Requirements . . . . . . . . . . . . . . . . 14  5.2.4 DASD Storage Requirements . . . . . . . . . . . . . . . 14  5.3 Program Considerations . . . . . . . . . . . . . . . . . . . 19  5.3.1 SMP/E Procedures and Data Sets . . . . . . . . . . . . . 20  6.0 INSTALLATION INSTRUCTIONS . . . . . . . . . . . . . . . . . 21  6.1 Installing ACIF and AFP API . . . . . . . . . . . . . . . . 21  6.1.1 Unload Sample JCL . . . . . . . . . . . . . . . . . . . 22  6.1.2 Allocate Target and Distribution Libraries . . . . . . . 23  6.1.3 Target and Distribution Library DDDEFs . . . . . . . . . 27  6.1.4 Load SMP/E Libraries Using RECEIVE . . . . . . . . . . . 31  6.1.5 RECEIVE Cumulative Service Tape, if Applicable . . . . . 32  6.1.6 Perform SMP/E APPLY CHECK . . . . . . . . . . . . . . . 33  6.1.7 Load Target Libraries Using APPLY . . . . . . . . . . . 35  6.1.8 Verify Installation of ACIF and AFP API . . . . . . . . 37   (C) Copyright IBM Corp. 1993, 1996 iii ¤   6.1.9 Perform SMP/E ACCEPT CHECK . . . . . . . . . . . . . . . 37  6.1.10 Load Distribution Libraries Using ACCEPT . . . . . . . 38  7.0 ACIF AND AFP API INSTALLATION VERIFICATION PROCEDURE . . . . 40  7.1 ACIF Installation Verification Procedure . . . . . . . . . . 40  7.2 AFP API Installation Verification Procedure in the MVS  Environment . . . . . . . . . . . . . . . . . . . . . . . . . . 43  7.2.1 Create Font Library Index . . . . . . . . . . . . . . . 43  7.2.2 IVP for the COBOL Program . . . . . . . . . . . . . . . 45  7.2.3 IVP for the PL/1 Program . . . . . . . . . . . . . . . . 49  7.3 AFP API Installation Verification Procedure for the CICS/ESA  Environment . . . . . . . . . . . . . . . . . . . . . . . . . . 55  7.3.1 Perform APQCILNK Post Installation Job . . . . . . . . . 55  7.3.2 Create Font Library Index . . . . . . . . . . . . . . . 59  7.3.3 Create VSAM Data Sets for Fonts and Page Segments . . . 59  7.3.3.1 VSAM Data Set for Fonts . . . . . . . . . . . . . . 59  7.3.3.2 VSAM Data Set for Page Segments . . . . . . . . . . 62  7.3.4 Create Entries in the CICS/ESA File Control Table . . . 64  7.3.5 Create Program Entries in the CICS/ESA Processing Program  Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64  7.3.6 Create Transaction Definitions in the CICS/ESA Program  Control Table . . . . . . . . . . . . . . . . . . . . . . . . 65  7.3.7 Add Resource Definitions to Active CICS/ESA System . . . 65  7.3.8 CICS System Definition File . . . . . . . . . . . . . . 67  7.3.9 Modify APQPERF Copy Book . . . . . . . . . . . . . . . . 71  7.3.10 Compile the Sample COBOL Programs . . . . . . . . . . . 73  7.3.11 Run the Sample COBOL Programs . . . . . . . . . . . . . 75  APPENDIX A. ACIF AND AFP API INSTALL LOGIC . . . . . . . . . . . 77  A.1 HQN2110 (ACIF) . . . . . . . . . . . . . . . . . . . . . . . 77  A.2 HQN2112 (AFP API) . . . . . . . . . . . . . . . . . . . . . 78  APPENDIX B. ACIF AND AFP API JCLIN . . . . . . . . . . . . . . . 80  READER'S COMMENTS . . . . . . . . . . . . . . . . . . . . . . . . 82    FIGURES    1. Basic Material: ACIF and AFP API Product Tape . . . . . . . 3  2. Program Tape: ACIF and AFP API Tape File Content . . . . . 3  3. ACIF and AFP API Basic Material: Unlicensed Publications . . 5  4. Publications Useful During Installation . . . . . . . . . . 5  5. PSP Upgrade and Subset ID . . . . . . . . . . . . . . . . . 7  6. Component IDs . . . . . . . . . . . . . . . . . . . . . . . 8   Contents iv ¤   7. Abbreviations used for the data set type . . . . . . . . . . 15  8. Storage Requirements for ACIF Target Libraries . . . . . . . 16  9. Storage Requirements for AFP API Target Libraries . . . . . 17  10. Storage Requirements for ACIF Distribution Libraries . . . . 18  11. Storage Requirements for AFP API Distribution Libraries . . 19  12. Sample JCL to Unload the ACIF and AFP API Sample Jobs . . . 22  13. Sample Allocate Job for ACIF . . . . . . . . . . . . . . . . 24  14. Sample Allocate Job for AFP API . . . . . . . . . . . . . . 26  15. JCL to Create Target and Distribution DDDEFs for ACIF . . . 28  16. JCL to Create Target and Distribution DDDEFs for AFP API . . 30  17. Sample SMP/E RECEIVE Job . . . . . . . . . . . . . . . . . . 32  18. RECEIVE Job for Cumulative Service Tape . . . . . . . . . . 33  19. Sample SMP/E APPLY CHECK Job . . . . . . . . . . . . . . . . 34  20. Sample SMP/E APPLY Job . . . . . . . . . . . . . . . . . . . 35  21. Sample SMP/E ACCEPT CHECK Job . . . . . . . . . . . . . . . 38  22. Sample SMP/E ACCEPT Job . . . . . . . . . . . . . . . . . . 39  23. APKIVP Job for ACIF IVP . . . . . . . . . . . . . . . . . . 40  24. APQFLIP Job to Create Font Index . . . . . . . . . . . . . . 44  25. APQCOCOB Job for COBOL IVP . . . . . . . . . . . . . . . . . 46  26. APQIVCOB Job for COBOL IVP . . . . . . . . . . . . . . . . . 48  27. APQCOPLI Job for PL/1 IVP . . . . . . . . . . . . . . . . . 50  28. APQIVPLI Job for PL/1 IVP . . . . . . . . . . . . . . . . . 53  29. APQCILNK Post Installation Job . . . . . . . . . . . . . . . 56  30. APQCIFON Job . . . . . . . . . . . . . . . . . . . . . . . . 61  31. APQCISEG Job . . . . . . . . . . . . . . . . . . . . . . . . 63  32. RDO Menu to Install Resource Definitions to CICS . . . . . . 66  33. Sample CICS System Definition (CSD) Listing . . . . . . . . 67  34. APQPERF Copy Book . . . . . . . . . . . . . . . . . . . . . 71  35. APQCOSMB Job to Compile the Sample COBOL Program . . . . . . 74           Figures v ¤   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 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.  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  International Business Machines Corporation  IBM Director of Licensing  500 Columbus Avenue  Thornwood, New York 10594  USA   TRADEMARKS AND SERVICE MARKS  The following terms used in this document are trademarks or service  marks of IBM Corporation in the United States or other countries:  ACF/VTAM MO:DCA  AFP MVS/SP  Advanced Function Printing MVS/ESA  Advanced Function Presentation MVS/XA  BookManager PSF  CBIPO Print Services Facility  CBPDO RETAIN  IBM(R) S/390  IBMLink VTAM      (C) Copyright IBM Corp. 1993, 1996 vi ¤   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 Advanced Function Presentation Conversion and Indexing  Facility (ACIF) and Advanced Function Presentation Application  Programming Interface (AFP API). 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 and AFP API.  ù 3.0, "Program Support" on page 7 describes the IBM support  available for ACIF and AFP API.  ù 4.0, "Program and Service Level Information" on page 9 lists the  APARs (program level) and PTFs (service level) incorporated into  ACIF and AFP API.  ù 5.0, "Installation Requirements and Considerations" on page 13  identifies the resources and considerations for installing and  using ACIF and AFP API.  ù 6.0, "Installation Instructions" on page 21 provides detailed  installation instructions for ACIF and AFP API.  ù 7.0, "ACIF and AFP API Installation Verification Procedure" on  page 40 provides the installation verification procedures for ACIF  and AFP API.  ù Appendix A, "ACIF and AFP API Install Logic" on page 77 provides  the install logic for ACIF and AFP API.  ù Appendix B, "ACIF and AFP API JCLIN" on page 80 provides listings  of the JCLIN for ACIF and AFP API.  Before installing ACIF and AFP API, read 3.2, "Preventive Service  Planning" on page 7. 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 and AFP  API with an MVS Custom-Built Installation Process Offering (CBIPO)  (5751-CS1). Instead, use the CBIPO Related Installation Materials  (RIMs) provided with the CBIPO. The CBIPO RIMs will point you to  specific sections of the program directory as required.   (C) Copyright IBM Corp. 1993, 1996 1 ¤   If you are installing ACIF and AFP API 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 and AFP API are included on the CBPDO  tape.   1.1 ACIF DESCRIPTION  The AFP Conversion and Indexing Facility (ACIF) processes host  application data into the Advanced Function Printing (AFP) data stream  (MO:DCA-P) format for platform-independent printing, viewing using the  AFP Workbench for Windows product, and input to other application  areas such as archival/retrieval. It also provides an indexing  capability for efficient retrieval and a resource extraction function  for print and view fidelity.   1.2 AFP API DESCRIPTION  AFP Application Programming Interface (AFP API) provides callable  routines for COBOL and PL/1 programmers to use to produce the AFP data  stream. These routines enable programmers to format complex output  applications without knowing the syntax and semantics of the AFP data  stream, thus improving programmer productivity.  Refer to Print Services Facility/MVS Version 2.2.0 Program Directory  for a list of printers that ACIF and AFP API supports.           Introduction 2 ¤   2.0 PROGRAM MATERIALS    An IBM program is identified by a program number and a feature code.  The program number for PSF/MVS and the ACIF and AFP API features is  5695-040.  The program announcement material describes the functions supported by  the ACIF and AFP API features. Ask your IBM marketing representative  for this information if you have not already received a copy.  The following sections identify the basic and optional program  materials available with this program.   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. See 6.0, "Installation Instructions" on  page 21 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.  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | Figure 1. Basic Material: ACIF and AFP API Product Tape |  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | ¿ ¿ ¿ ¿ |  | | FEATURE | PHYSICAL | EXTERNAL LABEL | |  | MEDIUM | NUMBER | VOLUME | IDENTIFICATION | VOLSER |  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | | | | | |  | 6250 tape | 5801 | 1 | PSF.ACIF.API.2.2.0 | QN2110 |  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | | | | | |  | 3480 cart. | 5802 | 1 | PSF.ACIF.API.2.2.0 | QN2110 |  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | | | | | |  | 4mm cart. | 5337 | 1 | PSF.ACIF.API.2.2.0 | QN2110 |  ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ  À À À À   ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | Figure 2 (Page 1 of 2). Program Tape: ACIF and AFP API Tape File |  | Content |  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | ¿ ¿ ¿ ¿ ¿ ¿ |  | | | | REC | | BLK | NUMBER OF |  | VOLSER | FILE | NAME | FM | LRECL | SIZE | ELEMENTS |  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | | | | | | | |  | QN2110 | 1 | SMPMCS | FB | 80 | 6400 | 1 |  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | | | | | | | |  | | 2 | IBM.HQN2110.F1 | FB | 80 | 8800 | 1 (JCLIN) |  ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ  À À À À À À   (C) Copyright IBM Corp. 1993, 1996 3 ¤   ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | Figure 2 (Page 2 of 2). Program Tape: ACIF and AFP API Tape File |  | Content |  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | ¿ ¿ ¿ ¿ ¿ ¿ |  | | | | REC | | BLK | NUMBER OF |  | VOLSER | FILE | NAME | FM | LRECL | SIZE | ELEMENTS |  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | | | | | | | |  | | 3 | IBM.HQN2110.F2 | U | 0 | 6144 | 144 |  | | | | | | | (AAPKMOD1) |  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | | | | | | | |  | | 4 | IBM.HQN2110.F3 | FB | 80 | 8800 | 8 |  | | | | | | | (AAPKSAM1) |  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | | | | | | | |  | | 5 | IBM.HQN2110.F4 | FB | 80 | 8800 | 1 |  | | | | | | | (AAPKSAM2) |  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | | | | | | | |  | | 6 | IBM.HQN2110.F5 | VBM | 8205 | 8209 | 7 |  | | | | | | | (AAPKULIB) |  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | | | | | | | |  | | 7 | IBM.HQN2110.F6 | FBA | 200 | 8000 | 1 |  | | | | | | | (AAPKSAM3) |  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | | | | | | | |  | | 8 | IBM.HQN2112.F1 | FB | 80 | 8800 | 1 (JCLIN) |  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | | | | | | | |  | | 9 | IBM.HQN2112.F2 | U | 0 | 6144 | 181 |  | | | | | | | (AAPQMOD1) |  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | | | | | | | |  | | 10 | IBM.HQN2112.F3 | U | 0 | 6144 | 49 |  | | | | | | | (AAPQMOD2) |  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | | | | | | | |  | | 11 | IBM.HQN2112.F4 | VBM | 8205 | 8209 | 2 |  | | | | | | | (AAPQULIB) |  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | | | | | | | |  | | 12 | IBM.HQN2112.F5 | FB | 80 | 8800 | 32 |  | | | | | | | (AAPQSAM1) |  ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ  À À À À À À   2.2 OPTIONAL MACHINE-READABLE MATERIAL  Refer to Print Services Facility/MVS Version 2.2.0 Program Directory  for PSF/MVS Version 2.2.0 optional machine-readable materials.   2.3 PROGRAM PUBLICATIONS  Refer to Print Services Facility/MVS Version 2.2.0 Program Directory  for basic and optional publications available with PSF/MVS Version  2.2.0.  The following section identifies the basic publications provided with  PSF/MVS Version 2.2.0 that are specifically used with ACIF and AFP  API.   Program Materials 4 ¤   2.3.1 BASIC PROGRAM PUBLICATIONS  Figure 3 on page 5 identifies the basic program publications provided  with PSF/MVS Version 2.2.0 that are specifically used with ACIF and  AFP API. For additional copies, contact your IBM representative.  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | Figure 3. ACIF and AFP API Basic Material: Unlicensed Publications |  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | ¿ |  | PUBLICATION TITLE | FORM NUMBER |  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | | |  | AFP Application Programming Interface: Programming | S544-3872 |  | Guide and Reference | |  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | | |  | AFP Application Programming Interface: COBOL | S544-3873 |  | Language Reference | |  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | | |  | AFP Application Programming Interface: PL/1 | S544-3874 |  | Language Reference | |  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | | |  | AFP Conversion and Indexing Facility: Application | S544-5285 |  | Programming Guide | |  ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ  À   2.3.2 OPTIONAL PROGRAM PUBLICATIONS  Refer to Print Services Facility/MVS Version 2.2.0 Program Directory  for optional publications available with PSF/MVS Version 2.2.0.   2.4 MICROFICHE SUPPORT  There is no microfiche for ACIF and AFP API.   2.5 PUBLICATIONS USEFUL DURING INSTALLATION  The publications listed in Figure 4 may be useful during the  installation of ACIF and AFP API. To order copies, contact your IBM  representative.  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | Figure 4 (Page 1 of 2). Publications Useful During Installation |  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | ¿ |  | PUBLICATION TITLE | FORM NUMBER |  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | | |  | SMP/E Reference | SC28-1107 |  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | | |  | SMP/E User's Guide | SC28-1302 |  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | | |  | MVS/ESA V5 JCL Reference | GC28-1479 |  ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ  À   Program Materials 5 ¤   ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | Figure 4 (Page 2 of 2). Publications Useful During Installation |  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | ¿ |  | PUBLICATION TITLE | FORM NUMBER |  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | | |  | MVS/ESA V4 JCL Reference | GC28-1654 |  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | | |  | CICS/ESA 4.1 Resource Definition Guide | SC33-1166 |  ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ  À                  Program Materials 6 ¤   3.0 PROGRAM SUPPORT    This section describes the IBM support available for ACIF and AFP API.   3.1 SERVICE INSTRUCTIONS  Contact your IBM marketing representative or systems engineer (SE) for  specific information about available service instructions.   3.2 PREVENTIVE SERVICE PLANNING  If you obtained ACIF and AFP API as part of a CBPDO, there is HOLDDATA  and Preventive Service Planning (PSP) information for ACIF and AFP API  on the CBPDO tape. Before installing ACIF and AFP API, check with  your IBM Support Center or use S/390 SoftwareXcel (IBMLink) to see  whether there is additional Preventive Service Planning (PSP)  information that you should know. To obtain this information, specify  the following UPGRADE and SUBSET values:  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | Figure 5. PSP Upgrade and Subset ID |  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | ¿ ¿ |  | UPGRADE | SUBSET | RETAIN RELEASE |  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | | | |  | PSFMVS220 | HQN2110/9617 | 110 |  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | | | |  | PSFMVS220 | HQN2112/9617 | 112 |  ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ  À À  If you have received ACIF and AFP API only from IBM Software  Distribution, you should also check to see if additional PSP  information is available prior to installation.  NOTE: The PSP SUBSET name reflects the Function Module Identifier  (FMID) that was updated and the corresponding CBPDO weekly service  tape that was used to supply the integrated PTFs. (Example;  FMID/YYWW, where YY is the year and WW is the week of the CBPDO weekly  service tape.).  The CBPDO weekly Service tape is the Service Level Indicator for any  products updated by the Software Manufacturing Center (SMC) processes.  If you wish to determine the latest level of PUT maintenance installed  in this product, see 4.0, "Program and Service Level Information" on  page 9.    (C) Copyright IBM Corp. 1993, 1996 7 ¤   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 IDs (COMPIDs) for ACIF and AFP API.  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | Figure 6. Component IDs |  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | ¿ ¿ ¿ |  | FMID | COMPID | COMPONENT NAME | REL |  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | | | | |  | HQN2110 | 564806201 | ACIF | 110 |  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | | | | |  | HQN2112 | 564806202 | AFP API | 112 |  ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ  À À À               Program Support 8 ¤   4.0 PROGRAM AND SERVICE LEVEL INFORMATION    This section identifies the program and any relevant service levels of  ACIF and AFP API. 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.  ACIF for PSF/MVS 2.2.0 (FMID HQN2110) and AFP API for PSF/MVS 2.2.0  (FMID HQN2112) are service updates of ACIF for PSF/MVS 2.1.1 and AFP  API for PSF/MVS 2.1.1. They have a new SOURCEID of SMC9617. It is  possible to install the service listed in this section for ACIF for  PSF/MVS 2.1.1 and AFP API for PSF/MVS 2.1.1 to receive the same  function as ACIF for PSF/MVS 2.2.0 and AFP API for PSF/MVS 2.2.0,  Service Level SMC9617.   4.1 PROGRAM LEVEL INFORMATION  The following APAR fixes against previous releases of ACIF and AFP API  have been incorporated into this release:  ACIF FMID HQN2110  AN39451 AN41826 AN44241 AN50104 AN51229  AN51925 AN53621 AN53970 AN55008 AN55288  AN57157 BN50104   AFP API FMID HQN2112  AN36146 AN45202 AN47219 AN48099 AN49902  AN50511 AN52653 AN52669 AN53185 AN53201  AN53401 AN53565 AN54342 AN54347 AN54555  AN54560 AN54711 AN55291 AN55404 AN56150  AN56401 AN57387       (C) Copyright IBM Corp. 1993, 1996 9 ¤   The following APAR fixes against ACIF and AFP API have been  incorporated into this Service Level SMC9617.  ACIF FMID HQN2110  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 AN70919 AN71191 AN71324  AN71614 AN71815 AN71931 AN71974 AN72026  AN72249 AN72359 AN73470 AN73683 AN74886  AN74914 AN74930 AN75027 AN75544 AN76385  AN76494 AN77224 AN77537 AN77694 AN77727  AN78463 AN79096 AN79174 AN79284 AN79946  AN79985 AN80074 AN80401 AN80403 AN81336  AN81527 AN81807 AN82198 AN82368 AN83160  AN83206 BN50104 BN67975 CN67975   AFP API FMID HQN2112  AN36146 AN45202 AN47219 AN48099 AN49902  AN50511 AN51700 AN52653 AN52669 AN53185  AN53201 AN53401 AN53565 AN54255 AN54342  AN54347 AN54555 AN54560 AN54711 AN55291  AN55404 AN56150 AN56401 AN57387 AN58999  AN60606 AN62852 AN63489 AN64496 AN64756  AN65739 AN65965 AN67836 AN69627 AN70396  AN71167 AN71721 AN72810 AN73433 AN73909  AN74445 AN75041 AN75871 AN76148 AN76280  AN76720 AN77003 AN77175 AN77314 AN77481  AN78003 AN78378 AN78628 AN78749 AN80014  AN80567 AN82150 AN83203 AN83205   4.2 SERVICE LEVEL INFORMATION  The following PTFs contain the APAR fixes against the previous release  of ACIF and AFP API. They are listed by FMID and have been  incorporated into this release.  ACIF FMID HQN2110  UN43866 UN47897 UN47898 UN56430 UN56866  UN57483 UN58647 UN58768 UN60091 UN60300  UN62288    Program and Service Level Information 10 ¤   AFP API FMID HQN2112  UN44746 UN51816 UN55120 UN57386 UN57780  UN58203 UN58567 UN58991 UN58993 UN59841  UN59849 UN59934 UN60195 UN60241 UN60373  UN60412 UN60590 UN60592 UN61309 UN61364  UN62131 UN62223   The following PTFs containing APAR fixes against ACIF and AFP API have  been integrated into this Service Level SMC9617.  NOTE: COR-CLOSED PTFs are available for 'Corrective Service' and will  be placed on the next available Program Update Tape (PUT). The  following sub-categories for COR-CLOSED PTFs have been provided by the  Software Manufacturing Center (SMC), Kingston:  SMCREC COR-CLOSED PTFs that have been researched and recommended for  installation by the Software Manufacturing Center (SMC) in  Kingston.  SMCCOR COR-CLOSED PTFs that have no special recommendations for  installation.   ACIF FMID HQN2110  UN43866 UN47897 UN47898  UN56430-PUT9402 UN56866-PUT9402 UN57483-PUT9402  UN58647-PUT9403 UN58768-PUT9403 UN59731-PUT9405  UN60091-PUT9404 UN60300-PUT9404 UN61596-PUT9406  UN62288-PUT9405 UN62317-PUT9405 UN62584-PUT9406  UN64299-PUT9407 UN65383-PUT9407 UN66555-PUT9408  UN67105-PUT9409 UN67839-PUT9409 UN68866-PUT9410  UN70075-PUT9411 UN71127-PUT9412 UN71368-PUT9501  UN74316-PUT9503 UN75909-PUT9505 UN76335-PUT9505  UN76505-PUT9505 UN76812-PUT9505 UN76817-PUT9505  UN77324-PUT9505 UN77786-PUT9506 UN77944-PUT9506  UN78051-PUT9506 UN78208-PUT9506 UN79291-PUT9507  UN79642-PUT9507 UN80468-PUT9508 UN80637-PUT9508  UN80718 UN80816-PUT9509 UN81322-PUT9509  UN81433-PUT9509 UN81657-PUT9509 UN81782-PUT9509  UN82066-PUT9509 UN82315-PUT9509 UN82319-PUT9510  UN83113-PUT9510 UN83595-PUT9511 UN84246-PUT9601  UN85046-PUT9512 UN85845-PUT9601 UN86422  UN86445-PUT9601 UN86632-PUT9601 UN86704-PUT9601  UN86801-PUT9601 UN87089-PUT9602 UN87167-PUT9602  UN87534 UN87667-PUT9602 UN87886-PUT9602  UN88107-PUT9603 UN88268-PUT9603 UN88710-PUT9603  UN88848-PUT9603 UN88953-PUT9603 UN89414-SMCCOR  UN89630-SMCCOR UN89700-SMCCOR    Program and Service Level Information 11 ¤   AFP API FMID HQN2112  UN44746 UN51816 UN55120  UN57386-PUT9402 UN57780-PUT9403 UN58203-PUT9403  UN58567-PUT9403 UN58991-PUT9403 UN58993-PUT9403  UN59841-PUT9404 UN59849-PUT9404 UN59934-PUT9404  UN60195-PUT9404 UN60241-PUT9404 UN60373-PUT9404  UN60412-PUT9404 UN60590-PUT9404 UN60592-PUT9404  UN61309-PUT9405 UN61364-PUT9405 UN62131-PUT9405  UN62223-PUT9405 UN62623-PUT9405 UN63602-PUT9406  UN65032-PUT9407 UN66697-PUT9408 UN69674-PUT9412  UN71137-PUT9412 UN72176-PUT9501 UN72179-PUT9501  UN72856-PUT9502 UN73409-PUT9503 UN75782-PUT9504  UN76614-PUT9505 UN77776-PUT9506 UN77783-PUT9506  UN78246-PUT9506 UN78961-PUT9507 UN79772-PUT9507  UN79913-PUT9507 UN81617-PUT9509 UN81895-PUT9509  UN81978-PUT9509 UN82365-PUT9509 UN82854-PUT9510  UN83377-PUT9510 UN83400-PUT9510 UN83458-PUT9510  UN83681-PUT9510 UN84069-PUT9511 UN84952-PUT9512  UN85167-PUT9512 UN85805-PUT9512 UN86880-PUT9601  UN87226-PUT9602 UN87896-PUT9602 UN89412-SMCCOR  UN89576-SMCCOR UN89629-SMCCOR   4.3 CUMULATIVE SERVICE TAPE  A cumulative service tape, containing PTFs not incorporated into this  release, might be included with this program. If you received this  product as part of a CBPDO, then there is no cumulative service tape.           Program and Service Level Information 12 ¤   5.0 INSTALLATION REQUIREMENTS AND CONSIDERATIONS    The following sections identify the system requirements for installing  and activating ACIF and AFP API. In most cases, you can install ACIF  and AFP API on a running system (target system). However, sometimes  two systems may be required. If two systems are required, then the  following terminology is used:  1. The system used to install the program (driving system)  2. The system on which the program is installed (target system).   5.1 DRIVING SYSTEM REQUIREMENTS  This section describes the environment of the driving system required  to install ACIF and AFP API.   5.1.1 PROGRAMMING REQUIREMENTS  The minimum SMP/E release required to install ACIF and AFP API is  System Modification Program Extended, Version 1, Release 8 or later.   5.1.2 DASD STORAGE REQUIREMENTS  ACIF and AFP API uses any storage device that is supported by the  environment in which it is operating. See 5.2.4, "DASD Storage  Requirements" on page 14 for additional information about the amount  of storage required for ACIF and AFP API.   5.2 TARGET SYSTEM REQUIREMENTS  This section describes the environment of the target system required  to install and use ACIF and AFP API.   5.2.1 OPERATING SYSTEM REQUIREMENTS  Before installing ACIF and AFP API, one of the following versions of  the MVS operating system is required:  ù MVS/SP-JES2 Version 3 Release 1.3 (5685-001) or MVS/SP-JES3  Version 3 Release 1.3 (5685-002)  ù MVS/ESA SP-JES2 Version 4 Release 2 (5695-047) or MVS/ESA SP-JES3  Version 4 Release 2 (5695-048)   (C) Copyright IBM Corp. 1993, 1996 13 ¤   ù MVS/ESA SP-JES2 Version 5 Release 1 (5655-068) or MVS/ESA SP-JES3  Version 5 Release 1 (5655-069)  ù OS/390 Version 1 (5645-001)   5.2.2 MACHINE REQUIREMENTS  The target system has no special machine requirements when installing  ACIF and AFP API.  Refer to Print Services Facility/MVS Version 2.2.0 Program Directory  for PSF/MVS Version 2.2.0 machine requirements.   5.2.3 PROGRAMMING REQUIREMENTS  Programming requirements for ACIF are as follows:  ù To print output from the ACIF feature, PSF/MVS Version 2.1.1 or  PSF/MVS Version 2.2.0 must be installed.  Programming requirements for AFP API are as follows:  ù PL/1 Version 2 Release 3.0 (or above) or VS COBOL II Version 1  Release 4.0 (or above) compiler and libraries are required for  AFP API applications.  ù The Installation Verification Procedure jobs for AFP API use the  10-point Roman Medium Times New Roman 240 pel or 300 pel fonts  (FMIDs JPRF172, JPRF175, JPRF1G0). If you do not have these FMIDs  installed, these fonts can be obtained from the Latin1 fonts  supplied with IBM AFP Font Collection product, program number  5648-113 (FMIDs H0HL141 and J0HL145 for 240-pel fonts or FMIDs  H0HL15D and J0HL14T for 300-pel fonts).  ù To use AFP API with CICS/ESA requires CICS/ESA Version 3 Release  2.1 or later.  ù To print output from the AFP API feature, PSF/MVS Version 2.1.1 or  PSF/MVS Version 2.2.0 must be installed.   5.2.4 DASD STORAGE REQUIREMENTS  Abbreviations describing the data set type are listed in Figure 7.  These abbreviations are used in Figure 8, Figure 9, Figure 10, and  Figure 11.     Installation Requirements and Considerations 14 ¤   ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | Figure 7. Abbreviations used for the data set type |  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | ¿ |  | ABBREVIATION | DATA SET TYPE |  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | | |  | NU | New data set used by only the FMIDs listed. In |  | | order to determine the correct storage needed for |  | | this data set, only the storage size given in the |  | | one table needs to be used. No other tables (or |  | | program directories) need to be referenced for the |  | | data set size. |  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | | |  | EU | Existing data set used by only the FMIDs listed. |  | | In order to determine the correct storage needed |  | | for this data set, only the storage size given in |  | | the one table needs to be used. No other tables |  | | (or program directories) need to be referenced for |  | | the data set size. |  ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ  À  The following figures list the target and distribution libraries (data  sets) and their attributes required to install ACIF and AFP API. See  6.1.2, "Allocate Target and Distribution Libraries" on page 23 for a  sample job to allocate the target and distribution data sets.  SMP/E DDDEF entries for each data set should be created. See 6.1.3,  "Target and Distribution Library DDDEFs" on page 27 for information on  creating the DDDEFs.           Installation Requirements and Considerations 15 ¤   Storage requirements for ACIF target libraries are in Figure 8 on  page 16.  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | Figure 8. Storage Requirements for ACIF Target Libraries |  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | ¿ ¿ ¿ ¿ ¿ ¿ ¿ |  | | | D | R | L | | | |  | | T | S | E | R | | | NO. |  | DATA SET NAME | Y | O | C | E | | NO. | OF |  | OR | P | R | F | C | BLK | OF | DIR |  | LIBRARY NAME | E | G | M | L | SIZE | BLKS | BLKS |  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | | | | | | | | |  | psf.acif.SAPKMOD1 | NU/EU | PO | U | 0 | 6144 | 144 | 2 |  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | | | | | | | | |  | psf.acif.SAPKSAM1 | NU/EU | PO | FB | 80 | 6160 | 16 | 2 |  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | | | | | | | | |  | psf.acif.SAPKSAM2 | NU/EU | PO | FB | 80 | 6160 | 16 | 2 |  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | | | | | | | | |  | psf.acif.SAPKSAM3 | NU/EU | PO | FBA | 200 | 8000 | 36 | 2 |  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | | | | | | | | |  | psf.acif.SAPKULIB | NU/EU | PO | VBM | 8205 | 8209 | 18 | 2 |  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | À À À À À À À |  | NOTES: |  | |  | ù The high level qualifier, psf.acif, can be changed to meet |  | your installations naming conventions. |  | |  | ù The number of blocks and directory blocks specified is 15% |  | larger than the minimum storage required by ACIF after the |  | program is installed and the data sets are compressed. You |  | may wish to revise these numbers based on your plans for |  | adding additional function or service. |  | |  | ù If required, data sets may be reblocked to a larger size. |  | |  | ù See 6.1.2, "Allocate Target and Distribution Libraries" on |  | page 23 for JCL that allocates these data sets. |  ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ        Installation Requirements and Considerations 16 ¤   Storage requirements for AFP API target libraries are in Figure 9 on  page 17.  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | Figure 9. Storage Requirements for AFP API Target Libraries |  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | ¿ ¿ ¿ ¿ ¿ ¿ ¿ |  | | | D | R | L | | | |  | | T | S | E | R | | | NO. |  | DATA SET NAME | Y | O | C | E | | NO. | OF |  | OR | P | R | F | C | BLK | OF | DIR |  | LIBRARY NAME | E | G | M | L | SIZE | BLKS | BLKS |  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | | | | | | | | |  | psf.afpapi.SAPQMOD1 | NU/EU | PO | U | 0 | 6144 | 200 | 3 |  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | | | | | | | | |  | psf.afpapi.SAPQMOD2 | NU/EU | PO | U | 0 | 6144 | 72 | 12 |  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | | | | | | | | |  | psf.afpapi.SAPQSAM1 | NU/EU | PO | FB | 80 | 6160 | 272 | 3 |  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | | | | | | | | |  | psf.afpapi.SAPQULIB | NU/EU | PO | VBM | 8205 | 8209 | 12 | 2 |  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | À À À À À À À |  | NOTES: |  | |  | ù The high level qualifier, psf.afpapi, can be changed to meet |  | your installations naming conventions. |  | |  | ù The number of blocks and directory blocks specified is 15% |  | larger than the minimum storage required by AFP API after the |  | program is installed and the data sets are compressed. You |  | may wish to revise these numbers based on your plans for |  | adding additional function or service. |  | |  | ù If required, data sets may be reblocked to a larger size. |  | |  | ù See 6.1.2, "Allocate Target and Distribution Libraries" on |  | page 23 for JCL that allocates these data sets. |  ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ         Installation Requirements and Considerations 17 ¤   Storage requirements for ACIF distribution libraries are in Figure 10  on page 18.  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | Figure 10. Storage Requirements for ACIF Distribution Libraries |  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | ¿ ¿ ¿ ¿ ¿ ¿ ¿ |  | | | D | R | L | | | |  | | T | S | E | R | | | NO. |  | DATA SET NAME | Y | O | C | E | | NO. | OF |  | OR | P | R | F | C | BLK | OF | DIR |  | LIBRARY NAME | E | G | M | L | SIZE | BLKS | BLKS |  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | | | | | | | | |  | psf.acif.AAPKMOD1 | NU/EU | PO | U | 0 | 6144 | 256 | 28 |  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | | | | | | | | |  | psf.acif.AAPKSAM1 | NU/EU | PO | FB | 80 | 6160 | 16 | 2 |  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | | | | | | | | |  | psf.acif.AAPKSAM2 | NU/EU | PO | FB | 80 | 6160 | 16 | 2 |  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | | | | | | | | |  | psf.acif.AAPKSAM3 | NU/EU | PO | FBA | 200 | 8000 | 36 | 2 |  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | | | | | | | | |  | psf.acif.AAPKULIB | NU/EU | PO | VBM | 8205 | 8209 | 18 | 2 |  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | À À À À À À À |  | NOTES: |  | |  | ù The high level qualifier, psf.acif, can be changed to meet |  | your installations naming conventions. |  | |  | ù The number of blocks and directory blocks specified is 15% |  | larger than the minimum storage required by ACIF after the |  | program is installed and the data sets are compressed. You |  | may wish to revise these numbers based on your plans for |  | adding additional function or service. |  | |  | ù If required, data sets may be reblocked to a larger size. |  | |  | ù See 6.1.2, "Allocate Target and Distribution Libraries" on |  | page 23 for JCL that allocates these data sets. |  ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ        Installation Requirements and Considerations 18 ¤   Storage requirements for AFP API distribution libraries are in  Figure 11 on page 19.  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | Figure 11. Storage Requirements for AFP API Distribution Libraries |  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | ¿ ¿ ¿ ¿ ¿ ¿ ¿ |  | | | D | R | L | | | |  | | T | S | E | R | | | NO. |  | DATA SET NAME | Y | O | C | E | | NO. | OF |  | OR | P | R | F | C | BLK | OF | DIR |  | LIBRARY NAME | E | G | M | L | SIZE | BLKS | BLKS |  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | | | | | | | | |  | psf.afpapi.AAPQMOD1 | NU/EU | PO | U | 0 | 6144 | 264 | 36 |  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | | | | | | | | |  | psf.afpapi.AAPQMOD2 | NU/EU | PO | U | 0 | 6144 | 56 | 11 |  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | | | | | | | | |  | psf.afpapi.AAPQSAM1 | NU/EU | PO | FB | 80 | 6160 | 272 | 3 |  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | | | | | | | | |  | psf.afpapi.AAPQULIB | NU/EU | PO | VBM | 8205 | 8209 | 12 | 2 |  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | À À À À À À À |  | NOTES: |  | |  | ù The high level qualifier, psf.afpapi, can be changed to meet |  | your installations naming conventions. |  | |  | ù The number of blocks and directory blocks specified is 15% |  | larger than the minimum storage required by AFP API after the |  | program is installed and the data sets are compressed. You |  | may wish to revise these numbers based on your plans for |  | adding additional function or service. |  | |  | ù If required, data sets may be reblocked to a larger size. |  | |  | ù See 6.1.2, "Allocate Target and Distribution Libraries" on |  | page 23 for JCL that allocates these data sets. |  ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ   5.3 PROGRAM CONSIDERATIONS  If you have installed Enhanced ACIF (FMID HQN2220), DO NOT INSTALL  ACIF FOR PSF/MVS 2.2.0 (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.  PSF/MVS Version 2.2.0 base product (FMID HPRF220) is not required to  install ACIF or AFP API. PSF/MVS Version 2.2.0 base product IS  required; however, to print ACIF or AFP API output. For information  on the programming requirements for ACIF and AFP API, see 5.2.3,  "Programming Requirements" on page 14.   Installation Requirements and Considerations 19 ¤   ACIF for PSF/MVS 2.2.0 (FMID HQN2110) and AFP API for PSF/MVS 2.2.0  (FMID HQN2112) are service updates of ACIF for PSF/MVS 2.1.1 and AFP  API for PSF/MVS 2.1.1. They have a new SOURCEID of SMC9617. It is  possible to install the service listed in 4.0, "Program and Service  Level Information" on page 9 for ACIF for PSF/MVS 2.1.1 and AFP API  for PSF/MVS 2.1.1 to receive the same function as ACIF for PSF/MVS  2.2.0 and AFP API for PSF/MVS 2.2.0, Service Level SMC9617.  The installation of ACIF and AFP API Service Level SMC9617, will  delete all prior levels of ACIF and AFP API. If you want to install  ACIF and AFP API Service Level SMC9617, and keep a previous level of  ACIF and AFP API on your system concurrently, then you should install  ACIF and AFP API Service Level SMC9617 into a separate set of SMP/E  zones from the previous level.   5.3.1 SMP/E PROCEDURES AND DATA SETS  All SMP/E installation jobs provided assume the existence of a  cataloged procedure called SMPPROC containing all necessary DD  statements for the execution of SMP/E. SMPPROC must point to the  Consolidated Software Inventory (CSI) where you are installing ACIF  and AFP API. If your SMP/E procedure is not named "SMPPROC",  substitute your procedure name for "SMPPROC" where appropriate. If you  do not have an SMP/E procedure, you can find instructions for building  one in the SMP/E User's Guide or in the SMP/E Reference.  All of the SMP/E installation steps can be completed using the SMP/E  dialog panels. The SMPPROC procedure is not required when using the  SMP/E dialogs. The equivalent function can be accomplished through  the SMP/E dialogs.  The default values on the SMP/E global zone OPTIONS entry (PEMAX and  DSSPACE) are adequate for the installation of ACIF and AFP API. Refer  to the SMP/E Reference for instructions on updating the global zone.         Installation Requirements and Considerations 20 ¤   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 and AFP  API.  If you obtained ACIF and AFP API as part of a CBPDO, you can use the  RCVPDO job found in the CBPDO RIMLIB data set to receive ACIF and AFP  API, as well as any service, HOLDDATA, or preventive service planning  (PSP) information included on the CBPDO tape. For more information,  refer to the MVS CBPDO Memo to User Extension included with the CBPDO.  This release of ACIF and AFP API is installed using the SMP/E RECEIVE,  APPLY, and ACCEPT commands.  In the sample SMP/E jobs shown, the global zone name in the SMP/E CSI  is GLOBAL. The distribution zone name is dlibzone. The target zone  name is tgtzone. If your installation does not use these zone names,  the sample jobs should be updated to reflect the zone names used at  your installation.   6.1 INSTALLING ACIF AND AFP API  The following steps are described in this section.  1. Unload sample JCL  2. Allocate target and distribution libraries  3. Define DDDEFs  4. Receive ACIF and AFP API  5. Perform APPLY CHECK  6. Load target libraries using APPLY  7. Verify Installation of ACIF and AFP API  8. Perform ACCEPT CHECK  9. Load distribution libraries using ACCEPT  10. Perform activities in 7.0, "ACIF and AFP API Installation  Verification Procedure" on page 40.    (C) Copyright IBM Corp. 1993, 1996 21 ¤   6.1.1 UNLOAD SAMPLE JCL  Sample jobs are provided on the ACIF and AFP API tape to help install  ACIF and AFP API.  Use the JCL shown in Figure 12 on page 22 to unload the sample jobs  from the ACIF and AFP API tape.  If the sample jobs are unloaded into a data set with a different name  from "apkq.jcllib", all future references in this directory to  "apkq.jcllib" should be replaced with that new name.  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | |  | //UNLOAD JOB 'account #','name',MSGLEVEL=(1,1) |  | //STEP1 EXEC PGM=IEBCOPY |  | //SYSPRINT DD SYSOUT=* |  | //* |  | //*----------------------------------------------------------- |  | //* UNLOAD SAMPLE JOBS FROM TAPE. |  | //* NOTE: CHANGE tape TO A VALID NAME FOR A TAPE DRIVE. |  | //* CHANGE vvvvvv TO A VALID VOLSER. |  | //* CHANGE apkq.jcllib TO A VALID DATA SET NAME |  | //* FOR YOUR INSTALLATION. |  | //*----------------------------------------------------------- |  | //* |  | //INTAP1 DD DSNAME=IBM.HQN2110.F3,DISP=(OLD,KEEP), |  | // UNIT=(tape,,DEFER), |  | // LABEL=(4,SL), |  | // VOL=SER=QN2110 |  | //INTAP2 DD DSNAME=IBM.HQN2112.F5,DISP=(OLD,KEEP), |  | // UNIT=(tape,,DEFER), |  | // LABEL=(12,SL), |  | // VOL=SER=QN2110 |  | //OUTDISK DD DSNAME=apkq.jcllib,DISP=(NEW,CATLG,DELETE), |  | // UNIT=SYSDA,SPACE=(TRK,(5,1,3)),VOL=SER=vvvvvv |  | //SYSUT3 DD UNIT=SYSDA,SPACE=(TRK,(30,5)),DISP=(NEW,DELETE) |  | //SYSUT4 DD UNIT=SYSDA,SPACE=(TRK,(30,5)),DISP=(NEW,DELETE) |  | //SYSIN DD * |  | COPY OUTDD=OUTDISK,INDD=INTAP1 |  | COPY OUTDD=OUTDISK,INDD=INTAP2 |  | S M=(APQDDEF,APQALOC) |  | /* |  | |  ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ  Figure 12. Sample JCL to Unload the ACIF and AFP API Sample Jobs  When this job is submitted, the following sample jobs to install ACIF  and AFP API are put into the "apkq.jcllib" data set:    Installation Instructions 22 ¤   APKQAC Sample ACCEPT job  APKQACCK Sample ACCEPT CHECK job  APKQALOC Sample job to allocate target and distribution  libraries for ACIF  APKQAP Sample APPLY job  APKQAPCK Sample APPLY CHECK job  APKQDDEF Sample job to define SMP/E DDDEFs for ACIF  APKQRCV Sample RECEIVE job  APKQRCVC Sample RECEIVE job for cumulative service  APQALOC Sample job to allocate target and distribution  libraries for AFP API  APQDDEF Sample job to define SMP/E DDDEFS for AFP API   6.1.2 ALLOCATE TARGET AND DISTRIBUTION LIBRARIES  Jobs are included in the sample JCL to allocate the target and  distribution data sets needed for installation. After unloading the  sample JCL, the allocation job for ACIF is found in  "apkq.jcllib(APKQALOC)". The APKQALOC job is shown in Figure 13 on  page 24.  The allocation job for AFP API can be found in "apkq.jcllib(APQALOC)".  The APQALOC job is shown in Figure 14 on page 26. See 6.1.1, "Unload  Sample JCL" on page 22 for more information on unloading the sample  JCL.  Modify the sample jobs to 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", defined in the APKQALOC  job, and high level qualifier prefix, "PSF.AFPAPI", defined in the  APQALOC job, to be valid high level qualifiers for your installation.       Installation Instructions 23 ¤   ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | |  | //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 13 (Part 1 of 2). Sample Allocate Job for ACIF    Installation Instructions 24 ¤   ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | |  | //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 13 (Part 2 of 2). Sample Allocate Job for ACIF           Installation Instructions 25 ¤   ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | |  | //APQALOC JOB 'account #','name',MSGLEVEL=(1,1) |  | //* |  | //*********************************************************** |  | //* ALLOCATE TARGET AND DISTRIBUTION DATA SETS FOR * |  | //* AFP API. * |  | //* 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 APIPFX='PSF.AFPAPI', |  | // UNIT=xxxx,TVOL=tttttt,DVOL=dddddd |  | //ALLOC1 EXEC PGM=IEFBR14 |  | //* |  | //*********************************************************** |  | //* ALLOCATE TARGET DATA SETS FOR AFP API. * |  | //*********************************************************** |  | //* |  | //SAPQMOD1 DD DSN=&APIPFX..SAPQMOD1,DISP=(NEW,CATLG), |  | // DCB=(RECFM=U,LRECL=0,BLKSIZE=6144), |  | // UNIT=&UNIT,VOL=SER=&TVOL,SPACE=(6144,(200,20,3)) |  | //* |  | //SAPQMOD2 DD DSN=&APIPFX..SAPQMOD2,DISP=(NEW,CATLG), |  | // DCB=(RECFM=U,LRECL=0,BLKSIZE=6144), |  | // UNIT=&UNIT,VOL=SER=&TVOL,SPACE=(6144,(72,7,12)) |  | //* |  | //SAPQSAM1 DD DSN=&APIPFX..SAPQSAM1,DISP=(NEW,CATLG), |  | // DCB=(RECFM=FB,LRECL=80,BLKSIZE=6160), |  | // UNIT=&UNIT,VOL=SER=&TVOL,SPACE=(6160,(272,27,3)) |  | //* |  | //SAPQULIB DD DSN=&APIPFX..SAPQULIB,DISP=(NEW,CATLG), |  | // DCB=(RECFM=VBM,LRECL=8205,BLKSIZE=8209), |  | // UNIT=&UNIT,VOL=SER=&TVOL,SPACE=(8209,(12,2,2)) |  | //* |  | //*********************************************************** |  | //* ALLOCATE DISTRIBUTION DATA SETS FOR AFP API. * |  | //*********************************************************** |  | //* |  | //AAPQMOD1 DD DSN=&APIPFX..AAPQMOD1,DISP=(NEW,CATLG), |  | // DCB=(RECFM=U,LRECL=0,BLKSIZE=6144), |  | // UNIT=&UNIT,VOL=SER=&DVOL,SPACE=(6144,(264,26,36)) |  | //* |  | |  ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ  Figure 14 (Part 1 of 2). Sample Allocate Job for AFP API    Installation Instructions 26 ¤   ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | |  | //AAPQMOD2 DD DSN=&APIPFX..AAPQMOD2,DISP=(NEW,CATLG), |  | // DCB=(RECFM=U,LRECL=0,BLKSIZE=6144), |  | // UNIT=&UNIT,VOL=SER=&DVOL,SPACE=(6144,(56,6,11)) |  | //* |  | //AAPQSAM1 DD DSN=&APIPFX..AAPQSAM1,DISP=(NEW,CATLG), |  | // DCB=(RECFM=FB,LRECL=80,BLKSIZE=6160), |  | // UNIT=&UNIT,VOL=SER=&DVOL,SPACE=(6160,(272,27,3)) |  | //* |  | //AAPQULIB DD DSN=&APIPFX..AAPQULIB,DISP=(NEW,CATLG), |  | // DCB=(RECFM=VBM,LRECL=8205,BLKSIZE=8209), |  | // UNIT=&UNIT,VOL=SER=&DVOL,SPACE=(8209,(12,2,2)) |  | //* |  | //EALLOC PEND |  | //* |  | //ALLOCAT EXEC ALLOC |  | /* |  | |  ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ  Figure 14 (Part 2 of 2). Sample Allocate Job for AFP API  A return code of "0" should be received from these jobs.   6.1.3 TARGET AND DISTRIBUTION LIBRARY DDDEFS  SMP/E DDDEF entries for each target and distribution library data set  should be defined at this time, if not already done.  The sample job to define the DDDEFs for ACIF is found in  "apkq.jcllib(APKQDDEF)". The APKQDDEF job is shown in Figure 15 on  page 28.  The sample job to define the DDDEFs for AFP API is found in  "apkq.jcllib(APQDDEF)". The APQDDEF job is shown in Figure 16 on  page 30.  Modify the sample jobs to specify the appropriate parameters for your  installation, using the comments in the job as a guide. Modify the  high level qualifier of "PSF.ACIF", and "PSF.AFPAPI" to be valid high  level qualifiers 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. See 6.1.2, "Allocate Target and Distribution  Libraries" on page 23 for information on allocating the target and  distribution data sets.  NOTE: SMP/E dialog panels may be used to define these DDDEFs instead  of the JCL.    Installation Instructions 27 ¤   ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | |  | //APKQDDEF JOB 'acct. no.','name',MSGLEVEL=(1,1) |  | //SMP EXEC SMPPROC |  | //* |  | //************************************************* |  | //* 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 15 (Part 1 of 2). JCL to Create Target and Distribution DDDEFs  for ACIF     Installation Instructions 28 ¤   ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | |  | 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 15 (Part 2 of 2). JCL to Create Target and Distribution DDDEFs  for ACIF      Installation Instructions 29 ¤   ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | |  | //APQDDEF JOB 'acct. no.','name',MSGLEVEL=(1,1) |  | //SMP EXEC SMPPROC |  | //* |  | //************************************************* |  | //* Allocate SMP/E DDDEFS for AFP API. |  | //* 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(SAPQMOD1) |  | DATASET(PSF.AFPAPI.SAPQMOD1) |  | UNIT(uuuu) VOLUME(tvol) |  | OLD . |  | REP DDDEF(SAPQMOD2) |  | DATASET(PSF.AFPAPI.SAPQMOD2) |  | UNIT(uuuu) VOLUME(tvol) |  | OLD . |  | REP DDDEF(SAPQSAM1) |  | DATASET(PSF.AFPAPI.SAPQSAM1) |  | UNIT(uuuu) VOLUME(tvol) |  | OLD . |  | REP DDDEF(SAPQULIB) |  | DATASET(PSF.AFPAPI.SAPQULIB) |  | UNIT(uuuu) VOLUME(tvol) |  | OLD . |  | REP DDDEF(AAPQMOD1) |  | DATASET(PSF.AFPAPI.AAPQMOD1) |  | UNIT(uuuu) VOLUME(dvol) |  | OLD . |  | REP DDDEF(AAPQMOD2) |  | DATASET(PSF.AFPAPI.AAPQMOD2) |  | UNIT(uuuu) VOLUME(dvol) |  | OLD . |  | REP DDDEF(AAPQSAM1) |  | DATASET(PSF.AFPAPI.AAPQSAM1) |  | UNIT(uuuu) VOLUME(dvol) |  | OLD . |  | |  ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ  Figure 16 (Part 1 of 2). JCL to Create Target and Distribution DDDEFs  for AFP API     Installation Instructions 30 ¤   ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | |  | REP DDDEF(AAPQULIB) |  | DATASET(PSF.AFPAPI.AAPQULIB) |  | UNIT(uuuu) VOLUME(dvol) |  | OLD . |  | ENDUCL. |  | SET BDY(dlibzone) . |  | UCLIN . |  | REP DDDEF(AAPQMOD1) |  | DATASET(PSF.AFPAPI.AAPQMOD1) |  | UNIT(uuuu) VOLUME(dvol) |  | OLD . |  | REP DDDEF(AAPQMOD2) |  | DATASET(PSF.AFPAPI.AAPQMOD2) |  | UNIT(uuuu) VOLUME(dvol) |  | OLD . |  | REP DDDEF(AAPQSAM1) |  | DATASET(PSF.AFPAPI.AAPQSAM1) |  | UNIT(uuuu) VOLUME(dvol) |  | OLD . |  | REP DDDEF(AAPQULIB) |  | DATASET(PSF.AFPAPI.AAPQULIB) |  | UNIT(uuuu) VOLUME(dvol) |  | OLD . |  | ENDUCL . |  | /* |  | // |  | |  ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ  Figure 16 (Part 2 of 2). JCL to Create Target and Distribution DDDEFs  for AFP API  A return code of "4" and the message GIM27701W should be received from  these jobs 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.   6.1.4 LOAD SMP/E LIBRARIES USING RECEIVE  Execute the SMP/E RECEIVE job to unload ACIF and AFP API data from the  install tape into the SMP/E data sets (SMPPTS and temporary data  sets).  A sample RECEIVE job can be found in "apkq.jcllib(APKQRCV)". The  APKQRCV job is shown in Figure 17 on page 32.  Modify the job to specify the appropriate value for "tape", and the  appropriate "UNIT", and "VOLSER" for the SMPTLIB data sets.  After the RECEIVE job is completed, all sample install jobs for ACIF  can be found in the SMPTLIB data set "IBM.HQN2110.F3", and the sample   Installation Instructions 31 ¤   install jobs for AFP API can be found in the SMPTLIB data set  "IBM.HQN2112.F5".  NOTE: This step is bypassed if receiving the product from a CBPDO.  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | |  | //APKQRCV JOB 'account #','name',MSGLEVEL=(1,1) |  | //RECEIVE EXEC SMPPROC |  | //SMP.SMPPTFIN DD DSN=SMPMCS,DISP=(OLD,PASS), |  | // VOL=SER=QN2110,LABEL=(1,SL), |  | // UNIT=(tape,,DEFER) |  | //SMPTLIB DD UNIT=xxxx,DISP=OLD,VOL=SER=nnnnnn |  | //SMP.SMPCNTL DD * |  | SET BDY(GLOBAL). |  | RECEIVE S(HQN2110, HQN2112) SYSMOD . |  | /* |  | |  ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ  Figure 17. Sample SMP/E RECEIVE Job  A return code of "0" should be received from this job.   6.1.5 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, skip this section.  A sample job to RECEIVE the PTFs and HOLDDATA from the cumulative  service tape can be found in "apkq.jcllib(APKQRCVC)". This job is  also provided on the ACIF and AFP API tape in member "APKQRCVC" of  SMPTLIB: "IBM.HQN2110.F3". The APKQRCVC job is shown in Figure 18 on  page 33.  Modify the job to specify the appropriate value for "tape".        Installation Instructions 32 ¤   ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | |  | //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 SMPPROC |  | //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 18. RECEIVE Job for Cumulative Service Tape  A return code of "0" should be received from this job.  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.   6.1.6 PERFORM SMP/E APPLY CHECK  Execute the SMP/E APPLY CHECK job to determine which SYSMODs, if any,  are missing. Any missing SYSMODs should be installed before  continuing with the installation of ACIF and AFP API.  A sample APPLY CHECK job can be found in "apkq.jcllib(APKQAPCK)".  This job is also provided on the ACIF and AFP API tape in member  "APKQAPCK" of SMPTLIB: "IBM.HQN2110.F3". The APKQAPCK job is shown in  Figure 19 on page 34.  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.   Installation Instructions 33 ¤   Modify the job to specify the appropriate "UNIT" and "VOLSER" for the  SMPTLIB data sets. Also modify the "tgtzone" to be the appropriate  SMP/E target zone name for your installation.  NOTE: If HQN2110 or HQN2112 is already installed, you must add the  REDO parameter to the APPLY CHECK statement.  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | |  | //APKQAPCK JOB 'account #','name',MSGLEVEL=(1,1) |  | //APPLY EXEC SMPPROC |  | //SMPTLIB DD UNIT=xxxx,DISP=OLD,VOL=SER=nnnnnn |  | //SMP.SMPCNTL DD * |  | SET BDY(tgtzone). |  | APPLY CHECK S(HQN2110,HQN2112) |  | BYPASS(HOLDCLASS(UCLREL,ERREL)) GROUPEXTEND. |  | /* |  | |  ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ  Figure 19. Sample SMP/E APPLY CHECK Job  If you are installing ACIF (HQN2110), you may receive the following  warning message:  GIM67301W LOAD MODULE APKACIF IN SYSLIB SAPKMOD1 DOES NOT  INCLUDE MODULE APKFTIEZ BECAUSE SMP/E COULD NOT  FIND APKFTIEZ.  This message can be safely ignored. A return code of "4" should be  received.  If AFP API (HQN2112) has never been installed, you will receive  message GIM61903W as follows:  GIM61903W LMOD APQIOMOD WAS NOT DELETED BY SYSMOD HQN2112  BECAUSE APQIOMOD IS NOT IN THE TARGET ZONE  GIM61903W LMOD APQTKMOD WAS NOT DELETED BY SYSMOD HQN2112  BECAUSE APQTKMOD IS NOT IN THE TARGET ZONE   and a return code of "4" should be received. If a previous release of  AFP API was installed, a return code of "0" should be received.  Investigate any other problems before continuing with the installation  of ACIF and AFP API.      Installation Instructions 34 ¤   6.1.7 LOAD TARGET LIBRARIES USING APPLY  Execute SMP/E to load the target libraries from the SMP/E temporary  data sets.  A sample APPLY job can be found in "apkq.jcllib(APKQAP)". This job is  also provided on the ACIF and AFP API tape in member "APKQAP" of  SMPTLIB: "IBM.HQN2110.F3". The APKQAP job is shown in Figure 20 on  page 35.  Modify the job to specify the appropriate "UNIT" and "VOLSER" for the  SMPTLIB data sets. Also modify the "tgtzone" to be the appropriate  SMP/E target zone name for your installation.  NOTE: If HQN2110 or HQN2112 is already installed, you must add the  REDO parameter to the APPLY statement.  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | |  | //APKQAP JOB 'account #','name',MSGLEVEL=(1,1) |  | //APPLY EXEC SMPPROC |  | //SMPTLIB DD UNIT=xxxx,DISP=OLD,VOL=SER=nnnnnn |  | //SMP.SMPCNTL DD * |  | SET BDY(tgtzone). |  | APPLY S(HQN2110,HQN2112) |  | BYPASS(HOLDCLASS(UCLREL,ERREL)) |  | GROUPEXTEND. |  | /* |  | |  ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ  Figure 20. Sample SMP/E APPLY Job  ACIF MESSAGES: If you are installing ACIF (HQN2110), you may receive  the following warning message:  GIM67301W LOAD MODULE APKACIF IN SYSLIB SAPKMOD1 DOES NOT  INCLUDE MODULE APKFTIEZ BECAUSE SMP/E COULD NOT  FIND APKFTIEZ.  This message can be safely ignored. A return code of "4" should be  received.  AFP API MESSAGES: If you are installing AFP API (HQN2112), you will  receive a return code of "4" and the following messages:  ù If AFP API has never been installed, you will receive the  following warning messages:  GIM61903W LMOD APQTKMOD WAS NOT DELETED BY SYSMOD HQN2112  BECAUSE APQTKMOD IS NOT IN THE TARGET ZONE  GIM61903W LMOD APQIOMOD WAS NOT DELETED BY SYSMOD HQN2112  BECAUSE APQIOMOD IS NOT IN THE TARGET ZONE   Installation Instructions 35 ¤   ù DFP linkage editor message IEW0461 or DFSMS binder mesage IEW2454W  is expected for the load modules listed below and can be ignored.  Message GIM23903W with return code 04 will be received for all  modules included in these load modules, and for all other load  modules that are processed by SMP/E in the same link-edit batch  (SMP/E sequence number).  Ä Unresolved external references for the CICS interface modules  DFHEAI0 and DFHEI1 are expected for the following load  modules:  APQCGET APQCLOAD APQEFOP  APQCIMOD APQEFLS APQEPLS  Ä Unresolved external references for the C interface modules  EDCXxxxx are expected for the following load modules:  APQBDOC APQDFLD APQINIT APQQSTR  APQBFLD APQDFNT APQINVM APQSCLR  APQBGRP APQDROW APQIOBJ APQSFNT  APQBPAG APQEARE APQIOVL APQSICS  APQBPAR APQEDOC APQIPSG APQSLIB  APQBROW APQEFLD APQPARE APQSOUT  APQBTBL APQEGRP APQPBOX APQSPOS  APQCARE APQEND APQPCHS APQSRTH  APQCEND APQEPAG APQPRUL APQSUNI  APQCFREE APQEPAR APQPTAG APQSWSP  APQCGET APQEROW APQPTXT APQTERM  APQCINIT APQETBL APQQATT APQXARE  APQCTERM APQGBUF APQQPOS  ù The DFSMS Binder messages  IEW2646W ESD RMODE(24) CONFLICTS WITH USER-SPECIFIED  RMODE(ANY) FOR SECTION APQxxxxx.  IEW2651W ESD AMODE 24 CONFLICTS WITH USER-SPECIFIED  AMODE 31 FOR FOR ENTRY POINT xxxxxxx.  are expected for the following load modules and may be safely  ignored:  APQCFREE APQCIMOD APQCUNLD APQEPLS  APQCGET APQCLOAD APQEFLS APQEFOP  ù The DFSMS Binder message  IEW2650I MODULE ENTRY NOT PROVIDED. ENTRY DEFAULTS TO  SECTION APQxxxx  is expected for the following load modules and may be safely  ignored:  APQBDOC APQBGRP APQBPAR APQBTBL  APQBFLD APQBPAG APQBROW APQCARE   Installation Instructions 36 ¤   APQCEND APQEFOP APQPARE APQSOUT  APQCFREE APQEGRP APQPBOX APQSPOS  APQCGET APQEND APQPCHS APQSRTH  APQCINIT APQEPAG APQPRUL APQSUNI  APQCLOAD APQEPAR APQPTAG APQSWSP  APQCTERM APQEROW APQPTXT APQTERM  APQDFLD APQETBL APQQATT APQXARE  APQDFNT APQGBUF APQQPOS APQXFREE  APQDROW APQINIT APQQSTR APQXGET  APQEARE APQINVM APQSCLR APQXLOAD  APQEDOC APQIOBJ APQSFNT APQXSRVI  APQEFLD APQIOVL APQSICS APQXSRVN  APQEFLS APQIPSG APQSLIB APQXUNLD  Investigate any other problems before continuing with the installation  of ACIF and AFP API.   6.1.8 VERIFY INSTALLATION OF ACIF AND AFP API  If you want to verify that the installation of ACIF and AFP API was  successful prior to running the SMP/E ACCEPT, you should complete the  steps in 7.0, "ACIF and AFP API Installation Verification Procedure"  on page 40 before continuing with 6.1.9, "Perform SMP/E ACCEPT CHECK."   6.1.9 PERFORM SMP/E ACCEPT CHECK  When you are satisfied that ACIF and AFP API are working correctly,  you can complete the SMP/E ACCEPT CHECK and ACCEPT jobs.  Execute the SMP/E ACCEPT CHECK job to determine which SYSMODs, if any,  are missing. Any missing SYSMODs should be installed before  continuing with the installation of ACIF and AFP API.  A sample ACCEPT CHECK job can be found in "apkq.jcllib(APKQACCK)".  This job is also provided on the ACIF and AFP API tape in member  "APKQACCK" of SMPTLIB: "IBM.HQN2110.F3". The APKQACCK job is shown in  Figure 21 on page 38.  Modify the job to specify the appropriate "UNIT" and "VOLSER" for the  SMPTLIB data sets. Also modify the "dlibzone" to be the appropriate  SMP/E distribution zone name for your installation.  NOTE: If HQN2110 or HQN2112 is already installed, you must add the  REDO parameter to the ACCEPT CHECK statement.  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).   Installation Instructions 37 ¤   The GROUPEXTEND operand indicates that SMP/E accept all requisite  SYSMODs. The requisite SYSMODS might be applicable to other  functions.  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | |  | //APKQACCK JOB 'account #','name',MSGLEVEL=(1,1) |  | //ACCEPT EXEC SMPPROC |  | //SMPTLIB DD UNIT=xxxx,DISP=OLD,VOL=SER=nnnnnn |  | //SMP.SMPCNTL DD * |  | SET BDY(dlibzone). |  | ACCEPT CHECK S(HQN2110,HQN2112) |  | BYPASS (HOLDCLASS(UCLREL,ERREL)) GROUPEXTEND. |  | /* |  | |  ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ  Figure 21. Sample SMP/E ACCEPT CHECK Job  If you are installing ACIF (HQN2110), a return code of "0" should be  received.  If you are installing AFP API (HQN2112), you will receive a return  code of "4" and the following warning messages:  GIM61903W LMOD APQIOMOD WAS NOT DELETED BY SYSMOD HQN2112  BECAUSE APQIOMOD IS NOT IN THE DLIB ZONE  GIM61903W LMOD APQTKMOD WAS NOT DELETED BY SYSMOD HQN2112  BECAUSE APQTKMOD IS NOT IN THE DLIB ZONE   These messages may be safely ignored. The ++DELETE for load modules  APQIOMOD and APQTKMOD in the SMPMCS causes this message to be  generated during ACCEPT CHECK processing because LMOD entries are not  stored in the DLIB zone.  Investigate any other problems before continuing with the installation  of ACIF and AFP API.   6.1.10 LOAD DISTRIBUTION LIBRARIES USING ACCEPT  Execute the SMP/E ACCEPT job to load the distribution libraries from  the SMP/E temporary data sets.  A sample ACCEPT job can be found in "apkq.jcllib(APKQAC)". This job  is also provided on the ACIF and AFP API tape in member "APKQAC" of  SMPTLIB: "IBM.HQN2110.F3". The APKQAC job is shown in Figure 22 on  page 39.  Modify the job to specify the appropriate "UNIT" and "VOLSER" for the  SMPTLIB data sets. Also modify the "dlibzone" to be the appropriate  SMP/E distribution zone name for your installation.   Installation Instructions 38 ¤   NOTE: If HQN2110 or HQN2112 is already installed, you must add the  REDO parameter to the ACCEPT statement.  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | |  | //APKQAC JOB 'account #','name',MSGLEVEL=(1,1) |  | //ACCEPT EXEC SMPPROC |  | //SMPTLIB DD UNIT=xxxx,DISP=OLD,VOL=SER=nnnnnn |  | //SMP.SMPCNTL DD * |  | SET BDY(dlibzone). |  | ACCEPT S(HQN2110,HQN2112) |  | BYPASS(HOLDCLASS(UCLREL,ERREL)) |  | GROUPEXTEND COMPRESS(ALL). |  | /* |  | |  ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ  Figure 22. Sample SMP/E ACCEPT Job  If you are installing ACIF (HQN2110), a return code of "0" should be  received.  If you are installing AFP API (HQN2112), you will receive a return  code of "4" and the following warning messages:  GIM61903W LMOD APQIOMOD WAS NOT DELETED BY SYSMOD HQN2112  BECAUSE APQIOMOD IS NOT IN THE DLIB ZONE  GIM61903W LMOD APQTKMOD WAS NOT DELETED BY SYSMOD HQN2112  BECAUSE APQTKMOD IS NOT IN THE DLIB ZONE   These messages may be safely ignored. The ++DELETE for load modules  APQIOMOD and APQTKMOD in the SMPMCS causes this message to be  generated during ACCEPT CHECK processing because LMOD entries are not  stored in the DLIB zone.         Installation Instructions 39 ¤   7.0 ACIF AND AFP API INSTALLATION VERIFICATION PROCEDURE    The following sections give detailed Installation Verification  Procedures (IVP) for ACIF, AFP API in the MVS environment, and AFP API  in the CICS/ESA environment.   7.1 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 23. 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.  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | |  | //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 */ |  | |  ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ  Figure 23 (Part 1 of 2). APKIVP Job for ACIF IVP    (C) Copyright IBM Corp. 1993, 1996 40 ¤   ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | |  | 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 |  | /* |  | //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 23 (Part 2 of 2). APKIVP Job for ACIF IVP  This job creates the following MVS 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, use your installation's normal  process to print documents using the resources saved in the data set  "PSF.ACIF.IVPSAMP.RESLIB".   ACIF and AFP API Installation Verification Procedure 41 ¤   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.                    ACIF and AFP API Installation Verification Procedure 42 ¤   7.2 AFP API INSTALLATION VERIFICATION PROCEDURE IN THE MVS  ENVIRONMENT  The IVP for AFP API consists of the following steps:  ù Create a font library index  ù Complete IVP jobs for the COBOL program  ù Complete IVP jobs for the PL/1 program.  The IVP jobs for AFP API use the Times New Roman 240 or 300 pel Core  Interchange Fonts. These fonts are shipped with the AFP Font  Collection product (5648-113). If you do not have these fonts  installed, the IVP jobs cannot be completed successfully.   7.2.1 CREATE FONT LIBRARY INDEX  Before running the IVP jobs APQIVCOB and APQIVPLI for AFP API, a font  library index for the Times New Roman 240 or 300 pel core interchange  fonts must be created.  If a font library index has already been created for these fonts using  the Font Library Index Program (FLIP) available with Document  Composition Facility (DCF)/MVS Version 1 Release 4.0, the DCFINDEX  file created from DCF/MVS can be used with AFP API. However, if  DCF/MVS Version 1 Release 4.0 is not available, the FLIP job included  with AFP API must be run to create a font library index called  AFPINDEX. To create the AFPINDEX file, execute the job in  "PSF.AFPAPI.SAPQSAM1(APQFLIP)". Modify the job card for your  installation. Also change the data set names in lower case to the  appropriate names for your installation.  NOTE: If other fonts will be used when AFP API is run in production,  this job can be used to create an AFPINDEX for the other fonts. This  job must be modified to contain the font library names where the other  fonts reside on your system. Refer to the "Font Library Index  Program" section of AFP Application Programming Interface:  Programming Guide and Reference for more information on FLIP.        ACIF and AFP API Installation Verification Procedure 43 ¤   ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | |  | //RUNFLIP JOB 'acct info','name',MSGLEVEL=(0,1), |  | // REGION=5M |  | //* |  | //INDEX1 EXEC PGM=FLIPMVS |  | //STEPLIB DD DISP=SHR,DSN=PSF.AFPAPI.SAPQMOD1 |  | //****************************************************** |  | //* Instructions for using this JCL. |  | //* 1. Replace the job card with a valid job card for your |  | //* installation. |  | //* |  | //* 2. The SYSPRINT ddname can be a sequential data set or |  | //* can be changed to a SYSOUT data set if you do not |  | //* want to save the report from building the font index. |  | //* |  | //* 3. The FONTLIB ddname can point to a single font library |  | //* or a concatenation of font libraries. If it is a single |  | //* library, the AFPINDEX member will be added to the |  | //* FONTLIB library. If a concatenation of libraries is |  | //* used for FONTLIB, you must use FONTLIBO to point to the |  | //* library to which the AFPINDEX member will be added. |  | //* For AFP API, you should use the library that contains |  | //* the core interchange fonts. |  | //****************************************************** |  | //SYSPRINT DD DSN=userid.FONT.LISTING,DISP=(NEW,CATLG), |  | // UNIT=nnnn,VOL=SER=vvvvvv, |  | // SPACE=(TRK,(10,10)), |  | // DCB=(RECFM=VMB,BLKSIZE=1022,LRECL=125,DSORG=PS) |  | //FONTLIB DD DISP=OLD,DSN=SYS1.FONTLIBB |  | //FONTLIBO DD DISP=OLD,DSN=SYS1.FONTLIBB |  | // |  | |  ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ  Figure 24. APQFLIP Job to Create Font Index  A return code of "0" should be received from this job.        ACIF and AFP API Installation Verification Procedure 44 ¤   7.2.2 IVP FOR THE COBOL PROGRAM  To ensure that the COBOL program is installed, run the APQCOCOB job  shown in Figure 25 on page 46, to compile and link-edit a sample  program. This job exists in the data set  "PSF.AFPAPI.SAPQSAM1(APQCOCOB)". Modify the job card for your  installation. Also change the data set name in lower case to your  COBOL library name before submitting the job.  The compile options to be used to compile APQCOCOB are:   ADV QUOTE NOAWO BUFSIZE(4096) NOCMPR2 NOCOMPILE(S)  DATA(31) NODBCS NODECK NODUMP NODYNAM NOEXIT NOFASTSRT  NOFDUMP FLAG(1) NOFLAGMIG NOFLAGSAA NOFLAGSTD  LANGUAGE(EN) LIB LINECOUNT(60) LIST NOMAP NONAME  NONUMBER NUMPROC(NOPFD) OBJECT NOOFFSET NOOPTIMIZE  OUTDD(SYSOUT) RENT RESIDENT SEQUENCE SIZE(MAX) SOURCE  SPACE(1) NOSSRANGE NOTERM NOTEST TRUNC(STD) NOVBREF  NOWORD NOXREF ZWB              ACIF and AFP API Installation Verification Procedure 45 ¤   ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | |  | //APQCOCOB JOB 'acct info','name',MSGLEVEL=(1,1) |  | //* COBOL API IVP - COMPILE, AND LINK |  | //COB2 EXEC PGM=IGYCRCTL,PARM='OBJECT,LIST,LIB,RENT,RES,Q', |  | // REGION=1024K |  | //* MODIFY THE FOLLOWING FOR YOUR COBOL LIBRARY |  | //STEPLIB DD DSNAME=cob2.V131.COB2COMP,DISP=SHR |  | //SYSPRINT DD SYSOUT=A |  | //SYSIN DD DSNAME=PSF.AFPAPI.SAPQSAM1(APQSAMP),DISP=SHR |  | //SYSLIN DD DSNAME=&&LOADSET,UNIT=SYSDA,DISP=(MOD,PASS), |  | // SPACE=(TRK,(3,3)), |  | // DCB=(BLKSIZE=80,LRECL=80,RECFM=FB) |  | //* MODIFY THE FOLLOWING FOR YOUR COBOL LIBRARY |  | //SYSLIB DD DSNAME=PSF.AFPAPI.SAPQSAM1,DISP=SHR |  | //SYSUT1 DD UNIT=SYSDA,SPACE=(CYL,(1,1)) |  | //SYSUT2 DD UNIT=SYSDA,SPACE=(CYL,(1,1)) |  | //SYSUT3 DD UNIT=SYSDA,SPACE=(CYL,(1,1)) |  | //SYSUT4 DD UNIT=SYSDA,SPACE=(CYL,(1,1)) |  | //SYSUT5 DD UNIT=SYSDA,SPACE=(CYL,(1,1)) |  | //SYSUT6 DD UNIT=SYSDA,SPACE=(CYL,(1,1)) |  | //SYSUT7 DD UNIT=SYSDA,SPACE=(CYL,(1,1)) |  | //LKED EXEC PGM=IEWL, |  | // PARM='LIST,AMODE=31,RMODE=ANY,RENT,CALL', |  | // COND=(5,LT,COB2), |  | // REGION=512K |  | //SYSLMOD DD DSNAME=PSF.AFPAPI.SAPQMOD1, |  | // DISP=(OLD,KEEP) |  | //* MODIFY FOLLOWING FOR YOUR COBOL LIBRARIES |  | //SYSLIB DD DSNAME=cob2.V131.COB2LIB,DISP=SHR |  | //APQSTUB DD DSNAME=PSF.AFPAPI.SAPQMOD2,DISP=SHR |  | //SYSLIN DD DSNAME=&&LOADSET,DISP=(OLD,DELETE) |  | // DD * |  | INCLUDE APQSTUB(APQINIT) |  | INCLUDE APQSTUB(APQBDOC) |  | INCLUDE APQSTUB(APQBPAG) |  | INCLUDE APQSTUB(APQSPOS) |  | INCLUDE APQSTUB(APQPCHS) |  | INCLUDE APQSTUB(APQEDOC) |  | INCLUDE APQSTUB(APQEPAG) |  | INCLUDE APQSTUB(APQTERM) |  | INCLUDE APQSTUB(APQCARE) |  | INCLUDE APQSTUB(APQPARE) |  | INCLUDE APQSTUB(APQXARE) |  | INCLUDE APQSTUB(APQBPAR) |  | INCLUDE APQSTUB(APQQATT) |  | INCLUDE APQSTUB(APQDFNT) |  | |  ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ  Figure 25 (Part 1 of 2). APQCOCOB Job for COBOL IVP    ACIF and AFP API Installation Verification Procedure 46 ¤   ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | |  | INCLUDE APQSTUB(APQSFNT) |  | INCLUDE APQSTUB(APQQPOS) |  | INCLUDE APQSTUB(APQQSTR) |  | INCLUDE APQSTUB(APQSUNI) |  | INCLUDE APQSTUB(APQSRTH) |  | INCLUDE APQSTUB(APQPBOX) |  | INCLUDE APQSTUB(APQPRUL) |  | INCLUDE APQSTUB(APQPTXT) |  | INCLUDE APQSTUB(APQEPAR) |  | INCLUDE APQSTUB(APQEARE) |  | INCLUDE APQSTUB(APQIOVL) |  | INCLUDE APQSTUB(APQDFLD) |  | INCLUDE APQSTUB(APQDROW) |  | INCLUDE APQSTUB(APQBTBL) |  | INCLUDE APQSTUB(APQBROW) |  | INCLUDE APQSTUB(APQBFLD) |  | INCLUDE APQSTUB(APQEFLD) |  | INCLUDE APQSTUB(APQEROW) |  | INCLUDE APQSTUB(APQETBL) |  | INCLUDE APQSTUB(APQEND) |  | INCLUDE APQSTUB(APQGBUF) |  | INCLUDE APQSTUB(APQINVM) |  | INCLUDE APQSTUB(APQIPSG) |  | INCLUDE APQSTUB(APQSCLR) |  | INCLUDE APQSTUB(APQSICS) |  | INCLUDE APQSTUB(APQSLIB) |  | INCLUDE APQSTUB(APQSOUT) |  | INCLUDE APQSTUB(APQSWSP) |  | INCLUDE APQSTUB(APQBGRP) |  | INCLUDE APQSTUB(APQEGRP) |  | INCLUDE APQSTUB(APQPTAG) |  | INCLUDE APQSTUB(APQIOBJ) |  | INCLUDE APQSTUB(APQXGET) |  | INCLUDE APQSTUB(APQXFREE) |  | INCLUDE APQSTUB(APQXLOAD) |  | INCLUDE APQSTUB(APQXSRVI) |  | INCLUDE APQSTUB(APQXSRVN) |  | INCLUDE APQSTUB(APQXUNLD) |  | ENTRY APQSAMP |  | NAME APQSAMP(R) |  | //SYSUT1 DD UNIT=SYSDA,SPACE=(CYL,(1,1)) |  | //SYSPRINT DD SYSOUT=* |  | /* |  | |  ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ  Figure 25 (Part 2 of 2). APQCOCOB Job for COBOL IVP  A return code of "0" should be received from the APQCOCOB job.  After the APQCOCOB job has completed successfully, run the APQIVCOB  job shown in Figure 26 on page 48, to run the sample program. This  job exists in the data set "PSF.AFPAPI.SAPQSAM1(APQIVCOB)". Modify   ACIF and AFP API Installation Verification Procedure 47 ¤   the job card for your installation. Also change the data set name in  lower case to your COBOL library name before submitting the job.  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | |  | //APQIVCOB JOB 'acct info','name',MSGLEVEL=(1,1) |  | //* COBOL API IVP - RUN APQSAMP |  | //* |  | //********************************************************** |  | //* THIS STEP DELETES THE EXISTING DATASETS * |  | //********************************************************** |  | //* |  | //STEP1 EXEC PGM=IEFBR14 |  | //* |  | //* |  | //FILE1 DD DSN=userid.APQSAMP.LISTAFP, |  | // DISP=(MOD,DELETE,DELETE), |  | // UNIT=SYSDA, |  | // SPACE=(TRK,(1,1),RLSE) |  | //* |  | //SYSPRINT DD SYSOUT=* |  | //SYSOUT DD SYSOUT=* |  | //* |  | //********************************************************** |  | //* THIS STEP RUNS THE JOB APQSAMP * |  | //********************************************************** |  | //* |  | //GO EXEC PGM=APQSAMP |  | //* MODIFY FOLLOWING FOR YOUR COBOL LIBRARY |  | //STEPLIB DD DSNAME=cob2.V131.COB2LIB,DISP=SHR |  | // DD DSNAME=PSF.AFPAPI.SAPQMOD1,DISP=SHR |  | //PSEGDD DD DSNAME=PSF.AFPAPI.SAPQULIB,DISP=SHR |  | //* MODIFY FOLLOWING FOR CORE FONT LIBRARY |  | //FONTDD DD DSNAME=SYS1.FONTLIBB,DISP=SHR |  | //* MODIFY FOLLOWING FOR SAMPLE OUTPUT DATASET |  | //APQSAMP DD DSNAME=userid.APQSAMP.LISTAFP, |  | // DISP=(NEW,CATLG,CATLG), |  | // UNIT=SYSDA, |  | // SPACE=(CYL,(2,1),RLSE), |  | // DCB=(RECFM=VB,LRECL=8205,BLKSIZE=8209) |  | //DATAFILE DD DSNAME=PSF.AFPAPI.SAPQSAM1(APQDATA),DISP=SHR |  | //SYSABOUT DD SYSOUT=* |  | //SYSOUT DD SYSOUT=* |  | //SYSDBOUT DD SYSOUT=* |  | //SYSUDUMP DD SYSOUT=* |  | /* |  | |  ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ  Figure 26. APQIVCOB Job for COBOL IVP  An AFPDS file named "userid.APQSAMP.LISTAFP" is produced, where  "userid" is the high level qualifier used in the JCL. If you want to  print this file, the overlay and page segment installed in  "PSF.AFPAPI.SAPQULIB" must be available for printing. The overlay   ACIF and AFP API Installation Verification Procedure 48 ¤   uses the Sonoran Sans Serif font product (FMID HZD1200) which must be  installed before this file is printed. PSF/MVS Version 2.2.0 can be  used to print this file. An example of the printed LISTAFP file is in  "Using AFP API" section of AFP Application Programming Interface:  Programming Guide and Reference.  If a return code of "0" is received from this job, the IVP is  completed successfully.  NOTE: The IVP jobs will not print correctly on a 3812 printer or on  a 3816 printer that has a microcode level less than V4.0. The output  from the IVP will receive Off Logical Page errors and may contain  vector lines that point to where the overlay should be placed on the  page. The 3812 can be used to print AFP API output, as long as the  output does not contain an overlay. The 3816 must be upgraded to the  TURBO level to print overlays included in the AFP API output. This  can be accomplished by installing a no charge RPQ S02134.   7.2.3 IVP FOR THE PL/1 PROGRAM  To ensure that the PL/1 program is installed, run the APQCOPLI job  shown in Figure 27 on page 50, to compile and link-edit a sample  program. This job exists in the data set  "PSF.AFPAPI.SAPQSAM1(APQCOPLI)". Modify the job card for your  installation. Also change the data set names in lower case to your  userid and your PL/1 library names, before submitting the job.            ACIF and AFP API Installation Verification Procedure 49 ¤   ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | |  | //APQCOPLI JOB 'acct no.','name',MSGLEVEL=(1,1) |  | //* |  | //* MODIFY THE FOLLOWING FOR YOUR PL/I LIBRARIES |  | //JOBLIB DD DSN=pli.V2R3M0.PLICOMP,DISP=SHR |  | // DD DSN=pli.V2R3M0.PLITASK,DISP=SHR |  | // DD DSN=pli.V2R3M0.PLIBASE,DISP=SHR |  | // DD DSN=pli.V2R3M0.SIBMBASE,DISP=SHR |  | // DD DSN=pli.V2R3M0.PLILINK,DISP=SHR |  | // DD DSN=pli.V2R3M0.SIBMLINK,DISP=SHR |  | //* |  | //********************************************************** |  | //* THIS JOB STEP COMPILES PL/1 PROGRAMS * |  | //********************************************************** |  | //* |  | //STEP3 EXEC PGM=IEL0AA, |  | // PARM='OBJECT,SOURCE,XREF,INCLUDE', |  | // REGION=512K |  | //* |  | //DDSYS DD DSN=PSF.AFPAPI.SAPQSAM1,DISP=SHR |  | //* |  | //SYSLIN DD DSNAME=&&LOADSET(APQPSAMP), |  | // UNIT=SYSDA,DISP=(MOD,PASS), |  | // SPACE=(TRK,(30,3,20)), |  | // DCB=(BLKSIZE=80,LRECL=80,RECFM=FB) |  | //SYSUT1 DD DSN=&&SYSUT1, |  | // UNIT=SYSDA, |  | // SPACE=(1024,(200,20)), |  | // DCB=BLKSIZE=1024 |  | //* |  | //SYSIN DD DSN=PSF.AFPAPI.SAPQSAM1(APQPSAMP),DISP=SHR |  | //* |  | //SYSPRINT DD SYSOUT=* |  | //* |  | //********************************************************** |  | //* THIS STEP LINKEDITS THE PROGRAMS * |  | //********************************************************** |  | //* |  | //STEP4 EXEC PGM=IEWL, |  | // COND=(9,LT,STEP3), |  | // PARM='XCAL,LIST', |  | // REGION=512K |  | |  ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ  Figure 27 (Part 1 of 3). APQCOPLI Job for PL/1 IVP     ACIF and AFP API Installation Verification Procedure 50 ¤   ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | |  | //* MODIFY THE FOLLOWING FOR YOUR PL/1 AND C LIBRARIES |  | //SYSLIB DD DSN=pli.V2R3M0.PLIBASE,DISP=SHR |  | // DD DSN=pli.V2R3M0.SIBMBASE,DISP=SHR |  | // DD DSN=pli.V2R3M0.SIBMLINK,DISP=SHR |  | // DD DSN=pli.V2R3M0.PLILINK,DISP=SHR |  | //* MODIFY THE DATA SET NAME AND VOLSER FOR YOUR INSTALLATION |  | //SYSLMOD DD DSN=userid.API.TEMPOUT(APQPSAMP), |  | // UNIT=SYSDA,DISP=(NEW,CATLG,DELETE), |  | // SPACE=(CYL,(5,1,1)),VOL=SER=TEMPnn, |  | // DCB=(BLKSIZE=13000,LRECL=256,RECFM=U) |  | //* |  | //SYSUT1 DD DSN=&&SYSUT1, |  | // UNIT=SYSDA, |  | // SPACE=(1024,(200,20)), |  | // DCB=BLKSIZE=1024 |  | //* |  | //TXTLIB DD DSN=PSF.AFPAPI.SAPQMOD2,DISP=SHR |  | //* |  | //OBJLIB DD DSN=&&LOADSET,DISP=(OLD,PASS) |  | //* |  | //SYSPRINT DD SYSOUT=* |  | //* |  | //SYSLIN DD * |  | INCLUDE OBJLIB(APQPSAMP) |  | INCLUDE TXTLIB(APQBDOC) |  | INCLUDE TXTLIB(APQBPAG) |  | INCLUDE TXTLIB(APQBFLD) |  | INCLUDE TXTLIB(APQBGRP) |  | INCLUDE TXTLIB(APQBROW) |  | INCLUDE TXTLIB(APQBTBL) |  | INCLUDE TXTLIB(APQBPAR) |  | INCLUDE TXTLIB(APQCARE) |  | INCLUDE TXTLIB(APQDFLD) |  | INCLUDE TXTLIB(APQDFNT) |  | INCLUDE TXTLIB(APQDROW) |  | INCLUDE TXTLIB(APQEARE) |  | INCLUDE TXTLIB(APQEDOC) |  | INCLUDE TXTLIB(APQEFLD) |  | INCLUDE TXTLIB(APQEGRP) |  | INCLUDE TXTLIB(APQEND) |  | INCLUDE TXTLIB(APQEPAG) |  | INCLUDE TXTLIB(APQEPAR) |  | INCLUDE TXTLIB(APQEROW) |  | INCLUDE TXTLIB(APQETBL) |  | INCLUDE TXTLIB(APQGBUF) |  | |  ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ  Figure 27 (Part 2 of 3). APQCOPLI Job for PL/1 IVP    ACIF and AFP API Installation Verification Procedure 51 ¤   ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | |  | INCLUDE TXTLIB(APQINIT) |  | INCLUDE TXTLIB(APQINVM) |  | INCLUDE TXTLIB(APQIOBJ) |  | INCLUDE TXTLIB(APQIOVL) |  | INCLUDE TXTLIB(APQIPSG) |  | INCLUDE TXTLIB(APQPARE) |  | INCLUDE TXTLIB(APQPBOX) |  | INCLUDE TXTLIB(APQPTAG) |  | INCLUDE TXTLIB(APQPTXT) |  | INCLUDE TXTLIB(APQQATT) |  | INCLUDE TXTLIB(APQPRUL) |  | INCLUDE TXTLIB(APQPCHS) |  | INCLUDE TXTLIB(APQQPOS) |  | INCLUDE TXTLIB(APQQSTR) |  | INCLUDE TXTLIB(APQSCLR) |  | INCLUDE TXTLIB(APQSFNT) |  | INCLUDE TXTLIB(APQSICS) |  | INCLUDE TXTLIB(APQSLIB) |  | INCLUDE TXTLIB(APQSOUT) |  | INCLUDE TXTLIB(APQSPOS) |  | INCLUDE TXTLIB(APQSRTH) |  | INCLUDE TXTLIB(APQSUNI) |  | INCLUDE TXTLIB(APQSWSP) |  | INCLUDE TXTLIB(APQTERM) |  | INCLUDE TXTLIB(APQXARE) |  | INCLUDE TXTLIB(APQXGET) |  | INCLUDE TXTLIB(APQXFREE) |  | INCLUDE TXTLIB(APQXLOAD) |  | INCLUDE TXTLIB(APQXSRVI) |  | INCLUDE TXTLIB(APQXSRVN) |  | INCLUDE TXTLIB(APQXUNLD) |  | INCLUDE SYSLIB(IBMBOPAA) |  | INCLUDE SYSLIB(IBMBLIIA) |  | MODE AMODE(31),RMODE(ANY) |  | NAME APQPSAMP(R) |  | /* |  | //* |  | // |  | |  ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ  Figure 27 (Part 3 of 3). APQCOPLI Job for PL/1 IVP  A return code of "0" should be received from the APQCOPLI job.  After the APQCOPLI job has completed successfully, run the APQIVPLI  job shown in Figure 28 on page 53, to run the sample program. This  job exists in the data set "PSF.AFPAPI.SAPQSAM1(APQIVPLI)". Modify  the job card for your installation. Also change the data set names in  lower case to your PL/1 library names, and userid before submitting  the job.   ACIF and AFP API Installation Verification Procedure 52 ¤   ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | |  | //APQIVPLI JOB 'acct no.','name',MSGLEVEL=(1,1) |  | //* |  | //* MODIFY THE FOLLOWING FOR YOUR PL/1 LIBRARIES |  | //* ALSO, MODIFY FOR THE TEMPORARY OBJECT DATA SET |  | //* CREATED FROM JOB APQCOPLI |  | //JOBLIB DD DSN=pli.V2R3M0.SIBMLINK,DISP=SHR |  | // DD DSN=pli.V2R3M0.PLILINK,DISP=SHR |  | // DD DSN=pli.V2R3M0.PLILINK,DISP=SHR |  | // DD DSN=PSF.AFPAPI.SAPQMOD1,DISP=SHR |  | // DD DSN=userid.API.TEMPOUT,DISP=SHR |  | //* |  | //********************************************************** |  | //* THIS STEP DELETES THE EXISTING DATASETS * |  | //********************************************************** |  | //* |  | //STEP1 EXEC PGM=IEFBR14 |  | //* |  | //* |  | //FILE1 DD DSN=userid.APQPSAMP.LISTAFP, |  | // DISP=(MOD,DELETE,DELETE), |  | // UNIT=SYSDA, |  | // SPACE=(TRK,(1,1),RLSE) |  | //* |  | //FILE2 DD DSN=userid.APQPSAMP.SYSPRINT, |  | // DISP=(MOD,DELETE,DELETE), |  | // UNIT=SYSDA, |  | // SPACE=(TRK,(1,1),RLSE) |  | //* |  | //SYSPRINT DD SYSOUT=* |  | //SYSOUT DD SYSOUT=* |  | //* |  | //********************************************************** |  | //* THIS STEP RUNS A PL/1 PROGRAM THAT USES THE AFP API * |  | //********************************************************** |  | //* |  | //STEP2 EXEC PGM=APQPSAMP,REGION=4098K |  | //* |  | //SYSUT1 DD UNIT=SYSDA,SPACE=(CYL,(5,1)) |  | //SYSUT2 DD UNIT=SYSDA,SPACE=(CYL,(5,1)) |  | //SYSUT3 DD UNIT=SYSDA,SPACE=(CYL,(5,1)) |  | //* |  | //FONTDD DD DSN=SYS1.FONTLIBB,DISP=SHR |  | //* |  | //PSEGDD DD DSN=PSF.AFPAPI.SAPQULIB,DISP=SHR |  | //* |  | |  ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ  Figure 28 (Part 1 of 2). APQIVPLI Job for PL/1 IVP    ACIF and AFP API Installation Verification Procedure 53 ¤   ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | |  | //APQSAMP DD DSN=userid.APQPSAMP.LISTAFP, |  | // DISP=(NEW,CATLG,CATLG), |  | // UNIT=SYSDA, |  | // SPACE=(CYL,(2,1),RLSE), |  | // DCB=(RECFM=VB,LRECL=8205,BLKSIZE=8209) |  | //* |  | //DATAIN DD DSN=PSF.AFPAPI.SAPQSAM1(APQDATA),DISP=SHR |  | //* |  | //SYSPRINT DD DSN=userid.APQPSAMP.SYSPRINT, |  | // DISP=(NEW,CATLG,CATLG), |  | // UNIT=SYSDA, |  | // SPACE=(TRK,(5,5),RLSE), |  | // DCB=(RECFM=FB,LRECL=133,BLKSIZE=13300) |  | //* |  | //SYSERR DD SYSOUT=* |  | //SYSABOUT DD SYSOUT=* |  | //SYSOUT DD SYSOUT=* |  | //SYSUDUMP DD SYSOUT=* |  | //SYSIN DD DUMMY |  | /* |  | // |  | |  ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ  Figure 28 (Part 2 of 2). APQIVPLI Job for PL/1 IVP  An AFPDS file named "userid.APQPSAMP.LISTAFP" is created, where  "userid" is the high level qualifier used in the JCL. If you want to  print this file, the overlay and page segment installed in  "PSF.AFPAPI.SAPQULIB" must be available for printing. The overlay  uses the Sonoran Sans Serif font product (FMID HZD1200) which must be  installed before this file is printed. PSF/MVS Version 2.2.0 can be  used to print this file. An example of the printed LISTAFP file is in  "Using AFP API" section of AFP Application Programming Interface:  Programming Guide and Reference.  If a return code of "0" is received from this job, the IVP is  completed successfully.        ACIF and AFP API Installation Verification Procedure 54 ¤   7.3 AFP API INSTALLATION VERIFICATION PROCEDURE FOR THE CICS/ESA  ENVIRONMENT  If you will be using AFP API functions in a CICS/ESA environment,  complete the steps in this section. Otherwise, skip this section.  The IVP for AFP API in a CICS/ESA environment consists of the  following steps:  ù Perform APQCILNK post installation job  ù Create Font Library Index  ù Create VSAM data sets for fonts and page segments  ù Create entries in the CICS/ESA File Control Table  ù Create entries in the CICS/ESA Processing Program Table  ù Create transaction definitions in the CICS/ESA Program Control  Table  ù Add Resource Definitions to active CICS/ESA system  ù Modify APQPERF Copy Book  ù Compile the sample COBOL programs  ù Run the sample COBOL programs.   7.3.1 PERFORM APQCILNK POST INSTALLATION JOB  After the SMP/E installation is complete, run the job "APQCILNK"  located in "PSF.AFPAPI.SAPQSAM1" in order to install the CICS modules  "DFHEAI" and "DFHEAIO" into the AFP API CICS load modules "APQCIMOD,  APQEFLS, APQEFOP" and "APQEPLS".  NOTE: Change the data set names in lower case to the appropriate  names for your installation.          ACIF and AFP API Installation Verification Procedure 55 ¤   ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | |  | //APQJCLC JOB 'acct no.','name',MSGLEVEL=(1,1) |  | //* |  | //***************************************************************|  | //* |  | //* This post install job link-edits load modules |  | //* created by the LINKAPI job in HQN2112J with CICS |  | //* modules DFHEAI and DFHEAI0. |  | //* |  | //* Re-created are the following modules: |  | //* |  | //* APQCIMOD: THE ABOVE-THE-LINE MAIN MODULE (CICS VERSION) |  | //* APQEFLS: CICS FONT LIBRARY EXIT SAMPLE CODE |  | //* APQEFOP: CICS FORMATTED OUTPUT SAMPLE USER EXIT |  | //* APQEPLS: CICS PSEG LIBRARY SAMPLE EXIT |  | //* |  | //***************************************************************|  | //* |  | //***************************************************************|  | //* |  | //* APQCIMOD: THE ABOVE-THE-LINE MAIN MODULE (CICS VERSION) |  | //* |  | //***************************************************************|  | //* |  | |  ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ  Figure 29 (Part 1 of 4). APQCILNK Post Installation Job           ACIF and AFP API Installation Verification Procedure 56 ¤   ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | |  | //LNKCIMOD EXEC PGM=HEWL,REGION=768K, |  | // PARM='AMODE=31,RMODE=ANY,RENT,XREF,LIST,LET,NCAL' |  | //SYSPRINT DD SYSOUT=* |  | //SYSUT1 DD UNIT=SYSDA,SPACE=(CYL,(5,1)) |  | //* |  | //* REPLACE WITH YOUR CICS LIBRARY |  | //* |  | //CICSDIST DD DISP=OLD,DSN=cics.load.library |  | //APQLOAD DD DISP=OLD,DSN=PSF.AFPAPI.SAPQMOD1 |  | //SYSLMOD DD DISP=OLD,DSN=PSF.AFPAPI.SAPQMOD1 |  | //SYSLIN DD * |  | INCLUDE CICSDIST(DFHEAI) |  | INCLUDE CICSDIST(DFHEAI0) |  | INCLUDE APQLOAD(APQCIMOD) |  | ORDER DFHEAI |  | ORDER DFHEAI0 |  | ORDER DSMAAAAA |  | ORDER DSMESFLP |  | ORDER DSMESPSP |  | ORDER DSMESPUT |  | . |  | . (Additional Order statements removed) |  | . |  | ENTRY EDCXSTRT |  | NAME APQCIMOD(R) |  | /* |  | //***************************************************************|  | //* |  | //* APQEFLS: CICS FONT LIBRARY EXIT SAMPLE CODE |  | //* |  | //***************************************************************|  | //* |  | //LNKEFLS EXEC PGM=HEWL,REGION=768K, |  | // PARM='AMODE=31,RMODE=ANY,RENT,XREF,LIST,LET,NCAL' |  | //SYSPRINT DD SYSOUT=* |  | //SYSUT1 DD UNIT=SYSDA,SPACE=(CYL,(5,1)) |  | //* |  | //* REPLACE WITH YOUR CICS LIBRARY |  | //* |  | //CICSDIST DD DISP=OLD,DSN=cics.load.library |  | //APQLOAD DD DISP=OLD,DSN=PSF.AFPAPI.SAPQMOD1 |  | //SYSLMOD DD DISP=OLD,DSN=PSF.AFPAPI.SAPQMOD1 |  | |  ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ  Figure 29 (Part 2 of 4). APQCILNK Post Installation Job     ACIF and AFP API Installation Verification Procedure 57 ¤   ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | |  | //SYSLIN DD * |  | INCLUDE CICSDIST(DFHEAI) |  | INCLUDE CICSDIST(DFHEAI0) |  | INCLUDE APQLOAD(APQEFLS) |  | ORDER DFHEAI |  | ORDER DFHEAI0 |  | ORDER APQEFLS |  | ENTRY APQEFLS |  | NAME APQEFLS(R) |  | /* |  | //***************************************************************|  | //* |  | //* APQEFOP: CICS FORMATTED OUTPUT SAMPLE USER EXIT |  | //* |  | //***************************************************************|  | //* |  | //LNKEFOP EXEC PGM=HEWL,REGION=768K, |  | // PARM='AMODE=31,RMODE=ANY,RENT,XREF,LIST,LET,NCAL' |  | //SYSPRINT DD SYSOUT=* |  | //SYSUT1 DD UNIT=SYSDA,SPACE=(CYL,(5,1)) |  | //* |  | //* REPLACE WITH YOUR CICS LIBRARY |  | //* |  | //CICSDIST DD DISP=OLD,DSN=cics.load.library |  | //APQLOAD DD DISP=OLD,DSN=PSF.AFPAPI.SAPQMOD1 |  | //SYSLMOD DD DISP=OLD,DSN=PSF.AFPAPI.SAPQMOD1 |  | //SYSLIN DD * |  | INCLUDE CICSDIST(DFHEAI) |  | INCLUDE CICSDIST(DFHEAI0) |  | INCLUDE APQLOAD(APQEFOP) |  | ORDER DFHEAI |  | ORDER DFHEAI0 |  | ORDER APQEFOP |  | ENTRY APQEFOP |  | NAME APQEFOP(R) |  | /* |  | //***************************************************************|  | //* |  | //* APQEPLS: CICS PSEG LIBRARY SAMPLE EXIT |  | //* |  | //***************************************************************|  | //* |  | |  ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ  Figure 29 (Part 3 of 4). APQCILNK Post Installation Job     ACIF and AFP API Installation Verification Procedure 58 ¤   ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | |  | //LNKEPLS EXEC PGM=HEWL,REGION=768K, |  | // PARM='AMODE=31,RMODE=ANY,RENT,XREF,LIST,LET,NCAL' |  | //SYSPRINT DD SYSOUT=* |  | //SYSUT1 DD UNIT=SYSDA,SPACE=(CYL,(5,1)) |  | //* |  | //* REPLACE WITH YOUR CICS LIBRARY |  | //* |  | //CICSDIST DD DISP=OLD,DSN=cics.load.library |  | //APQLOAD DD DISP=OLD,DSN=PSF.AFPAPI.SAPQMOD1 |  | //SYSLMOD DD DISP=OLD,DSN=PSF.AFPAPI.SAPQMOD1 |  | //SYSLIN DD * |  | INCLUDE CICSDIST(DFHEAI) |  | INCLUDE CICSDIST(DFHEAI0) |  | INCLUDE APQLOAD(APQEPLS) |  | ORDER DFHEAI |  | ORDER DFHEAI0 |  | ORDER APQEPLS |  | ENTRY APQEPLS |  | NAME APQEPLS(R) |  | /* |  | |  ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ  Figure 29 (Part 4 of 4). APQCILNK Post Installation Job  A return code of "0" should be received from each step of this job.   7.3.2 CREATE FONT LIBRARY INDEX  If you have not created a font library index for the Times New Roman  240 or 300 pel core interchange fonts, complete the instructions in  7.2.1, "Create Font Library Index" on page 43 before continuing.   7.3.3 CREATE VSAM DATA SETS FOR FONTS AND PAGE SEGMENTS  Fonts and page segments accessed by AFP API in a CICS/ESA environment  must be in key-sequenced VSAM data sets. The IVP jobs for AFP API in  the CICS/ESA environment use the Times New Roman 240 pel or 300 pel  fonts. If your installation uses other fonts for AFP API in the  CICS/ESA environment, they must also be put into key-sequenced VSAM  data sets.   7.3.3.1 VSAM DATA SET FOR FONTS  The job "PSF.AFPAPI.SAPQSAM1(APQCIFON)" creates a VSAM data set and  copies all members from the partitioned data set containing the Times  New Roman 240 pel or 300 pel fonts into it, including the AFPINDEX  created by Font Library Index Program. In the sample APQCIFON job,  the name of the font data set is" SYS1.FONT3820". If your font  library is not called "SYS1.FONT3820", change this name to the name of   ACIF and AFP API Installation Verification Procedure 59 ¤   your font library; for example, "SYS1.FONTLIBB" for 240 pel fonts, and  "SYS1.FONT300" for 300 pel fonts.  NOTE: If you only want to copy a subset of fonts into the VSAM data  set, you must create a PDS that contains only that subset of fonts  before running these jobs.  Change the data set names in lower case to the appropriate names for  your installation.                  ACIF and AFP API Installation Verification Procedure 60 ¤   ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | |  | //DEL1 EXEC PGM=IDCAMS |  | //SYSPRINT DD SYSOUT=* |  | //SYSIN DD * |  | DELETE user.AFP.FONTLIB |  | DELETE user.AFPVSAM.FONTLIB |  | /* |  | //CNVTFONT EXEC PGM=APQCIVSM,REGION=768K,TIME=1440 |  | //STEPLIB DD DSN=user.AFPAPI.LOAD,DISP=SHR |  | //SEQ DD DUMMY |  | //LIB DD DSN=SYS1.FONT3820, |  | // DISP=SHR |  | //VSAM DD DSN=user.AFP.FONTLIB, |  | // DISP=(NEW,CATLG), |  | // UNIT=SYSDA, |  | // SPACE=(CYL,(100,50),RLSE), |  | // DCB=(BLKSIZE=32760,LRECL=32756,RECFM=VB) |  | //SYSOUT DD SYSOUT=* |  | //SYSPRINT DD SYSOUT=* |  | //SYSUDUMP DD SYSOUT=* |  | //DEFINE EXEC PGM=IDCAMS,REGION=512K |  | //SYSPRINT DD SYSOUT=* |  | //SYSIN DD * |  | DEFINE CLUSTER - |  | (NAME( - |  | user.AFPVSAM.FONTLIB - |  | - |  | ) - |  | CYLINDERS(100 50) - |  | RECSZ(80 32760) - |  | KEYS(12 0) - |  | FSPC(10 10) - |  | SHR(2 3)) - |  | INDEX(NAME( - |  | user.AFPVSAM.FONTLIB.INDEX - |  | ) - |  | CISZ(1024)) - |  | DATA(NAME( - |  | user.AFPVSAM.FONTLIB.DATA - |  | ) - |  | CISZ(32768)) |  | /* |  | //REPRO EXEC PGM=IDCAMS,REGION=512K |  | //SYSPRINT DD SYSOUT=* |  | //SEQFON DD DSN=user.AFP.FONTLIB,DISP=OLD |  | //DCFFON DD DSN=user.AFPVSAM.FONTLIB,DISP=OLD |  | |  ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ  Figure 30 (Part 1 of 2). APQCIFON Job    ACIF and AFP API Installation Verification Procedure 61 ¤   ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | |  | //SYSIN DD * |  | REPRO INFILE(SEQFON) - |  | OUTFILE(DCFFON) |  | /* |  | //DEL2 EXEC PGM=IDCAMS |  | //SYSPRINT DD SYSOUT=* |  | //SYSIN DD * |  | DELETE user.AFP.FONTLIB |  | /* |  | |  ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ  Figure 30 (Part 2 of 2). APQCIFON Job  A return code of "0" should be received from this job.   7.3.3.2 VSAM DATA SET FOR PAGE SEGMENTS  The job "PSF.AFPAPI.SAPQSAM1(APQCISEG)" creates a VSAM data set and  copies all members from a page segment PDS into it. The page segment  VSAM data set only needs to be created if your application programs  include page segments.  NOTE: If you only want to copy a subset of page segments into the  VSAM data set, you must create a PDS that contains only that subset of  page segments before running these jobs.  Change the data set names in lower case to the appropriate names for  your installation.          ACIF and AFP API Installation Verification Procedure 62 ¤   ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | |  | //DEL1 EXEC PGM=IDCAMS |  | //SYSPRINT DD SYSOUT=* |  | //SYSIN DD * |  | DELETE user.AFP.PSEG3820 |  | DELETE user.AFPVSAM.PSEG3820 |  | /* |  | //CNVTSEG EXEC PGM=APQCIVSM,REGION=768K,TIME=1440 |  | //STEPLIB DD DSN=user.AFPAPI.LOAD,DISP=SHR |  | //SEQ DD DUMMY |  | //LIB DD DSN=user.PSEG3820, |  | // DISP=SHR |  | //VSAM DD DSN=user.AFP.PSEG3820, |  | // DISP=(NEW,CATLG), |  | // UNIT=SYSDA, |  | // SPACE=(CYL,(100,50),RLSE), |  | // DCB=(BLKSIZE=32760,LRECL=32756,RECFM=VB) |  | //SYSOUT DD SYSOUT=* |  | //SYSPRINT DD SYSOUT=* |  | //SYSUDUMP DD SYSOUT=* |  | //DEFINE EXEC PGM=IDCAMS,REGION=512K |  | //SYSPRINT DD SYSOUT=* |  | //SYSIN DD * |  | DEFINE CLUSTER - |  | (NAME( - |  | user.AFPVSAM.PSEG3820 - |  | - |  | ) - |  | CYLINDERS(100 50) - |  | RECSZ(80 32760) - |  | KEYS(12 0) - |  | FSPC(10 10) - |  | SHR(2 3)) - |  | INDEX(NAME( - |  | user.AFPVSAM.PSEG3820.INDEX - |  | ) - |  | CISZ(1024)) - |  | DATA(NAME( - |  | user.AFPVSAM.PSEG3820.DATA - |  | ) - |  | CISZ(32768)) |  | /* |  | //REPRO EXEC PGM=IDCAMS,REGION=512K |  | //SYSPRINT DD SYSOUT=* |  | //SEQSEG DD DSN=user.AFP.PSEG3820,DISP=OLD |  | //DCFSEG DD DSN=user.AFPVSAM.PSEG3820,DISP=OLD |  | |  ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ  Figure 31 (Part 1 of 2). APQCISEG Job    ACIF and AFP API Installation Verification Procedure 63 ¤   ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | |  | //SYSIN DD * |  | REPRO INFILE(SEQSEG) - |  | OUTFILE(DCFSEG) |  | /* |  | //DEL2 EXEC PGM=IDCAMS |  | //SYSPRINT DD SYSOUT=* |  | //SYSIN DD * |  | DELETE user.AFP.PSEG3820 |  | /* |  | |  ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ  Figure 31 (Part 2 of 2). APQCISEG Job  A return code of "0" should be received from this job.   7.3.4 CREATE ENTRIES IN THE CICS/ESA FILE CONTROL TABLE  Create entries in the CICS/ESA File Control Table (FCT) with the  following file names for the font and page segment VSAM data sets:  FILE NAME DEFINITION  FONTLIB VSAM font data set  SEGLIB VSAM page segment data set (required only if using page  segments)   NOTE: Refer to CICS/ESA Resource Definition Guide for information on  creating entries in the FCT.  See the sample listing of a CICS/ESA system definition (CSD) file in  Figure 33 on page 67 for the attributes of these files. If the font  or page segment data sets are accessed frequently and you require  improved performance, you can add VSAM buffers for these files or add  the files to the VSAM local shared resource pool (LSR).   7.3.5 CREATE PROGRAM ENTRIES IN THE CICS/ESA PROCESSING PROGRAM TABLE  Create program entries in the CICS/ESA Processing Program Table (PPT)  for the following load modules:      ACIF and AFP API Installation Verification Procedure 64 ¤   MODULE DEFINITION  APQCIMOD AFP API main module  APQCISMB Sample COBOL program, using buffered-output  APQCISMP Sample COBOL program, without buffered-output  APQEFLS AFP API program that reads a VSAM font data set  APQEFOP AFP API program that writes an output record  APQEPLS AFP API program that reads a VSAM page segment data set   NOTE: Refer to CICS/ESA Resource Definition Guide for information on  creating program entries in the PPT.  See the sample listing of a CICS/ESA system definition (CSD) file in  Figure 33 on page 67 for the attributes of these programs.   7.3.6 CREATE TRANSACTION DEFINITIONS IN THE CICS/ESA PROGRAM CONTROL  TABLE  Create transaction definitions in the CICS/ESA Program Control Table  (PCT) for the sample AFP API programs:  TRANSACTION DEFINITION  APQB Sample program, using buffered output  APQS Sample program, without buffered output  NOTE: Refer to CICS/ESA Resource Definition Guide for information on  creating transaction entries in the PCT.  See the sample listing of a CICS system definition (CSD) file in  Figure 33 on page 67 for the attributes of these transactions.   7.3.7 ADD RESOURCE DEFINITIONS TO ACTIVE CICS/ESA SYSTEM  If Resource Definition On-line (RDO) is used, issue the following  command to dynamically add the resource definitions in the named group  into the active CICS system:  CEDA Install Group(afpppt)  where "afpppt" is your PPT group name.  After your PPT group name is installed, edit the "afpppt" group name  in the menu with the "afppct" group name to install your PCT group   ACIF and AFP API Installation Verification Procedure 65 ¤   name. Figure 32 on page 66 is an example of the menu that is viewed  when you enter the Install Group command.  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | |  | INSTALL GROUP(afpppt) |  | OVERTYPE TO MODIFY |  | CEDA Install |  | Group ==> afppct |  | |  | |  | |  | |  | INSTALL SUCCESSFUL TIME: HH.MM.SS DATE: YY.DDD |  | |  ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ  Figure 32. RDO Menu to Install Resource Definitions to CICS               ACIF and AFP API Installation Verification Procedure 66 ¤   7.3.8 CICS SYSTEM DEFINITION FILE  Figure 33 is a sample listing of a CICS system definition file (CSD),  showing the files, programs, and transactions required by AFP API.  The files, programs, and transactions are in group AFP API.  Use the file, program, and transaction attributes shown here when  creating the FCT, PPT, and PCT entries. The following example has  been reformatted for viewing in the program directory.  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | |  | GROUP NAME: AFP API |  | |  | FILES: FONTLIB SEGLIB |  | PROGRAMS: APQCISMB APQCISMP APQEFLS APQEFOP APQEPLS APQCIMOD |  | TRANSACTIONS: APQB APQS |  | ****************************************************************|  | |  | OBJECTS IN GROUPS UTILITY COMMAND: LIST GROUP(AFP API) OBJECTS|  | |  | ****************************************************************|  | |  | GROUP NAME: AFP API |  | |  | FILE(FONTLIB) GROUP(AFP API) |  | DESCRIPTION(VSAM FONTLIB) |  | VSAM-PARAMETERS |  | |  | DSNAME(** I wil use name in jcl*) |  | PASSWORD() LSRPOOLID(1) DSNSHARING(ALLREQS) |  | STRINGS(1) NSRGROUP() |  | REMOTE-ATTRIBUTES |  | REMOTESYSTEM() REMOTENAME() RECORDSIZE() |  | KEYLENGTH() |  | INITIAL-STATUS |  | STATUS(ENABLED) OPENTIME(FIRSTREF) DISPOSITION(SHARE) |  | |  ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ  Figure 33 (Part 1 of 4). Sample CICS System Definition (CSD) Listing       ACIF and AFP API Installation Verification Procedure 67 ¤   ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | |  | BUFFERS |  | DATABUFFERS(2) INDEXBUFFERS(1) |  | DATATABLE-PARAMETERS |  | TABLE(NO) MAXNUMRECS() |  | DATA-FORMAT |  | RECORDFORMAT(V) |  | OPERATIONS |  | ADD(NO) BROWSE(YES) DELETE(NO) |  | READ(YES) UPDATE(NO) |  | AUTO-JOURNALLING |  | JOURNAL(NO) JNLREAD(NONE) JNLSYNCREAD(NO) |  | JNLUPDATE(NO) JNLADD(NONE) JNLSYNCWRITE(YES) |  | RECOVERY-PARAMETERS |  | RECOVERY(NONE) FWDRECOVLOG(NO) BACKUPTYPE(STATIC) |  | |  | |  | FILE(SEGLIB) GROUP(AFP API) DESCRIPTION(VSAM SEGLIB)|  | VSAM-PARAMETERS |  | |  | DSNAME(* I will use name in jcl*) |  | PASSWORD() LSRPOOLID(1) DSNSHARING(ALLREQS)|  | STRINGS(1) NSRGROUP() |  | REMOTE-ATTRIBUTES |  | REMOTESYSTEM() REMOTENAME() RECORDSIZE() |  | KEYLENGTH() |  | INITIAL-STATUS |  | STATUS(ENABLED) OPENTIME(FIRSTREF) DISPOSITION(SHARE)|  | BUFFERS |  | DATABUFFERS(2) INDEXBUFFERS(1) |  | DATATABLE-PARAMETERS |  | TABLE(NO) MAXNUMRECS() |  | DATA-FORMAT |  | RECORDFORMAT(V) |  | OPERATIONS |  | ADD(NO) BROWSE(YES) DELETE(NO) |  | READ(YES) UPDATE(NO) |  | JOURNAL(NO) JNLREAD(NONE) JNLSYNCREAD(NO) |  | JNLUPDATE(NO) JNLADD(NONE) JNLSYNCWRITE(YES) |  | RECOVERY-PARAMETERS |  | RECOVERY(NONE) FWDRECOVLOG(NO) BACKUPTYPE(STATIC) |  | |  | |  | PROGRAM(APQCISMB) GROUP(AFP API) |  | DESCRIPTION(BUFFERED AFP API SAMPLE PROG) |  | LANGUAGE(COBOL) RELOAD(NO) RESIDENT(NO) |  | |  ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ  Figure 33 (Part 2 of 4). Sample CICS System Definition (CSD) Listing    ACIF and AFP API Installation Verification Procedure 68 ¤   ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | |  | USAGE(NORMAL) USELPACOPY(NO) STATUS(ENABLED)|  | CEDF(YES) DATALOCATION(ANY) |  | |  | |  | PROGRAM(APQCISMP) GROUP(AFP API) |  | DESCRIPTION(AFP API SAMPLE PROG) |  | LANGUAGE(COBOL) RELOAD(NO) RESIDENT(NO) |  | USAGE(NORMAL) USELPACOPY(NO) STATUS(ENABLED)|  | CEDF(YES) DATALOCATION(ANY) |  | |  | |  | PROGRAM(APQEFLS) GROUP(AFP API) DESCRIPTION(FONT EXIT) |  | LANGUAGE(ASSEMBLER) RELOAD(NO) |  | RESIDENT(NO) USAGE(NORMAL) USELPACOPY(NO) |  | STATUS(ENABLED) CEDF(YES) DATALOCATION(BELOW)|  | |  | |  | PROGRAM(APQEFOP) GROUP(AFP API) DESCRIPTION(RECD EXIT) |  | LANGUAGE(ASSEMBLER) RELOAD(NO) |  | RESIDENT(NO) USAGE(NORMAL) USELPACOPY(NO) |  | STATUS(ENABLED) CEDF(YES) DATALOCATION(BELOW)|  | |  | |  | PROGRAM(APQEPLS) GROUP(AFP API) DESCRIPTION(PSEG EXIT) |  | LANGUAGE(ASSEMBLER) RELOAD(NO) |  | RESIDENT(NO) USAGE(NORMAL) USELPACOPY(NO) |  | STATUS(ENABLED) CEDF(YES) DATALOCATION(BELOW)|  | |  | |  | PROGRAM(APQCIMOD) GROUP(AFP API) |  | DESCRIPTION(AFP API MAIN MODULE) |  | LANGUAGE(ASSEMBLER) RELOAD(NO) RESIDENT(NO) |  | USAGE(NORMAL) USELPACOPY(NO) STATUS(ENABLED) |  | CEDF(YES) DATALOCATION(ANY) |  | |  | |  | TRANSACTION(APQB) GROUP(AFP API) |  | DESCRIPTION(SAMPLE AFP API CICS TRANSACTION) |  | PROGRAM(APQCISMB) TWASIZE(0) PROFILE(DFHCICST)|  | PROFILE(DFHCICST) PARTITIONSET() STATUS(ENABLED) |  | TASKDATALOC(BELOW) |  | REMOTE-ATTRIBUTES |  | DYNAMIC(NO) REMOTESYSTEM() REMOTENAME() |  | TRPROF() LOCALQ() |  | SCHEDULING |  | |  ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ  Figure 33 (Part 3 of 4). Sample CICS System Definition (CSD) Listing    ACIF and AFP API Installation Verification Procedure 69 ¤   ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | |  | PRIORITY(1) TCLASS(NO) |  | ALIASES |  | ALIAS() TASKREQ() XTRANID() |  | TPNAME() XTPNAME() |  | RECOVERY |  | DTIMOUT(NO) INDOUBT(BACKOUT) RESTART(NO) |  | SPURGE(NO) TPURGE(NO) DUMP(YES) |  | TRACE(YES) |  | SECURITY |  | RESSEC(NO) CMDSEC(NO) |  | |  | |  | TRANSACTION(APQS) GROUP(AFP API) |  | DESCRIPTION(SAMPLE AFP API CICS TRANSACTION) |  | PROGRAM(APQCISMP) TWASIZE(0) PROFILE(DFHCICST) |  | REMOTE-ATTRIBUTES |  | DYNAMIC(NO) REMOTESYSTEM() REMOTENAME() |  | TRPROF() LOCALQ() |  | SCHEDULING |  | PRIORITY(1) TCLASS(NO) |  | ALIASES |  | ALIAS() TASKREQ() XTRANID() |  | TPNAME() XTPNAME() |  | RECOVERY |  | DTIMOUT(NO) INDOUBT(BACKOUT) RESTART(NO) |  | SPURGE(NO) TPURGE(NO) DUMP(YES) |  | TRACE(YES) |  | SECURITY |  | RESSEC(NO) CMDSEC(NO) |  | |  ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ  Figure 33 (Part 4 of 4). Sample CICS System Definition (CSD) Listing         ACIF and AFP API Installation Verification Procedure 70 ¤   7.3.9 MODIFY APQPERF COPY BOOK  Modify the file "APQPERF" in data set "PSF.AFPAPI.SAPQSAM1". Follow  the instructions contained in the APQPERF copy book to comment and  uncomment lines so that the sample will run in the CICS environment.  The portion of the APQPERF job as shown in Figure 34 is modified so  that the statements for the CICS API are not commented out. Modify  your APQPERF job to look similar to this example.  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | |  | /---------------------------------------------------------------*|  | *---------------------------------------------------------------*|  | * *|  | * COPY BOOK --- APQPERF *|  | * *|  | * This copy book contains paragraphs which invoke the AFP API *|  | * procedures. Upon return from an AFP API procedure, the *|  | * severity code is examined and if found to contain a SEVERE *|  | * or FATAL code, the name of the AFP API call in error and *|  | * its associated return code and severity code are displayed *|  | * at SYSOUT. In addition, the API is terminated by calling *|  | * AFPTERM which causes any partial page to be printed and the *|  | * COBOL program is also terminated by generating a STOP RUN *|  | * statement. *|  | *---------------------------------------------------------------*|  | |  | /---------------------------------------------------------------*|  | *---------------------------------------------------------------*|  | * *|  | * DETERMINE SUCCESS OR FAILURE OF THE API CALL *|  | * *|  | * IF THE CALL FAILED, DISPLAY THE NAME OF THE CALL IN ERROR, *|  | * THE API RETURN CODE AND SEVERITY CODE ON SYSOUT. ALSO, *|  | * CALL AFPTERM TO TERMINATE THE API SESSION AND PRINT THE *|  | * PARTIAL PAGE (IF ONE EXISTS). MOVE THE FAILING AFP API *|  | |  ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ  Figure 34 (Part 1 of 3). APQPERF Copy Book        ACIF and AFP API Installation Verification Procedure 71 ¤   ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | |  | * SEVERITY CODE TO RETURN-CODE PRIOR TO TERMINATING THE *|  | * PROGRAM WITH STOP RUN SO THAT THE SYSTEM COMPLETION CODE *|  | * REFLECTS THE SEVERITY CODE OF THE FAILING AFP API CALL. *|  | * *|  | *---------------------------------------------------------------*|  | |  | CHKSUCC. |  | IF (AFP-SEVERITY-CODE IS GREATER THAN WARNING) |  | *---------------------------------------------------------------*|  | * THE FOLLOWING LINES *|  | * REPRESENT THE OUTPUT FROM THE EXEC CICS *|  | * TRANSLATOR FOR THE FOLLOWING STATEMENTS: *|  | * *|  | *EXEC CICS WRITEQ TD QUEUE("CSSL") *|  | * FROM(AFP-ERRDATA) END-EXEC. *|  | *EXEC CICS WRITEQ TD QUEUE("CSSL") *|  | * FROM(AFP-MSG4) END-EXEC. *|  | *EXEC CICS WRITEQ TD QUEUE("CSSL") *|  | * FROM(AFP-MSG5) END-EXEC. *|  | *EXEC CICS WRITEQ TD QUEUE("CSSL") *|  | * FROM(AFP-RET-CODE-DISPLAY) END-EXEC. *|  | *EXEC CICS WRITEQ TD QUEUE("CSSL") *|  | * FROM(AFP-MSG6) END-EXEC. *|  | *EXEC CICS WRITEQ TD QUEUE("CSSL") *|  | * FROM(AFP-SEVERITY-CODE-DISPLAY) END-EXEC. *|  | * *|  | * THE FOLLOWING LINES SHOULD BE UNCOMMENTED FOR CICS: *|  | *---------------------------------------------------------------*|  | MOVE AFP-RET-CODE TO AFP-RET-CODE-DISPLAY |  | MOVE AFP-SEVERITY-CODE TO AFP-SEVERITY-CODE-DISPLAY |  | MOVE """\"""; "00008 " TO DFHEIV0 |  | MOVE "CSSL" TO DFHC0040 |  | MOVE LENGTH OF AFP-ERRDATA TO DFHB0020 |  | CALL "DFHEI1" USING DFHEIV0 DFHC0040 AFP-ERRDATA |  | DFHB0020 |  | MOVE """\"""; "00010 " TO DFHEIV0 |  | MOVE "CSSL" TO DFHC0040 |  | MOVE LENGTH OF AFP-MSG4 TO DFHB0020 |  | CALL "DFHEI1" USING DFHEIV0 DFHC0040 AFP-MSG4 DFHB0020 |  | MOVE """\"""; "00012 " TO DFHEIV0 |  | MOVE "CSSL" TO DFHC0040 |  | MOVE LENGTH OF AFP-MSG5 TO DFHB0020 |  | CALL "DFHEI1" USING DFHEIV0 DFHC0040 AFP-MSG5 DFHB0020|  | MOVE """\"""; "00014 " TO DFHEIV0 |  | MOVE "CSSL" TO DFHC0040 |  | |  ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ  Figure 34 (Part 2 of 3). APQPERF Copy Book    ACIF and AFP API Installation Verification Procedure 72 ¤   ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | |  | MOVE LENGTH OF AFP-RET-CODE-DISPLAY TO DFHB0020 |  | CALL "DFHEI1" USING DFHEIV0 DFHC0040 |  | AFP-RET-CODE-DISPLAY DFHB0020 |  | MOVE """\"""; "00016 " TO DFHEIV0 |  | MOVE "CSSL" TO DFHC0040 |  | MOVE LENGTH OF AFP-MSG6 TO DFHB0020 |  | CALL "DFHEI1" USING DFHEIV0 DFHC0040 AFP-MSG6 DFHB0020 |  | MOVE """\"""; "00018 " TO DFHEIV0 |  | MOVE "CSSL" TO DFHC0040 |  | MOVE LENGTH OF AFP-SEVERITY-CODE-DISPLAY TO DFHB0020 |  | CALL "DFHEI1" USING DFHEIV0 DFHC0040 |  | AFP-SEVERITY-CODE-DISPLAY DFHB0020 |  | *---------------------------------------------------------------*|  | * COMMENT OUT THE FOLLOWING LINES IF USING CICS API *|  | *---------------------------------------------------------------*|  | * DISPLAY AFP-ERRDATA "FAILED" UPON SYSOUT |  | * DISPLAY "AFPAPI Return Code: " AFP-RET-CODE UPON SYSOUT |  | * DISPLAY "AFPAPI Severity Code: " AFP-SEVERITY-CODE UPON |  | * SYSOUT |  | *---------------------------------------------------------------*|  | * END OF OPTIONAL CODE FOR CICS API *|  | *---------------------------------------------------------------*|  | MOVE AFP-SEVERITY-CODE TO AFP-TEMP-SEVERITY-CODE |  | IF (AFP-ERRDATA NOT EQUAL TO "AFPEND") AND |  | (AFP-ERRDATA NOT EQUAL TO "AFPTERM") |  | CALL "AFPTERM" |  | USING |  | BY CONTENT |  | AFPAPI-HANDLE |  | BY REFERENCE |  | AFP-RET-CODE |  | AFP-SEVERITY-CODE |  | MOVE AFP-TEMP-SEVERITY-CODE TO RETURN-CODE |  | STOP RUN |  | ELSE CONTINUE |  | END-IF |  | ELSE CONTINUE |  | END-IF. |  | |  ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ  Figure 34 (Part 3 of 3). APQPERF Copy Book   7.3.10 COMPILE THE SAMPLE COBOL PROGRAMS  To ensure that the AFP API CICS/ESA installation is completed  successfully, run the APQCOSMB job and the APQCOSMP job to translate,  compile, and link-edit the sample programs:  ù "PSF.AFPAPI.SAPQSAM1(APQCOSMB)" for program APQCISMB  ù "PSF.AFPAPI.SAPQSAM1(APQCOSMP)" for program APQCISMP   ACIF and AFP API Installation Verification Procedure 73 ¤   APQCISMB is a sample program using buffered output, and APQCISMP is a  sample program without buffered output. The job APQCOSMB is shown in  Figure 35 on page 74.  Modify the COB.SYSLIB statement in APQCOSMB and APQCOSMP to specify  your COBOL library name before submitting the job.  ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | |  | //DOIT EXEC PROC=DFHEITVL,LNKPARM='LIST,XREF,AMODE=31,RMODE=ANY'|  | //TRN.SYSIN DD DSN=PSF.AFPAPI.SAPQSAM1(APQCISMB),DISP=SHR |  | //COB.SYSLIB DD |  | // DD |  | // DD DSN=PSF.AFPAPI.SAPQSAM1,DISP=SHR |  | //LKED.SYSLMOD DD DSN=PSF.AFPAPI.SAPQMOD1,DISP=SHR |  | //LKED.SYSIN DD * |  | INCLUDE APQSTUB(APQBDOC) |  | INCLUDE APQSTUB(APQBFLD) |  | INCLUDE APQSTUB(APQBGRP) |  | INCLUDE APQSTUB(APQBPAG) |  | INCLUDE APQSTUB(APQBPAR) |  | INCLUDE APQSTUB(APQBROW) |  | INCLUDE APQSTUB(APQBTBL) |  | INCLUDE APQSTUB(APQCARE) |  | INCLUDE APQSTUB(APQCEND) |  | INCLUDE APQSTUB(APQCFREE) |  | INCLUDE APQSTUB(APQCGET) |  | INCLUDE APQSTUB(APQCINIT) |  | INCLUDE APQSTUB(APQCLOAD) |  | INCLUDE APQSTUB(APQCTERM) |  | INCLUDE APQSTUB(APQCUNLD) |  | INCLUDE APQSTUB(APQDFLD) |  | INCLUDE APQSTUB(APQDFNT) |  | INCLUDE APQSTUB(APQDROW) |  | INCLUDE APQSTUB(APQEARE) |  | INCLUDE APQSTUB(APQEDOC) |  | INCLUDE APQSTUB(APQEFLD) |  | INCLUDE APQSTUB(APQEGRP) |  | INCLUDE APQSTUB(APQEPAG) |  | INCLUDE APQSTUB(APQEPAR) |  | INCLUDE APQSTUB(APQEROW) |  | INCLUDE APQSTUB(APQETBL) |  | INCLUDE APQSTUB(APQGBUF) |  | INCLUDE APQSTUB(APQINVM) |  | |  ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ  Figure 35 (Part 1 of 2). APQCOSMB Job to Compile the Sample COBOL  Program     ACIF and AFP API Installation Verification Procedure 74 ¤   ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿  | |  | INCLUDE APQSTUB(APQIOBJ) |  | INCLUDE APQSTUB(APQIOVL) |  | INCLUDE APQSTUB(APQIPSG) |  | INCLUDE APQSTUB(APQPARE) |  | INCLUDE APQSTUB(APQPBOX) |  | INCLUDE APQSTUB(APQPCHS) |  | INCLUDE APQSTUB(APQPRUL) |  | INCLUDE APQSTUB(APQPTAG) |  | INCLUDE APQSTUB(APQPTXT) |  | INCLUDE APQSTUB(APQQATT) |  | INCLUDE APQSTUB(APQQPOS) |  | INCLUDE APQSTUB(APQQSTR) |  | INCLUDE APQSTUB(APQSCLR) |  | INCLUDE APQSTUB(APQSFNT) |  | INCLUDE APQSTUB(APQSICS) |  | INCLUDE APQSTUB(APQSLIB) |  | INCLUDE APQSTUB(APQSOUT) |  | INCLUDE APQSTUB(APQSPOS) |  | INCLUDE APQSTUB(APQSRTH) |  | INCLUDE APQSTUB(APQSUNI) |  | INCLUDE APQSTUB(APQSWSP) |  | INCLUDE APQSTUB(APQXARE) |  | INCLUDE APQSTUB(APQXSRVI) |  | INCLUDE APQSTUB(APQXSRVN) |  | ENTRY APQCISMB |  | NAME APQCISMB(R) |  | /* |  | //LKED.APQSTUB DD DSNAME=SYS1.SAPQMOD2,DISP=SHR |  | |  ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ  Figure 35 (Part 2 of 2). APQCOSMB Job to Compile the Sample COBOL  Program  A return code of "0" should be received from this job.  NOTE: There are several modules that are common to both APQTKMOD and  APQCIMOD that are also link edited to your application program.  These modules have different external names, but have the same  CSECT name; hence, when running the link editing jobs for your  own application, use the sample JCL job APQCOSMB or APQCOSMP as  a template for your application job compilation.   7.3.11 RUN THE SAMPLE COBOL PROGRAMS  After the COBOL programs are compiled, enter one of the following  transaction names:  ù "APQB" to invoke the APQCISMB program  ù "APQS" to invoke the APQCISMP program.   ACIF and AFP API Installation Verification Procedure 75 ¤   To ensure that the transaction completed successfully, browse the CICS  job output on the JES spool.  If the program is successful, you will see the following message:  APQSAMP COMPLETED  To view on-line the AFPDS data representing the formatted document,  browse the temporary storage output queue created by the sample  program:  ù If you are running transaction APQB, issue:  CEBR APQSAMPB  ù If you are running transaction APQS, issue:  CEBR APQSAMP   This data may be written to a user-supplied transient data queue using  the "CEBR PUT" command. If this transient data queue is allocated to  an MVS sequential file with the correct attributes for a LISTAFP  dataset, the user may then view or print the formatted document in the  same way as any other LISTAFP dataset and compare it with the sample  document in Advanced Function Presentation Application Programming  Interface: Programming Guide and Reference.            ACIF and AFP API Installation Verification Procedure 76 ¤   APPENDIX A. ACIF AND AFP API INSTALL LOGIC    The entire set of SMP modification control statements for the  installation can be obtained by printing the first file of the ACIF  and AFP API program tape.  This is the System Modification Program install logic for ACIF and AFP  API:   A.1 HQN2110 (ACIF)  ++FUNCTION(HQN2110 ) REWORK(1996114 )  RFDSNPFX(IBM ) FILES(6)  /*********************************************************/  /* */  /* 5695-040 (C) COPYRIGHT IBM CORP. */  /* 1993 */  /* */  /* 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 AN70919 AN71191 AN71324  AN71614 AN71815 AN71931 AN71974 AN72026  AN72249 AN72359 AN73470 AN73683 AN74886  AN74914 AN74930 AN75027 AN75544 AN76385  AN76494 AN77224 AN77537 AN77694 AN77727  AN78463 AN79096 AN79174 AN79284 AN79946  AN79985 AN80074 AN80401 AN80403 AN81336  AN81527 AN81807 AN82198 AN82368 AN83160  AN83206 BN50104 BN67975 CN67975 UN43866  UN47897 UN47898 UN56430 UN56866 UN57483  UN58647 UN58768 UN59731 UN60091 UN60300  UN61596 UN62288 UN62317 UN62584 UN64299  UN65383 UN66555 UN67105 UN67839 UN68866   (C) Copyright IBM Corp. 1993, 1996 77 ¤   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  UN85046 UN85845 UN86422 UN86445 UN86632  UN86704 UN86801 UN87089 UN87167 UN87534  UN87667 UN87886 UN88107 UN88268 UN88710  UN88848 UN88953 UN89414 UN89630 UN89700 ) .  ++JCLIN RELFILE(1) .   A.2 HQN2112 (AFP API)  ++FUNCTION(HQN2112 ) REWORK(1996114 )  RFDSNPFX(IBM ) FILES(5)  /****************************************************/  /* */  /* 5695-040 (C) COPYRIGHT IBM CORP. 1993 */  /* ALL RIGHTS RESERVED */  /* */  /* US GOVERNMENT USERS RESTRICTED RIGHTS */  /* - USE, DUPLICATION OR DISCLOSURE */  /* RESTRICTED BY GSA ADP SCHEDULE */  /* CONTRACT WITH IBM CORP. */  /* */  /* LICENSED MATERIALS-PROPERTY OF IBM */  /* */  /* REFER TO COPYRIGHT INSTRUCTIONS FORM */  /* NUMBER G120-2083 */  /* */  /****************************************************/  .  ++VER(Z038 ) SUP(AN36146 AN45202 AN47219 AN48099 AN49902  AN50511 AN51700 AN52653 AN52669 AN53185  AN53201 AN53401 AN53565 AN54255 AN54342  AN54347 AN54555 AN54560 AN54711 AN55291  AN55404 AN56150 AN56401 AN57387 AN58999  AN60606 AN62852 AN63489 AN64496 AN64756  AN65739 AN65965 AN67836 AN69627 AN70396  AN71167 AN71721 AN72810 AN73433 AN73909  AN74445 AN75041 AN75871 AN76148 AN76280  AN76720 AN77003 AN77175 AN77314 AN77481  AN78003 AN78378 AN78628 AN78749 AN80014  AN80567 AN82150 AN83203 AN83205 UN44746  UN51816 UN55120 UN57386 UN57780 UN58203  UN58567 UN58991 UN58993 UN59841 UN59849  UN59934 UN60195 UN60241 UN60373 UN60412  UN60590 UN60592 UN61309 UN61364 UN62131  UN62223 UN62623 UN63602 UN65032 UN66697  UN69674 UN71137 UN72176 UN72179 UN72856  UN73409 UN75782 UN76614 UN77776 UN77783  UN78246 UN78961 UN79772 UN79913 UN81617   Appendix A. ACIF and AFP API Install Logic 78 ¤   UN81895 UN81978 UN82365 UN82854 UN83377  UN83400 UN83458 UN83681 UN84069 UN84952  UN85167 UN85805 UN86880 UN87226 UN87896  UN89412 UN89576 UN89629 ) .  ++DELETE(APQTKMOD) SYSLIB(ALL ) .  ++DELETE(APQIOMOD) SYSLIB(ALL ) .  ++JCLIN RELFILE(1) .                  Appendix A. ACIF and AFP API Install Logic 79 ¤   APPENDIX B. ACIF AND AFP API JCLIN    The JCLIN for ACIF is contained on the installation tape in file  "IBM.HQN2110.F1" member "HQN2110". The JCLIN for AFP API is contained  on the installation tape in file "IBM.HQN2112.F1" member "HQN2112".  These files are loaded to disk by SMP/E when ACIF and AFP API are  SMP/E RECEIVEd. You may browse or print the JCLIN files using TSO/E,  ISPF, or IEBGENER.                 (C) Copyright IBM Corp. 1993, 1996 80 ¤                      81 ¤   READER'S COMMENTS    PROGRAM DIRECTORY FOR ACIF AND AFP API SERVICE LEVEL SMC9617 FOR  PSF/MVS VERSION 2.2.0  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?   (C) Copyright IBM Corp. 1993, 1996 82 ¤   __ CBIPO  __ CBPDO  __ 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   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:  ____________________________________________________________  ____________________________________________________________  ____________________________________________________________  ____________________________________________________________  ____________________________________________________________  ____________________________________________________________  ____________________________________________________________  ____________________________________________________________  ____________________________________________________________  ____________________________________________________________  ____________________________________________________________  ____________________________________________________________    Reader's Comments 83 ¤   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 ACIF and AFP API Development group):  IBM Printing Systems Company  Attention: Dept. DME/003G  Box 1900  Boulder, CO 80301-9191  USA             Reader's Comments 84 ¤   IBM   Program Number: 5695-040 5801  5802  5337  Printed in U.S.A.