SCRIPT/VS 4.0.0: DEVICE 1403N6 CHARS MONO Program Directory for Print Services Facility for OS/390 Version 3 Release 1, Modification Level 0  Program Number 5655-B17  FMIDs HPRF310, JPRF311  for Use with MVS OS/390 Document Date: January 1999  GI10-0228-00 NOTE! ׯ | | | Before using this information and the product it supports, be sure | | to read the general information under "Notices" on page vi. | | | ר  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 1983,1998. ALL RIGHTS RESERVED. Note to U.S. Government Users Documentation related to restricted rights Use, duplication or disclosure is subject to restrictions set forth in GSA ADP Schedule Contract with IBM Corp. CONTENTS  NOTICES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . VI Trademarks . . . . . . . . . . . . . . . . . . . . . . . . . . vii 1.0 INTRODUCTION . . . . . . . . . . . . . . . . . . . . . . . . 1 1.1 PSF 3.1.0 Description . . . . . . . . . . . . . . . . . . . 2 1.2 PSF 3.1.0 FMIDs . . . . . . . . . . . . . . . . . . . . . . 4 2.0 PROGRAM MATERIALS . . . . . . . . . . . . . . . . . . . . . 5 2.1 Basic Machine-Readable Material . . . . . . . . . . . . . . 5 2.2 Optional Machine-Readable Material . . . . . . . . . . . . . 6 2.3 Program Publications . . . . . . . . . . . . . . . . . . . . 6 2.3.1 Basic Program Publications . . . . . . . . . . . . . . . 7 2.3.2 Optional Program Publications . . . . . . . . . . . . . 8 2.4 Program Source Materials . . . . . . . . . . . . . . . . . . 9 2.5 Publications Useful During Installation . . . . . . . . . . 9 3.0 PROGRAM SUPPORT . . . . . . . . . . . . . . . . . . . . . . 10 3.1 Program Services . . . . . . . . . . . . . . . . . . . . . . 10 3.2 Preventive Service Planning . . . . . . . . . . . . . . . . 10 3.3 Statement of Support Procedures . . . . . . . . . . . . . . 10 4.0 PROGRAM AND SERVICE LEVEL INFORMATION . . . . . . . . . . . 12 4.1 Program Level Information . . . . . . . . . . . . . . . . . 12 4.2 Service Level Information . . . . . . . . . . . . . . . . . 13 4.3 Cumulative Service Tape . . . . . . . . . . . . . . . . . . 13 5.0 INSTALLATION REQUIREMENTS AND CONSIDERATIONS . . . . . . . . 14 5.1 Driving System Requirements . . . . . . . . . . . . . . . . 14 5.1.1 Machine Requirements . . . . . . . . . . . . . . . . . . 14 5.1.2 Programming Requirements . . . . . . . . . . . . . . . . 18 5.2 Target System Requirements . . . . . . . . . . . . . . . . . 18 5.2.1 Machine Requirements . . . . . . . . . . . . . . . . . . 18 5.2.1.1 General Attachment Information and Notes . . . . . . 18 5.2.2 Programming Requisites . . . . . . . . . . . . . . . . . 19 5.2.2.1 Minimum Requisites . . . . . . . . . . . . . . . . . 19 5.2.2.2 Functional Requisites . . . . . . . . . . . . . . . 20 5.2.2.3 Toleration/Coexistence Requisites . . . . . . . . . 22 5.2.2.4 Incompatibility (Negative) Requisites . . . . . . . 22 5.2.3 DASD Storage Requirements . . . . . . . . . . . . . . . 22 5.3 FMIDs Deleted . . . . . . . . . . . . . . . . . . . . . . . 26 5.4 Special Considerations . . . . . . . . . . . . . . . . . . . 27 5.4.1 Installing PSF 3.1.0 into the Link Pack Area . . . . . . 27 5.4.2 Migration Considerations . . . . . . . . . . . . . . . . 27 5.4.2.1 Library Restructure for PSF 3.1.0 . . . . . . . . . 27 5.4.2.2 Resources Provided with PSF 3.1.0 . . . . . . . . . 27 5.4.2.3 Installation Exits Provided with PSF 3.1.0 . . . . . 28 5.4.2.4 Startup Procedures Provided with PSF 3.1.0 . . . . . 28 5.4.2.4.1 BUFNO Parameter in Startup Procedures . . . . . 29  (C) Copyright IBM Corp. 1983,1998 iii 5.4.2.4.2 TRACE Parameter in Startup Procedures . . . . . 29 6.0 INSTALLATION INSTRUCTIONS . . . . . . . . . . . . . . . . . 30 6.1 Installing PSF 3.1.0 . . . . . . . . . . . . . . . . . . . . 30 6.1.1 Deciding Which FMIDs to Install . . . . . . . . . . . . 30 6.1.2 SMP/E Considerations for Installing PSF 3.1.0 . . . . . 30 6.1.3 SMP/E Environment . . . . . . . . . . . . . . . . . . . 30 6.1.4 SMP/E Options Subentry Values . . . . . . . . . . . . . 31 6.1.5 Unload Sample Jobs from Product Tape . . . . . . . . . . 31 6.1.6 Perform SMP/E RECEIVE . . . . . . . . . . . . . . . . . 32 6.1.7 RECEIVE Cumulative Service Tape, if applicable . . . . . 33 6.1.8 Allocate SMP/E Target and Distribution Libraries . . . . 34 6.1.9 Create DDDEF Entries . . . . . . . . . . . . . . . . . . 34 6.1.10 Perform SMP/E APPLY CHECK . . . . . . . . . . . . . . . 35 6.1.11 Perform SMP/E APPLY . . . . . . . . . . . . . . . . . . 35 6.1.12 Perform I/O Configuration . . . . . . . . . . . . . . . 35 6.1.13 Modify the System Environment for PSF 3.1.0 . . . . . . 36 6.1.14 Re-IPL the MVS or OS/390 System . . . . . . . . . . . . 36 6.1.15 Perform SMP/E ACCEPT CHECK . . . . . . . . . . . . . . 36 6.1.16 Perform SMP/E ACCEPT . . . . . . . . . . . . . . . . . 37 6.1.17 Perform Installation Verification Procedure . . . . . . 37 6.1.18 Cleanup After Migration from PSF/MVS 2.2.0 . . . . . . 37 6.2 Installation Verification Procedure . . . . . . . . . . . . 37 6.2.1 Complete the Installation Verification . . . . . . . . . 38 6.2.1.1 IVP Job for JES Environment . . . . . . . . . . . . 38 6.2.1.2 IVP Job for Direct-Attach Environment . . . . . . . 40 APPENDIX A. PSF 3.1.0 INSTALL LOGIC . . . . . . . . . . . . . . 43 A.1 SMP/E Modification Control Statements . . . . . . . . . . . 43 A.1.1 For FMID HPRF310 . . . . . . . . . . . . . . . . . . . . 43 A.1.2 For FMID JPRF311 . . . . . . . . . . . . . . . . . . . . 43 APPENDIX B. READER'S COMMENTS . . . . . . . . . . . . . . . . . 45 FIGURES  1. Basic Material: Program Tape . . . . . . . . . . . . . . . . 5 2. Program Tape: File Content . . . . . . . . . . . . . . . . . 6 3. Basic Material: Unlicensed Publications . . . . . . . . . . 7 4. Basic Material: Unlicensed Publications on CD-ROM . . . . . 7 5. Publications Useful During Installation . . . . . . . . . . 9 6. PSP Upgrade and Subset ID . . . . . . . . . . . . . . . . . 10 7. Component ID . . . . . . . . . . . . . . . . . . . . . . . . 11 8. Driving System Software Requirements . . . . . . . . . . . . 18  Contents iv 9. PSP Upgrade and Subset ID . . . . . . . . . . . . . . . . . 19 10. Minimum Requisites . . . . . . . . . . . . . . . . . . . . . 20 11. Functional Requisites . . . . . . . . . . . . . . . . . . . 20 12. Total DASD Space Required (in 3390 tracks) by PSF 3.1.0 . . 22 13. Storage Requirements for SMP/E Work Data Sets . . . . . . . 23 14. Storage Requirements for SMP/E Data Sets . . . . . . . . . . 24 15. Storage Requirements for PSF 3.1.0 Target Libraries . . . . 25 16. Storage Requirements for PSF 3.1.0 Distribution Libraries 25 17. FMID Deleted . . . . . . . . . . . . . . . . . . . . . . . . 26 18. SMP/E Options Subentry Values . . . . . . . . . . . . . . . 31 19. Unload - Sample Unload tape job . . . . . . . . . . . . . . 32 20. RECEIVE Job for Cumulative Service Tape . . . . . . . . . . 33 21. APSIVP Job . . . . . . . . . . . . . . . . . . . . . . . . . 39 22. APSIVPDA Job . . . . . . . . . . . . . . . . . . . . . . . . 41 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. APAR numbers are provided in this document to assist in locating PTFs that may be required. Ongoing problem reporting may result in additional APARs being created. Therefore, the APAR lists in this document may not be complete. To obtain current service recommendations and to identify current product service requirements, always contact the IBM Customer Support Center. IBM may have patents or pending patent applications covering subject matter in this document. The furnishing of this document does not give you any license to these patents. You can send license inquiries, in writing, to the IBM Director of Licensing IBM Corporation North Castle Drive Armonk, NY 10504-1785 USA For online versions of this book, we authorize you to: Copy, modify, and print the documentation contained on the media, for use within your enterprise, provided you reproduce the copyright notice, all warning statements, and other required statements on each copy or partial copy. Transfer the original unaltered copy of the documentation when you transfer the related IBM product (which may be either machines you own, or programs, if the program's license terms permit a transfer). You must, at the same time, destroy all other copies of the documentation. You are responsible for payment of any taxes, including personal property taxes, resulting from this authorization. THERE ARE NO WARRANTIES, EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. (C) Copyright IBM Corp. 1983,1998 vi Some jurisdictions do not allow the exclusion of implied warranties, so the above exclusion may not apply to you. Your failure to comply with the terms above terminates this authorization. Upon termination, you must destroy your machine readable documentation.  TRADEMARKS The following terms are trademarks of the IBM Corporation in the United States or other countries or both: ACF/VTAM IP PrintWay AFCCU MVS/ESA AFP NetSpool Advanced Function Presentation OS/390 AIX Print Services Facility CBIPO PrintWay CBPDO ProductPac CICS Proprinter DFSMS/MVS SP DFSMS S/390 IBM SystemPac IMS RACF InfoPrint RETAIN IPDS VTAM  Notices vii 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 Print Services Facility for OS/390. This publication refers to Print Services Facility for OS/390 as PSF 3.1.0. 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 5 identifies the basic and optional program materials and documentation for PSF 3.1.0. 3.0, "Program Support" on page 10 describes the IBM support available for PSF 3.1.0. 4.0, "Program and Service Level Information" on page 12 lists the APARs (program level) and PTFs (service level) incorporated into PSF 3.1.0. 5.0, "Installation Requirements and Considerations" on page 14 identifies the resources and considerations for installing and using PSF 3.1.0. 6.0, "Installation Instructions" on page 30 provides detailed installation instructions for PSF 3.1.0. 6.2, "Installation Verification Procedure" on page 37 provides information on the installation verification procedures. Appendix A, "PSF 3.1.0 Install Logic" on page 43 provides the install logic for PSF 3.1.0. Before installing PSF 3.1.0, read 3.2, "Preventive Service Planning" on page 10. 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 PSF 3.1.0 with an MVS Custom-Built Installation Process Offering (CBIPO), SystemPac, or ServerPac. When using these offerings, use the jobs and documentation supplied with the offering. This documentation may point you to specific sections of the program directory as required. If you are installing PSF 3.1.0 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 PSF 3.1.0 are included on the CBPDO tape.  (C) Copyright IBM Corp. 1983,1998 1 1.1 PSF 3.1.0 DESCRIPTION PSF for OS/390 (PSF 3.1.0) is a printer-driver program that combines print data with other resources and printing controls to produce AFP data that can be printed on AFP printers and Computer Output Microfilm. The printers can be channel-attached, SNA-attached, or TCP/IP-attached. Following are some of the major functions PSF 3.1.0 provides: Receives print jobs, accesses resources required by the print jobs, and sends print commands to the printer. Manages resources required for the print job, such as form definitions, page definitions, fonts, page segments and overlays. Provides operator control of printers. Provides problem diagnosis and error recovery. Writes accounting records. Writes separator pages between print jobs or copies of print jobs. Restarts printing from checkpoints. Allows installations to manage resources; modify output records, separator pages, and accounting records; and inspect messages. The following separately orderable features are available with PSF 3.1.0: AFP Conversion and Indexing Facility (ACIF) The AFP Conversion and Indexing Facility (ACIF) processes host application data into the Advanced Function Presentation (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. Download for OS/390 Download for OS/390 automatically transmits data from the JES spool to remote systems using Transmission Control Protocol/Internet Protocol (TCP/IP). This eliminates the need for manual print file transfer using File Transfer Protocol (FTP). A cooperating print server or archive server running on the remote system receives the data sets for printing with InfoPrint Manager for AIX or for archiving using EDMSuite on Demand. Download for OS/390 provides high-speed data transfer, JES scheduling, job management, data integrity, and job accounting for distributed production print management. NetSpool NetSpool converts data received from VTAM applications, such as CICS and IMS, to S/390 line data and places the data on the JES2 or JES3 spool. You can then use JES, PSF 3.1.0, or IP PrintWay to print or distribute this output. NetSpool enables VTAM applications to take advantage of AFP solutions without program  Introduction 2 changes. NetSpool allows multiple VTAM applications to share a single multi-function printer, and also allows a single VTAM application to broadcast output with the same or different output formats to multiple distributed printers. AFP Upload for AIX AFP Upload for AIX allows you to submit a job to PSF for AIX or InfoPrint for AIX, for printing on any printer supported by PSF 3.1.0. AFP Upload for AIX receives the print data from PSF for AIX and places it on the JES spool for printing by PSF 3.1.0. Jobs submitted to PSF for AIX can contain any type of data stream that PSF for AIX can transform to MO:DCA-P. IP PrintWay IP PrintWay is a robust method of automatically routing JES2 or JES3 print data from your MVS or OS/390 system to printers in your TCP/IP network without changing your application program. It is the strategic replacement for the Network Print Facility (NPF) feature of the MVS TCP/IP product, providing improved function, capacity, performance, and usability. IP PrintWay takes any data format on the spool and transmits it to another spool or printer. Depending on the options specified, the data will either be left alone (the binary option) or transformed from EBCDIC to ASCII (alternate translation tables may be specified). IP PrintWay can route data to your printer in either of two ways: For maximum flexibility on JES2 systems, and JES3 systems at OS/390 Version 2 Release 5 or later, you can specify your host system and printer address directly in your JCL. This gives you dynamic addressing capability for any workstation printer, departmental printer, or system printer in your TCP/IP network. You can select printer destinations which have not been previously defined by the system administrator, thus relieving you of dependencies on other functions to route print jobs within the network. For more centralized control, an update to a routing table can provide the network addressing. Compatibility Fonts The fonts optionally supplied with PSF 3.1.0 are the IBM Compatibility fonts. There are 240-pel bounded box, 240-pel unbounded box, and 300-pel printer formats.  Introduction 3 1.2 PSF 3.1.0 FMIDS PSF 3.1.0 consists of the following FMIDs: HPRF310 JPRF311  Introduction 4 2.0 PROGRAM MATERIALS  An IBM program is identified by a program number and a feature number. The program number for PSF 3.1.0 is 5655-B17. Basic Machine-Readable Materials are materials that are supplied under the base license and feature code, and are required for the use of the product. Optional Machine-Readable Materials are orderable under separate feature codes, and are not required for the product to function. The program announcement material describes the features supported by PSF 3.1.0. Ask your IBM representative for this information if you have not already received a copy.  2.1 BASIC MACHINE-READABLE MATERIAL The distribution medium for this program is 9-track magnetic tape (written at 6250 bpi), 3480 cartridge, or 4mm cartridge. The tape or cartridge contains all the programs and data needed for installation. It is installed using SMP/E, and is in SMP/E RELFILE format. See 6.0, "Installation Instructions" on page 30 for more information about how to install the program. Figure 1 describes the tape or cartridge. Figure 2 on page 6 describes the file content of the program tape or cartridge. NOTE: If you are installing PSF 3.1.0 using the MVS Custom-Built Product Delivery Offering (CBPDO) (5751-CS3), some of the information in these figures may not be valid. Consult the CBPDO documentation for actual values. ׯ | Figure 1. Basic Material: Program Tape |  ׯ | | | | FEATURE | PHYSICAL | EXTERNAL LABEL | | | MEDIUM | NUMBER | VOLUME | IDENTIFICATION | VOLSER |  ׯ | | | | | | | 6250 tape | 5801 | 1 | PSF.BASE.V310 | PRF310 |  ׯ | | | | | | | 3480 | 5802 | 1 | PSF.BASE.V310 | PRF310 | | cart. | | | | |  ׯ | | | | | | | 4mm cart. | 5337 | 1 | PSF.BASE.V310 | PRF310 |  ר (C) Copyright IBM Corp. 1983,1998 5 ׯ | Figure 2. Program Tape: File Content |  ׯ | | | | | | DIST | | | BLK | | VOLSER | FILE | NAME | LIBRARY | RECFM | LRECL | SIZE |  ׯ | | | | | | | | | PRF310 | 1 | SMPMCS | -- | FB | 80 | 8800 |  ׯ | | | | | | | | | | 2 | IBM.HPRF310.F1 | JCLIN | FB | 80 | 8800 |  ׯ | | | | | | | | | | 3 | IBM.HPRF310.F2 | ASAMPLIB| FB | 80 | 8800 |  ׯ | | | | | | | |  | | 4 | IBM.HPRF310.F3 | AAPSMOD0, U | 0 | 6144 | |  | | | | ALINKLIB, | | | |  | | | | ANUCLEUS, | | | | | | | | AOSC5 | | | |  ׯ | | | | | | | | | | 5 | IBM.HPRF310.F4 | APROCLIB| FB | 80 | 8800 |  ׯ | | | | | | | | | | 6 | IBM.HPRF310.F5 | AMACLIB | FB | 80 | 8800 |  ׯ | | | | | | | | | | 7 | IBM.HPRF310.F6 | AAPSDAT0| VBM | 8205 | 8209 |  ׯ | | | | | | | | | | 8 | IBM.HPRF310.F7 | AFDEFLIB| VBM | 8205 | 8209 |  ׯ | | | | | | | | | | 9 | IBM.HPRF310.F8 | APDEFLIB| VBM | 8205 | 8209 |  ׯ | | | | | | | | | | 10 | IBM.HPRF310.F9 | AOVERLIB| VBM | 8205 | 8209 |  ׯ | | | | | | | | | | 11 | IBM.HPRF310.F10 | APSEGLIB| VBM | 8205 | 8209 |  ׯ | | | | | | | | | | 12 | IBM.JPRF311.F1 | ASAMPLIB| FB | 80 | 8800 |  ׯ | | | | | | | | | | 13 | IBM.JPRF311.F2 | AAPSMOD0| U | 0 | 6144 |  ׯ | | | | | | | | | | 14 | IBM.JPRF311.F3 | AAPSPDFD| FB | 80 | 8800 |  ר  2.2 OPTIONAL MACHINE-READABLE MATERIAL No optional machine-readable materials are provided for PSF 3.1.0.  2.3 PROGRAM PUBLICATIONS The following sections identify the basic and optional publications for PSF 3.1.0.  Program Materials 6 2.3.1 BASIC PROGRAM PUBLICATIONS Figure 3 on page 7 identifies the basic program publications for PSF 3.1.0. One copy of each of these publications is included when you order the basic materials for PSF 3.1.0. For additional copies, contact your IBM representative. ׯ | Figure 3. Basic Material: Unlicensed Publications |  ׯ | | | PUBLICATION TITLE | FORM NUMBER |  ׯ | | | | Print Services Facility for OS/390: Introduction | G544-5625 |  ׯ | | | | Print Services Facility for OS/390: User's Guide | S544-5630 |  ׯ | | | | Print Services Facility for OS/390: Customization | S544-5622 |  ׯ | | | | Print Services Facility for OS/390: Messages and | G544-5627 | | Codes | |  ׯ | | | | Print Services Facility for OS/390: Diagnosis | G544-5623 |  ׯ | | | | Print Services Facility for OS/390: Licensed | G544-5626 | | Programming Specifications | |  ר Figure 4 identifies the basic program publications for PSF 3.1.0 on CD-ROM SK2T-9267 when you order the basic materials for PSF 3.1.0. For additional copies, contact your IBM representative. ׯ | Figure 4 (Page 1 of 2). Basic Material: Unlicensed Publications on | | CD-ROM |  ׯ | | | PUBLICATION TITLE | FORM NUMBER |  ׯ | | | | Print Services Facility for OS/390: Introduction | G544-5625 |  ׯ | | | | Print Services Facility for OS/390: User's Guide | S544-5630 |  ׯ | | | | Print Services Facility for OS/390: Customization | S544-5622 |  ׯ | | | | Print Services Facility for OS/390: Messages and | G544-5627 | | Codes | |  ׯ | | | | Print Services Facility for OS/390: Diagnosis | G544-5623 |  ׯ | | | | Print Services Facility for OS/390: Licensed | G544-5626 | | Programming Specifications | |  ׯ | | | | Print Services Facility for OS/390: Download for | S544-5624 | | OS/390 | |  ר  Program Materials 7 ׯ | Figure 4 (Page 2 of 2). Basic Material: Unlicensed Publications on | | CD-ROM |  ׯ | | | PUBLICATION TITLE | FORM NUMBER |  ׯ | | | | IBM NetSpool Guide | G544-5301 |  ׯ | | | | IBM IP PrintWay Guide | S544-5379 |  ׯ | | | | PSF for AIX: Upload Configuration Guide Using SNA | S544-5422 |  ׯ | | | | PSF for AIX: Upload Configuration Guide Using | S544-5423 | | TCP/IP . | |  ׯ | | | | IBM AFP Fonts: Font Summary for AFP Font Collection | S544-5633 |  ׯ | | | | IBM AFP Fonts: Font Summary | G544-3810 |  ׯ | | | | ACIF User's Guide | S544-5285 |  ׯ | | | | AFP Printer Summary | G544-3135 |  ׯ | | | | AFP Printer Information | G544-3290 |  ׯ | | | | IBM Dictionary of Printing | G544-3973 |  ׯ | | | | AFP: Programming Guide and Line Data Reference | S544-3884 |  ׯ | | | | PPFA User's Guide | S544-5284 |  ׯ | | | | AFP Toolbox for Multiple Operating Systems User's | S544-5292 | | Guide | |  ׯ | | | | MO:DCA Reference | SC31-6802 |  ׯ | | | | PTOCA Reference | SC31-6803 |  ׯ | | | | IOCA Reference | SC31-6805 |  ׯ | | | | BCOCA Reference | S544-3766 |  ׯ | | | | GOCA Reference | S544-5498 |  ר  2.3.2 OPTIONAL PROGRAM PUBLICATIONS No optional publications are provided for PSF 3.1.0. Program Materials 8 2.4 PROGRAM SOURCE MATERIALS No program source materials or viewable program listings are provided for PSF 3.1.0.  2.5 PUBLICATIONS USEFUL DURING INSTALLATION The publications listed in Figure 5 may be useful during the installation of PSF 3.1.0. To order copies, contact your IBM representative. ׯ | Figure 5. Publications Useful During Installation |  ׯ | | | PUBLICATION TITLE | FORM NUMBER |  ׯ | | | | OS/390 SMP/E Commands | SC28-1805 |  ׯ | | | | OS/390 SMP/E Reference | SC28-1806 |  ׯ | | | | OS/390 SMP/E User's Guide | SC28-1740 |  ׯ | | | | OS/390 SMP/E Messages and Codes | SC28-1738 |  ׯ | | | | SMP/E Reference | SC28-1107 |  ׯ | | | | SMP/E User's Guide | SC28-1302 |  ׯ | | | | SMP/E Messages and Codes | SC28-1108 |  ׯ | | | | OS/390 MVS JCL Reference | GC28-1757 |  ׯ | | | | MVS/ESA V5 JCL Reference | GC28-1479 |  ׯ | | | | Advanced Function Presentation: Printer Information | G544-3290 |  ׯ | | | | Attachment Configuration Handbook | S544-3977 |  ר  Program Materials 9 3.0 PROGRAM SUPPORT  This section describes the IBM support available for PSF 3.1.0.  3.1 PROGRAM SERVICES Contact your IBM representative for specific information about available program services.  3.2 PREVENTIVE SERVICE PLANNING Before installing PSF 3.1.0, you should review the current Preventive Service Planning (PSP) information. If you obtained PSF 3.1.0 as part of a CBPDO, there is HOLDDATA and PSP information included on the CBPDO tape. If you obtained PSF 3.1.0 on a product tape, or if the CBPDO is more than two weeks old when you install it, you should contact the IBM Support Center or use S/390 SoftwareXcel to obtain the current "PSP Bucket". PSP Buckets are identified by UPGRADEs, which specify product levels, and SUBSETs, which specify the FMIDs for a product level. The UPGRADE and SUBSET values for PSF 3.1.0 are: ׯ | Figure 6. PSP Upgrade and Subset ID |  ׯ | | | UPGRADE | SUBSET | DESCRIPTION |  ׯ | | | | | PSFMVS310 | HPRF310 | PSF for Softcopy Print |  ׯ | | | | | PSFMVS310 | JPRF311 | PSF for OS/390 |  ר  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 7 identifies the component ID (COMPID) for PSF 3.1.0. (C) Copyright IBM Corp. 1983,1998 10 ׯ | Figure 7. Component ID |  ׯ | | | | | | RETAIN | | FMID | COMPID | COMPONENT NAME | RELEASE |  ׯ | | | | | | HPRF310 | 5655B1701 | PSF for Softcopy Print | 310 |  ׯ | | | | | | JPRF311 | 5655B1701 | PSF for OS/390 | 311 |  ר Program Support 11 4.0 PROGRAM AND SERVICE LEVEL INFORMATION  This section identifies the program and any relevant service levels of PSF 3.1.0. 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.  4.1 PROGRAM LEVEL INFORMATION The following APAR fixes against PSF/MVS 2.2.0 have been incorporated into this release. OW01421 OW08612 OW11255 OW14115 OW17446 OW03243 OW08623 OW11287 OW14128 OW17456 OW03536 OW08819 OW11773 OW14303 OW17525 OW04104 OW08936 OW11808 OW14307 OW17541 OW04452 OW08944 OW12021 OW14437 OW17550 OW05273 OW08946 OW12023 OW14522 OW17564 OW05579 OW08956 OW12034 OW14552 OW17576 OW06310 OW08975 OW12081 OW14565 OW17625 OW06321 OW08979 OW12092 OW14708 OW17669 OW06408 OW08999 OW12168 OW14975 OW17750 OW06631 OW09046 OW12274 OW15013 OW17839 OW06775 OW09054 OW12326 OW15018 OW18088 OW06799 OW09221 OW12698 OW15088 OW18225 OW06943 OW09290 OW12700 OW15113 OW18369 OW06977 OW09445 OW12710 OW15171 OW18534 OW06979 OW09512 OW12811 OW15188 OW18550 OW07305 OW09625 OW12840 OW15599 OW18551 OW07348 OW09626 OW12896 OW15940 OW18606 OW07359 OW09728 OW12903 OW16007 OW18619 OW07400 OW09854 OW12904 OW16075 OW18773 OW07430 OW09987 OW13045 OW16122 OW18774 OW07446 OW10066 OW13145 OW16209 OW19064 OW07459 OW10067 OW13161 OW16398 OW19103 OW07536 OW10068 OW13171 OW16407 OW19139 OW07612 OW10071 OW13197 OW16432 OW19142 OW07738 OW10101 OW13242 OW16540 OW19236 OW07806 OW10239 OW13387 OW16562 OW19259 OW07995 OW10530 OW13531 OW16589 OW19288 OW08022 OW10532 OW13627 OW16647 OW19344 OW08159 OW10550 OW13631 OW16789 OW19614 OW08336 OW10748 OW13702 OW16843 OW19657 OW08338 OW10787 OW13836 OW16864 OW19712 OW08340 OW10887 OW13936 OW16914 OW19765 OW08438 OW10891 OW13965 OW16932 OW19814 OW08451 OW10903 OW14055 OW17026 OW19834 OW08453 OW10928 OW14056 OW17258 OW19864 OW08593 OW11235 OW14103 OW17445 OW19912  (C) Copyright IBM Corp. 1983,1998 12 OW19962 OW22257 OW25538 OW28020 OW31358 OW20061 OW22373 OW25560 OW28050 OW31424 OW20079 OW22517 OW25734 OW28104 OW31502 OW20090 OW22539 OW25735 OW28145 OW31616 OW20115 OW22828 OW25839 OW28160 OW31717 OW20126 OW22894 OW26002 OW28351 OW31767 OW20200 OW22965 OW26144 OW28787 OW31939 OW20299 OW23130 OW26246 OW28894 OW32090 OW20392 OW23347 OW26403 OW29135 OW32244 OW20430 OW23426 OW26508 OW29140 OW32505 OW20538 OW23493 OW26510 OW29241 OW32665 OW20569 OW23580 OW26734 OW29314 OW32931 OW20675 OW23602 OW26735 OW29526 OW33047 OW20842 OW23708 OW26837 OW29615 OW33049 OW20867 OW23777 OW26864 OW29646 OW33245 OW20892 OW23852 OW27061 OW29924 OW33515 OW20909 OW23937 OW27173 OW29990 OW33751 OW21006 OW24057 OW27174 OW29991 OW33942 OW21012 OW24319 OW27176 OW29992 OW34106 OW21024 OW24329 OW27204 OW29993 OW34193 OW21138 OW24360 OW27247 OW30000 OW34334 OW21161 OW24371 OW27354 OW30034 OW34409 OW21299 OW24516 OW27442 OW30181 OW34459 OW21409 OW24771 OW27585 OW30211 OW34506 OW21475 OW24777 OW27610 OW30255 OW34674 OW21530 OW24868 OW27622 OW30796 OW34806 OW21837 OW24922 OW27623 OW30797 OW34938 OW21861 OW25116 OW27658 OW30962 OW35139 OW21983 OW25178 OW27855 OW30978 OW35323 OW22055 OW25442 OW27898 OW31334 OW35384 OW22087 OW25449 4.2 SERVICE LEVEL INFORMATION No PTFs against this release of PSF 3.1.0 have been incorporated into the product tape.  4.3 CUMULATIVE SERVICE TAPE A cumulative service tape, containing PTFs not incorporated into this release, might be included with this program. Installation instructions for cumulative service tapes can be found in the SMP/E publications. If you received this product as part of a CBPDO or a ProductPac, PTFs not incorporated into this release are provided on the tape, and a separate cumulative service tape will not be provided.  Program and Service Level Information 13 5.0 INSTALLATION REQUIREMENTS AND CONSIDERATIONS  The following sections identify the system requirements for installing and activating PSF 3.1.0. The following terminology is used: Driving system: the system used to install the program. Target system: the system on which the program is installed. In many cases, the same system can be used as both a driving system and a target system. However, you may want to set up a clone of your system to use as a target system by making a separate IPL-able copy of the running system. The clone should include copies of all system libraries that SMP/E updates, copies of the SMP/E CSI data sets that describe the system libraries, and your PARMLIB and PROCLIB. Some cases where two systems should be used include the following: When installing a new level of a product that is already installed, the new product will delete the old one. By installing onto a separate target system, you can test the new product while still keeping the old one in production. When installing a product that shares libraries or load modules with other products, the installation can disrupt the other products. Installing onto a test system or clone will allow you to assess these impacts without disrupting your production system.  5.1 DRIVING SYSTEM REQUIREMENTS This section describes the environment of the driving system required to install PSF 3.1.0.  5.1.1 MACHINE REQUIREMENTS The driving system can run in any hardware environment that supports the required software as described in 5.2, "Target System Requirements" on page 18. Not all printers support all functions provided by PSF 3.1.0. Check Advanced Function Presentation: Printer Information or your printer documentation for information concerning supported functions. Some printers require special levels of microcode to support certain functions. Contact your IBM Hardware Customer Engineer to determine if your printer requires a microcode update. (C) Copyright IBM Corp. 1983,1998 14 The following minimum level of microcode requirements apply for the indicated hardware: IBM 3130 Models 01S, 02S, 02D, and 03S No special microcode required IBM 3160 No special microcode required IBM 3300 (InfoPrint 3000) No special microcode required IBM 3800 IBM 3800 Models 3 & 8 without SEF (Storage Expansion Feature) require engineering change (EC) 847612 with patches P401 through P420. IBM 3800 Models 3 and 8 with SEF require (EC) C05192 and patches P501 through P525. IBM 3800 Model 6 without SEF requires (EC) 847661 and patches P701 through P706. IBM 3800 Model 6 with SEF requires (EC) C05193 and patches P801 through P803. IBM 3812 IBM 3812 Model 2 requires 3270 IDS microcode Version 2.4.0 (or above). IBM 3816 Models 01S, and 01D requires 3270 IDS microcode Version 3.11 (or above). IBM 3820 IBM 3820 requires microcode Patch P50B05 P/N 1693492 to print with the Core Interchange and Proprinter Emulation fonts. IBM 3825 To support basic N_UP printing, install microcode Version 6.B (or above). IBM 3827 Requires microcode Version 10.0 (or above) To support basic N_UP printing, install microcode Version 12.Q (or above). IBM 3828 Installation Requirements and Considerations 15 To support basic N_UP printing, install microcode Version 4.E (or above). IBM 3829 To support basic N_UP printing, install microcode Version 1.C (or above). IBM 3831 No special microcode required IBM 3835 Model 001 - To support basic N_UP printing, install microcode Version 23 (or above). Model 002 - To support basic N_UP printing, install microcode Version 12.1 (or above). IBM 3900 (CCU) Model 001 - To support basic N_UP printing, install microcode Version 6.E.7 (or above). IBM 3900 (AFCCU) All AFCCU models - To use the Enhanced N_UP capability, install microcode Version 6.121 (or above). IBM 3912 Model NS1 - No special microcode required IBM 3916 Model NS1 - No special microcode required IBM 3930 Models 02S and 02D - No special microcode required IBM 3935 Model 001 - To use the Enhanced N_UP capability, install microcode Version 3.0.2 (or above). IBM 4000 (InfoPrint 4000) No special microcode required IBM 4019  Installation Requirements and Considerations 16 Models E01 and 001 are supported by PSF 3.1.0 only through the Distributed Print Function (DPF) provided with the PSF/2 licensed program. IBM 4028 Model NS1 - No special microcode required IBM 4029 all models are supported by PSF 3.1.0 only through the Distributed Print Function (DPF) provided with the PSF/2 licensed program. IBM 4039 Models 10D, 10R, 12L and 12R are supported by PSF 3.1.0 only through the Distributed Print Function (DPF) provided with the PSF/2 licensed program. IBM 4224 Models 201, 202, 2C2, 2E2, 2E3 with serial number AA001 or higher. IBM 4230 Models 202, 2T1 are supported in 4224 emulation mode only. Model 5I3 is supported in 4230 mode. IBM 4234 Models 07 and 011 with serial number AA030 or above. IBM Network Printers (4312 4317 4320 4324) No special microcode required IBM 4370 (InfoPrint 62) No special microcode required IBM 6400 Model 004 - Supported in 4234 emulation mode only. IBM 6408 Model CTA - Supported in 4234 emulation mode only. IBM 6412 Model CTA - Supported in 4234 emulation mode only. Installation Requirements and Considerations 17 5.1.2 PROGRAMMING REQUIREMENTS  ׯ | Figure 8. Driving System Software Requirements |  ׯ | | | PROGRAM | PRODUCT NAME AND | | NUMBER | MINIMUM VRM/SERVICE LEVEL |  ׯ | | | Any ONE of the following: |  ׯ | | | | 5668-949 | System Modification Program/Extended (SMP/E) | | | | 1.8.1 with PTF UR49485 or higher |  ׯ | | | | | | 5645-001 | SMP/E element of OS/390 Version 1 Release 2 with | | | | PTF UR48837 | | | | SMP/E element of OS/390 Version 1 Release 3 with | | | | PTF UR48840 |  ׯ | | | | | | 5647-A01 | SMP/E element of OS/390 Version 2 Release 4 with | | | | with PTF UR48840 | | | | SMP/E element of OS/390 Version 2 Release 5 or | | | | higher |  ר  5.2 TARGET SYSTEM REQUIREMENTS This section describes the environment of the target system required to install and use PSF 3.1.0.  5.2.1 MACHINE REQUIREMENTS The target system can run in any hardware environment that supports the required software.  5.2.1.1 GENERAL ATTACHMENT INFORMATION AND NOTES Refer to Advanced Function Presentation: Printer Information or your printer documentation for detailed information regarding each printer type. Refer to Print Services Facility for OS/390: Customization for information on attaching any of the printers supported by PSF 3.1.0. Refer to IBM 3130, 3160, and 3935 Advanced Function Printers: Attachment Configuration Handbook for 3130, 3160, and 3935 attachment information. For PSF 3.1.0 VTAM SNA attached printers, see the specific Printer Announcement Letter for appropriate 3174 and 3274 attachment information and for levels of microcode required for the controller.  Installation Requirements and Considerations 18 Preventive Service Planning (PSP) information is available for each of the following device types. To obtain this information, check with your IBM Support Center or use SoftwareXcel Extended. Specify the following UPGRADE and SUBSET values: ׯ | Figure 9. PSP Upgrade and Subset | | ID |  ׯ | | | UPGRADE | SUBSET |  ׯ | | | | PSFPRINTERS | 3130 | | | 3160 | | | 3827 | | | 3828 | | | 3829 | | | 3835 | | | 3916 | | | 3930 | | | 3935 | | | 6408/6412 | | | 3900STD | | | 3900DUPLEX | | | 3900WIDE | | | 3900DUP/WID | | | 4000 | | | IP62/4370 | | | NETWORKPRTS | | | 3000 |  ר  5.2.2 PROGRAMMING REQUISITES  5.2.2.1 MINIMUM REQUISITES A minimum requisite is defined as one of the following: 1. Installation Requisite: A product that is required at installation time. i.e. this product WILL NOT INSTALL successfully unless this requisite is met. This includes products that are specified as REQs, PREs, or CALLLIBs. 2. Run Time Requisite: A product that is NOT required for the successful installation of this product, but IS needed at run time in order for this product to work. Installation Requirements and Considerations 19 ׯ | Figure 10. Minimum Requisites |  ׯ | | | | PRODUCT NAME AND | INSTALL | | PROGRAM NUMBER | MINIMUM VRM/SERVICE LEVEL | REQ? |  ׯ | | | Any ONE of the following: |  ׯ | | | | 5655-068 | MVS/ESA SP JES2 Version 5 Release 2.2 | No | | | | or higher | |  ׯ | | | | | | | 5655-069 | MVS/ESA SP JES3 Version 5 Release 2.2 | No | | | | or higher | |  ׯ | | | | | | | 5645-001 | OS/390 Version 1 or higher with | No | | | | supported levels of JES2 or JES3 | |  ׯ | | | | | | | 5647-A01 | OS/390 Version 2 or higher with | No | | | | supported levels of JES2 or JES3 | |  ׯ | | | Any ONE of the following: |  ׯ | | | | 5895-DF1 | DFSMS/MVS Version 1.2 | No |  ׯ | | | | | | | 5645-001 | DFSMS Element Of OS/390 Version 1 | No |  ׯ | | | | | | | 5647-A01 | DFSMS Element Of OS/390 Version 2 | No |  ר 5.2.2.2 FUNCTIONAL REQUISITES A functional requisite is defined as a product that is not required for the successful installation of this product or for the base function of the product, but is needed at run time for a specific function of this product to work. This includes products that are specified as IF REQs. ׯ | Figure 11 (Page 1 of 3). Functional Requisites |  ׯ | | | | PRODUCT NAME AND | | | | PROGRAM | MINIMUM VRM/SERVICE | | INSTALL | | NUMBER | LEVEL | FUNCTION | REQ? |  ׯ | | | | | | 5695-117 | ACF/VTAM Version 4.3 | Print on | No | | | or higher | SNA-attached | | | | | printers | |  ר Installation Requirements and Considerations 20 ׯ | Figure 11 (Page 2 of 3). Functional Requisites |  ׯ | | | | PRODUCT NAME AND | | | | PROGRAM | MINIMUM VRM/SERVICE | | INSTALL | | NUMBER | LEVEL | FUNCTION | REQ? |  ׯ | | | | | | 5695-039 | RACF Version 2 | Optional RACF | No | | | Release 2 or higher | protection for user | | | | | libraries, and print | | | | | security labelling | |  ׯ | | | Any ONE of the following: |  ׯ | | | | 5655-HAL | TCP/IP Version 3.2 | For TCP/IP | No | | | | with APARs | attached printers | | | | | PQ07866, PQ13154, | | | | | | and PQ17052 or | | | | | | higher | | |  ׯ | | | | | | | | 5647-A01 | e-Network | For TCP/IP | No | | | | Communication | attached printers | | | | | Server element of | | | | | | OS/390 Version 2 | | | | | | Release 5 or | | | | | | higher | | | | | | | | | | | | For OS/390 | | | | | | Version 2 | | | | | | Release 5, | | | | | | APARs PQ13154 | | | | | | and PQ17052 | | | | | | are required. | | | | | | For OS/390 | | | | | | Version 2 | | | | | | Release 6, | | | | | | APAR PQ17052 | | | | | | is required | | |  ׯ | | | Any ONE of the following: |  ׯ | | | | 5648-B33 | IBM Font | Recommended fonts | No | | | | Collection Version | for use with PSF | | | | | 2 | 3.1.0, contains | | | | | | euro support | |  ׯ | | | | | | | | 5648-113 | IBM Font | IBM fonts, does | No | | | | Collection Version | not contain euro | | | | | 1 | support | |  ׯ | | | | | | | | 5645-001 | OS/390 Version 1 | IBM Core fonts | No | | | | Release 2 fonts or | used for Printing | | | | | higher | | |  ר  Installation Requirements and Considerations 21 ׯ | Figure 11 (Page 3 of 3). Functional Requisites |  ׯ | | | | PRODUCT NAME AND | | | | PROGRAM | MINIMUM VRM/SERVICE | | INSTALL | | NUMBER | LEVEL | FUNCTION | REQ? |  ׯ | | | | | 5647-A01 | OS/390 Version 2 | IBM Core fonts | No | | | | fonts or higher | used for Printing | |  ר  5.2.2.3 TOLERATION/COEXISTENCE REQUISITES A toleration/coexistence requisite is defined as a product which must be present on a sharing system. These systems can be other systems in a multisystem environment (not necessarily sysplex), a shared DASD environment (such as test and production), or systems that reuse the same DASD at different time intervals. There are no toleration/coexistence requisites for PSF 3.1.0.  5.2.2.4 INCOMPATIBILITY (NEGATIVE) REQUISITES A negative requisite identifies products which must not be installed on the same system as this product. There are no negative requisites for PSF 3.1.0.  5.2.3 DASD STORAGE REQUIREMENTS PSF 3.1.0 libraries can reside on any IBM MVS supported DASD. Figure 12 lists the total space required for each type of library. ׯ | Figure 12. Total DASD Space Required (in 3390 tracks) by PSF 3.1.0 |  ׯ | | | LIBRARY TYPE | TOTAL SPACE REQUIRED |  ׯ | | | | Target | 169 Tracks |  ׯ | | | | Distribution | 212 Tracks |  ר NOTES: 1. The data set sizes specified contain 15% extra space. You may wish to revise these numbers based on your plans for adding additional function or service. Installation Requirements and Considerations 22 2. IBM recommends use of system determined blocksizes for efficient DASD utilization for all non-RECFM U data sets. For RECFM U data sets, IBM recommends a blocksize of 32760, which is the most efficient from a performance and DASD utilization perspective. If you choose not to use system determined blocksizes, use the blocksizes and numbers of blocks specified to allocate the data sets. Data sets can be reblocked to a larger size. Please note that the maximum allowable blocksize will depend on the type of DASD on which the dataset will reside; for example, the blocksize of datasets on a 3350 DASD cannot exceed 19,069. 3. Abbreviations used for the data set type are: U Unique data set used by only the FMIDs listed. In order to determine the correct storage needed for this data set, this table provides all required information; no other tables (or program directories) need to be referenced for the data set size. S Shared data set used by more than the FMIDs listed. In order to determine the correct storage needed for this data set, the storage size given in this table needs to be added to other tables (perhaps in other program directories). If the data set already exists, it must have enough free space to accommodate the storage size given in this table. If you currently have a previous release of this product installed in these libraries, the installation of this release will delete the old one and reclaim the space used by the old release and any service that had been installed. You can determine whether or not these libraries have enough space by deleting the old release with a dummy function, compressing the libraries, and comparing the space requirements with the free space in the libraries. For more information on the names and sizes of the required data sets, please refer to 6.1.8, "Allocate SMP/E Target and Distribution Libraries" on page 34. ׯ | Figure 13 (Page 1 of 2). Storage Requirements for SMP/E Work Data | | Sets |  ׯ | | | | | D | R | L | | | NO. | | | | | T | S | E | R | | | OF | NO. | NO. | | | Y | O | C | E | NO. | | 3380/| OF | OF | | LIBRARY | P | R | F | C | OF | BLK | 9345 | 3390 | DIR | | DDNAME | E | G | M | L | BLKS | SIZE | TRKS | TRKS | BLKS |  ׯ | | | | | | | | | | | | SMPWRK1 | S | PO | FB | 80 | -- | -- | -- | 75 | 50 |  ׯ | | | | | | | | | | | | SMPWRK2 | S | PO | FB | 80 | -- | -- | -- | 75 | 50 |  ׯ | | | | | | | | | | | | SMPWRK3 | S | PO | FB | 80 | -- | -- | -- | 75 | 50 |  ר  Installation Requirements and Considerations 23 ׯ | Figure 13 (Page 2 of 2). Storage Requirements for SMP/E Work Data | | Sets |  ׯ | | | | | D | R | L | | | NO. | | | | | T | S | E | R | | | OF | NO. | NO. | | | Y | O | C | E | NO. | | 3380/| OF | OF | | LIBRARY | P | R | F | C | OF | BLK | 9345 | 3390 | DIR | | DDNAME | E | G | M | L | BLKS | SIZE | TRKS | TRKS | BLKS |  ׯ | | | | | | | | | | | | SMPWRK4 | S | PO | FB | 80 | -- | -- | -- | 75 | 50 |  ׯ | | | | | | | | | | | | SMPWRK6 | S | PO | FB | 80 | -- | -- | -- | 75 | 50 |  ׯ | | | | | | | | | | | | SYSUT1 | U | PS | -- | -- | -- | -- | -- | 75 | 0 |  ׯ | | | | | | | | | | | | SYSUT2 | U | PS | -- | -- | -- | -- | -- | 75 | 0 |  ׯ | | | | | | | | | | | | SYSUT3 | U | PS | -- | -- | -- | -- | -- | 75 | 0 |  ׯ | | | | | | | | | | | | SYSUT4 | U | PS | -- | -- | -- | -- | -- | 75 | 0 |  ר The following table provides an estimate of the storage needed in the SMP/E data sets for PSF 3.1.0. The estimates must be added to those of any other programs and service being installed to determine the total additional storage requirements. ׯ | Figure 14. Storage Requirements for SMP/E Data Sets |  ׯ | | | | | D | R | L | | | NO. | | | | | T | S | E | R | | | OF | NO. | NO. | | | Y | O | C | E | NO. | | 3380/| OF | OF | | LIBRARY | P | R | F | C | OF | BLK | 9345 | 3390 | DIR | | DDNAME | E | G | M | L | BLKS | SIZE | TRKS | TRKS | BLKS |  ׯ | | | | | | | | | | | | SMPLTS | S | PO | U | 0 | 0 | 6144 | -- | 0 | 0 | | (not | | | | | | | | | | | used) | | | | | | | | | |  ׯ | | | | | | | | | | | | SMPMTS | S | PO | FB | 80 | 16 | 8800 | -- | 5 | 1 |  ׯ | | | | | | | | | | | | SMPPTS | S | PO | FB | 80 | 48 | 8800 | -- | 6 | 1 |  ׯ | | | | | | | | | | | | SMPSCDS | S | PO | FB | 80 | 16 | 8800 | -- | 2 | 1 |  ׯ | | | | | | | | | | | | SMPSTS | S | PO | FB | 80 | 16 | 8800 | -- | 2 | 1 |  ר The following figures list the target and distribution libraries (data sets) and their attributes required to install PSF 3.1.0. The storage requirements of PSF 3.1.0 must be added to the storage required by Installation Requirements and Considerations 24 other programs having data in the same data set (library). A 15% additional growth factor has been added into the library size. ׯ | Figure 15. Storage Requirements for PSF 3.1.0 Target Libraries |  ׯ | | | | | D | R | L | | | NO. | | | | | T | S | E | R | | | OF | NO. | NO. | | | Y | O | C | E | NO. | | 3380/| OF | OF | | LIBRARY | P | R | F | C | OF | BLK | 9345 | 3390 | DIR | | DDNAME | E | G | M | L | BLKS | SIZE | TRKS | TRKS | BLKS |  ׯ | | | | | | | | | | | | FDEFLIB | S | PO | VBM | 8205 | 24 | 8209 | -- | 4 | 8 |  ׯ | | | | | | | | | | | | LINKLIB | S | PO | U | 0 | 812 | 6144 | -- | 56 | 8 |  ׯ | | | | | | | | | | | | MACLIB | S | PO | FB | 80 | 36 | 8800 | -- | 5 | 2 |  ׯ | | | | | | | | | | | | NUCLEUS | S | PO | U | 0 | 16 | 6144 | -- | 2 | 3 |  ׯ | | | | | | | | | | | | OVERLIB | S | PO | VBM | 8205 | 6 | 8209 | -- | 2 | 2 |  ׯ | | | | | | | | | | | | PDEFLIB | S | PO | VBM | 8205 | 58 | 8209 | -- | 10 | 7 |  ׯ | | | | | | | | | | | | PROCLIB | S | PO | FB | 80 | 18 | 8800 | -- | 3 | 2 |  ׯ | | | | | | | | | | | | PSEGLIB | S | PO | VBM | 8205 | 14 | 8209 | -- | 3 | 2 |  ׯ | | | | | | | | | | | | SAMPLIB | S | PO | FB | 80 | 380 | 8800 | -- | 66 | 7 |  ׯ | | | | | | | | | | | | SAPSDAT0 | U | PO | VBM | 8205 | 36 | 8209 | -- | 6 | 2 |  ׯ | | | | | | | | | | | | SAPSPDFD | U | PO | FB | 80 | 66 | 8800 | -- | 12 | 17 |  ר ׯ | Figure 16 (Page 1 of 2). Storage Requirements for PSF 3.1.0 | | Distribution Libraries |  ׯ | | | | | D | R | L | | | NO. | | | | | T | S | E | R | | | OF | NO. | NO. | | | Y | O | C | E | NO. | | 3380/| OF | OF | | LIBRARY | P | R | F | C | OF | BLK | 9345 | 3390 | DIR | | DDNAME | E | G | M | L | BLKS | SIZE | TRKS | TRKS | BLKS |  ׯ | | | | | | | | | | | | AAPSDAT0 | U | PO | VBM | 8205 | 36 | 8209 | -- | 6 | 2 |  ׯ | | | | | | | | | | | | AAPSMOD0 | S | PO | U | 0 | 760 | 6144 | -- | 95 | 80 |  ׯ | | | | | | | | | | | | AAPSPDFD | U | PO | FB | 80 | 66 | 8800 | -- | 12 | 18 |  ׯ | | | | | | | | | | | | AFDEFLIB | S | PO | VBM | 8205 | 24 | 8209 | -- | 4 | 8 |  ר Installation Requirements and Considerations 25 ׯ | Figure 16 (Page 2 of 2). Storage Requirements for PSF 3.1.0 | | Distribution Libraries |  ׯ | | | | | D | R | L | | | NO. | | | | | T | S | E | R | | | OF | NO. | NO. | | | Y | O | C | E | NO. | | 3380/| OF | OF | | LIBRARY | P | R | F | C | OF | BLK | 9345 | 3390 | DIR | | DDNAME | E | G | M | L | BLKS | SIZE | TRKS | TRKS | BLKS |  ׯ | | | | | | | | | | | | ALINKLIB | S | PO | U | 0 | 5 | 6144 | -- | 2 | 2 |  ׯ | | | | | | | | | | | | AMACLIB | S | PO | FB | 80 | 36 | 8800 | -- | 5 | 2 |  ׯ | | | | | | | | | | | | ANUCLEUS | S | PO | U | 0 | 8 | 6144 | -- | 2 | 2 |  ׯ | | | | | | | | | | | | AOSC5 | S | PO | U | 0 | 7 | 6144 | -- | 2 | 2 |  ׯ | | | | | | | | | | | | AOVERLIB | S | PO | VBM | 8205 | 6 | 8209 | -- | 2 | 2 |  ׯ | | | | | | | | | | | | APDEFLIB | S | PO | VBM | 8205 | 58 | 8209 | -- | 10 | 7 |  ׯ | | | | | | | | | | | | APROCLIB | S | PO | FB | 80 | 18 | 8800 | -- | 3 | 2 |  ׯ | | | | | | | | | | | | APSEGLIB | S | PO | VBM | 8205 | 14 | 8209 | -- | 3 | 2 |  ׯ | | | | | | | | | | | | ASAMPLIB | S | PO | FB | 80 | 380 | 8800 | -- | 66 | 7 |  ר  5.3 FMIDS DELETED Installing PSF 3.1.0 will result in the deletion of the following FMIDs: ׯ | Figure 17. FMID Deleted |  ׯ | | | DELETED | DELETING | | | FMID | FMID | DESCRIPTION |  ׯ | | | | | HPRF220 | HPRF310 | PSF/MVS 2.2.0 |  ׯ | | | | | JPRF223 | HPRF310 | PSF/MVS 2.2.0 Resources |  ׯ | | | | | JPRF225 | HPRF310 | MVS Download |  ר Installation Requirements and Considerations 26 5.4 SPECIAL CONSIDERATIONS  5.4.1 INSTALLING PSF 3.1.0 INTO THE LINK PACK AREA PSF 3.1.0 performance may be improved if many functional subsystems (FSS) are defined and PSF 3.1.0 is installed into LPA. For deferred printing, certain load modules can be installed into LPA. For information on deferred printing, see Print Services Facility for OS/390: Customization. Some high usage modules are listed below which are good candidates to be placed into the MVS LPA and ELPA to obtain performance improvements. APSPPIEP (aliases APSAFSA, APSPPFSA, APSPPNST, APSZCMND, APSZRSTR) - ELPA APSGBTL - LPA DCKVTBL, if you use SNA printers - ELPA. If PSF 3.1.0 will be used in direct printing mode, then PSF 3.1.0 CANNOT be installed into LPA.  5.4.2 MIGRATION CONSIDERATIONS  5.4.2.1 LIBRARY RESTRUCTURE FOR PSF 3.1.0 If you are migrating from PSF/MVS 2.2.0, changes have been made to the target and distribution library data sets. The target library data set APSDAT00 provided with PSF/MVS 2.2.0 has been replaced with the target library data set SAPSDAT0 provided with PSF 3.1.0. The target library data set SAPSPDFD and the distribution library data set AAPSPDFD are new for PSF 3.1.0. These data sets must be allocated, and the DDDEFs defined prior to installing PSF 3.1.0. See 6.1.8, "Allocate SMP/E Target and Distribution Libraries" on page 34 to allocate the new data set libraries, and see 6.1.9, "Create DDDEF Entries" on page 34 to define the new DDDEFs.  5.4.2.2 RESOURCES PROVIDED WITH PSF 3.1.0 There are new resources provided with PSF 3.1.0. The resources reside in FDEFLIB, PDEFLIB, OVERLIB, and PSEGLIB data set libraries. If you have modified your IBM-supplied resources and want to save them, copy them to a temporary data set so that they are not overwritten by the resources provided by PSF 3.1.0. After the Installation Verification Procedure is completed, copy the resources back to their proper resource libraries.  Installation Requirements and Considerations 27 The names of the resources provided with PSF 3.1.0 can be found by listing the SMPMCS file. Refer to Print Services Facility for OS/390: User's Guide for more information regarding resources and their use.  5.4.2.3 INSTALLATION EXITS PROVIDED WITH PSF 3.1.0 The installation exits for PSF 3.1.0 contain new function that was not provided with the PSF/MVS 2.2.0 installation exits. If you would like to keep the installation exits from PSF/MVS 2.2.0, then copy the installation exits from the SAMPLIB data set to a temporary data set so that they are not overwritten when PSF 3.1.0 is installed. Installation exits that should be copied are as follows: APSUX01 APSUX02 APSUX03 APSUX04 APSUX05 APSUX06 APSUX07 APSUX14 APSUX15 APSUX16 After the installation verification procedure is completed, copy these members back to the PSF 3.1.0 SAMPLIB data set. In addition, the installation exits must be reassembled prior to using them with PSF 3.1.0.  5.4.2.4 STARTUP PROCEDURES PROVIDED WITH PSF 3.1.0 The startup procedures for PSF 3.1.0 contain new function that was not provided with the PSF/MVS 2.2.0 startup procedures. If you would like to keep the startup procedures from PSF/MVS 2.2.0, then copy the startup procedures from the PROCLIB data set to a temporary data set so that they are not overwritten when PSF 3.1.0 is installed. Startup procedures for PSF/MVS 2.2.0 are as follows: APSWPROA APSWPROB APSWPROC APSWPROD APSWPROM APSWPROP APSWPROR APSWPROS APSWPROT NOTE: APSWPROD and APSWPROS are not provided with PSF 3.1.0. Installation Requirements and Considerations 28 After the installation verification procedure is completed, copy these members back to the PSF 3.1.0 PROCLIB data set. 5.4.2.4.1 BUFNO PARAMETER IN STARTUP PROCEDURES: The I/O buffer expansion factor for the BUFNO option in the PRINTDEV parameter has changed from 4K (PSF/MVS 2.2.0 and earlier) to 32K (PSF 3.1.0). If you continue to use the startup procedures specifying BUFNO values defined for PSF/MVS 2.2.0 or earlier, PSF 3.1.0 will reserve 8 times as much I/O buffer space. This may not present a concern since the BUFNO space is reserved above the 16 Meg line. However, a review the BUFNO values defined in your startup procedures is recommended. Refer to the "PRINTDEV Parameters" chapter and the "Selecting Region Sizes" heading of Print Services Facility for OS/390: Customization for a detailed explaination of the effects of the BUFNO parameter. 5.4.2.4.2 TRACE PARAMETER IN STARTUP PROCEDURES: The PSF 3.1.0 startup procedures DEFAULT SETTING of the TRACE option in the PRINTDEV parameter has been changed from TRACE=NO to TRACE=YES. This has been done to improve First Failure Data Capture. The probability of resolving situations that cause PSF 3.1.0 to abend is greatly enhanced when the TRACE option is YES. The overhead caused by this INTERNAL WRAP trace is generally negligible, however, certain applications being printed on high speed printers that may have been performing marginally before may experience clutching due to this change. If this occurs, you may want to set the TRACE option back to NO. If you are going to reuse your startup procedure from PSF/MVS 2.2.0, and it still has the old default value (TRACE=NO), you should consider changing it. Installation Requirements and Considerations 29 6.0 INSTALLATION INSTRUCTIONS  This chapter describes the installation method and the step-by-step procedures to install and to activate the functions of PSF 3.1.0. Please note the following: If you want to install PSF 3.1.0 into its own SMP/E environment, consult the SMP/E manuals for instructions on creating and initializing the SMPCSI and the SMP/E control data sets. Sample jobs have been provided to help perform some or all of the installation tasks. The SMP/E jobs assume that all DDDEF entries required for SMP/E execution have been defined in the appropriate zones. The SMP/E dialogs may be used instead of the sample jobs to accomplish the SMP/E installation steps.  6.1 INSTALLING PSF 3.1.0  6.1.1 DECIDING WHICH FMIDS TO INSTALL If you have OS/390 Version 2 Release 7 or above installed, then FMID HPRF310 is already installed. You must install FMID JPRF311 to obtain the full function of PSF 3.1.0. If you do not have OS/390 Version 2 Release 7 or above installed, you must install both FMIDs HPRF310 and JPRF311 to receive the full function of PSF 3.1.0.  6.1.2 SMP/E CONSIDERATIONS FOR INSTALLING PSF 3.1.0 This release of PSF 3.1.0 is installed using the SMP/E RECEIVE, APPLY, and ACCEPT commands. The SMP/E dialogs may be used to accomplish the SMP/E installation steps.  6.1.3 SMP/E ENVIRONMENT All SMP/E installation jobs provided assume that all necessary DD statements for the execution of SMP/E are defined using DDDEFs. Sample jobs are provided to assist you in installing PSF 3.1.0. After the RECEIVE step has been completed, the sample jobs can be found in SMPTLIB: IBM.HPRF310.F2. Make a copy of these jobs in your own (C) Copyright IBM Corp. 1983,1998 30 library and modify them for use during the installation of PSF 3.1.0. The sample jobs are: APSWREC Sample RECEIVE job APSWALOC Sample job to allocate target and distribution libraries APSWDDEF Sample job to define SMP/E DDDEFs APSWAPCK Sample APPLY CHECK job APSWAPP Sample APPLY job APSWACCK Sample ACCEPT CHECK job APSWACC Sample ACCEPT job In the sample SMP/E jobs provided, the name of the SMP/E CSI is "#GLOBALCSI". The global zone name in the SMP/E CSI is "GLOBAL". The distribution zone name is "#DZONE". The target zone name is "#TZONE". The sample jobs should be updated to reflect the CSI and zone names used at your installation.  6.1.4 SMP/E OPTIONS SUBENTRY VALUES The recommended values for some SMP/E CSI subentries are shown in Figure 18. Use of values lower than these may result in failures in the installation process. DSSPACE is a subentry in the GLOBAL options entry. PEMAX is a subentry of the GENERAL entry in the GLOBAL options entry. Refer to the SMP/E manuals for instructions on updating the global zone. ׯ | Figure 18. SMP/E Options Subentry Values |  ׯ | | | SUB-ENTRY | VALUE | COMMENT |  ׯ | | | | | DSSPACE | (100,10,75)TRK | Recommended value for PSF 3.1.0 |  ׯ | | | | | PEMAX | 9999 | The SMP/E default is larger than | | | | what can be specified here |  ר  6.1.5 UNLOAD SAMPLE JOBS FROM PRODUCT TAPE Sample installation jobs are provided on the distribution tape to help you install PSF 3.1.0. The following sample job will copy the PSF 3.1.0 installation jobs from the tape. Add a job card and modify the parameters in boldface to uppercase values to meet your site's requirements before submitting. Installation Instructions 31 ׯ | | | //STEP1 EXEC PGM=IEBCOPY | | //SYSPRINT DD SYSOUT=* | | //IN DD DSN=IBM.HPRF310.F2,UNIT=TUNIT,VOL=SER=PRF310, | | // LABEL=(3,SL),DISP=(OLD,KEEP) | | //OUT DD DSNAME=PSF.JCLLIB, | | // DISP=(NEW,CATLG,DELETE), | | // VOL=SER=DASDVOL,UNIT=SYSALLDA, | | // DCB=*.STEP1.IN,SPACE=(8800,(9,2,5)) | | //SYSUT3 DD UNIT=SYSDA,SPACE=(CYL,(1,1)) | | //SYSIN DD * | | COPY INDD=IN,OUTDD=OUT | | SELECT MEMBER=APSWACC | | SELECT MEMBER=APSWACCK | | SELECT MEMBER=APSWALOC | | SELECT MEMBER=APSWAPCK | | SELECT MEMBER=APSWAPP | | SELECT MEMBER=APSWDDEF | | SELECT MEMBER=APSWREC | | /* | | | ר Figure 19. Unload - Sample Unload tape job where TUNIT is the unit value matching the product tape or cartridge, PSF.JCLLIB is the name of the data set where the sample jobs will reside, DASDVOL is the volume serial of the DASD device where the data set will reside. You can also access the sample installation jobs by performing an SMP/E RECEIVE for FMID HPRF310, and then copying the jobs from data set HLQ.IBM.HPRF310.F2 to a work dataset for editing and submission.  6.1.6 PERFORM SMP/E RECEIVE Edit and submit sample job APSWREC in psf.jcllib to perform the SMP/E RECEIVE for PSF 3.1.0. Consult the instructions in the sample job for more information. NOTE: If you obtained PSF 3.1.0 as part of a CBPDO, use the RCVPDO job found in the CBPDO RIMLIB data set to RECEIVE the PSF 3.1.0 FMIDs as well as any service, HOLDDATA, or preventive service planning (PSP) information included on the CBPDO tape. For more information, refer to the documentation included with the CBPDO. EXPECTED RETURN CODES AND MESSAGES: Return code "0" should be received from this job. Installation Instructions 32 6.1.7 RECEIVE CUMULATIVE SERVICE TAPE, IF APPLICABLE A cumulative service tape may be shipped with the product package. If no cumulative service tape is shipped or if the product is received by CBPDO, disregard this section. The JCL in Figure 20 on page 33 is a sample job to RECEIVE the PTFs and HOLDDATA from the cumulative service tape. Create JCL similar to this example, modify the job to specify the appropriate parameters for your installation. If any of the PTFs on the tape have a system hold by the ++HOLD SYSTEM modification control statement with a reason ID equal to UCLIN, file 6 of the cumulative service tape will contain the UCLIN for that PTF. The instructions for the UCLIN are contained in the cover letter of the PTF. EXPECTED RETURN CODES AND MESSAGES: Return code "0" should be received from this job. ׯ | | | //RECEIVEC JOB 'account #','name',MSGLEVEL=(1,1) | | //************************************************************* | | //* RECEIVE CUMULATIVE SERVICE DATA. * | | //* MAKE THE FOLLOWING MODIFICATIONS: * | | //* 1) CHANGE THE JOB CARD TO MEET YOUR LOCAL REQUIREMENTS * | | //* 2) CHANGE #globalcsi - TO THE DATA SET NAME OF YOUR * | | //* GLOBAL CSI DATA SET * | | //* 3) CHANGE tape TO A VALID TAPE UNIT NAME * | | //* 4) CHANGE sssssss TO A VALID SOURCE NAME * | | //************************************************************* | | //RECEIVE EXEC PGM=GIMSMP,REGION=4096K | | //SMPCSI DD DSN=#globalcsi, | | // DISP=SHR | | //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 20. RECEIVE Job for Cumulative Service Tape  Installation Instructions 33 6.1.8 ALLOCATE SMP/E TARGET AND DISTRIBUTION LIBRARIES Edit and submit sample job APSWALOC in psf.jcllib to allocate the SMP/E target and distribution libraries for PSF 3.1.0. Consult the instructions in the sample job for more information. NOTE: If you are installing PSF 3.1.0 on an OS/390 Version 2 Release 7 system or higher, most of the data sets for PSF 3.1.0 have already been allocated. You must allocate the SAPSPDFD and AAPSPDFD data sets prior to installing JPRF311. Refer to the comments in the APSWALOC job for instructions on allocating these data sets. The samples specify the storage requirements using average block lengths. BLKSIZE=0 indicates that system-determined block sizes are being used. For example, the sizes might look like this: SPACE=(8800,(135,27,6)), DCB=(RECFM=FB,LRECL=80,BLKSIZE=0) Do not confuse the SPACE=8800 (average block length) parameter with the BLKSIZE=0 (block size) parameter. If you would like to change the block size to something other than the system-determined block size, you can change the BLKSIZE parameter. Do not change the SPACE parameter. You can use the storage allocations as they are, or convert them to cylinder or track allocations. EXPECTED RETURN CODES AND MESSAGES: Return code "0" should be received from this job.  6.1.9 CREATE DDDEF ENTRIES Edit and submit sample job APSWDDEF in psf.jcllib to create DDDEF entries for the SMP/E target and distribution libraries for PSF 3.1.0. Consult the instructions in the sample job for more information. NOTES: 1. If you are installing PSF 3.1.0 on an OS/390 Version 2 Release 7 system or higher, most of the DDDEFs for PSF 3.1.0 have already been defined. You must define DDDEFs for SAPSPDFD and AAPSPDFD prior to installing JPRF311. Refer to the comments in the APSWDDEF job for instructions on defining these DDDEFs. 2. If you install PSF 3.1.0 into the same SMP/E zones as the base control program (BCP), some DDDEFs may already be defined. These DDDEFs are listed below. If these DDDEFs are not defined, define these DDDEFs before continuing with the installation of PSF 3.1.0. LINKLIB MACLIB NUCLEUS PROCLIB SAMPLIB  Installation Instructions 34 ALINKLIB AMACLIB ANUCLEUS AOSC5 APROCLIB ASAMPLIB EXPECTED RETURN CODES AND MESSAGES: Return code "0" should be received from this job.  6.1.10 PERFORM SMP/E APPLY CHECK Edit and submit sample job APSWAPCK to perform an SMP/E APPLY CHECK for PSF 3.1.0. Consult the instructions in the sample job for more information. To receive the full benefit of the SMP/E Causer SYSMOD Summary Report, do not bypass the following on the APPLY CHECK: PRE, ID, REQ, and IFREQ. This is because the SMP/E root cause analysis identifies the cause only of ERRORS and not of WARNINGS (SYSMODs that are bypassed are treated as warnings, not errors, by SMP/E). The GROUPEXTEND operand indicates that SMP/E apply all requisite SYSMODs. The requisite SYSMODS might be applicable to other functions. EXPECTED RETURN CODES AND MESSAGES: Return code "0" should be received from this job. Investigate any problems if a return code of "0" is not received.  6.1.11 PERFORM SMP/E APPLY Edit and submit sample job APSWAPP to perform an SMP/E APPLY for PSF 3.1.0. Consult the instructions in the sample job for more information. EXPECTED RETURN CODES AND MESSAGES: Return code "0" should be received from this job.  6.1.12 PERFORM I/O CONFIGURATION An I/O configuration must be performed for printers that are channel-attached to the host and new printers that are added to your system by using Hardware Configuration Dialog (HCD). Refer to the section entitled "Defining Channel-Attached Printers to OS/390" in Print Services Facility for OS/390: Customization for information on configuration definitions. Installation Instructions 35 6.1.13 MODIFY THE SYSTEM ENVIRONMENT FOR PSF 3.1.0 The installation of PSF 3.1.0 may require that the system environment be modified before PSF 3.1.0 can be used. The system environment, in this case, is the MVS or OS/390 system libraries, JES, and VTAM. The modifications required depend upon whether PSF has been installed before, what printers will be used, and whether the printers will be controlled with a job entry subsystem (JES) or not. Refer to Print Services Facility for OS/390: Customization for information on changing the system environment.  6.1.14 RE-IPL THE MVS OR OS/390 SYSTEM All previous installation steps must be successfully completed before the MVS or OS/390 system is re-IPLed. Re-IPL your MVS or OS/390 system to enable the changes that have been made up to this point in the installation. After the IPL is completed, you may perform the Installation Verification Procedures that are in 6.2, "Installation Verification Procedure" on page 37.  6.1.15 PERFORM SMP/E ACCEPT CHECK Edit and submit sample job APSWACCK to perform an SMP/E ACCEPT CHECK for PSF 3.1.0. Consult the instructions in the sample job for more information. To receive the full benefit of the SMP/E Causer SYSMOD Summary Report, do not bypass the following on the ACCEPT CHECK: PRE, ID, REQ, and IFREQ. This is because the SMP/E root cause analysis identifies the cause only of ERRORS and not of WARNINGS (SYSMODs that are bypassed are treated as warnings, not errors, by SMP/E). The GROUPEXTEND operand indicates that SMP/E accept all requisite SYSMODs. The requisite SYSMODS might be applicable to other functions. EXPECTED RETURN CODES AND MESSAGES: Return code "0" should be received from this job. Investigate any problems if a return code of "0" is not received.  Installation Instructions 36 6.1.16 PERFORM SMP/E ACCEPT Edit and submit sample job APSWACC to perform an SMP/E ACCEPT for PSF 3.1.0. Consult the instructions in the sample job for more information. Before using SMP/E to load new distribution libraries, IBM recommends that you set the ACCJCLIN indicator in the distribution zone. This causes entries produced from JCLIN to be saved in the distribution zone whenever a SYSMOD containing inline JCLIN is ACCEPTed. For more information on the ACCJCLIN indicator, see the description of inline JCLIN in the SMP/E manuals. EXPECTED RETURN CODES AND MESSAGES: Return code "0" should be received from this job. If PTFs containing replacement modules are being ACCEPTed, SMP/E ACCEPT processing will linkedit/bind the modules into the distribution libraries. During this processing, the Linkage Editor or Binder may issue IEW0461 or IEW2454W messages documenting unresolved external references, resulting in a return code of 4 from the ACCEPT step. These messages are acceptable because the distribution libraries are not executable and the unresolved external references will not affect the executable system libraries.  6.1.17 PERFORM INSTALLATION VERIFICATION PROCEDURE When all the previous installation steps have been completed successfully, the installation verification procedure listed in 6.2, "Installation Verification Procedure" should be performed.  6.1.18 CLEANUP AFTER MIGRATION FROM PSF/MVS 2.2.0 If you are migrating from PSF/MVS 2.2.0, you can now delete the obsolete library SYS1.APSDAT00 and the corresponding DDDEF APSDAT00. This data set was replaced by SYS1.SAPSDAT0 in PSF 3.1.0.  6.2 INSTALLATION VERIFICATION PROCEDURE Complete the following steps for the PSF 3.1.0 IVP: Complete the installation verification Perform PSF 3.1.0 tasks after running installation verification. Installation Instructions 37 6.2.1 COMPLETE THE INSTALLATION VERIFICATION To verify that PSF 3.1.0 has been installed correctly, IVP procedures are provided in either a JES environment (for all printers supported by PSF 3.1.0) or in direct-attach mode. The IVP consists of an IEBGENER job that prints a page segment called S1IVP. The page segment was placed on your system during the installation of PSF 3.1.0. The logical-page size needed for any printer for this IVP is 8.5 inches wide by 11 inches long.  6.2.1.1 IVP JOB FOR JES ENVIRONMENT Perform the following steps if PSF 3.1.0 will be used in a JES environment: 1. Submit the APSIVP job shown in Figure 21 on page 39. This job exists in the data set SYS1.SAMPLIB(APSIVP). The job produces a listing of the member SYS1.PSEGLIB(S1IVP) for output on the printer. The output class in the SYSUT2 DD statement for the printer in the job is class A. If this class is incorrect for your installation, the output class should be changed to the correct value. If PSF 3.1.0 will be used to print on an IBM 3800, this job must be modified according to the comments within the job.  Installation Instructions 38 ׯ | | | //APSIVP JOB 'acct. #','name',MSGLEVEL=(1,1) | | //STEP1 EXEC PGM=IEBGENER | | //* | | //************************************************************ | | //* THIS IVP IS DESIGNED TO VERIFY THAT PSF HAS BEEN * | | //* INSTALLED CORRECTLY FOR PRINTERS SUPPORTED BY PSF * | | //* * | | //* NOTE: * | | //* IF THIS IVP JOB IS BEING RUN FOR A 3800 PRINTER, * | | //* COMMENT OUT THE FIRST 'OUTPUT1' STATEMENT, AND * | | //* UNCOMMENT THE SECOND 'OUTPUT1' STATEMENT. * | | //************************************************************ | | //* | | //SYSIN DD DUMMY | | //SYSPRINT DD SYSOUT=* | | //OUTPUT1 OUTPUT FORMDEF=A10110 /* <-- SEE NOTE ABOVE */ | | //*OUTPUT1 OUTPUT FORMDEF=0101 /* <-- SEE NOTE ABOVE */ | | //SYSUT2 DD SYSOUT=A, | | // OUTPUT=*.OUTPUT1, | | // DCB=(RECFM=VBA,BLKSIZE=8509) | | //SYSUT1 DD DSN=SYS1.PSEGLIB(S1IVP),DISP=SHR | | /* | | | ר Figure 21. APSIVP Job 2. Set up and start the printer. To use PSF 3.1.0 to print the output of the job APSIVP, the printer must be set up with the correct output class (class A). If you are not using the startup procedures supplied in SYS1.PROCLIB, your startup procedure should specify the same default page definition as specified in the startup procedure APSWPROA, APSWPROB, APSWPROC, APSWPROM, APSWPROP, APSWPROR, or APSWPROT. Startup procedure APSWPROA is for channel-attached printers. Startup procedure APSWPROB is for SNA-attached printers. Startup procedure APSWPROC is for the IBM 3800 Printer. Startup procedure APSWPROM is for microfilm printer support. Startup procedure APSWPROP is for OS/390 Softcopy Print support. Startup procedure APSWPROR is for PSF multiple resolution attached devices. Startup procedure APSWPROT is for TCP/IP attached devices. Installation Instructions 39 JES2 SETUP: To set up for printing under JES2, change the printer settings, and start the printer using the following commands: $TPRTnn,Q=A $SPRTnn where "nn" is the printer number set up in the JES2 INIT deck as a page printer. JES3 SET UP: To set up for printing under JES3, change the printer settings, and start the printer using the following commands: *V jname ON *S jname,WC=A where "jname" is the printer name as specified in the JES3 INISH deck. Refer to the appropriate MVS/ESA JES2 or JES3 Commands publication for additional information about the JES commands to use when starting a printer. 3. The expected result of the IVP is a frame with the letters IBM placed at an angle in the left corner of the frame, the words Print Services Facility in the middle of the frame, and the words Advanced Function Printing rotated 90 degrees at the bottom of the frame. Refer to Print Services Facility for OS/390: Customization for an example of the IVP frame.  6.2.1.2 IVP JOB FOR DIRECT-ATTACH ENVIRONMENT Perform the following steps if PSF 3.1.0 will be used in a direct-attach environment: 1. Set aside the printer in direct-attach mode. The printer cannot be allocated to other applications on the system if it is running in direct-attach mode. 2. Submit the APSIVPDA job shown in Figure 22 on page 41. This job exists in the data set SYS1.SAMPLIB(APSIVPDA). The job produces a listing of the member SYS1.PSEGLIB(S1IVP) for output on the printer. If you plan to print on an IBM 3800, this job must be modified according to the comments within the job. Installation Instructions 40 ׯ | | | //APSIVPDA JOB 'acct. #','name',MSGLEVEL=(1,1) | | //STEP1 EXEC PGM=IEBGENER,REGION=750K | | //* | | //************************************************************ | | //* THIS IVP IS DESIGNED TO VERIFY THAT PSF HAS BEEN * | | //* INSTALLED CORRECTLY AND THAT YOUR INSTALLATION CAN * | | //* USE A PRINTER IN DIRECT ATTACH MODE. * | | //* * | | //* NOTE: * | | //* IF YOU PLAN ON RUNNING THIS IVP FOR A 3800 PRINTER, * | | //* COMMENT OUT THE FIRST OCCURRENCES OF THE FOLLOWING * | | //* STATEMENTS: * | | //* 'MSGDS', 'FONT01', 'FORMDEF', 'PAGEDEF' AND 'OUTPUT1'. * | | //* THEN UNCOMMENT THE SECOND OCCURRENCES OF THE SAME * | | //* STATEMENTS. * | | //************************************************************ | | //* | | //MSGDS OUTPUT FORMDEF=A10110 /* <-- SEE NOTE ABOVE */ | | //*MSGDS OUTPUT FORMDEF=0101 /* <-- SEE NOTE ABOVE */ | | //FONT01 DD DSN=SYS1.FONTLIBB, /* <-- SEE NOTE ABOVE */ | | //*FONT01 DD DSN=SYS1.FONTLIB, /* <-- SEE NOTE ABOVE */ | | // DISP=SHR /* SYSTEM FONTS */ | | //PSEG01 DD DSN=SYS1.PSEGLIB, /* SYSTEM PAGE SEGMENTS */ | | // DISP=SHR | | //OLAY01 DD DSN=SYS1.OVERLIB, /* SYSTEM OVERLAYS */ | | // DISP=SHR | | //PDEF01 DD DSN=SYS1.PDEFLIB, /* SYSTEM PAGEDEFS */ | | // DISP=SHR | | //FDEF01 DD DSN=SYS1.FDEFLIB, /* SYSTEM FORMDEFS */ | | // DISP=SHR | | //* | | //DAPRT1 CNTL | | //DAPRT1 PRINTDEV FONTDD=*.FONT01, /* FONT LIBRARY DD */ | | // OVLYDD=*.OLAY01, /* OVERLAY LIBRARY DD */ | | // PSEGDD=*.PSEG01, /* SEGMENT LIBRARY DD */ | | // PDEFDD=*.PDEF01, /* PAGEDEF LIBRARY DD */ | | // FDEFDD=*.FDEF01, /* FORMDEF LIBRARY DD */ | | // MESSAGE=*.MSGDS, /* MSG DATA SET OUTPUT */ | | // FORMDEF=A10110, /* <-- SEE NOTE ABOVE */ | | //* FORMDEF=0101, /* <-- SEE NOTE ABOVE */ | | // PAGEDEF=A06462, /* <-- SEE NOTE ABOVE */ | | //* PAGEDEF=06080, /* <-- SEE NOTE ABOVE */ | | // BUFNO=5, /* NO. WRITE DATA BUFFER*/ | | // TRACE=NO, /* TRACE FLAG */ | | // PIMSG=YES /* ACCUM. DATA SET MSGS */ | | | ר Figure 22 (Part 1 of 2). APSIVPDA Job Installation Instructions 41 ׯ | | | //DAPRT1 ENDCNTL | | //* | | //SYSIN DD DUMMY | | //SYSPRINT DD SYSOUT=* | | //* | | //OUTPUT1 OUTPUT FORMDEF=A10110 /* <-- SEE NOTE ABOVE */ | | //*OUTPUT1 OUTPUT FORMDEF=0101 /* <-- SEE NOTE ABOVE */ | | //* | | //************************************************************ | | //* NOTE: * | | //* THE 'UNIT=' PARAMETER BELOW MUST BE UPDATED TO POINT TO * | | //* THE ADDRESS OF THE PRINTER THAT YOU ARE GOING TO USE AS * | | //* A DIRECT ATTACH PRINTER. * | | //************************************************************ | | //* | | //SYSUT2 DD UNIT=nnn, /* <-- SEE NOTE ABOVE */ | | // CNTL=*.DAPRT1, | | // DCB=(RECFM=VBA,BLKSIZE=8509), | | // OUTPUT=(*.OUTPUT1) | | //SYSUT1 DD DSN=SYS1.PSEGLIB(S1IVP),DISP=SHR | | /* | | | ר Figure 22 (Part 2 of 2). APSIVPDA Job The expected result of the IVP is a frame with the letters IBM placed at an angle in the left corner of the frame, the words Print Services Facility in the middle of the frame, and the words Advanced Function Printing rotated 90 degrees at the bottom of the frame. Refer to Print Services Facility for OS/390: Customization for an example of the IVP frame.  Installation Instructions 42 APPENDIX A. PSF 3.1.0 INSTALL LOGIC  A.1 SMP/E MODIFICATION CONTROL STATEMENTS The SMP/E Modification Control Statements (SMPMCS) for PSF 3.1.0 are contained in the SMPMCS file on the installation tape. The SMPMCS for the FMID in the product will be loaded to the SMPPTS dataset, with a member name matching the FMID, when the FMID is SMP/E RECEIVEd. You may browse or print these members using TSO/E, ISPF, or IEBGENER (or IEBPTPCH).  A.1.1 FOR FMID HPRF310 ++FUNCTION(HPRF310) FILES(10) REWORK(1998309) RFDSNPFX(IBM) /*********************************************************/ /* Licensed Materials - Property of IBM */ /* 5655-B17, 5647-A01(C) Copyright IBM Corp. 1984, 1998 */ /* All Rights Reserved */ /* US Government Users Restricted Rights - */ /* Use, duplication or disclosure restricted by */ /* GSA ADP Schedule Contract with IBM Corp. */ /*********************************************************/ . ++VER(Z038 ) DELETE(HAF1103 HAF1203 HAF1220 HAF1228 HPRF102 HPRF220 JAF1110 JAF1111 JAF1210 JAF1211 JAF1213 JAF1218 JAF1222 JAF1223 JAF1224 JAF1225 JAF1227 JAF1230 JAF1231 JAF1232 JAF1233 JAF1235 J00M110 ) SUP(HAF1103 HAF1203 HAF1220 HAF1228 HPRF102 JAF1110 JAF1111 JAF1210 JAF1211 JAF1213 JAF1218 JAF1222 JAF1223 JAF1224 JAF1225 JAF1227 JAF1230 JAF1231 JAF1232 JAF1233 JAF1235 J00M110 ) . ++JCLIN RELFILE(1) .  A.1.2 FOR FMID JPRF311 ++FUNCTION(JPRF311) FILES(3) REWORK(1998307) RFDSNPFX(IBM) /*********************************************************/ /* Licensed Materials - Property of IBM */ /* 5655-B17, (C) Copyright IBM Corp. 1984, 1998 */ /* All Rights Reserved */ /* US Government Users Restricted Rights - */ /* Use, duplication or disclosure restricted by */ /* GSA ADP Schedule Contract with IBM Corp. */ /*********************************************************/ . ++VER(Z038) FMID(HPRF310)  (C) Copyright IBM Corp. 1983,1998 43 SUP(HPRF220) . Appendix A. PSF 3.1.0 Install Logic 44 APPENDIX B. READER'S COMMENTS  PROGRAM DIRECTORY FOR PRINT SERVICES FACILITY FOR OS/390 VERSION 3 RELEASE 1, MODIFICATION LEVEL 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. 1983,1998 45 __ CBIPO __ CBPDO __ CustomPac __ ServerPac __ Independent __ Other Is this the first time your organization has installed this product? __ Yes __ No Were the people who did the installation experienced with the installation of MVS products? __ Yes __ No 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: ____________________________________________________________ ____________________________________________________________ ____________________________________________________________ ____________________________________________________________ ____________________________________________________________ ____________________________________________________________ ____________________________________________________________ ____________________________________________________________ ____________________________________________________________ ____________________________________________________________ ____________________________________________________________ ____________________________________________________________ Appendix B. Reader's Comments 46 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 Print Services Facility for OS/390 Development group): IBM Printing Systems Company Box 1900 Boulder, Colorado 80301-9191 USA Attention: Dept. RJXA/003G FAX Number: (800) 524-1519 E-Mail: printpub@us.ibm.com  Appendix B. Reader's Comments 47  IBM Program Number: 5655-B17 5801 5802 5337 Printed in U.S.A.