pvgetOS390_master.doc, printed on 12/10/2004, at 2:18:51 PM AllFusion CA-Panvalet for z/OS Getting Started 14.5 MAN01115609E F00003-1E pvgetOS390_master.doc, printed on 12/10/2004, at 2:18:51 PM This documentation and related computer software program (hereinafter referred to as the “Documentation”) is for the end user’s informational purposes only and is subject to change or withdrawal by Computer Associates International, Inc. (“CA”) at any time. This documentation may not be copied, transferred, reproduced, disclosed or duplicated, in whole or in part, without the prior written consent of CA. This documentation is proprietary information of CA and protected by the copyright laws of the United States and international treaties. Notwithstanding the foregoing, licensed users may print a reasonable number of copies of this documentation for their own internal use, provided that all CA copyright notices and legends are affixed to each reproduced copy. Only authorized employees, consultants, or agents of the user who are bound by the confidentiality provisions of the license for the software are permitted to have access to such copies. This right to print copies is limited to the period during which the license for the product remains in full force and effect. Should the license terminate for any reason, it shall be the user’s responsibility to return to CA the reproduced copies or to certify to CA that same have been destroyed. To the extent permitted by applicable law, CA provides this documentation “as is” without warranty of any kind, including without limitation, any implied warranties of merchantability, fitness for a particular purpose or noninfringement. In no event will CA be liable to the end user or any third party for any loss or damage, direct or indirect, from the use of this documentation, including without limitation, lost profits, business interruption, goodwill, or lost data, even if CA is expressly advised of such loss or damage. The use of any product referenced in this documentation and this documentation is governed by the end user’s applicable license agreement. The manufacturer of this documentation is Computer Associates International, Inc. Provided with “Restricted Rights” as set forth in 48 C.F.R. Section 12.212, 48 C.F.R. Sections 52.227- 19(c)(1) and (2) or DFARS Section 252.227-7013(c)(1)(ii) or applicable successor provisions. 2004 Computer Associates International, Inc. All trademarks, trade names, service marks, and logos referenced herein belong to their respective companies. pvgetOS390_master.doc, printed on 12/10/2004, at 2:18:51 PM Contents Chapter 1: Welcome Options ....................................................................... 1-2 Option for ISPF............................................................. 1-2 Option for TSO ............................................................. 1-2 Exits .......................................................................... 1-3 Compare Utility................................................................ 1-3 Other Product Interfaces ........................................................ 1-3 CA Technology Services: Delivering Business Value On Your Terms ................ 1-4 CA Education Services: Ready When You Are .................................... 1-5 Computer Associates: Commitment, Quality, Innovation .......................... 1-5 For More Information........................................................... 1-7 Contacting Technical Support ................................................... 1-7 Chapter 2: Installation Requirements and Steps Supported Environments ....................................................... 2-1 System Requirements........................................................... 2-2 CPU Storage ............................................................... 2-3 Batch System ........................................................... 2-3 DUMP/RESTORE ...................................................... 2-3 Subsystem Storage ...................................................... 2-3 Authorizing CAI.CAILIB .................................................... 2-4 Modifying SMP/E Libraries ................................................. 2-4 Optional Product Considerations ............................................ 2-5 Contents iii pvgetOS390_master.doc, printed on 12/10/2004, at 2:18:51 PM SYSMODs ................................................................. 2-6 Target and Distribution Library Space Requirements .......................... 2-7 Option for ISPF Requirements............................................... 2-8 Option for TSO Requirements ............................................... 2-8 Installation Tape Contents ...................................................... 2-9 CA Common Services ......................................................... 2-11 CAIRIM.................................................................. 2-11 CA-LMP ................................................................. 2-12 Installation Steps ............................................................. 2-12 Step 1: Review System Requirements ....................................... 2-13 Step 2: Review Library Upgrade Considerations ............................. 2-13 Step 3: Select Target Libraries .............................................. 2-13 Option for ISPF Considerations ......................................... 2-14 Option for TSO Considerations ......................................... 2-15 Step 4: Complete the Installation Worksheet ................................. 2-15 Step 5: Unload Sample JCL................................................. 2-15 Step 6: Unload BookManager Files from Tape................................ 2-17 Changing the Prefix in the Bookshelf Definition .......................... 2-17 Downloading Files for Use on a PC ..................................... 2-18 Step 7: Unload Adobe Acrobat PDF Files from Tape .......................... 2-19 Move Compressed Archive File to Another Platform (Optional) ........... 2-19 Restore PDF Files and Directory Structure ............................... 2-20 Read Documentation Files ............................................. 2-21 Step 8: Allocate Target and Distribution Libraries ............................ 2-21 Step 9: Allocate Private SMP/E Libraries .................................... 2-22 Step 10: Customize the SMP/E Procedure ................................... 2-24 Step 11: Receive AllFusion CA-Panvalet (and Options) ....................... 2-24 Step 12: Apply AllFusion CA-Panvalet (and Options) ........................ 2-25 Step 13: Define and Build the Installation and USERMOD PANLIBs ........... 2-26 Step 14: Accept AllFusion CA-Panvalet (and Options) ........................ 2-26 Step 15: Apply PVOPT Macro USERMODs .................................. 2-27 Step 16: Save Installation Materials ......................................... 2-27 iv AllFusion CA-Panvalet for z/OS Getting Started pvgetOS390_master.doc, printed on 12/10/2004, at 2:18:51 PM Chapter 3: Activating the Subsystem System Considerations.......................................................... 3-1 JES3 and JES2 Multi-Access Spool Considerations ............................. 3-2 GETMAIN Considerations .................................................. 3-3 SMP/E Considerations...................................................... 3-4 Subsystem Activation........................................................... 3-4 Step 1: Implement the Subsystem Programs ................................... 3-4 Types of Subsystem Programs ........................................... 3-4 Methods for Locating Type 3 Programs ................................... 3-8 Step 2: Define the Subsystem ............................................... 3-12 SYS1.PARMLIB (IEFSSNxx) ............................................ 3-13 CAIRIM .............................................................. 3-15 Step 3: Initialize the Subsystem ............................................. 3-15 PSINIT ............................................................... 3-15 PANSYSxx Parameters ................................................. 3-17 CAIRIM .............................................................. 3-20 Step 4: Start the Subsystem ................................................. 3-20 CAIRIM .............................................................. 3-21 Restarting the Subsystem ............................................... 3-21 Step 5: Communicate with the Subsystem.................................... 3-23 Step 6: Stop the Subsystem ................................................. 3-26 CAIRIM .............................................................. 3-26 Emergency Shutdown and Recovery of the Subsystem ........................ 3-26 Multiple Subsystems....................................................... 3-28 Chapter 4: Configuring the Options Configuring the Option for ISPF ................................................. 4-1 Step 1: Renaming the Primary Menu ......................................... 4-1 Step 2: Creating a CLIST or Logon Procedure to do Allocation .................. 4-3 Step 3: Testing the Option for ISPF ........................................... 4-4 Step 4: Customizing the Option for ISPF (Optional) ............................ 4-5 Contents v pvgetOS390_master.doc, printed on 12/10/2004, at 2:18:51 PM Customizing the Option for ISPF ................................................ 4-5 Selecting Library Concatenation Panels .....................................