Unicenter CA-Spool Print Management Getting Started · 00SPGTTL.doc, printed on 11/19/2004, at 2:12...

00SPGTTL.doc, printed on 11/19/2004, at 2:12 PM

Unicenter® CA-Spool™ Print Management

Getting Started r11

MAN06111039EK00751-1E

00SPGTTL.doc, printed on 11/19/2004, at 2:12 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.

2005 Computer Associates International, Inc.

All trademarks, trade names, service marks, and logos referenced herein belong to their respective companies.

01SPGTOC.doc, printed on 11/27/2004, at 10:56 AM

Contents

Chapter 1: Welcome What is Unicenter CA-Spool?.................................................... 1-1

Consolidates Distributed Print Workload ..................................... 1-2 Self-Contained Subsystem................................................... 1-2 Distributed Control ......................................................... 1-2 Unified Support for Printing................................................. 1-3 Managed Printing Environment.............................................. 1-3 NJE Interface............................................................... 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-6 For More Information........................................................... 1-7

Chapter 2: Basic Concepts and Features Concepts ...................................................................... 2-1

User Control ............................................................... 2-2 Enterprise Printing ......................................................... 2-2 System Interfaces ........................................................... 2-2 Functions .................................................................. 2-3 Structure .................................................................. 2-4

Contents iii

01SPGTOC.doc, printed on 11/19/2004, at 2:12 PM

Chapter 3: Software and System Requirements Software Requirements......................................................... 3-1 System Requirements .......................................................... 3-1

SAS/C Runtime Library .................................................... 3-2 CA Common Services ...................................................... 3-2 z/OS UNIX System Services ................................................ 3-2

Chapter 4: Installation Parallel Installation ............................................................ 4-1

Disk space................................................................. 4-2 Installation Materials........................................................... 4-2 Resource Requirements ........................................................ 4-3

Distribution Libraries....................................................... 4-3 Target Libraries............................................................ 4-3

Installing Under SMP/E........................................................ 4-4 Cartridge Contents and Format.............................................. 4-4 Major SMP/E Operations ................................................... 4-4

Overview of the Installation Steps ............................................... 4-5 Installation Steps .............................................................. 4-6

Step 1. Install CA Common Services ......................................... 4-7 Step 2. Review the System Requirements ..................................... 4-7 Step 3. Load the Installation Sample JCL...................................... 4-8 Step 4. Allocate the Target and Distribution Libraries.......................... 4-9 Step 5. Allocate and Mount HFS, and Create HFS Directories................... 4-9 Step 6. Allocate SMP/E Libraries and Define SMP Zones ..................... 4-10 Step 7. Customize the SMP JCL Procedures .................................. 4-10 Step 8: Initialize the SMP/E Environment................................... 4-11 Step 9. Execute the SMP/E RECEIVE Function............................... 4-11 Step 10. Execute the SMP/E APPLY Function ................................ 4-12 Step 11. Execute the SMP/E ACCEPT Function .............................. 4-12 Step 12. Run UCLIN....................................................... 4-12 Step 13. Copy the Modules to an APF Authorized Library..................... 4-13 Step 14. Load the SAS/C Runtime Library .................................. 4-13

iv Getting Started

01SPGTOC.doc, printed on 11/19/2004, at 2:12 PM

Step 15. Add the JCL Procedure ............................................ 4-14 Step 16. Enter the LMP Code ............................................... 4-16 Step 17. Add the VTAM Resource Number................................... 4-20 Step 18. Add the JES Initialization Parameters (Optional) ...................... 4-20 Step 19. Configure TCP/IP Setup ........................................... 4-21 Step 20. Allocate the Spool and Checkpoint Data Sets ......................... 4-22 Step 21. Assign Values to the Initialization Parameters ........................ 4-22 Step 22. Start Unicenter CA-Spool r11 for the First Time ....................... 4-23 Step 23. Verify the Installation .............................................. 4-24 Step 24. Run Post-Install Jobs as Required for Other Environments ............. 4-27 Step 25. Run Any Other Optional Jobs ....................................... 4-28

Chapter 5: Migration Considerations Initialization Statements ........................................................ 5-2

Added Initialization Statements.............................................. 5-2 Changed Initialization Statements............................................ 5-3 Deleted Initialization Statements ............................................. 5-3

New Macro Names ............................................................. 5-4

Index

Contents v

02SPGC01.doc, printed on 11/19/2004, at 2:14 PM

Chapter

1 Welcome

This guide introduces you to Unicenter® CA-Spool™ Print Management, referred to from now on as Unicenter CA-Spool. By the time you have finished reading this guide, you will have an overview of the wide scope of the product and its usability will be familiar to you. It is important to us that you feel comfortable with Unicenter CA-Spool before you begin to use it.

What is Unicenter CA-Spool? Unicenter CA-Spool is a completely independent spooling and print management system for the following types of printers: 3270, AFP, PCL, and PostScript-type SNA, TCP/IP and FSS connected printers. Unicenter CA-Spool provides all the facilities necessary to manage remote printing in a z/OS environment, creating a true enterprise-wide, single-image printing function. It offers powerful facilities for exchanging data between programs and platforms, and for spooling and printing in a multi-platform environment. It provides clients using VTAM, CICS, and IMS with enterprise-wide spooling and print capabilities.

Unicenter CA-Spool provides non-stop operation, thereby relieving the JES printing workload. It collects reports from multiple sources, including non-mainframe platforms (VSE, VM, OS/400, NetWare, Windows, and various UNIX flavors) for printing, viewing and storage into a single, centralized, secure report repository.

Welcome 1–1

What is Unicenter CA-Spool?


Consolidates Distributed Print Workload

Unicenter CA-Spool provides all the necessary facilities to consolidate your enterprise distributed print workload on to one Unicenter CA-Spool enterprise print server. You eliminate the hardware, software and administrative costs of distributed print servers by defining and managing all of your printing needs using Unicenter CA-Spool.

Self-Contained Subsystem

Unicenter CA-Spool operates as a self-contained subsystem under z/OS. It maintains its own checkpoint and spool datasets, which you can share with up to 32 members in a Parallel Sysplex. Unicenter CA-Spool is designed for non-stop operation without reorganizing the spool datasets. To simplify reprinting, you can retain processed print files for a specified period of time for the installation, the printer, or the individual file.

Distributed Control

Unicenter CA-Spool establishes distributed control by collecting users, printers, display terminals, and reports into logical network groups – independent of hardware. You are in total control of the printers and print files, while other parts of the network are invisible. Access to Unicenter CA-Spool is verified against your user ID. Security checks are provided at the network group, printer, file, and command levels. Internal/external security support is provided for RACF, eTrust™ CA-ACF2® Security, and eTrust™ CA-Top Secret®

Security.

1–2 Getting Started

What is Unicenter CA-Spool?


Unified Support for Printing

Unicenter CA-Spool provides unified support for printing of text, AFP, PCL, PostScript, and binary print files on VTAM-attached, FSS-attached, and TCP/IP-attached printers. You can print GDDM and SAS/GRAPH print files on VTAM-attached printers. Unicenter CA-Spool includes an Advanced Laser Printer interface for automatic formatting of text files with different fonts, layouts, and overlays. Unicenter CA-Spool includes a PSF Interface, which lets Unicenter CA-Spool act as the system spool for PSF, XPAF, and ida PSS.

Managed Printing Environment

Unicenter CA-Spool allows you to manage your own printing environment using a Unicenter CA-Spool Menu system available under TSO, ISPF, CICS, IMS, VTAM, Natural, Advantage™ CA-IDMS®/DC, Advantage™ CA-Roscoe®, and VM/CMS. This reduces the load on the Help Desk. The Menu system improves your productivity through on-demand report creation and printing, and allows you to reprint all or a portion of a print file. The Unicenter CA-Spool Menu system provides online viewing of reports, allowing immediate access to needed information and reducing the use of printed paper.

NJE Interface

You can send Unicenter CA-Spool print files to other NJE supporting spool systems using the NJE Interface, to Unicenter® CA-View® Output Archival and Viewing (Unicenter CA-View) for data collection, backup and archive using the Unicenter CA-View Interface, and to Unicenter® Output Management Document Viewer (Unicenter OM Document Viewer) from the Unicenter CA-Spool Menu system.

Welcome 1–3

CA Technology Services: Delivering Business Value On Your Terms


CA Technology Services: Delivering Business Value On Your Terms

CA Technology Services is a global organization of highly trained, experienced professionals who are determined to provide you with the technical expertise you need, when and how you need it. From implementing a CA solution to helping you get the most out of the CA technology that you have, CA Technology Services is committed to delivering business value to you on your terms.

Our professionals understand your unique business needs and work closely with you to assess which technology is right for your business. Whether the assignment is large or small or you need a custom, stand-alone, or packaged solution, we tailor our efforts to meet your business demands.

By offering a broad range of flexible services, we help you maximize your investment in our technology, achieve more efficient IT performance, and better manage your infrastructure, security, storage, applications, and data. Such flexibility ensures that you reach your time-to-market goals while improving your business performance.

Why not ask your CA representative for more information about how a CA Technology Services professional can help your organization get the most out of your CA business solutions?


CA Education Services: Ready When You Are


CA Education Services: Ready When You Are The goal of CA Education Services is to help you realize the full potential of your CA software investment. To meet this goal, our high-quality instructors strive to understand your specific training requirements, and then deliver the right kind of training when, where, and how you need it.

All CA instructors are fully certified and offer a wealth of hands-on enterprise management experience gained in working with today’s largest and most complex businesses. Whether your training is web-based, self-paced, or in the traditional classroom, you always receive the most up-to-date instruction and expertise that is available. The knowledge you gain through training prepares you to successfully leverage the capabilities of your CA software.

Why not ask your CA representative how our training and education programs can help you get more out of your CA business solutions?

Welcome 1–5

Computer Associates: Commitment, Quality, Innovation


Computer Associates: Commitment, Quality, Innovation

For more than a quarter century, CA has been developing and supporting software solutions that are currently used by more than 99 percent of the Fortune 500 companies in more than 100 countries. CA is committed to offering leading technologies in flexible partnerships to help you derive full value from your software investments.

At Computer Associates, we are committed to offering simple and meaningful solutions to your complex problems, and to delivering management solutions that offer security, reliability, availability, and performance. We work hard to achieve the highest levels of quality in our solutions to help you meet your changing business needs.

To meet these needs, CA’s world-class solutions address all aspects of process management, information management, and infrastructure management with six focus areas:

■ Enterprise management

■ Security

■ Storage

■ Portal and business intelligence

■ Database management

■ Application life cycle management and application development

In addition, our innovative approach to technology is carried over into our innovative business solutions. From a revolutionary new business model to a dedicated customer relationship organization, CA is responding to your changing business needs.


For More Information

02SPGC01.doc, printed on 11/27/2004, at 10:31 AM

We know what it takes to deliver and support valuable solutions 24 hours a day, 7 days a week, 365 days a year while maintaining the highest standards for quality and innovation:

■ We are the first global enterprise software company to meet the exacting standards for worldwide ISO 9002 certification.

■ We have earned over 150 patents for innovative software solutions.

■ We have the highest caliber software developers and consultants in the industry.

We also know you expect us to stand by our commitments. And we do.

For More Information After reading this Getting Started, you can refer to the numerous resources available to you for additional information. Your product cartridge contains instructional documents that showcase your software and provide detailed explanations about the product’s comprehensive, feature-rich components.

If you need technical assistance with this product, access the Computer Associates web site, ca.com, where you can quickly locate answers to many questions. Technical support is available 24 hours a day, 7 days a week.

For Frequently Asked Questions, look on the Unicenter CA-Spool SupportConnect website, under Technical Document Index.

Welcome 1–7


Chapter

2 Basic Concepts and Features

Unicenter CA-Spool is a comprehensive, flexible print spooling subsystem for IBM mainframe MVS environments, which normally use JES2 or JES3 as the primary spooling system. Unicenter CA-Spool is a powerful extension of JES2 or JES3, although it operates completely independently. Changes or updates to JES never affect Unicenter CA-Spool. Job output distribution to decentralized printer devices is facilitated and no changes are required to existing applications.

Unicenter CA-Spool operates as the general spooling system for VTAM-, FSS- and TCP/IP-attached printers.

Concepts Printer devices, spool files, and display terminals are formed into logical units, called network groups. Unicenter CA-Spool implements full user-controlled operation from within the user’s local environment. Unicenter CA-Spool provides:

■ User control

■ Enterprise printing

■ System interfaces

■ Functionality

Basic Concepts and Features 2–1

Concepts


User Control

Unicenter CA-Spool provides full end-user control of the printing process in environments that employ 3270-type printers. It effectively offers the same facilities to users that JES2 or JES3 gives to the central site operator in a traditional mainframe printing environment.

Unicenter CA-Spool also allows users to control their local environments in much the same way as the system operator controls centralized printing.

Enterprise Printing

Unicenter CA-Spool totally facilitates the management of all remote printing in MVS environments, and creates a true enterprise-wide, single-image printing function.

System Interfaces

Unicenter CA-Spool interfaces with three entities:

■ Primary spooling system (JES2 or JES3)

■ VTAM control program

■ Operating system


Concepts


Functions

Unicenter CA-Spool performs the following functions:

■ Creates, controls, and processes spool files from online terminals connected to VTAM

Specially coded application programs can use the Advanced Communication Interface.

■ Provides interfaces to allow application programs to retrieve files, obtain file status, route files, purge files, and enter operator commands

These interfaces are mainly of interest to application programmers.

■ Routes spool files as follows:

– To local and remote printers

– To and from the primary JES system

– To and from NJE nodes

The network interface is the link between Unicenter CA-Spool and the network groups. Unicenter CA-Spool uses this interface to communicate with printers and display terminals.

Basic Concepts and Features 2–3

Concepts


Structure

The following illustration shows how Unicenter CA-Spool is related to the other system components in an IBM z/OS environment.



Chapter

3 Software and System Requirements

This chapter discusses the software and system requirements you will need before you can install Unicenter CA-Spool r11.

Software Requirements Unicenter CA-Spool supports the following software environment:

■ 5694-A01 IBM z/OS V1R2 or higher, which includes both VTAM and TCP/IP support in the base product.

(Optional) Unicenter® TCPaccess™ Communications Server (from now on called Unicenter TCPaccess) 6.0 (or higher).

System Requirements The following are software prerequisites for Unicenter CA-Spool:

■ CA Common Services for z/OS (for CA LMP)

■ SAS/C 7.50 (or higher) Runtime Library included on the Unicenter CA-Spool r11 installation tape

■ z/OS UNIX System Services running in full function mode

Software and System Requirements 3–1

System Requirements


SAS/C Runtime Library

The SAS/C Runtime Library is distributed on the Unicenter CA-Spool installation tape. This software might already be installed at your site.

CA Common Services

If CA Common Services has not been installed on your system, you must install it before proceeding with this installation. See your cover letter and the CA-Common Services Installation and Maintenance Guide for detailed instructions.

The CA License Management Program (CA LMP) is a standardized, automated approach to the tracking of licensed software that uses common realtime enforcement software to validate the user‘s configuration. CA LMP reports on activities related to the license, usage, and financial activity of program solutions. CA LMP features include the following:

■ A common key data set that can be shared among many CPUs

■ The use of “check digits“ to detect errors in transcribing key information

■ Execution keys that can be entered without affecting any Computer Associates software solution already running

■ No special maintenance requirements

z/OS UNIX System Services

The Unicenter CA-Spool installation process creates some HFS files. To be able to do this, z/OS UNIX System Services running in full function mode is a prerequisite.



Chapter

4 Installation

This chapter discusses guidelines for installing Unicenter CA-Spool, discusses the materials and resources necessary before you can begin the installation, then gives you detailed steps on how to install the product using SMP/E.

Parallel Installation We recommend that you install a new Unicenter CA-Spool release so that it runs in parallel with any previous release. This allows your site to maintain normal operations with a previous release, while verifying the latest release.

If you already have a running version of Unicenter CA-Spool, this new version can be installed to run in parallel by renaming some of the load modules.

This installation process effectively makes Unicenter CA-Spool load the common storage modules (that is, load modules) into CSA. The alternative is to have these modules loaded into LPA instead. For more information, see the Common Storage Modules section in the "Customization" chapter of the Customization Guide.

Installation is normally performed in three stages:

1. Do an SMP/E installation. SMP/E installs source, macros and modules, builds the CAILIB data set, and controls fixes and usermods.

Installation 4–1

Installation Materials


2. Install Unicenter CA-Spool into the operating system and the network. This updates the MVS, JES, and VTAM parameter data sets, and copies load modules to the linklist.

3. Verify that a successful installation was performed.

Disk space

Installation of Unicenter CA-Spool requires about 40 MB disk storage including 20 MB disk storage for the Unicenter CA-Spool distribution data sets, and about 20 MB for the test Unicenter CA-Spool spool and checkpoint data sets.

Installation Materials Computer Associates provides the following materials for installing and using Unicenter CA-Spool.

■ A standard 3480 label magnetic cartridge (DCB=DEN=4) containing Unicenter CA-Spool. The Volume Serial number is IQyymm. The cartridge contents are as follows:

– DSN=CAI.SAMPJCL (File number 9)—This is an unloaded PDS containing all of the sample JCL referred to in this document that pertains to the installation of Unicenter CA-Spool.

– DSN=SMPMCS (File number 32)—This file contains SMP/E control statements for installing Unicenter CA-Spool.

Note: Files beyond 32 are the SMP RELFILES that SMP downloads to disk during RECEIVE processing.

■ Documentation that explains how to use, install, customize, and maintain Unicenter CA-Spool.


Resource Requirements


Resource Requirements The following sections describe the libraries used by Unicenter CA-Spool and provide space requirement estimates.

Distribution Libraries Use the following table to estimate disk space for the distribution libraries that are needed to install Unicenter CA-Spool.

Library Name Blksize Blocks Dir. Blks. Description

CAI.ESF.CIQB0BLD 6144 800 70 Binary library

CAI.ESF.CIQB0LLD 6144 1260 70 Load library

CAI.ESF.CIQB0MLD 3120 1755 70 Macro library

CAI.ESF.CIQB0SLD 3120 1755 70 Source library

CAI.LPD.CLPB0LLD 6144 1800 300 Load library

CAI.LPD.CLPB0MLD 3120 1500 60 Macro library

Target Libraries

Note: Allocate these libraries only if they do not already exist.

Use the following table to estimate disk space for the target libraries that are needed to install Unicenter CA-Spool.


CAI.CAILIB 6144 1360 70 Load library

CAI.CAIPROC 3120 20 50 Sample proclib

CAI.CAIMAC 3120 1755 70 Macro library

CAI.CAISRC 3120 1755 70 Source library

CAI.CAIISPP 3120 150 50 Panel library

Installation 4–3

Installing Under SMP/E



CAI.PPOPTION 3120 465 25 Options library

CAI.CAICLIB 3120 60 5 Clist library

/usr/lpp/caspool - - - HFS directory

Installing Under SMP/E The following sections describe the installation cartridge, and RECEIVE, APPLY, and ACCEPT, the primary SMP/E operations that must be performed.

Cartridge Contents and Format

The machine-readable program materials required for installation are distributed as a multi-file installation cartridge in SMP format (see Installation Materials in this chapter). This cartridge contains all the necessary data to install and execute Unicenter CA-Spool.

Use the IBM-supplied SMP/E to install, customize, and maintain Unicenter CA-Spool. This program lets you control these activities in a consistent manner.

Major SMP/E Operations

RECEIVE, APPLY, and ACCEPT are the three major operations that are performed by SMP/E when a product is being installed or maintained. These operations manage a structure wherein a given product is present in two places: distribution libraries and target system libraries.

The distribution libraries are used for maintenance operations only. The product executes from the target system libraries.


Overview of the Installation Steps


The operations performed are as follows:

RECEIVE processing The installation cartridge is loaded by SMP into temporary data sets. If any error is detected, or if you want to stop the process at this point, you can run a REJECT operation, which reverses any actions performed during RECEIVE processing.

APPLY processing During APPLY processing, SMP performs the operations dictated by the modification control statements (MCS), and updates the target system libraries. The user can then test the modification. If the installation is to be aborted at this point, a RESTORE operation can be run to restore the system libraries from the distribution libraries.

ACCEPT processing When the ACCEPT operation is run, the modification is permanently placed in the distribution libraries.

Overview of the Installation Steps Unicenter CA-Spool is installed using SMP/E. This section provides an overview of the tasks that are accomplished as you perform each step:

Installation steps Steps 1 through 23 install and verify the installation of Unicenter CA-Spool into your z/OS environment.

The post-installation jobs Step 24 suggests jobs that update SMP/E with the information that a foreign job is present.

Optional other jobs Step 25 suggests additional jobs that you might have to run, based on the needs of your site.

Installation 4–5

Installation Steps


Installation Steps The following list summarizes the steps involved in the Unicenter CA-Spool installation process. Review this list before attempting to install Unicenter CA-Spool, then use it as a checklist during the actual installation process.

1. Install CA Common Services.

2. Review the software and resource requirements described earlier in this chapter.

3. Load the installation sample JCL.

4. Allocate the target and distribution libraries.

5. Allocate and mount HFS, and create HFS directories.

6. Allocate SMP/E libraries and define SMP zones.

7. Customize the SMP JCL procedures using the IQB0SMPE member.

8. Initialize the SMP/E Environment.

9. Execute the SMP/E RECEIVE function.

10. Execute the SMP/E APPLY function.

11. Execute the SMP/E ACCEPT function.

12. Run UCLIN.

13. Run IQB0CAPF to copy and rename some of the load modules to a linklist library.

14. Load the SAS/C Runtime library.

15. Add the Unicenter CA-Spool JCL procedure.

16. Enter the LMP Code.

17. Add the VTAM resource number.

18. Add the JES parameters to the initialization parameter deck.

19. Configure TCP/IP setup.

20. Allocate the spool and checkpoint data sets.

21. Assign values to the initialization parameters.


Installation Steps


22. Start Unicenter CA-Spool r11 for the first time.

23. Verify the Installation.

24. Run any post-installation jobs required by your environment.

25. Run any optional other jobs you might need.

Important! You must perform each of the following installation steps completely and in order before you configure Unicenter CA-Spool.

Step 1. Install CA Common Services

If all of the CA Common Services have been installed at your site, you can skip this step.

If CA Common Services has not been installed, be aware that it is delivered separately and the documented prerequisite components (genlevel 9409 or higher) must be installed before you continue with the installation or attempt to execute Unicenter CA-Spool. CA Common Services includes the following components:

■ CAIRIM

■ CA-LMP code

Installation of CA Common Services is a standard SMP procedure; see the CA Common Services Getting Started for more information.

Step 2. Review the System Requirements

Be sure that your system meets all requirements listed in the “Software and System Requirements” chapter, and in the Resource Requirements section, earlier in this chapter.

Installation 4–7

Installation Steps


Step 3. Load the Installation Sample JCL

Unicenter CA-Spool installs through SMP/E. The product cartridge received with this package contains all of the data necessary to install and execute Unicenter CA-Spool.

Before you install the product, load the sample JCL library. This is the ninth file on the cartridge (DSN=CAI.SAMPJCL) and it is in IEBCOPY unloaded format.

Use the following JCL as a model to load the sample JCL library to DASD.

//LOAD EXEC PGM=IEBCOPY //SYSPRINT DD SYSOUT=A //SYSUT1 DD DISP=(OLD,KEEP), // DSN=CAI.SAMPJCL, // UNIT=CART, <=== generic 3480 cartridge // VOL=SER=IQyymm, // LABEL=(9,SL), // DCB=DEN=4 //SYSUT2 DD DISP=(NEW,CATLG,DELETE), // DSN=CAI.ESF.SAMPJCL, <=== your DSN // UNIT=SYSDA, <=== your generic DASD // VOL=SER=xxxxxx, <=== permanent DASD volser // SPACE=(3120,(150,10,30)), <=== minimum space required // DCB=(LRECL=80,BLKSIZE=3120,RECFM=FB) //SYSUT3 DD UNIT=SYSDA, // SPACE=(TRK,(5,5)) //SYSUT4 DD UNIT=SYSDA, // SPACE=(TRK,(5,5)) //SYSIN DD DUMMY

When this job ends, your library contains all of the JCL needed to complete the SMP portion of the Unicenter CA-Spool installation. All of the other installation members can be found in the CAI.PPOPTION target library.

You must tailor the JCL to meet your data center’s requirements; do this as you execute the steps on the following pages.


Installation Steps


Step 4. Allocate the Target and Distribution Libraries

Member IQB0ALC allocates all of the target and distribution libraries required by Unicenter CA-Spool during installation and maintenance.

Edit the JCL to conform to the installation standards of your site. However, do not change any of the ddnames or the last qualifier of the data set names.

All library space allocations supplied in member IQB0ALC are in blocks to allow for compatibility between DASD types. The allocations listed are the minimum required for installing Unicenter CA-Spool; you can adjust them for your installation device types and to allow enough free space for maintenance. The more free space you allocate, the less often compression occurs during maintenance.

Submit member IQB0ALC and review the output.

Step 5. Allocate and Mount HFS, and Create HFS Directories

Member IQB0HFS allocates and mounts the Unicenter CA-Spool HFS, and creates target HFS directories required by Unicenter CA-Spool during installation and maintenance.

We recommend that these directories and files not be included as part of a Network File System (NFS).

The HFS need to be mounted Read/Write during the rest of the installation.

This is a good time to update your BPXPRMxx member to include the mount points, so subsequent IPLs will mount the HFS automatically.

Installation 4–9

Installation Steps


The default HFS directories are named /usr/lpp/caspool and /usr/lpp/caspool/images. If these names are changed, the corresponding CAIHFS and CAIHFSBN allocations in member IQB0SMPE/CAIIQB0 also have to be changed.

Note: The IQB0HFS job should be run with a userid which is allowed to mount a file system.

Submit member IQB0HFS and review the output.

Step 6. Allocate SMP/E Libraries and Define SMP Zones

For first-time users of Computer Associates products, define the Computer Associates SMP data sets using sample JCL member CAINITE5 for SMP/E Release 1.5 or higher.

Allocate and Initialize Base SMP Libraries

Member CAINITE5 can be used to allocate and initialize a set of private SMP data sets for all Computer Associates products. We recommend that you keep Computer Associates products as distinct entities from other SMP data sets. These members also set up CAI global, target, and distribution zones for Computer Associates products. If this job completes with a return code greater than 4, correct the problem and resubmit.

Note: Supply the correct data set names of the CALLLIBS required for r11 on the DDDEF statements in the UCLIN.

Step 7. Customize the SMP JCL Procedures Locate the model JCL procedure IQB0SMPE in the sample install JCL library.

Edit the procedure to conform to the installation standards of your site. This procedure can be placed into a system or user procedure library with member name CAIIQB0, or it can be executed instream. CAIIQB0 is used in the following SMP/E RECEIVE, APPLY, and ACCEPT steps.


Installation Steps


Step 8. Initialize the SMP/E Environment

If new SMP libraries have been created with CAINITE5 for this installation, skip this step and go to step 9.

Execute this step if Unicenter CA-Spool r11 will be installed in a shared CSI with other CA products, or into a CSI that has contained previous releases of Unicenter CA-Spool.

SAMPJCL member IQB0INIT allocates an SMPLTS data set, and defines required CALLLIBS for Unicenter CA-Spool r11.

Read the comments in member IQB0INIT to determine which steps relate to your environment, and edit the JCL to conform to your installation standards.

Step 9. Execute the SMP/E RECEIVE Function

Member IQB0REC RECEIVEs all the components (functional SYSMODs) of Unicenter CA-Spool, and executes the procedure edited in Step 8. Customize the SMP JCL Procedure.

Note: The Unicenter CA-Spool installation cartridge is used as input for this step.

1. Edit the JCL to conform to the installation standards of your site.

2. Submit the job and review the output to Unicenter CA-Spool to verify that the RECEIVE processing ran successfully. If RECEIVE completed with an SMP return code greater than 0, review the output, correct the problem, then resubmit the job.

Installation 4–11

Installation Steps


Step 10. Execute the SMP/E APPLY Function

Member IQB0APP APPLYs all the components (functional SYSMODs) of Unicenter CA-Spool to the target libraries.

Important! APPLYING the Unicenter CA-Spool r11 SYSMODS will delete any prior releases of Unicenter CA-Spool components from the target and distribution libraries that exist in the same SMP/E CSI.


2. Submit the job and review the output to verify that the APPLY processing ran successfully. If the APPLY completed with an SMP return code greater than 4, review the output, correct the job, and resubmit the job.

Step 11. Execute the SMP/E ACCEPT Function

Member IQB0ACC ACCEPTs all the components (functional SYSMODs) of Unicenter CA-Spool to the distribution libraries.


2. Submit the job and review the output to verify that the ACCEPT processing ran successfully. If ACCEPT completed with an SMP return code greater than 4, view the output, correct the problem, then resubmit the job.

Important! We strongly recommend that you ACCEPT the Unicenter CA-Spool product immediately after you have successfully run the APPLY. This ACCEPT step provides a backup of the base product on the distribution libraries. This backup is necessary for future SMP RESTOREs.

Step 12. Run UCLIN

SAMPJCL member IQB0IUCL updates SMP/E with information about the relationship between source and macros. A return code of 04 is acceptable.


Installation Steps


Step 13. Copy the Modules to an APF Authorized Library

Run SAMPJCL member IQB0CAPF.

This job copies and renames some of the Unicenter CA-Spool load modules to a linklist library. Note that the library must be authorized, either by specifying LNKAUTH=LNKLST in the SYS1.PARMLIB member IEASYS00, or by APF authorizing the library. Issue the F LLA,REFRESH command after this job has run.

Alternatively, you can make the Unicenter CA-Spool CAILIB library APF authorized, and add it to the STEPLIB in the Unicenter CA-Spool JCL procedure.

This job is self-documenting. Be sure to adjust the JCL deck to your site's standards and assign proper values to various installation-dependent parameters.

Step 14. Load the SAS/C Runtime Library

Member IQB0SASC restores the SAS/C Runtime library file 13 from the installation cartridge.

Note: The Unicenter CA-Spool installation cartridge is used as input for this step.

Installation 4–13

Installation Steps


Step 15. Add the JCL Procedure

The CAI Common Procedure library (CAIPROC) contains all the procedures relevant to Unicenter CA-Spool. These procedures were placed in this library during SMP APPLY processing.

Edit each JCL procedure to conform to your site's installation standards.

After completing these modifications, you can do either of the following:

■ Copy the procedures into a PROCLIB of your choice.

■ Copy the following procedure into the CAI common procedure library (CAIPROC) which can be added to the system PROCLIB concatenations.

//CAIQPOOL PROC MEMBER=CAIQPARM * INITIALIZATION PARMS // CAILIB='CAI.SPOOL.CAILIB', * CA-SPOOL LOAD LIB // SASCLIB='SASC750.RUNTIME', * SASC RUNTIME LIBRARY // OPTLIB='CAI.PPOPTION'. * OPTION CARD LIBRARY // OPTION=WARM * STARTUP OPTION ************************************************************************ //* THE FOLLOWING DD IS REQUIRED IF USING CA-SPOOL IN CONJUNCTION * //* WITH CA-VIEW * //* * //* VIEWLIB='CAI.VIEW.CAILIB * //* TAILOR THE IMAGELIB DD STATEMENT BELOW TO ALLOCATE YOUR SITE'S * //* IMAGELIB. BE SURE TO UNCOMMENT THE DD STATEMENT. * //* * //* TAILOR THE SYSTCPD DD STATEMENT BELOW TO ALLOCATE YOUR SITE'S * //* TCPIP DATA DATASET. BE SURE TO UNCOMMENT THE DD STATEMENT. * //* * //* TAILOR THE PJLLIB DD STATEMENT BELOW TO ALLOCATE YOUR SITE'S * //* PJL RESOURCE LIBRARY. BE SURE TO UNCOMMENT THE DD STATEMENT. * //* * //* TAILOR THE PCLLIB DD STATEMENT BELOW TO ALLOCATE YOUR SITE'S * //* PCL RESOURCE LIBRARY. BE SURE TO UNCOMMENT THE DD STATEMENT. * //* * //* TAILOR THE BINLIB DD STATEMENT BELOW TO ALLOCATE YOUR SITE'S * //* BINARY RESOURCE LIBRARY. BE SURE TO UNCOMMENT THE DD STATEMENT. * //* * //* TAILOR THE OVLYLIB DD STATEMENT BELOW TO ALLOCATE YOUR SITE'S * //* OVERLAY RESOURCE LIBRARY. BE SURE TO UNCOMMENT THE DD STATEMENT * //* * ************************************************************************ //IEFPROC EXEC PGM=ESFMAIN,TIME=1440,REGION=0M, PARM=&OPTION //STEPLIB DD DISP=SHR,DSN=&CAILIB, // DD DISP=SHR,DSN=&SASCLIB //* DD DISP=SHR,DSN=&VIEWLIB


Installation Steps


//ESFPARM DD DISP=SHR,DSN=&OPTLIB(&MEMBER) //ESFLIST DD SYSOUT=*,OUTLIM=0 //SYSTERM DD DUMMY //SYMDUMP DD DUMMY //*NJESNAP DD SYSOUT=* //*SAPISNAP DD SYSOUT=* //*SECUSNAP DD SYSOUT=* //*IMAGELIB DD DISP=SHR,DSN=**YOUR**.IMAGELIB //*SYSTCPD DD DISP=SHR,DSN=**YOUR**.TCPIP.DATA.FILE //*PJLLIB DD DISP=SHR,DSN=**YOUR**.PJL.RESOURCE.LIBRARY //*PCLLIB DD DISP=SHR,DSN=**YOUR**.PCL.RESOURCE.LIBRARY //*BINLIB DD DISP=SHR,DSN=**YOUR**.BIN.RESOURCE.LIBRARY //*OVLYLIB DD DISP=SHR,DSN=**YOUR**.OVLY.RESOURCE.LIBRARY

Standard Data Sets

The standard Unicenter CA-Spool data sets are as follows:

STEPLIB Points to the Unicenter CA-Spool load library and the SAS/C runtime library.

Note: If the direct interface to Unicenter CA-View is used, or the Advantage CA-Roscoe menu interface is used, the load libraries from these products must also be included in the steplib or in linklist and be APF authorized.

ESFPARM Points to the Unicenter CA-Spool initialization parameter file.

ESFLIST The Unicenter CA-Spool initialization parameters are listed here if PARM=LIST was specified when the task was started.

SYSTERM Points to the SAS/C error message file. Activate this DD when necessary for debugging.

SYMDUMP Used in conjunction with the CA-SymDump System for abend debugging.

NJESNAP Points to the NJE trace file.

SAPISNAP Points to the SAPI trace file.

Installation 4–15

Installation Steps


SECUSNAP Points to the security trace file.

IMAGELIB Points to the system image library.

SYSTCPD Points to the optional TCPIP.DATA file.

PJLLIB Points to the PJL resource library.

PCLLIB Points to the PCL resource library.

BINLIB Points to the binary resource library.

OVLYLIB Points to the OVLY resource library.

Step 16. Enter the LMP Code

Unicenter CA-Spool requires CA LMP (License Management Program), one of the CA Common services, in order to initialize correctly. CA LMP provides a standardized, automated approach to the tracking of licensed software. Examine the CA LMP Key Certificate you received with your installation cartridge.

The LMP Key Certificate

Your LMP key certificate contains the following information:

Product Name The trademark or registered name of the copy of Unicenter CA-Spool licensed for the designated site and CPUs.

Supplement The reference number of your license for the particular Unicenter CA-Spool, in the format nnnnnn nnn. This format differs slightly outside North America and, in some cases, might not be provided at all.


Installation Steps


Expiration Date The date (month dd, yyyy as in OCTOBER 21, 2004) that your license expires for the installation and maintenance of the designated Unicenter CA-Spool.

Technical Contact The name of the technical contact at your site who is responsible for Unicenter CA-Spool installation and maintenance; this is the person to whom Computer Associates addresses all CA LMP correspondence.

MIS Director The name of the Director of MIS or the person who performs MIS functions at your site. If the title, but not the individual’s name, is indicated on the Certificate, you should supply the actual name when correcting and verifying the Certificate.

CPU Location The address of the building where the CPU is installed. CA LMP is provided as an integral part of CAIRIM, another of the CA Common Services benefits.

Execution Key An encrypted code required by CA LMP for Unicenter CA-Spool initialization, referred to as the LMP Code during installation.

Product Code A two-character code that corresponds to Unicenter CA-Spool.

CPU ID The code that identifies the specific CPU for which installation of your Unicenter CA-Spool is valid.

Installation 4–17

Installation Steps


Defining the CA LMP Execution Key

To define a CA LMP execution key to the CAIRIM parameters, modify member KEYS in the OPTLIB data set.

The parameter structure for member KEYS is presented below: PROD(pp) DATE(ddmmmyy) CPU(tttt-mmmm/ssssss) LMPCODE(kkkkkkkkkkkkkkkk)

where:

pp (Required) Specifies the two-character product code. For any given CA LMP software solution, this code agrees with the product code already in use by the CAIRIM initialization parameters for earlier genlevels of Unicenter CA-Spool.

Ddmmmyy (Required) Specifies the CA LMP licensing agreement expiration date.

tttt-mmmm (Required) Specifies the CPU type and model (for example, 3090-600) on which the CA LMP software solution is to run. If the CPU type, model, or both require fewer than four characters, insert blank spaces for the unused characters.

ssssss (Required) Specifies the serial number of the CPU on which the CA LMP software solution is to run.

kkkkkkkkkkkkk (Required) Specifies the execution key needed to run the CA LMP software solution. This CA LMP execution key is provided on the Key Certificate shipped with each CA LMP software solution.

The following example shows a control card for the CA LMP execution software parameter. Note that this CA LMP execution key is invalid and is provided as an example only. PROD(VA) DATE(01JAN04) CPU(3090-600 /370623) LMPCODE(52H2K06130Z7RZD6)


Installation Steps


LMP Codes

The Unicenter CA-Spool LMP product codes:

OA Unicenter CA-Spool Base Product

OB Unicenter CA-Spool Advanced Laser Printer option

OC Unicenter CA-Spool NATURAL Interface option

OD Unicenter CA-Spool NJE Interface option

OE Unicenter CA-Spool PC-File Transfer option

OF Unicenter CA-Spool PSF Interface option

OG Unicenter CA-Spool VPI Interface option

OH Unicenter CA-Spool VM/CMS Menu System option

JT Unicenter CA-Spool MAS Interface option

OI Unicenter CA-Spool Package (Unicenter CA-Spool Base and all the above options)

JX Unicenter CA-Spool AFP to PCL Transformer option

J1 Unicenter CA-Spool AFP to PostScript Transformer option

Installation 4–19

Installation Steps


Step 17. Add the VTAM Resource Number

Run job IQB0VTAM to add the special Unicenter CA-Spool VTAM resource definition member APPLESF to SYS1.VTAMLST

This member only contains the definition of the VTAM application ESF.


Step 18. Add the JES Initialization Parameters (Optional)

Note: This step is optional.

Run one of the following jobs, depending on which version of JES you are running, and how your JES system is configured:

IQB0JES2 If JES2 is configured with DESTDEF NODENAME= OPTIONAL, which is the JES2 default, there is no need to define the destination ESF to JES2, and this step can be skipped.

If JES2 is configured with DESTDEF NODENAME= REQUIRED, run this job to add the destination identifier ESF to the JES2 initialization parameter deck (JES2PARM) and associate an unused local JES2 route code.

Note: You can also define the destination ESF with a JES2 $ADD command, as follows: $ADD DESTID(ESF),DEST=Unnn

where Unnn must specify an unused local JES2 route code.

IQB0JES3 This job adds the destination identifier ESF to the JES3 initialization-parameter deck (JES3IN).


Installation Steps


Unless it was added dynamically, JES2 or JES3 has to be restarted to make the destination ESF known. The Automatic File Transfer interface JESTOESF cannot be used until the destination is known to JES, but all the remaining Unicenter CA-Spool facilities will function.


Step 19. Configure TCP/IP Setup

Configuring the TCP/IP setup requires an OMVS segment and specific Unicenter TCPaccess considerations.

OMVS Segment

To use the Unicenter CA-Spool TCP/IP interfaces, the Unicenter CA-Spool started task User ID must have an OMVS segment assigned. Contact your security administrator to have an OMVS segment defined for your Unicenter CA-Spool user ID.

Unicenter TCPaccess

Be aware of the following Unicenter TCPaccess considerations:

The default subsystem name (SUBID) for Unicenter TCPaccess is ACSS. Specify the following in ESFLPRP in CAISRC: ICS:SUBSYS=xxxx

where xxxx is the subsystem name (SUBID) for Unicenter TCPaccess. Note that this has to be applied using the usermod process. For more information, see the ESFLPRP section in the “Customization” chapter of the Customization Guide.

Installation 4–21

Installation Steps


Step 20. Allocate the Spool and Checkpoint Data Sets

Run the IQB0ALOC job to allocate the Unicenter CA-Spool spool and checkpoint data sets onto any type of disk storage.


Step 21. Assign Values to the Initialization Parameters

Assign suitable values to a few initialization parameters in the member CAIQPARM in PPOPTION. Define a test network group containing printer nodes and user IDs, and for internal security, the user IDs should also be defined.

SVCCODE

The SVCCODE statement specifies the user SVC number used by Unicenter CA-Spool. The system administrator responsible for the MVS system must decide which unused Type 4 SVC number to use.

During startup Unicenter CA-Spool verifies if the specified SVC number in the SVC table points to a valid SVC routine.

If the SVC table entry corresponding to the specified SVC number is not in use, Unicenter CA-Spool dynamically loads the SVC routine module, specified through the SVC parameter on the MODULES statement, into the CSA and updates the SVC table entry to point to it.



Installation Steps


Step 22. Start Unicenter CA-Spool r11 for the First Time

Start the Unicenter CA-Spool r11 system for the first time as follows:

1. Enter the following command to activate the Unicenter CA-Spool VTAM resource: V NET,ACT,ID=APPLESF

2. Perform the following to start the system:

a. Enter the following MVS start command on the MVS operator console: S procname

where procname is the member name of the Unicenter CA-Spool proc in your system procedure library.

b. Unicenter CA-Spool prompts you for initialization options with the following WTOR message: *xx ESF000 SPECIFY OPTIONS FOR ESF r11

c. To format all the spool data sets, enter: R xx,FORMAT

d. The following WTOR message asks you to confirm that the checkpoint data set should be overwritten: *yy - ESF053 REPLY Y OR N TO CONFIRM CHECKPOINT RECORD CHANGE

e. To confirm, enter: R yy,Y

f. Unicenter CA-Spool displays initialization progress with the following WTO messages: -ESF059 CHKPTDS1 COLD-START IS IN PROGRESS -ESF024 FORMATTING VOLUME=vvvvvv DSN=dddddddd.ssssssss.nnnnnnnn -ESF041 INTERNAL TRACE REQUESTED, 512 ENTRIES ALLOCATED -ESF100 SIMPLE COLD START COMPLETED -ESF301 VIRTUAL PRINTER INTERFACE STARTED -ESF490 NETWORK INTERFACE STARTED

3. The message NETWORK INTERFACE STARTED confirms a successful initialization.

Installation 4–23

Installation Steps


4. As a quick check, enter the following display-status command from the MVS operator console: -DS

Unicenter CA-Spool responds by writing the following messages to the MVS console: -ESF809 VERSION.LEVEL CA-Spool r11 (9999) -ESF816 0 OUTSTANDING I/O-REQUESTS -ESF817 OPEN FILE COUNT: 0/ 0 OUTPUT, 0/ 0 INPUT -ESF818 0 % SPOOL UTILIZATION -ESF820 0 FILE QUEUE ELEMENTS IN USE - TOTAL 500 -ESF823 VTAM ACB OPEN - LOGONS ENABLED -ESF865 NO ACTIVE COMMUNICATION CHANNELS -ESF318 VPS 10( 0) ACB(S) 0( 0) STG( 9K) -ESF827 SAR INTERFACE IS NOT ACTIVE -ESF878 Transformer Interface is not active -ESF886 LPD Interface is not active -ESF885 A(ESFSSSM)=X'06DAA730' A(ESFUSS)=X'099CC6F0'

If there are no errors, you can proceed to the Verify the Installation step.

Step 23. Verify the Installation

This section contains information that lets you verify that both the basic system and optional features are correctly installed.

The name of the modules used might start with EB0 instead of ESF. This depends on what was decided in the IQB0CAPF job.

The SAMPJCL library includes some sample test jobs. These jobs are self-documenting but each job should be adjusted to your local JCL standards.

Note: The Unicenter CA-Spool loadlib must be available to the user’s session in linklist or STEPLIB to complete some of the following steps.


Installation Steps


Basic System Verification

Verification of the basic system normally includes these steps:

1. To operate from a 3270 display terminal, first log on through VTAM. To start a session, enter the logon APPLID. For example: LOGON APPLID(ESF)

a. Unicenter CA-Spool prompts for a user ID and password. Enter the userid and password which is specified in CAIQPARM.

b. When the session is successfully established, Unicenter CA-Spool formats the screen into a message-output area and a command-entry area.

c. You can enter the display-file command. For example: DF

Unicenter CA-Spool responds to the display-file command with the message: ESF840 QUEUE EMPTY

2. Run the supplied sample job IVP2PRNT to test the ESFPRINT utility in batch mode, to generate the first Unicenter CA-Spool file.

After the job has terminated, start the specified Unicenter CA-Spool printer. Unicenter CA-Spool starts printing the spool file if the printer setup matches the file setup.

3. To test the Unicenter CA-Spool to JES file transfer interface, enter the following: RF1,ND=LOCAL => ESF850 1 FILE(S) ROUTED RF1 => ESF850 1 FILE(S) REQUEUED

The file is copied to a JES2 or JES3 spin-off SYSOUT data set.

4. Run the supplied sample job IVP2JESX to test the automatic JESTOESF file transfer interface.

After the job has terminated, a new file starts printing on the specified printer.

Installation 4–25

Installation Steps


5. To test the ESFPRINT/DSPRINT TSO command, first start a TSO session: ESFPRINT DSN(‘CAI.PPOPTION(CAIQPARM)’) DEST(destination) SUB(ESF)

Specify the name of the test printer as the destination.

SUBSYS Verification

Verification of the SUBSYS parameter interface normally includes:

1. Run the supplied sample job IVP2SUBS to test the SUBSYS-parameter interface.

After the job has terminated, a new file starts printing on the specified Unicenter CA-Spool printer.

2. To test the ESFALLOC TSO command, first start a TSO session. After the session is started, you can use the ESFALLOC command, as follows: ALLOC DUMMY FILE(SYSPRINT) ALLOC DUMMY FILE(SYSIN) ALLOC CAI.PPOPTION(CAIQPARM) ESFALLOC SYSUT2 DEST(destination) SUBSYS(ESF) CALL ’SYS1.LINKLIB(IEBGENER)’ FREE FILE(SYSPRINT,SYSIN,SYSUT1,SYSUT2)

Specify the name of the test printer as the destination.

Menu Verification

Verification of the menu system and the Advanced Communication Interface can normally be confirmed in two steps:

1. To test the menu system from TSO, you must first start a TSO session.

2. Start the menu system by entering the native TSO command: ESFMTSO


Installation Steps


Step 24. Run Post-Install Jobs as Required for Other Environments

Unicenter CA-Spool has interfaces to a number of different environments. In some environments, some of these interfaces require that you run extra installation jobs. The job names begin with “IQB0” and the remaining characters indicate the relevant environment.

IQB0xxxx are SMP/E jobs that update SMP/E with the information that a foreign product is present. Some of the source distributed with Unicenter CA-Spool assembles differently when an IQB0xxxx job is executed.

The optional jobs are as follows:

■ IQB0ACF2 for eTrust CA-ACF2 support

■ IQB0CICS for CICS menu support

■ IQB0COMP (Com-plete) for Software AG’s Com-plete support

■ IQB0IDMS for Advantage CA-IDMS support

■ IQB0IMS for IMS menu support

■ IQB0JES for JES2 support; used with XFER or SAPI interfaces

■ IQB0NATU for Software AG’s NATURAL support

■ IQB0ROSC for Advantage CA-Roscoe support

■ IQB0SAP for SAP’s R/2 support

Installation 4–27

Installation Steps


Step 25. Run Any Other Optional Jobs

Run the following jobs according to the needs of your site:

■ IQB0GEN to copy XENOS GENLIB for AFP to PCL Transformer support

■ IQB0NTUN to copy NATURAL.Inpl file for NATURAL menu support

■ IQB0U*** jobs for usermod maintenance

■ IQB0M*** jobs for maintenance upgrades

■ IQB0F*** jobs for fix applies

■ IQB0REFS



Chapter

5 Migration Considerations

When migrating from Unicenter CA-Spool release 2.0 to r11, consider that:

■ The file queue has not been restructured.

Unicenter CA-Spool r11 can be warm started on your existing Unicenter CA-Spool release 2.0 spool and checkpoint configuration. In addition, should it become necessary to fall back from Unicenter CA-Spool r11 to Unicenter CA-Spool 2.0, you can do this by simply warm starting the Unicenter CA-Spool r11 checkpoint and spool configuration on your Unicenter CA-Spool 2.0 system.

Unicenter CA-Spool r11 members may coexist with Unicenter CA-Spool release 2.0 members in the same EMAS/MAS complex.

When migrating from Unicenter CA-Spool release 1.11 or prior releases to r11, consider that:

■ The file queue has been restructured.

If you have files under control of any previous release, which must now be used with r11, do the following:

1. Use your current version of ESFSPTP to unload these files.

2. Use the r11 version of ESFSPTP to reload the files.

■ A FORMAT start is necessary when the Unicenter CA-Spool r11 system is started for the first time.

Migration Considerations 5–1

Initialization Statements


When migrating from any previous Unicenter CA-Spool release to r11, consider that:

■ Any application programs using pre-V8.0 interface routines (AESFPRIV) must be relinked with the r11 interface routines.

■ All user exits have been renumbered in Unicenter CA-Spool r11. Source updates to exits in IEBUPDTE format must use these new numbers, so be sure to check the sequence numbers before applying the updates.

■ Userzaps status. If you have been using any of the Unicenter CA-Spool 2.0 Userzaps, see the “Userzaps” appendix in the Customization Guide to verify their status in Unicenter CA-Spool r11.

Initialization Statements The following initialization statements have been added, changed, or deleted in Unicenter CA-Spool r11.

For a full description of these statements, see the “Initialization” chapter in the Customization Guide.

Added Initialization Statements

TCPLHOST This statement specifies the Local IP address to bind from if TCPDRIV option Q is specified.


Initialization Statements


Changed Initialization Statements

The following initialization statements have been changed in r11:

LPDSERV The following enhancement has been added:

■ New DKEY=decryption-key parameter.

LPDDEST The following enhancement has been added:

■ New FKEY=decryption-key parameter.

DEFNODE The following enhancement has been added:

■ New FKEY=encryption-key printer node parameter.

NODE The following enhancement has been added:

■ New KEY=encryption-key printer node parameter

Deleted Initialization Statements

There are no deleted initialization statements in this release.


New Macro Names


New Macro Names In r11, many of the names of the Unicenter CA-Spool CAIMAC macro library members have changed. Review any customization usermods and update the names of these macros, if necessary. The following table shows the old and new names:

Old Name New Name

$ALCB $IQALCB

$AMODE $IQAMODE

$BIND $IQBIND

$CALLPF $IQCALL

$CDB $IQCDB

$CIB $IQCIB

$CMB $IQCMB

$COMPLT $IQCOMP

$DCE $IQDCE

$DFHBLK $IQDFHB

$DISTERR $IQDSTER

$EHCWDS $IQEHCW

$EMPTRPL $IQMTRPL

$EPILOG $IQEPIL

$FAXB $IQFAXB

$FCB $IQFCB

$FQB $IQFQB

$FQE $IQFQE

$FREMAIN $IQFREMN

$FSCT $IQFSCT


New Macro Names


Old Name New Name

$GETMAIN $IQGETMN

$ICE $IQICE

$IMAGE $IQIMAGE

$LASCMD $IQLASC

$LASDEV $IQLASD

$LKUPNAM $IQLKPNM

$MODESET $IQMODST

$MSG $IQMSG

$MSGPARM $IQMSGPM

$MSYSD $IQMSYSD

$PCB $IQPCB

$PROLOG $IQPROL

$READY $IQREADY

$RPL $IQRPL

$SAFAT $IQSAFAT

$SAFNTYP $IQSFNTP

$SAFUID $IQSAFID

$SAPCOM $IQSAPCM

$SAPUSER $IQSAPUS

$SAV $IQSAV

$SB $IQSB

$SECPARM $IQSECPM

$SENDMSG $IQSNDMS

$SFB $IQSFB

$SMFBUF $IQSMFB


New Macro Names


Old Name New Name

$SNABUF $IQSNAB

$SSCT $IQSSCT

$SSVT $IQSSVT

$TDCE $IQTDCE

$TIME $IQTIME

$USB $IQUSB

$USEXITS $IQUSEXT

$USOPARM $IQUSOPM

$USSLINK $IQUSSLK

$VECTOR $IQVCTR

$WAIT $IQWAIT

$XEQDSCK $IQQDSCK

$XEQXSEC $IQQXSEC

$XFQLKUP $IQXFQLP

$XFQUPDT $IQXFQUP

$XMRB $IQXMRB

#CICSCSA #IQCICSA

#DOS #IQDOS

#ESFCOIN #IQESFCN

#ESTAE #IQESTAE

#FREMAIN #IQFREMN

#GETMAIN #IQGETMN

#IQABEND #IQABEND

#IQPOST #IQPOST

#IQWAIT #IQWAIT


New Macro Names


Old Name New Name

#MVS #IQMVS


07SPGIND.doc, printed on 11/27/2004, at 11:02 AM

Index

A

ACCEPT CA-LPD, 4-12

ACCEPT processing, 4-5

AESFPRIV, 5-1

allocation of spool and checkpoint data sets, 4-22

APPLESF, 4-20

APPLY processing, 4-5

B

BINLIB data set, 4-16

C

CA Education Services, 1-5

CA Technology Services, 1-4

CA-LMP, 3-2

cartridge installation, 4-2, 4-4

checkpoint and spool datasets, 4-2, 4-22

CHKPTDS statement, 5-2

D

DEFNODE parameter, 5-3

disk storage, 4-2

distributed control, 1-2

distribution libraries, 4-3, 4-9

E

enterprise printing, 2-2

ESFALLOC, 4-26

ESFLIST data set, 4-15

ESFMT10, 4-26

ESFMTSO, 4-26

ESFPARM data set, 4-15

ESFSPTP, 5-1

F

FAQs, 1-7

file queue, 5-1

functions, 2-3

Index–1


H

hardware requirements, 4-3

I

IEBUPDTE, 5-2

IMAGELIB data set, 4-16

initialization statements changes, 5-3 new, 5-2

INS4xxxx, 4-27

INS5xxxx, 4-27

installation ACCEPT, 4-12 APPLY, 4-12 CA Common Services, 4-7 cartridge, 4-2, 4-4 distribution libraries, 4-3 INS2COP1, 4-13 INS2JES2, 4-20 INS2JES3, 4-20 INS2VTAM, 4-20 loading sample JCL library, 4-8 materials, 4-2 parallel, 4-1 RECEIVE, 4-11 SAS/C, 3-1 SMP procedure, customizing, 4-10 SMP zones, defining, 4-10 software requirements for, 3-1 summary of the steps, 4-6 target and distribution libraries, allocating, 4-9 target libraries, 4-3 under SMP/E, 4-4 verification of, 4-24 verification procedure for advanced communication interface, 4-26

verification procedure for menu system, 4-26

IVP2SUBS, 4-26

J

JCL library, 4-8

JES2PARM, 4-20

JES3, 4-20

JES3IN, 4-20

L

libraries distribution, 4-3, 4-9 target, 4-3, 4-9

License Management Program code (LMP), 4-16

LMP, 3-2

LMP code, entering, 4-16

LMP key certificate, 4-16

LOGON, 4-24

LPD data sets, 4-15

LPDDEST parameter, 5-3

LPDSERV parameter, 5-3

Index–2 Getting Started


M

managed printing environment, 1-3

menu verification, 4-26

migration considerations, 5-1

N

NJE interface, 1-3

NJESNAP data set, 4-15

NODE statement, 5-3

O

OVLYLIB data set, 4-16

P

PCLLIB data set, 4-16

PJLLIB data set, 4-16

printing text support, 1-3

R

RECEIVE processing, 4-5

RECEIVEing CA-LPD, 4-11

resource requirements, 4-3

S

SAPISNAP data set, 4-15

SAS/C runtime library, 3-1

SECUSNAP data set, 4-16

self contained subsystem, 1-2

SMP/E customize procedure, 4-10

software requirements, for installing, 3-1

spool data sets, 4-23

STEPLIB data set, 4-15

structure, 2-4

SVCCODE, 4-22

SYMDUMP data set, 4-15

SYS1.VTAMLST, 4-20

SYSTCPD data set, 4-16

system interfaces, 2-2

SYSTERM data set, 4-15

T

target libraries, 4-3, 4-9

TSO, testing the menu system, 4-26

Index–3


U

Unicenter CA-Spool description, 1-1 file queue, 5-1 illustration, 2-4 overview, 2-1

user control, 2-2

user exits, 5-1

userzaps status, 5-1

V

VTAM, 4-20, 4-24

Z

zones, defining distribution for CA products, 4-10

Index–4 Getting Started

Date post:	16-Jul-2018
Category:	Documents
Upload:	vuongduong
View:	216 times
Download:	0 times

Unicenter CA-Spool Print Management Getting Started · 00SPGTTL.doc, printed on 11/19/2004, at 2:12...

Documents