0% found this document useful (0 votes)

78 views

ROSCOE - B001653e - Installation Guide

ROSCOE - Installation Guide

Uploaded by

pagbarros

Available Formats

Download as PDF, TXT or read online on Scribd

0% found this document useful (0 votes)

78 views

ROSCOE - B001653e - Installation Guide

ROSCOE - Installation Guide

Uploaded by

pagbarros

Available Formats

Download as PDF, TXT or read online on Scribd

You are on page 1/ 132

Advantage CA-Roscoe

 

Interactive Environment

Installation Guide
r6
This documentation and any related computer software help programs (hereinafter referred to as the
“Documentation”) is for the end user’s informational purposes only and is subject to change or withdrawal by CA at
any time.

This Documentation may not be copied, transferred, reproduced, disclosed, modified or duplicated, in whole or in
part, without the prior written consent of CA. This Documentation is confidential and 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 the documentation for
their own internal use, and may make one copy of the related software as reasonably required for back-up and
disaster recovery purposes, 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 provisions of the license for
the product are permitted to have access to such copies.

The right to print copies of the documentation and to make a copy of the related software is limited to the period
during which the applicable 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 certify in writing to CA that all copies and partial copies of the
Documentation have been returned to CA or destroyed.

EXCEPT AS OTHERWISE STATED IN THE APPLICABLE LICENSE AGREEMENT, 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 the Documentation is governed by the end user’s applicable license
agreement.

The manufacturer of this Documentation is CA.

Provided with “Restricted Rights.” Use, duplication or disclosure by the United States Government is subject to the
restrictions set forth in FAR Sections 12.212, 52.227-14, and 52.227-19(c)(1) - (2) and DFARS Section 252.227-
7014(b)(3), as applicable, or their successors.

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

Copyright  2005 CA. All rights reserved.

Contents

About This Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii

Chapter 1. Using SMP/E . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1

Chapter 2. System Requirements . . . . . . . . . . . . . . . . . . . . . . . . 2-1

2.1 Authorized Library Requirements . . . . . . . . . . . . . . . . . . . . . . 2-2
2.2 BTAM Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3
2.3 Hardware Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-4
2.4 Non-Swappable Requirement . . . . . . . . . . . . . . . . . . . . . . . . 2-5
2.5 Operating Environment Requirements . . . . . . . . . . . . . . . . . . . 2-6
2.6 Storage Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-7
2.6.1 DASD Devices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-7
2.6.2 Disk Space Estimates . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-7
2.6.2.1 Target Libraries . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-7
2.6.2.2 Distribution Libraries . . . . . . . . . . . . . . . . . . . . . . . . 2-8
2.6.2.3 Product Libraries . . . . . . . . . . . . . . . . . . . . . . . . . . 2-9
2.7 TTY Device Considerations . . . . . . . . . . . . . . . . . . . . . . . . . 2-10
2.8 VTAM Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-11
2.9 Compatibility with Other Products . . . . . . . . . . . . . . . . . . . . 2-12
2.9.1 Optional Components . . . . . . . . . . . . . . . . . . . . . . . . . 2-12
2.10 CA Common Services for z/OS . . . . . . . . . . . . . . . . . . . . . 2-13
2.10.1 CAIRIM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-13
2.10.1.1 LMP Support . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-13
2.10.2 Using CA LMP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-14
2.10.3 CAISSF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-16
2.10.4 Advantage CA-Earl Reporting Service . . . . . . . . . . . . . . . 2-16
2.10.5 CA-SRAM Service . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-17
2.11 Optional Common Component . . . . . . . . . . . . . . . . . . . . . . 2-18

Chapter 3. Product Distribution and Installation Materials . . . . . . . . 3-1

Chapter 4. Advantage CA-Roscoe Installation Steps . . . . . . . . . . . . 4-1

4.1 Summary of Installation Steps . . . . . . . . . . . . . . . . . . . . . . . . 4-2
4.2 Step 1. Save All Installation Materials and Output . . . . . . . . . . . . 4-4
4.3 Step 2. Review the Cover Letter and PIPs in Install Package . . . . . . 4-5
4.4 Step 3. Review Advantage CA-Roscoe System Requirements . . . . . 4-6
4.5 Step 4. Review Conversion Considerations . . . . . . . . . . . . . . . . 4-7
4.6 Step 5. Complete the Advantage CA-Roscoe Installation Worksheet. . 4-8
4.7 Step 6. Add LMP Keys and Execute CAIRIM . . . . . . . . . . . . . . . 4-9

Contents iii
4.8 Step 7. Load Installation Sample JCL Library . . . . . . . . . . . . . . 4-10
4.8.1 Sample JCL Library Member Naming Conventions . . . . . . . . 4-10
4.9 Step 8. Allocate Target and Distribution Libraries . . . . . . . . . . . 4-11
4.10 Step 9. Allocate Private SMP/E Libraries . . . . . . . . . . . . . . . . 4-12
4.11 Step 10. Customize the SMP/E Procedure . . . . . . . . . . . . . . . 4-13
4.12 Step 11. RECEIVE the Advantage CA-Roscoe Product . . . . . . . . 4-15
4.13 Step 12. APPLY the Advantage CA-Roscoe Product . . . . . . . . . 4-16
4.14 Step 13. Allocate and Format AWS Data Sets . . . . . . . . . . . . . 4-17
4.14.1 Number of AWS Files and Placement Considerations . . . . . 4-17
4.14.2 AWS Blocksize Considerations . . . . . . . . . . . . . . . . . . . 4-17
4.14.3 AWS Format Parameters and Space Considerations . . . . . . . 4-18
4.15 Step 14. Allocate and Format Advantage CA-Roscoe User Libraries 4-19
4.15.1 User Library Volume and File Placement Information . . . . . 4-19
4.15.2 User Library Blocksize Considerations . . . . . . . . . . . . . . . 4-20
4.15.3 User Library Space Requirements . . . . . . . . . . . . . . . . . . 4-20
4.16 Step 15. Restore Advantage CA-Roscoe User Libraries . . . . . . . . 4-21
4.17 Step 16. Define ROSGBL . . . . . . . . . . . . . . . . . . . . . . . . . . 4-23
4.18 Step 17. Define RCS . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-24
4.19 Step 18. Define RPS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-25
4.20 Step 19. Allocate Accounting Data Sets . . . . . . . . . . . . . . . . . 4-26
4.20.1 Accounting File Volume and File Placement Information . . . 4-26
4.20.2 Accounting File Blocksize Considerations . . . . . . . . . . . . . 4-26
4.20.3 Accounting File Space Considerations . . . . . . . . . . . . . . . 4-27
4.21 Step 20. Review the Automatically Installed Facilities . . . . . . . . 4-28
4.21.1 Data Set Facility . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-28
4.21.2 Dialog Management Facility . . . . . . . . . . . . . . . . . . . . . 4-29
4.21.3 ETSO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-29
4.21.4 Monitor Routines . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-30
4.21.5 PF/PA Key Assignments . . . . . . . . . . . . . . . . . . . . . . . 4-31
4.21.6 Security/Accounting Exit Facilities . . . . . . . . . . . . . . . . . 4-32
4.21.7 SKETCH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-32
4.21.8 User Profile System (UPS) . . . . . . . . . . . . . . . . . . . . . . 4-32
4.22 Step 21. Review Available Advantage CA-Roscoe Customization
Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-33
4.23 Step 22. Install Unicenter CA-JCLCheck Optional Tables . . . . . . 4-36
4.24 Step 23. Prepare to Execute Advantage CA-Roscoe. . . . . . . . . . 4-37
4.24.1 Set Up and Execute CAIRIM for Advantage CA-Roscoe . . . . 4-37
4.24.2 Set Up Advantage CA-Roscoe JCL and Initialization Parameters 4-37
4.25 Step 24. ACCEPT the Advantage CA-Roscoe Product . . . . . . . . 4-39
| 4.26 Step 25. Download Advantage CA-Roscoe Documentation . . . . . 4-40

Chapter 5. Maintenance Steps for Advantage CA-Roscoe . . . . . . . . . 5-1

5.1 Cumulative Maintenance Materials . . . . . . . . . . . . . . . . . . . . . 5-2
5.2 Overview of Maintenance Steps . . . . . . . . . . . . . . . . . . . . . . . 5-3
5.3 Step 1. Review and Follow the Cover Letter Instructions . . . . . . . . 5-4
5.4 Step 2. Load the Sample JCL from the Tape . . . . . . . . . . . . . . . . 5-5
5.5 Step 3. Customize the SMP/E Procedure . . . . . . . . . . . . . . . . . 5-6
5.6 Step 4. RECEIVE Advantage CA-Roscoe Maintenance . . . . . . . . . 5-7
5.7 Step 5. APPLY CHECK Advantage CA-Roscoe Maintenance . . . . . . 5-8
5.8 Step 6. RESTORE any Applicable SYSMODs . . . . . . . . . . . . . . . 5-9
5.9 Step 7. APPLY Advantage CA-Roscoe Maintenance . . . . . . . . . . 5-10

iv Installation Guide
5.10 Step 8. Re-APPLY any Applicable SYSMODs . . . . . . . . . . . . . 5-11
5.11 Step 9. ACCEPT Advantage CA-Roscoe Maintenance . . . . . . . . 5-12
5.12 Step 10. Save All Materials and Output . . . . . . . . . . . . . . . . . 5-13

Chapter 6. Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-1

6.1 Diagnostic Procedures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-2
6.1.1 Collecting Diagnostic Data . . . . . . . . . . . . . . . . . . . . . . . 6-3
6.1.2 Interpreting Diagnostic Data . . . . . . . . . . . . . . . . . . . . . . 6-3
| 6.2 Accessing the Online Client Support System . . . . . . . . . . . . . . . 6-4
| 6.2.1 Requirements for Using SupportConnect . . . . . . . . . . . . . . . 6-4
| 6.2.2 Accessing the Technical Support Phone Services Directory . . . . 6-5
| 6.2.3 CA-TLC: Total License Care . . . . . . . . . . . . . . . . . . . . . . 6-5
| 6.3 Calling Computer Associates Technical Support . . . . . . . . . . . . . 6-6
| 6.4 Product Versions and Maintenance . . . . . . . . . . . . . . . . . . . . . 6-7
| 6.5 Requesting Enhancements . . . . . . . . . . . . . . . . . . . . . . . . . . 6-8

Appendix A. Advantage CA-Roscoe Installation and Maintenance

Worksheets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-1
A.1 General Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-2
A.2 AWS Related Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . A-3
A.3 User Library Related Parameters . . . . . . . . . . . . . . . . . . . . . A-4
A.4 Accounting File Related Parameters . . . . . . . . . . . . . . . . . . . A-5
A.5 Execution Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-6

Appendix B. Install XTPM . . . . . . . . . . . . . . . . . . . . . . . . . . . B-1

B.1 Step 1: Review Installation Checklist . . . . . . . . . . . . . . . . . . . . B-2
B.2 Step 2: Review XTPM Description . . . . . . . . . . . . . . . . . . . . . B-3
B.3 Step 3: Review XTPM Generation Macro(s) . . . . . . . . . . . . . . . . B-4
B.4 Step 4: Determine Advantage CA-Roscoe Selection Criteria . . . . . . B-6
B.5 Step 5: Install XTPM CICS Interface Modules . . . . . . . . . . . . . . . B-8
B.5.1 Copy the Appropriate XTPM Interface Installation JCL . . . . . . B-8
B.5.2 Modify and Submit the JCL . . . . . . . . . . . . . . . . . . . . . . . B-8
B.5.3 Install the CICS Interface Modules . . . . . . . . . . . . . . . . . . B-9
B.6 Step 6: Review XTPM CICS Programmed Interface . . . . . . . . . . B-11
B.7 Step 7: Install XTPM TSO Interface Modules . . . . . . . . . . . . . . B-13
B.7.1 Copy the Appropriate XTPM Interface Installation JCL . . . . . B-13
B.7.2 Modify and Submit the JCL . . . . . . . . . . . . . . . . . . . . . . B-13
B.7.3 Install the TSO Interface Modules . . . . . . . . . . . . . . . . . . B-14
B.8 Step 8: Install XTPM Advantage CA-Roscoe Interface Modules . . . B-15
B.8.1 Copy the Appropriate XTPM Interface Installation JCL . . . . . B-15
B.8.2 Modify and Submit the JCL . . . . . . . . . . . . . . . . . . . . . . B-15
B.8.3 Install the Advantage CA-Roscoe Interface Modules . . . . . . . B-16
B.9 Step 9: Activate XTPM . . . . . . . . . . . . . . . . . . . . . . . . . . . B-18

Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . X-1

Contents v
vi Installation Guide
About This Guide

The Advantage CA-Roscoe Interactive Environment Installation Guide contains

step-by-step instructions for installing, customizing, and maintaining
Advantage CA-Roscoe.

Review this document in its entirety before attempting to install Advantage

CA-Roscoe.

About This Guide vii

Organization

CHAPTER DESCRIPTION
1 Presents an overview of the installation process and SMP/E
control.
2 Specifies the hardware and software requirements needed to
install Advantage CA-Roscoe.
3 Describes the format of the installation tape and and lists
the installation materials provided by Computer Associates.
4 Gives a step-by-step description of the installation process
used to install Advantage CA-Roscoe.
5 Gives a step-by-step description of the tasks required to
maintain Advantage CA-Roscoe.
6 Contains information about identifying and resolving
problems.
Appendix A Provides an installation worksheet.
Appendix B Provides information about the XTPM component and how
to install and access it from several optional interfaces.
Index Provides a quick way to locate specific material.

viii Installation Guide

Revisions and Enhancements
|

| The following information has been provided as a quick reference regarding

| revisions and enhancements that have been made in the the core release and
| the Service Packs that followed.

|Summary of Revisions for Service Pack 7

| ■ The user library minimum blocksize has been increased to 536 bytes and
| the maximum is now 32k.
| ■ Define the CA SMP/E data sets using sample JCL member CAINITE5.

Summary of Revisions for Service Pack 5

Editorial and minor technical changes have been made throughout this
manual.

Summary of Revisions
■ The Advantage CA-Roscoe installation procedure has been changed to
reflect SMP/E protocol.
■ The Advantage CA-Roscoe library names have been changed to the
following:
Advantage CA-Roscoe Load
CAI.RO60LIB
Advantage CA-Roscoe Macro
CAI.RO60MAC
Advantage CA-Roscoe Options
CAI.RO60OPT

About This Guide ix

Advantage CA-Roscoe Publications
The following publications are supplied with Advantage CA-Roscoe Interactive
Environment. They are divided into a User Series and a System Series.

User Series Contents

Name
Command Reference Describes all Advantage CA-Roscoe primary and
Guide line commands and Monitor commands.
Extended Development Describes how: 1) the Application Programming
Tools Guide Interface (API) can be used by applications
executing under ETSO to take advantage of
Advantage CA-Roscoe facilities, and 2) the
interactive facilities provided by SKETCH can be
used to generate and maintain panels used in
programs running under CICS or IMS.
Getting Started Introduces Advantage CA-Roscoe to
non-programmers.
Release Guide Provides a summary of the enhancements included
in this release.
RPF Language Guide Describes all components of the RPF language and
how to write RPF programs. It also describes the
Dialog Management Facility (DMF) which can be
used to develop, maintain and execute panel-driven
RPF applications.
User Guide Provides task-oriented descriptions of how to use
Advantage CA-Roscoe.

x Installation Guide
System Series Contents
Name
Extended Facilities for Describes how sites can make extensions to their
System Programmers Advantage CA-Roscoe system. This includes
Guide creating site-written Monitor routines and
customizing security and other online exits.
Installation Guide Describes the steps to follow when installing or
upgrading Advantage CA-Roscoe.
Messages and Codes Explains all messages that might be received by
Guide individuals using Advantage CA-Roscoe or by the
individual responsible for maintaining Advantage
CA-Roscoe.
Programs and Utilities Describes Advantage CA-Roscoe execution
Guide requirements. Also describes maintenance and
reporting programs for the accounting facility,
Active Work Space (AWS), library system, and user
profile system.
Security Administration Describes implementation of internal and external
Guide security to protect your Advantage CA-Roscoe
system.
System Commands Guide Describes commands used to control and monitor
Advantage CA-Roscoe and to obtain performance
information about that execution.
System Reference Guide Intended for the individual responsible for
maintaining Advantage CA-Roscoe. It describes
Advantage CA-Roscoe and its components.

About This Guide xi

Related Publications
The CA Common Services r11 for z/OS SP6 (formerly known as Unicenter
TNG Framework for OS/390 and CA Common Services for z/OS and OS/390
Services) documentation can be found on http://supportconnect.ca.com.

The following manuals relate to Advantage CA-Roscoe and are on

http://supportconnect.ca.com.

Title Contents
Advantage CA-Earl Reference Guide Contains detailed information about
Advantage CA-Earl statements,
parameters, and coding rules. Also
explains the Advantage CA-Earl
Reporting Service.
Advantage CA-Earl User Guide Designed for users interested in
learning about Advantage CA-Earl. It
presents an introduction to
Advantage CA-Earl features and
capabilities.
Advantage CA-Earl Systems Lists the installation options for
Programmer Guide Advantage CA-Earl and instructions
for modifying them. Also describes
size requirements and program
execution.
Advantage CA-Earl Examples Guide Contains sample programs that show
a variety of common applications.

xii Installation Guide

CA Common Services for z/OS
CA Common Services for z/OS are a common set of services that may be used
by any MVS Computer Associates product. These services are maintained
separately from the product and are documented and installed separately as
well. Advantage CA-Roscoe uses CAIRIM for installation services and security.

Licensing Management Program (LMP)

Advantage CA-Roscoe now interfaces with CAIRIM services to determine

product licensing authorization.

About This Guide xiii

xiv Installation Guide
Chapter 1. Using SMP/E

The machine-readable program materials required for installation are

distributed as a multifile installation tape in SMP/E format. The System
Modification Program/Extended (SMP/E) must be used to perform solution
installation, tailoring, and maintenance.

There are three major operations performed by SMP/E when installing a

solution or performing maintenance. These operations manage a structure
wherein a given solution is present in executable form in the target system
libraries, and is also present in the distribution libraries for maintenance
operations (only).

The operations performed are as follows:

■ RECEIVE Processing
The installation tape is loaded by SMP/E into temporary data sets. If any
error is detected, or the user wishes to stop the process at this point, a
REJECT operation may be run, which undoes anything done during
RECEIVE processing.
■ APPLY Processing
During APPLY processing, SMP/E performs the operations dictated by the
modification control statements (MCS), and updates the target system
libraries. The user may then test the updates. If the installation is to be
aborted at this point, a RESTORE operation may be run, which restores the
system libraries from the distribution libraries. If the APPLY installed the
solution for the first time, RESTORE processing deletes the members that
were added to the target libraries.
■ ACCEPT Processing
When the ACCEPT operation is run, the modification is permanently
placed in the distribution libraries. There is no direct way to undo the
modification once ACCEPT has been run. On an initial install, an ACCEPT
should always be run, as future maintenance may depend on updates
having been made to the distribution libraries.

Chapter 1. Using SMP/E 1-1

1-2 Installation Guide
Chapter 2. System Requirements

| The following system requirements are discussed in this chapter:

Chapter 2. System Requirements 2-1

2.1 Authorized Library Requirements

The following libraries must be authorized:
■ Advantage CA-Roscoe load library (CAI.RO60LIB)
■ AllFusion CA-Librarian load library, if your site is using AllFusion
CA-Librarian and the method used to allow Advantage CA-Roscoe to
access certain AllFusion CA-Librarian I/O modules is the recommended
method (concatenating the AllFusion CA-Librarian load library to the
Advantage CA-Roscoe load library).

To authorize a library, you must modify the appropriate PROGnn member in

SYS1.PARMLIB (where 'nn' identifies the APF member that will be used in the
next IPL). The modification consists of adding an entry in the form:
APF ADD DSNAME(dsname) VOLUME(volid)

where dsname is the library's data set name and volid is the serial number of
the pack on which the library resides. When adding an entry to the member,
every entry except the last MUST end with a comma.
Note: If SYS1.SORTLIB is not defined in the system link list library (member
LNKLSTxx in SYS1.PARMLIB), it must be added to the member
PROGnn to run the SORT Monitor routine.

2-2 Installation Guide

2.2 BTAM Requirements

Review Chapter 6 of the Advantage CA-Roscoe Interactive Environment System
Reference Guide which describes specific options and modules that must be
included in your system. Also note the error recovery procedures for local and
remote devices.

If the facilities described in these sections are not available, they must be made
so and your system must be re-IPLed.

Chapter 2. System Requirements 2-3

2.3 Hardware Requirements

The hardware base for Advantage CA-Roscoe is:
■ Any IBM or compatible processor running under a supported version of
z/OS as described below.
■ Any direct access devices and the standard TP control units. (See the
section 'Devices Supported' in the Advantage CA-Roscoe Interactive
Environment System Reference Guide.

The Advantage CA-Roscoe architecture is such that the required region size
varies greatly based on the following:
■ Specific installation and initialization parameters chosen
■ Number of concurrent sessions to be supported
■ Type of terminals to be used
■ Function mix as determined by the users of the system

| A 4096K region should be considered the minimum size to initialize

Advantage CA-Roscoe. Typical Advantage CA-Roscoe systems with 20 to 150
users are commonly run with a region specification in the range of three to
seven megabytes.

In general, sites should provide Advantage CA-Roscoe with the largest region
available based on the private area restrictions in the system. Areas that are
not used do not occupy real storage or increase paging and only require that
sufficient backing slots are available on the paging data sets. Only if the
paging DASD space is severely constrained and Advantage CA-Roscoe is being
run with a small number of users should a site be concerned with trimming
the region specification.

2-4 Installation Guide

2.4 Non-Swappable Requirement

Advantage CA-Roscoe should be designated as non-swappable. You can do
this by either:
1. Modifying the system Program Property Table (PPT) which requires you to
re-IPL your system. If you choose this method, see the appropriate IBM
System Modifications manuals.
2. Including the NONSWAP initialization parameter in the Advantage
CA-Roscoe JCL. If you choose this method, you do not need to re-IPL
your system.

The generated Advantage CA-Roscoe execution JCL includes the NONSWAP

initialization parameter.

Chapter 2. System Requirements 2-5

2.5 Operating Environment Requirements

Advantage CA-Roscoe operates under:
BCP All supported versions
JES2 All supported versions
JES3 All supported versions
DFP All supported versions

The site's system generation must include the BDAM access method.

BTAM or VTAM must be available.

2-6 Installation Guide

2.6 Storage Requirements

2.6.1 DASD Devices

Advantage CA-Roscoe supports the following DASD devices:

3350
3375
3380
3390
9345
9391 RAMAC - RAD
9392 RAMAC - RAD
2105 ESS Shark - supported in emulation mode only

2.6.2 Disk Space Estimates

The following tables estimate disk space required for Advantage CA-Roscoe
data sets. A default block size has been chosen that will fit on most DASD
storage devices.

2.6.2.1 Target Libraries

The following table estimates disk space for the target libraries required to
install Advantage CA-Roscoe. Note that these estimates include common
components, therefore less space may be required if some of these components
have already been installed.

Name Description Block LRECL Space Directory

Chapter 2. System Requirements 2-7

2.6 Storage Requirements

| Name Description Block LRECL Space Directory

Note: The above libraries are created during the allocation of Computer
Associates common target libraries.

2.6.2.2 Distribution Libraries

The following table estimates disk space for the distribution libraries needed to
install Advantage CA-Roscoe.

DDname Description Block LRECL Space Directory

2-8 Installation Guide

2.6 Storage Requirements

2.6.2.3 Product Libraries

The following table estimates disk space for the various libraries allocated
during the Advantage CA-Roscoe install.

DDname Description Block LRECL Space Directory

Size (BLK) Block
| SAMPJCL Sample JCL 3120 80 600 40
ROSACT00 Advantage 1024 1020 7500 0
CA-Roscoe
Accounting
Files
ROSACT01 Advantage 1024 1020 7500 0
CA-Roscoe
Accounting
Files
ROSLIB00 Advantage 2560 2560 3000 0
CA-Roscoe
Library Files
ROSLIB01 Advantage 2560 2560 5000 0
CA-Roscoe
Library Files
ROSLIB02 Advantage 2560 2560 5000 0
CA-Roscoe
Library Files
SYSAWSP Advantage 512 512 1350 0
CA-Roscoe
AWS files
SYSAWS1 Advantage 2560 2560 1350 0
CA-Roscoe
AWS files

Chapter 2. System Requirements 2-9

2.7 TTY Device Considerations

If your site is using TTY or TTY-type devices, you must perform the tasks
shown below. For detailed information about these tasks, see Chapter 6 of the
Advantage CA-Roscoe Interactive Environment System Reference Guide.

1. Replace the IGG019MP (CCW table) with the Advantage CA-Roscoe

version.
2. Zap IGG019MP to use the autospeed option of Memorex.
3. Update the Advantage CA-Roscoe speed table if non-standard TTY
terminals are used.
4. Define the TTY ID table to verify the TTY ID whenever a user signs on to
Advantage CA-Roscoe.
5. Zap IEG0304A to use the BREAK key as ATTN.

2-10 Installation Guide

2.8 VTAM Requirements

You must change your VTAM network definition so that VTAM recognizes
Advantage CA-Roscoe as a valid application. (See Chapter 9 in the Advantage
CA-Roscoe Interactive Environment System Reference Guide for additional
information.)

Chapter 2. System Requirements 2-11

2.9 Compatibility with Other Products

Advantage CA-Roscoe supports the following CA software products:

eTrustCA-ACF2 All supported releases.

Advantage CA-Datacom All supported releases.
CA-DATACOM/DB
Datadictionary
Advantage CA-Earl All supported releases.
CA-eMAIL+ All supported releases.
CA-ETC All supported releases.
Unicenter CA-JCLCheck All supported releases.
AllFusion CA-Librarian All supported releases.
Unicenter CA-Sort All supported releases.
Unicenter CA-SysView All supported releases.
eTrust CA-Top Secret All supported releases.

And also:

IBM RACF All supported releases.

2.9.1 Optional Components

The following optional component is available under separate license for
Advantage CA-Roscoe.
■ Advantage CA-Roscoe DB2

2-12 Installation Guide

2.10 CA Common Services for z/OS

Advantage CA-Roscoe requires the installation of the following CA Common
Services for z/OS:
■ CAIRIM
■ CAISSF

Advantage CA-Roscoe also makes use of the following CA Common Services

for z/OS:
| ■ Advantage CA-Earl
| ■ CA-SRAM

If there are other CA products installed at your site, some of these services
may already be installed.

This section presents an overview of each of these services and explains how
your product implements each service. See the CA Common Services for z/OS
Getting Started and CA Common Services for z/OS Reference Guide for more
information on CA Common Services for z/OS.

2.10.1 CAIRIM
CAIRIM, CAI Resource Initialization Manager, is the common driver for a
collection of dynamic initialization routines that eliminate the need for user
SVCs, SMF exits, subsystems, and other installation requirements commonly
encountered when installing systems software. These routines are grouped
under the Computer Associates MVS dynamic service code, S910. Some of
CAIRIM's features are:
■ obtaining SMF data
■ verification of proper software installation
■ installation of MVS interfaces
■ automatic startup of CA and other vendor products
■ proper timing and order of initialization

2.10.1.1 LMP Support

The License Management Program portion of the CAIRIM services interfaces

with Advantage CA-Roscoe to determine licensing authorization. If Advantage
CA-Roscoe invocation should fail due to licensing authorization enforcement,
the following events occur:
1. Batch Advantage CA-Roscoe utilities fail with SYSTEM COMPLETION
CODE = CA0
2. New Advantage CA-Roscoe sign-ons (except for the CONTROL account)
are suspended.

Chapter 2. System Requirements 2-13

2.10 CA Common Services for z/OS

3. The CONTROL account will have only enough functionality to correct or

update the product LMP keys.
4. All other accounts already signed on will have very limited functionality.

2.10.2 Using CA LMP

Advantage CA-Roscoe requires CA LMP (License Management Program), one
of the CA Common Services for z/OS, to initialize correctly. CA LMP also
provides a standardized and automated approach to the tracking of licensed
software. Examine the CA LMP Key Certificate you received with your
Advantage CA-Roscoe installation or maintenance tape. That certificate, shown
in the following table contains the following information:

Field Description
Product Name The trademarked or registered name of
Advantage CA-Roscoe licensed for the
designated site and CPUs.
Product Code A two-character code that corresponds to
Advantage CA-Roscoe.
Supplement The reference number of your license for the
particular Advantage CA-Roscoe, in the format
nnnnnn - nnn. This format differs slightly inside
and outside North America, and in some cases
may not be provided at all.
CPU ID The code that identifies the specific CPU for
which installation of your Advantage CA-Roscoe
is valid.
Execution Key An encrypted code required by CA LMP for
Advantage CA-Roscoe installation. During
installation, it is referred to as the LMP Code.
Expiration Date The date (ddMONyy, as in 15JAN93) your
license for Advantage CA-Roscoe expires.
Technical Contact The name of the technical contact at your site,
who is responsible for installation and
maintenance of the designated Advantage
CA-Roscoe. This is the person to whom CA
addresses all CA LMP correspondence.
MIS Director The name of the Director of MIS, or the person
who performs that function at the 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.

2-14 Installation Guide

2.10 CA Common Services for z/OS

Field Description
CPU Location The address of the building in which the CPU is
installed.

CA LMP is provided as an integral part of CAIRIM (Resource Initialization

Manager), another one of the CA Common Services for z/OS. Once CAIRIM
has been installed or maintained at Service Level A5 or higher, CA LMP
support is available for all CA LMP-supported CA software products.

The CA LMP execution key, provided on the Key Certificate, must be added to
the CAIRIM parameters to ensure proper initialization of the CA software
product. To define a CA LMP execution key to the CAIRIM parameters,
modify member KEYS in CAI.PPOPTION.

The parameter structure for member KEYS is:

PROD(pp) DATE(ddmmmyy) CPU(tttt-mmmm/ssssss) LMPCODE (kkkkkkkkkkkkkkkk)

where:
pp The two-character product code. This code agrees with the
product code already in use by the CAIRIM initialization
parameters for earlier genlevels of Advantage CA-Roscoe.
This is required.
ddmmmyy The CA LMP licensing agreement expiration date.
tttt-mmmm The CPU type and model (for example, 3090-600) on which
CA LMP is to run. If the CPU type or model require less than
four characters, blank spaces are inserted for the unused
characters. This is required.
ssssss The serial number of the CPU on which CA LMP is to run.
This is required.
kkkkkkkkkkkkkkkk
The execution key needed to run CA LMP. This CA LMP
execution key is provided on the Key Certificate shipped with
each CA LMP software solution.

An example of a control statement for the CA LMP execution software

parameter is shown following. Although this example uses Unicenter CA-Sort
to represent Advantage CA-Roscoe, the CA LMP execution key value is invalid
and is provided as an example only.
PROD(SL) DATE (1JAN92) CPU(39-6 /37623) LMPCODE(52H2K613Z7RZD6)

For a full description of the procedure for defining the CA LMP execution key
to the CAIRIM parameters, see the Installation Tasks in the CA Common
Services for z/OS Administrator Guide.

Chapter 2. System Requirements 2-15

2.10 CA Common Services for z/OS

2.10.3 CAISSF
CAISSF (CAI Standard Security Facility) allows Computer Associates software
to offer standardized security interfaces regardless of the underlying access
control software. CAISSF offers user authentication and resource access
validation facilities, and can interface with Computer Associates security
products (eTrust CA-ACF2 or eTrust CA-Top Secret) or compatible
non-Computer Associates security products. CAISSF is a subservice contained
within the Computer Associates MVS service code, S910 (CAIRIM). For
Computer Associates security products, some of CAISSF's features include:
■ a single security mechanism
■ isolation of Computer Associates enterprise solutions from Computer
Associates or vendor mechanisms

For non-Computer Associates security products, some of CAISSF's features

include:
■ resource class translation
■ access level translation
■ selective logging of requests
■ request type control
■ message support for failed access

2.10.4 Advantage CA-Earl Reporting Service

The Advantage CA-Earl (Easy Access Report Language) Reporting Component
is a user-friendly report definition facility with the power of a comprehensive
programming system. Advantage CA-Earl allows you to modify and print the
contents and layout of a predefined CA product report using English-like
statements. The routines that provide this service are grouped under the
Computer Associates MVS Advantage CA-Earl Reporting Service code, XE60.
Some of the Advantage CA-Earl Reporting Service's features are:
■ page, user and field headings
■ automatic subtotaling and totaling capabilities
■ automatic data editing
■ full arithmetic computational facilities
■ high-level capabilities
■ enhanced printed output control

Advantage CA-Roscoe accounting reports are produced using Advantage

CA-Earl. See Advantage CA-Roscoe Interactive Environment Programs and Utilities
Guide for more information.

2-16 Installation Guide

2.10 CA Common Services for z/OS

2.10.5 CA-SRAM Service

The CA-SRAM (Sort Reentrant Access Method) Service is a complete
replacement for conventional methods of invoking a sort system from
high-level languages. CA-SRAM allows the activation of several sorts
concurrently, thereby simplifying the data and logic flow. The incoming data
to the sort can be manipulated as desired by the user program in a high-level
language without the need for special exit routines. The service routines that
accomplish this are grouped under the Computer Associates MVS service code,
SR66. Some of CA-SRAM's features are:
■ has all loaded modules coded to be completely reentrant
■ sorts in ascending or descending sequence
■ accepts fixed and variable length records
■ allows key definitions to spread out over the record
■ low overhead
■ operating system independence

Advantage CA-Roscoe accounting reports are produced using Advantage

CA-Earl. CA-SRAM is invoked internally by Advantage CA-Earl.

Chapter 2. System Requirements 2-17

2.11 Optional Common Component

The CA-JCLCheck Common Component is provided for sites that do not have
the full Unicenter CA-JCLCheck product. This common component can only be
used from another Computer Associates product. The CA-JCLCheck Common
Component will be invoked to validate JCL when the CA-Roscoe Monitor
command JCK is issued.

2-18 Installation Guide

Chapter 3. Product Distribution and Installation
Materials

The machine-readable program materials required for installation are

distributed as a multifile installation tape in SMP/E format. SMP/E must be
used to perform the installation and maintenance.

In addition to this guide, Computer Associates provides the following

materials for the installation and use of Advantage CA-Roscoe:
■ A standard magnetic cartridge containing all of the sample JCL referred to
in this document pertaining to the installation and execution of Advantage
CA-Roscoe. The volume serial number is ROyymm, where RO is the
| Advantage CA-Roscoe product ID and 'yymm' is the year and month of
| the tape.
The installation tape contains the files listed in the table below.

| File DSName Attributes Description

Chapter 3. Product Distribution and Installation Materials 3-1

Be sure to save all of your installation materials and all output from the
installation process. This material is essential for Computer Associates to
provide effective maintenance and support of your Advantage CA-Roscoe
system.
Several days before the installation, check with your Computer Associates
regional office or central support office to ensure that you have all PTFs
beyond the base genlevel. Also check to ensure that you have all PIBs
issued since this documentation was last updated. Review them before
starting the installation.

3-2 Installation Guide

■ Documentation, divided into a User Series and a System Programmer
series.
The User Series includes:
– Advantage CA-Roscoe Interactive Environment Command Reference Guide
– Advantage CA-Roscoe Interactive Environment Extended Development Tools
Guide
– Advantage CA-Roscoe Interactive Environment Getting Started Guide
– Advantage CA-Roscoe Interactive Environment Release Guide
– Advantage CA-Roscoe Interactive Environment RPF Language Guide
– Advantage CA-Roscoe Interactive Environment User Guide
The System Programmer Series includes:
– Advantage CA-Roscoe Interactive Environment Extended Facilities for System
Programmers Guide
– Advantage CA-Roscoe Interactive Environment Installation Guide
– Advantage CA-Roscoe Interactive Environment Messages and Codes Guide
– Advantage CA-Roscoe Interactive Environment Programs and Utilities Guide
– Advantage CA-Roscoe Interactive Environment Security Administration
Guide
– Advantage CA-Roscoe Interactive Environment System Commands Guide
– Advantage CA-Roscoe Interactive Environment System Reference Guide

Chapter 3. Product Distribution and Installation Materials 3-3

3-4 Installation Guide
Chapter 4. Advantage CA-Roscoe Installation Steps

This chapter describes the installation steps necessary to install Advantage

CA-Roscoe on an MVS operating system.

The installation process consists of:

■ Loading and modifying the supplied sample JCL library
■ Allocating libraries
■ Executing an SMP/E RECEIVE function
■ Executing an SMP/E APPLY function.
■ Executing several product customization tasks
■ Executing an SMP/E ACCEPT function

Review the first section of this chapter, 'Summary of Installation Steps', before
commencing with Advantage CA-Roscoe installation.
Note: If you are converting from an earlier version of Advantage CA-Roscoe
you will be following the same installation process, however, some of
the installation steps will be modified/omitted.

Chapter 4. Advantage CA-Roscoe Installation Steps 4-1

4.1 Summary of Installation Steps

The table below summarizes the steps involved in the Advantage CA-Roscoe
installation process. Review this list before attempting to install Advantage
CA-Roscoe.

Step Description
1 Save all installation materials and output.
2 Review the cover letter and PIPs which were included in the
install package.
3 Review Advantage CA-Roscoe system requirements. Be sure
all the requirements are met before installing Advantage
CA-Roscoe.
4 Review conversion considerations if you are upgrading from
an earlier version of Advantage CA-Roscoe.
5 Complete the Advantage CA-Roscoe Installation Worksheet.
Modify the default values which do not meet your site
standards. Use the worksheet as a guide when modifying the
installation JCL.
6 Add the LMP keys for Advantage CA-Roscoe and execute
CAIRIM.
7 Load the sample installation JCL from the tape. This provides
all of the JCL necessary to complete subsequent tasks.
8 Allocate the Target and Distribution libraries using the
RO60ALC JCL member.
| 9 Define the CA SMP/E data sets using sample JCL member
| CAINITE5. Add Advantage CA-Roscoe SMP/E zones.
10 Customize the SMP/E JCL procedure using JCL member
RO60SMPE.
11 Execute an SMP/E RECEIVE function using the RO60REC JCL
member.
12 Execute an SMP/E APPLY function using the RO60APP JCL
member.
13 Allocate and format the AWS data sets using JCL member
RO60FAWS.
14 Allocate and format Advantage CA-Roscoe user libraries
(Optional if converting) using JCL member RO60ALRU.
15 Restore Advantage CA-Roscoe user libraries.

4-2 Installation Guide

4.1 Summary of Installation Steps

16 Define, assemble, and link the ROSGBL macro to allow use of

the ATTACH JOB, CONSOLE, and DISPLAY facilities.
17 Define, assemble, and link the RCS (Advantage CA-Roscoe
Communications Services) macro to provide the interface
between Advantage CA-Roscoe and telecommunications
access methods used at your site.
18 Define RPS (Advantage CA-Roscoe Printing Services)
environment.
19 Allocate Accounting data sets (Optional for initial install and
for conversion) using JCL member RO60ALAC.
20 Review the automatically installed facilities.
21 Review available Advantage CA-Roscoe customization
options.
22 Install Unicenter CA-JCLCheck Optional Tables.
23 Prepare to execute Advantage CA-Roscoe.
24 Execute an SMP/E ACCEPT function using JCL member
RO60ACC.
| 25 Download Advantage CA-Roscoe documentation.

Chapter 4. Advantage CA-Roscoe Installation Steps 4-3

4.2 Step 1. Save All Installation Materials and Output

Be sure to save all of your installation materials and output from the
installation process. This material is essential for timely and accurate Computer
Associates maintenance and support of the product.

4-4 Installation Guide

4.3 Step 2. Review the Cover Letter and PIPs in Install Package

4.3 Step 2. Review the Cover Letter and PIPs in Install

Package
At this time, you should refer to the installation cover letter that was supplied
with your Advantage CA-Roscoe installation tape. This letter details any
changes to the installation process at the current Genlevel.

Additionally, before starting this installation procedure, you should:

■ check the packlist for Advantage CA-Roscoe against the package contents
■ For the latest information on all PTFs (Program Temporary Fixes) and
PIBs(Product Information Bulletins), refer to http://supportconnect.ca.com

IMPORTANT
For online technical assistance and a complete list of locations, primary
service hours, and telephone numbers, contact Customer Support at
http://ca.com/support.

Chapter 4. Advantage CA-Roscoe Installation Steps 4-5

4.4 Step 3. Review Advantage CA-Roscoe System Requirements

4.4 Step 3. Review Advantage CA-Roscoe System

Requirements
Be sure that you have reviewed the system requirements found in Chapter 2 of
this guide to ensure that all the requirements are met before installing
Advantage CA-Roscoe.

Be particularly careful to check the following:

■ The Advantage CA-Roscoe target library is authorized.
■ Advantage CA-Roscoe is designated as non-swappable.
■ Advantage CA-Roscoe region size.
■ Operating environment requirements.

4-6 Installation Guide

4.5 Step 4. Review Conversion Considerations

If you are installing Advantage CA-Roscoe for the first time, you may proceed
to the next step.

| This section highlights subsequent steps of the Advantage CA-Roscoe

| installation which may be omitted if you are converting from an earlier
| version of Advantage CA-Roscoe

The information presented in this section is repeated in the documentation for

the affected steps.
■ AWS Files
| The AWS files are temporary work data sets and every Advantage
| CA-Roscoe system must have its own unique set of AWS data sets. Use the
| Advantage CA-Roscoe utility FAWSDS to format the AWS files.
| ■ Advantage ROSLIBS
| If you plan to use the Advantage CA-ROSLIBS from an earlier install or if
| you plan to share the ROSLIBS with another Advantage CA-Roscoe
| system, you may omit Step 14. Allocate and Format User Libraries.
■ Accounting Data Sets
If you plan to use Accounting data sets from an earlier Advantage
CA-Roscoe version, you may omit Step 19. Allocate Accounting Data sets.
■ Restore of Advantage CA-Roscoe Libraries
| If you plan to use Advantage CA-Roscoe user libraries from an earlier
| Genlevel, you will restore a different set of keys than you would for a new
| install.

Chapter 4. Advantage CA-Roscoe Installation Steps 4-7

4.6 Step 5. Complete the Advantage CA-Roscoe Installation Worksheet.

4.6 Step 5. Complete the Advantage CA-Roscoe

Installation Worksheet.
An Advantage CA-Roscoe installation worksheet is provided in Appendix A. It
is designed to simplify modifying the supplied JCL. Answer each question on
the worksheet, filling in the blanks with the appropriate information. Default
values are noted, so if the default value is acceptable, leave the item blank on
the worksheet. However, you must supply appropriate volume serial numbers.

Once you have completed the worksheet, you can use it as a reference while
performing the remaining installation steps.

4-8 Installation Guide

4.7 Step 6. Add LMP Keys and Execute CAIRIM

Before executing Advantage CA-Roscoe, you must add LMP keys and start (or
restart) CAIRIM. See the CA Common Services for z/OS Administrator Guide and
CA Common Services for z/OS Reference Guide for detailed instructions.

Chapter 4. Advantage CA-Roscoe Installation Steps 4-9

4.8 Step 7. Load Installation Sample JCL Library

| Advantage CA-Roscoe installs using SMP/E. The product media received with
| this package contains all the necessary data to install and execute Advantage
| CA-Roscoe. Prior to installing Advantage CA-Roscoe, you should copy the
| sample JCL library from the product media to disk. This is the ninth file on the
| tape, 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.

//SAMPJCL EXEC PGM=IEBCOPY

//SYSPRINT DD SYSOUT=
//SYSUT1 DD DISP=(OLD,KEEP),
// DSN=CAI.SAMPJCL,
// UNIT=CART, <=== Generic 38k catridge
// VOL=SER=ROyymm, <=== Service pack date
// LABEL=(9,SL)
//SYSUT2 DD DISP=(NEW,CATLG,DELETE),
// DSN=CAI.ROSCOE.SAMPJCL, <=== Your DSN
// UNIT=uuuu, <=== Your generic DASD
// VOL=SER=ssssss, <=== Permanent DASD VOLSER
// SPACE=(312,(6,5,4)), <=== Minimum Space
// DCB=(LRECL=8,BLKSIZE=312,RECFM=FB)
//SYSUT3 DD UNIT=SYSDA,SPACE=(CYL,(5,5))
//SYSUT4 DD UNIT=SYSDA,SPACE=(CYL,(5,5))
//SYSIN DD
//COPY INDD=((SYSUT1,R)),OUTDD=SYSUT2

Once this job is complete, your library will contain all of the JCL needed to
complete the installation of Advantage CA-Roscoe.

4.8.1 Sample JCL Library Member Naming Conventions

Prefix Purpose
RO60 Advantage CA-Roscoe Installation Tasks
MRO60 Advantage CA-Roscoe Product USERMODs
| MZ270 Unicenter CA-JCLCheck Product USERMODs
| UZ270 Unicenter CA-JCLCheck UCLIN
| Z270 Unicenter CA-JCLCheck Product Customization
OTHER Advantage CA-Roscoe Non-installation JCL

4-10 Installation Guide

4.9 Step 8. Allocate Target and Distribution Libraries

Installation sample JCL member RO60ALC allocates all of the Target and
Distribution libraries required by Advantage CA-Roscoe during installation
and maintenance. However, many Computer Associates products have
common components and libraries that may have already been installed.
Therefore, carefully analyze the installation steps to ensure that completed
steps are not repeated.

Edit the JCL to conform to your installation standards and the previously
completed worksheet. However, never change any of the ddnames or the last
qualifier of the data set names.

All space allocations supplied in this member are in blocks to allow for
compatibility between DASD types. The allocations given are the minimum
required for installing Advantage CA-Roscoe. You may want to adjust these
for your installation device types and to allow enough free space for
maintenance (the more free space you allocate the less often they will be
compressed during maintenance). For common libraries already present, be
sure there is sufficient space for Advantage CA-Roscoe, and Unicenter
CA-JCLCheck.

See the section 2.6.2 "Disk Space Estimates" in the Advantage CA-Roscoe
Interactive Environment Installation Guide for more information.

Submit member RO60ALC and review the output.

Chapter 4. Advantage CA-Roscoe Installation Steps 4-11

4.10 Step 9. Allocate Private SMP/E Libraries

A. Create CAI.SMPCSI (Optional, if already existing)

Member CAINITE5 can be used to allocate and initialize SMP/E data sets for
Roscoe in SMP/E. This is recommended to keep Roscoe solutions as distinct
entities from other SMP/E data sets. This member also sets up CAI global,
target, and distribution zones.

Submit member CAINITE5 and review the output. If the job completed with a
return code greater than 4, correct the problem and resubmit the job. A return
code of 4 is normal during initialization.

B. Required for all Advantage CA-Roscoe clients.

Member RO60ZONE establishes separate target and distribution zones for

Advantage CA-Roscoe. These zones should either be added to your
pre-existing CAI.SMPCSI or the CAI.SMPCSI which you just created in step 9A
above.

Submit member RO60ZONE and review the output. If the job completed with
a return code greater than 4, correct the problem and resubmit the job. A
return code of 4 is normal during initialization of new zones.

4-12 Installation Guide

4.11 Step 10. Customize the SMP/E Procedure

Member RO60SMPE contains the procedure CAIRO60. Modify this procedure
to conform to your installation standards and the previously completed
worksheet. This procedure can be placed into a system or user procedure
library, or executed instream. This procedure is executed by subsequent
SMP/E install steps, future maintenance applications, and future applications
of corrective fixes.

If optional Unicenter CA-JCLCheck Common Component SYSMODs CZ27001,

CZ27002, or CZ27003 are to be installed, your SMP/E procedure CAIRO60
must be modified to include either the BrightStor CA-1 or BrightStor
CA-DYNAM/TLMS macro libraries or another CAI.CAIMAC macro library
which contains the necessary macros.

| MVS users must modify the SYSLIB concatenation as shown below. Note that
| the SHASMAC data set name must conform to your operating system.

| Clients installing on z/OS systems should use the following SYSLIB

| concatination.For any updtes on the CAIR060 SYSLIB concatenation, refer
| http://supportconnect.ca.com.

| Clients installing on OS/390 systems should use the following SYSLIB

| concatenation.

Chapter 4. Advantage CA-Roscoe Installation Steps 4-13

4.11 Step 10. Customize the SMP/E Procedure

| Note: JES3 clients must modify the SYSLIB concatenation shown above
| replacing either the "SYS1.SHASMAC" in the z/OS SYSLIB
| concatenation or the "SYS1.VvRrM_SHASM" in the OS/390 SYSLIB
| concatenation with the applicable version of the "SYS1.SAITMAC".

4-14 Installation Guide

4.12 Step 11. RECEIVE the Advantage CA-Roscoe Product

Member RO60REC RECEIVEs all of the components (functional SYSMODs) of
Advantage CA-Roscoe. Edit the JCL to conform to your installation standards
and the previously completed worksheet.

Member RO60REC also contains instructions for installing the optional

functions which make up the CA-JCLCheck Common Component.

Member RO60REC contains instructions for including optional functions.

FMID(s) Service
CRO6000 Advantage CA-Roscoe - base Advantage CA-Roscoe, all
clients must install this function.
| CZ27000 Unicenter CA-JCLCheck Common Component - remove
| from the RECEIVE SELECT if already installed.
| CZ27001 Unicenter CA-JCLCheck Common Component - optional
| - for CA-1 (TMS) 4.9 Support
| CZ27002 Unicenter CA-JCLCheck Common Component - optional
| - for CA-DYNAM/TLMS Support
| CZ27003 Unicenter CA-JCLCheck Common Component - optional
| - for CA-1 (TMS) 5.x Support

| Note: If you do not wish to implement the CA-JCLCheck Common

| Component, or if thefull Unicenter CA-JCLCheck product or the
| CA-JCLCheck Common Component has already been installed, you
| may comment out the appropriate FMID(s). FMIDs CZ27001, CZ27002,
| and CZ27003 are mutually exclusive, and only one of them should be
| selected.

| If optional Unicenter CA-JCLCheck Common Component SYSMODs

| CZ27001, CZ27002, or CZ27003 are to be installed, your SMP/E
| procedure CAIRO60 (that was customized in STEP 10) must be
| modified to include either the BrightStor CA-1 or BrightStor
| CA-DYNAM/TLMS macro libraries or another CAI.CAIMAC macro
| library which contains the necessary macros.

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

Chapter 4. Advantage CA-Roscoe Installation Steps 4-15

4.13 Step 12. APPLY the Advantage CA-Roscoe Product

Member RO60APP APPLYs all of the components (functional SYSMODs) of
Advantage CA-Roscoe to the Target libraries. SMP/E does not require the
Distribution libraries to be allocated during APPLY processing.

Edit the JCL to conform to your installation standards and the previously
completed worksheet.

If other CA solutions have been installed, some of these functions may have
already been applied. The following table lists the functions on the Advantage
CA-Roscoe tape, and details those that you may already have.

Member RO60APP contains instructions for including optional functions.

FMID(s) Service
CRO6000 Advantage CA-Roscoe - base Advantage CA-Roscoe, all
clients must install this function.
| CZ27000 Unicenter CA-JCLCheck Common Component - remove
| from the APPLY SELECT if already installed.
| CZ27001 Unicenter CA-JCLCheck Common Component - optional
| - for CA-1 (TMS) 4.9 Support
| CZ27002 Unicenter CA-JCLCheck Common Component - optional
| - for CA-Dynam/TLMS Support
| CZ27003 Unicenter CA-JCLCheck Common Component - optional
| - for CA-1 (TMS) 5.x Support

| Note: FMIDs CZ27001, CZ27002, and CZ27003 are mutually exclusive, and
| only one of them should be selected.

| If optional Unicenter CA-JCLCheck Common Component SYSMODs

| CZ27001, CZ27002, or CZ27003 are to be installed, your SMP/E
| procedure CAIRO60 (that was customized in STEP 10) must be
| modified to include either the BrightStor CA-1 or BrightStor
| CA-Dynam/TLMS macro libraries or another CAI.CAIMAC macro
| library which contains the necessary macros.

Submit the job and review the output to verify that the APPLY processing ran
successfully.

4-16 Installation Guide

4.14 Step 13. Allocate and Format AWS Data Sets

The Active Work Space (AWS) is a system of at least two files which provides
each terminal user with a temporary work area. The AWS is used to hold a
number of records and allows for rapid and efficient modifications.

If you are installing Advantage CA-Roscoe for the first time or if you want
new AWS data sets for Advantage CA-Roscoe 6.0, use JCL member
RO60FAWS to allocate and format the AWS data sets.

4.14.1 Number of AWS Files and Placement Considerations

A minimum of two AWS files must be allocated, where one is the pointer file
and the other is a data file. A maximum of 17 AWS files may be allocated,
where one is the pointer file and the other 16 are data files.

Member RO60FAWS by default allocates and formats one pointer file and two
data files. Symbolic parameter 'AWSVOLX', along with DDnames SYSAWSX
(in both the allocate and format step) are provided as comments in member
RO60FAWS. They can be uncommented and duplicated if you wish to
allocate/format more than 2 data files.

The installation worksheet has provisions for AWSVOL1 through AWSVOL8,

along with AWSPVOL, to be used to specify your AWS volumes. AWSVOL9
through AWSVOL16 can be added to the worksheet as needed.
Note: Consult the section File Placement in Chapter 2 File Requirements of the
Advantage CA-Roscoe Interactive Environment System Reference Guide for
sample volume layouts of the AWS, Advantage CA-Roscoe target
library, Advantage CA-Roscoe user libraries and Advantage CA-Roscoe
accounting files. The placement of these files has a major impact on
Advantage CA-Roscoe performance and should be evaluated carefully.

4.14.2 AWS Blocksize Considerations

Member RO60FAWS allocates your AWS data files with the default blocksize
of 2560. To determine the ideal blocksize for your specific device type, review
the section "2.3.3 Space Requirements" in the Advantage CA-Roscoe Interactive
Environment System Reference Guide.

The blocksize for the AWS pointer file is fixed at 512.

Chapter 4. Advantage CA-Roscoe Installation Steps 4-17

4.14 Step 13. Allocate and Format AWS Data Sets

4.14.3 AWS Format Parameters and Space Considerations

The FAWSDS program has four input parameters. These are described briefly
below. For a detailed explanation of each parameter, see the section "Program
Requirements for the FAWSDS Program" in the Advantage CA-Roscoe Interactive
Environment Programs and Utilities Guide, and also see the "2.3.3 Space
Requirements" section in the Advantage CA-Roscoe Interactive Environment
System Reference Guide.
AWSAWS# Nnumber of AWSs that could be needed when Advantage
CA-Roscoe is executing.
AWSDBLK Blocksize of the AWS data files.
AWSDS# Number of AWS data files.
AWSSIZE Maximum number of records a user may have in the AWS at one
time.

The values that you specify for the four input parameters above, combined
with several assumptions about Average Record Length and Average Records
per AWS, should be used to determine the minimum number of data and
index blocks that your configuration requires.

If you are upgrading from an earlier version of Advantage CA-Roscoe you

should use the AWSSPACE RPF found in the control account to calculate your
AWS space requirements.

If you are installing Advantage CA-Roscoe for the first time you should
determine your AWS space requirements using the formulas provided in the
AWS files section in the Advantage CA-Roscoe Interactive Environment System
Reference Guide. You can check these results later using the AWSSPACE RPF
that is placed in the control account when the system keys are restored.

Edit the JCL to conform to your installation standards and the previously
completed worksheet. Submit the job and review the output to verify that the
allocate and format ran correctly.

4-18 Installation Guide

4.15 Step 14. Allocate and Format Advantage CA-Roscoe User Libraries

4.15 Step 14. Allocate and Format Advantage CA-Roscoe

User Libraries
Multiple Advantage CA-Roscoe systems can access a single, common user
library system. If you plan to use Advantage CA-Roscoe user libraries from an
earlier release, you may omit this step. If you are installing Advantage
CA-Roscoe for the first time, or if you want new user libraries for Advantage
CA-Roscoe 6.0, use JCL member RO60ALRU to allocate and format the
Advantage CA-Roscoe user libraries.

The user libraries are a set of at least three files consisting of:
■ An index file (ROSLIB00) containing control information on the location of
user library members within the system and data on available space for
writing new members.
■ At least 2 online files, ROSLIB01 and ROSLIB02 must be allocated. The
online files must be sequentially numbered, starting with ROSLIB01,
incrementing by 1 to a maximum of ROSLIB99.

See the Library Files section of the Advantage CA-Roscoe Interactive Environment
System Reference Guide for more detailed information on the library system.

4.15.1 User Library Volume and File Placement Information

Member RO60ALRU, by default, allocates and formats one index file and two
online files. Symbolic parameter 'ULDVOLx', along with DDnames ROSLIB0x,
are provided as comments in member RO60ALRU. If you wish to allocate
more than two online files, you may uncomment and duplicate the appropriate
ROSLIB0x statements, modifying the 'x' to the next sequential number,(03,
04,and so on), and updating ULDVOLx to a valid volume serial number.

The installation worksheet has provisions for ULDVOL1 through ULDVOL10

(you may add ULDVOL11 through ULDVOL99 to the worksheet as necessary),
along with ULIVOL, to be used to specify your user library volumes.
Note: Consult the section File Placement in Chapter 2 of the Advantage
CA-Roscoe Interactive Environment System Reference Guide for sample
volume layouts of the AWS, Advantage CA-Roscoe target library,
Advantage CA-Roscoe user libraries and Advantage CA-Roscoe
accounting files. The placement of these files has a major impact on
Advantage CA-Roscoe performance and should be evaluated carefully.

Chapter 4. Advantage CA-Roscoe Installation Steps 4-19

4.15 Step 14. Allocate and Format Advantage CA-Roscoe User Libraries

4.15.2 User Library Blocksize Considerations

| Member RO60ALRU allocates your User Libraries with the default blocksize of
| 2560. This blocksize can be modified. The minimum blocksize is 536 bytes, the
| maximum blocksize is 32k. The blocksize must always be a multiple of 8
| bytes.

4.15.3 User Library Space Requirements

JCL member RO60ALRU specifies default space. The space is sufficient to
contain the system keys that are restored, plus an additional 50 percent that
are used for user's library members.

Consult the Space Requirements section of the Advantage CA-Roscoe Interactive

Environment System Reference Guide for the formulas for calculating the number
of blocks required for the Index and Online Files of your user library system.

After reviewing the above items, edit JCL member RO60ALRU to conform to
your installation standards and the installation worksheet. Submit the job and
review the output to verify that the allocate ran correctly.

4-20 Installation Guide

4.16 Step 15. Restore Advantage CA-Roscoe User Libraries

JCL member RO60SRRU should be used to restore members by user prefix
from the System Keys file on the installation tape. The SYSIN stream in
RO60SRRU must be updated so that the proper user prefixes are restored for
your site.
Note: There are several user prefixes which have mixed-case and upper-case
versions. You are required to restore either the mixed-case or
upper-case version for each of these user prefixes.

The table below provides information on each user prefix to be restored.

In Out Contents New Upgrade

UPS UPS User profile system Req. Req.(NOREPLACE)
RO RO Control account Req. Req.(caution)
RIF *RIF Informational Req. Req.(caution)
RDF *RDF Dialog Req. Req.(caution)
mgmt(mixed)
RD5 *RDF Dialog mgmt(upper) Opt. Opt.(caution)
RHE *RHE Help(mixed) Req. Req.(caution)
RD3 *RHE Help(upper) Opt. Opt.(caution)
RSK *RSK SKETCH(mixed) Req. Req.(caution)
RD4 *RSK SKETCH(upper) Opt. Opt.(caution)
RTR *RTR RPF training(mixed) Req. Req.(caution)
RD2 *RTR RPF training(upper) Opt. Opt.(caution)
RTU *RTU Tutorial(mixed) Req. Req.(caution)
RD1 *RTU Tutorial(upper) Opt. Opt.(caution)
RBX *RBX Bulletin Board Req. Req.
System

The table columns are defined as follows:

'IN' column: Contains the 'in-prefix' for the LIBUTIL program. This is
not modifiable.
'OUT' column: Contains the default 'out-prefix' for the LIBUTIL program.
If the 'out-prefix' in the table has an '*', it is modifiable,
otherwise, it is not.

Chapter 4. Advantage CA-Roscoe Installation Steps 4-21

4.16 Step 15. Restore Advantage CA-Roscoe User Libraries

'Contents' column:
Contains a brief description of the members which will be
restored for this prefix. Where appropriate, the default case
(as noted above) is in parentheses.
'New' column: Indicates whether this prefix is required or optional for
either NEW installations of Advantage CA-Roscoe 6.0 or a
NEW set of Advantage CA-Roscoe 6.0 libraries.
'Upgrade' column: Indicates whether this prefix is required or optional if you
are restoring into a set of Advantage CA-Roscoe libraries
from an earlier release.

Contents of the New and Upgrade columns specifically list prefix requirements
and are defined below:
'REQ.' REQUIRED
'Opt.' OPTIONAL
'Req.(NOREPLACE)' REQUIRED. The NOREPLACE option MUST be
specified when restoring.
'Req.(caution)' REQUIRED. (Because you want the latest versions to
be restored.) You should exercise caution if you have
made modifications to any of the members for this
user prefix, as they will be overlaid by the RESTORE.
Opt.(caution) OPTIONAL. Exercise CAUTION if you have made
modifications to any of the members for this user
prefix, as they will be overlaid by the RESTORE.

After reviewing the table on the previous page, edit the SYSIN stream and
accompanying JCL in member RO60SRRU to conform to your installation
standards and the previously completed worksheet. Submit the job and
review the output to verify that the restore ran correctly.
Note: The Advantage CA-Roscoe 6.0 tape also includes a file with User
Contributed Routines (UCRs). The UCR user prefix can be restored
using JCL member RO60RUCR. The 'in-prefix' is UCR. The default
'out-prefix' is RUC and is modifiable. The restore of the UCR user
prefix is optional for ALL sites.

4-22 Installation Guide

4.17 Step 16. Define ROSGBL

You must define a ROSGBL macro to allow individuals at your site to use the
facilities provided by the following commands:
ATTACH JOB To view job files at their terminals. Depending on the site
environment, the file may be viewed before, during or after
job execution.
CONSOLE To issue operator commands and to display:
1. Messages written to the master or a designated console
2. Master Trace Table
3. Addresses of currently active consoles
DISPLAY To obtain information from the operating system about jobs in
execution, initiators, job queues and devices.

Use JCL member MRO6010 (for JES2 sites) or JCL member MRO6011 (for JES3
sites). Each of these members is an Advantage CA-Roscoe USERMOD. You
will RECEIVE and APPLY the appropriate member using SMP/E.

See the appropriate member for additional instructions on how to modify the
ROSGBL macro for your environment. You should also review Chapter 11 in
the Advantage CA-Roscoe Interactive Environment System Reference Guide for
information about:
■ Installing the ROJES2XT exit for sites that run Advantage CA-Roscoe on
JES2
■ Changes required by JES3 sites that run Advantage CA-Roscoe on a local
processor
■ Procedures to ensure job output is held for subsequent viewing by the user
■ Space considerations

Edit the JCL to conform to your installation standards and the previously
completed worksheet. Submit the job and review the output to verify that the
SMP/E RECEIVE and APPLY ran correctly.

| If your site is using multiple ROSGBLs, you must refer to the corresponding
| MRO60Gx JCL member and follow its instructions, where x is either 2, for JES2
| sites, or 3, for JES3 sites.

Chapter 4. Advantage CA-Roscoe Installation Steps 4-23

4.18 Step 17. Define RCS

RCS (Advantage CA-Roscoe Communications Services) provides the interface
between Advantage CA-Roscoe applications and the telecommunications
access methods used at your site.

RCS supports concurrent execution of:

■ VTAM
■ BTAM (with local and/or remote devices)
■ CICS

RCS also supports a batch terminal monitor that allows Advantage CA-Roscoe
to recognize a batch user session. (See Advantage CA-Roscoe Interactive
Environment Programs and Utilities Guide for additional information about
providing a batch user session.)

IMPORTANT
If your site is using:
■ Only VTAM
■ Only CICS
■ VTAM and CICS
■ BTAM with only local devices

the default RCSDEF that was installed by the SMP/E APPLY is sufficient
for your site and you can omit this step.

JCL member MRO6012 is the Advantage CA-Roscoe USERMOD that assembles

and links the RCS macro. The contents of the RCS macro that you create will
vary based on the way your communications network is defined.

If your site is using BTAM with remote devices, you must define an RCS
network definition before Advantage CA-Roscoe can be executed. This
network definition replaces the default RCS definition when you RECEIVE and
APPLY JCL member MRO6012.

Consult Chapter 7 of the Advantage CA-Roscoe Interactive Environment System

Reference Guide to review all of the RCS considerations before proceeding.

Once you have made all of your changes to the RCS macro, edit the JCL to
conform to your installation standards and the previously completed
worksheet. Submit the job and review the output to verify that the SMP/E
RECEIVE and APPLY ran correctly.

4-24 Installation Guide

4.19 Step 18. Define RPS

RPS (Advantage CA-Roscoe Printing Services) allows a site to establish and
use a printing network environment which permits their Advantage
CA-Roscoe users to print data at defined 328x-type and system printers.

If you do not want to define your printing network environment at this time,
you may skip this step for now and return to it at a later time.

JCL member MRO6013 is the Advantage CA-Roscoe USERMOD that assembles

and links your RPS definition. This member refers to a sample RPS definition
to be used as a guide in creating your own definition.

To use RPS, each site must:

■ Use JCL member MRO6013 to define their own printing network
environment, as described in the Advantage CA-Roscoe Interactive
Environment System Reference Guide.
■ Identify an RPS definition in the Advantage CA-Roscoe SYSIN parameters.
Once you have made all of your changes to the RPS macro, edit the JCL to
conform to your installation standards and the previously completed
worksheet. Submit the job and review the output to verify that the SMP/E
RECEIVE and APPLY ran correctly.

For information about the RPS commands that users can issue, see:
■ The Advantage CA-Roscoe Interactive Environment User Guide for a general
description of how you can use this facility to submit, hold, release,
reroute and cancel print requests.
■ The Advantage CA-Roscoe Interactive Environment Command Reference Guide
for information about the commands available to all users.
■ The Advantage CA-Roscoe Interactive Environment System Commands Guide for
information about commands that are restricted or that have restricted
operands.

Chapter 4. Advantage CA-Roscoe Installation Steps 4-25

4.20 Step 19. Allocate Accounting Data Sets

If you plan to use accounting data sets from an earlier Advantage CA-Roscoe
release, or if you do not plan to use accounting at this time, you may omit this
step.

The Advantage CA-Roscoe accounting files are designated ROSACT00 through

ROSACT09. When multiple accounting files are used, they must be numbered
sequentially, starting with ROSACT00 and incremented by one. The DD
statements can be specified in any order when included in the Advantage
CA-Roscoe execution JCL. Note that each Advantage CA-Roscoe region which
is using accounting must have it's own set of accounting files.

If you are installing Advantage CA-Roscoe for the first time, or if you want
new accounting data sets for Advantage CA-Roscoe 6.0, use JCL member
RO60ALAC to allocate the Advantage CA-Roscoe accounting files.

4.20.1 Accounting File Volume and File Placement Information

Member RO60ALAC, by default, allocates two accounting files, which is the
minimum for the accounting facility. Symbolic parameters 'ACCSPCX' and
'ACCVOLX', along with ddname ROSACT0x are provided as comments in
member RO60ALAC. They can be uncommented and duplicated if you want
to allocate more than two accounting files.

The installation worksheet has provisions for ACCVOL0 through ACCVOL4,

and for ACCSPC0 through ACCSPC4 to specify your accounting file volume
and space information. You may add ACCVOL5 through ACCVOL9 and
ACCSPC5 through ACCSPC9 to the worksheet as necessary.
Note: Consult the section File Placement in Chapter 2 of the Advantage
CA-Roscoe Interactive Environment System Reference Guide for sample
volume layouts of the AWS, Advantage CA-Roscoe target library,
Advantage CA-Roscoe user libraries and Advantage CA-Roscoe
accounting files. The placement of these files has a major impact on
Advantage CA-Roscoe performance and should be evaluated carefully.

4.20.2 Accounting File Blocksize Considerations

Member RO60ALAC allocates your accounting files with the default minimum
blocksize of 1024. This blocksize can be modified, but must be compatible with
the site-specified internal buffer size. The size of the internal buffer is
controlled by the 'ACTBUFF=' initialization parameter, which is described in
the Advantage CA-Roscoe Interactive Environment Programs and Utilities Guide.

See the accounting files section of the Advantage CA-Roscoe Interactive

Environment System Reference Guide for a detailed discussion of blocksize
compatibility with the internal buffer.

4-26 Installation Guide

4.20 Step 19. Allocate Accounting Data Sets

4.20.3 Accounting File Space Considerations

There is no relationship between the number of active users and the number of
accounting files needed. The number of accounting records written to the files
will vary based on the activity of the individual users. Actual experience is the
best gauge for determining the amount of space required per accounting file.

Member RO60ALAC, by default, allocates two accounting files, each with

7500 blocks of blksize=1024 (approximately 10 cylinders each on a 3380). See
the accounting files section of the Advantage CA-Roscoe Interactive Environment
System Reference Guide for a formula to estimate the number of accounting
records that are generated during an execution of Advantage CA-Roscoe. This
formula will allow to you calculate an estimated space requirement.

Edit member RO60ALAC to conform to your installation standards and the

previously completed worksheet. Submit the job and review the output to
verify that the ALLOCATE ran correctly.

Chapter 4. Advantage CA-Roscoe Installation Steps 4-27

4.21 Step 20. Review the Automatically Installed Facilities

The facilities described in this section are available when Advantage
CA-Roscoe is initially brought up. Review this section to determine if any site
extensions or modifications are needed.

4.21.1 Data Set Facility

The Data Set Facility allows a terminal user to:
■ Directly access sequential data sets, partitioned data set members,
AllFusion CA-Librarian modules, and data sets comprising a generation
data group.
■ Browse the data set, member, or module. Locate specific occurrences of
character strings. Copy all or selected data into the AWS. Print all or
selected data.
■ Browse Selection Lists containing information about:
– All or selected volumes
– All or selected data sets on a specific volume (VTOC information)
– All or selected entries on a VSAM, ICF, or OS CVOL catalog
– All or selected members/modules on a PDS or AllFusion CA-Librarian
master file
■ Perform such data management functions as:
– Allocate a data set
– Catalog or uncatalog a data set
– Delete a data set, member, or module
– Rename a data set, member, or module

For additional information about using this facility, see the Advantage
CA-Roscoe Interactive Environment User Guide.

Also review the Advantage CA-Roscoe Interactive Environment System Reference

Guide for information about:
■ Including DD statements in the Advantage CA-Roscoe JCL for volumes
that contain data sets which will be frequently accessed. (This saves system
overhead. If these volumes are not defined, they are dynamically allocated
when users attempt to read or write data to those volumes.
■ Security considerations.
■ Space requirements.

Finally, review the Advantage CA-Roscoe Programs and Utilities Guide for
information about Advantage CA-Roscoe initialization parameters that pertain
to the Data Set Facility.

4-28 Installation Guide

4.21 Step 20. Review the Automatically Installed Facilities

4.21.2 Dialog Management Facility

The Dialog Management Facility (DMF) is an application subsystem written in
the RPF language. It simplifies the development and maintenance of
panel-driven applications. It is also used to control the execution of those
applications.

During the installation of Advantage CA-Roscoe, a user profile is created for

DMF and the RPF programs comprising this application subsystem are
unloaded to the Advantage CA-Roscoe libraries. (The default prefix is RDF.
The default sign-on key is ROSCOE.DMF.)

For additional information about DMF, see the Advantage CA-Roscoe Interactive
Environment RPF Language Guide.

4.21.3 ETSO
ETSO (Extended Time-Sharing Option) is an application execution system that
permits multiple users to execute a broad spectrum of purchases and
site-written batch or interactive applications under Advantage CA-Roscoe. The
range of applications includes:
■ Applications written in Assembler and such high-level languages as
COBOL, FORTRAN, and PL/I.
■ Applications that run under TSO using TPUT and TGET for terminal I/O.
■ Applications based on TSO command processors and ISPF dialogs.
■ Applications containing CLISTs and REXX execs.

See the Advantage CA-Roscoe Interactive Environment System Reference Guide for
information about:
■ How to determine which applications should be defined for use under
ETSO.
■ The steps sites can take to control the resources (CPU time and memory)
used by applications executing under ETSO.
■ How to define an application to ETSO.

The following additional manuals should also be reviewed:

■ Advantage CA-Roscoe Interactive Environment User Guide - for information
about executing applications under ETSO.
■ Advantage CA-Roscoe Interactive Environment Command Reference Guide - for
detailed descriptions of the general ETSO-related commands.
■ Advantage CA-Roscoe Interactive Environment System Commands Guide - for
detailed descriptions of the privileged ETSO-related commands.

Chapter 4. Advantage CA-Roscoe Installation Steps 4-29

4.21 Step 20. Review the Automatically Installed Facilities

■ Advantage CA-Roscoe Interactive Environment RPF Language Guide - for

information about writing RPF programs to control the execution of
applications under ETSO.
■ Advantage CA-Roscoe Interactive Environment Extended Development Tools
Guide - for information about developing your own applications.

4.21.4 Monitor Routines

Monitor routines provide functions which are not currently part of Advantage
CA-Roscoe. The following table presents a brief description of the routines
that are automatically enabled in the generated Advantage CA-Roscoe
execution JCL. (This is done using the Advantage CA-Roscoe RUN=
initialization parameter).

Command Description
AMS Executes IDCAMS interactively.
AWS Displays AWS configuration and monitors AWS status
and performance.
COB Syntax checks COBOL programs.(Functionally
stabilized.)
CONSOLE Executes operator commands and displays:
1. Messages written to the master or designate console
2. MVS Master Trace Table
3. Currently active console
DISPLAY Displays information from the operating system about
jobs in execution, initiators, job queues, and online
devices.
DMS Provides information about the current use of storage by:
1. AWS
2. Data Set Facility
3. Library Facility
4. RPF program execution
EXPORT Writes to an existing OS data set or AllFusion
CA-Librarian master file from the AWS and/or library
member(s).
IMPORT Copies all or part of OS data set or AllFusion
CA-Librarian master file into the active AWS.
JCK Syntax checks JCL using Unicenter CA-JCLCheck.
MONITOR Displays information about one or all Monitor routines
defined for the current Advantage CA-Roscoe execution.
PLI Syntax checks PL/I programs.(Functionally stabilized.)

4-30 Installation Guide

4.21 Step 20. Review the Automatically Installed Facilities

Command Description
PURGE Cancels a job from MVS system queues.
ROS Provides Advantage CA-Roscoe system status
information.
SORT Invokes the system utility to sort the contents of the
active AWS.
ZAP Permits superzap processing to be performed on OS data
sets.

For additional information about Monitor routines, see the following manuals:
■ Advantage CA-Roscoe Interactive Environment System Reference Guide - for
information about all of the distributed Monitor routines and how they can
be enabled and/or customized.
■ Advantage CA-Roscoe Interactive Environment Command Reference Guide - for
descriptions of the Monitor commands that are generally available to all
users.
■ Advantage CA-Roscoe Interactive Environment System Commands Guide - for
detailed descriptions of the Monitor commands which are meant for the
individual assigned operator privileges and/or console operation.
■ Advantage CA-Roscoe Interactive Environment Extended Facilities for System
Programmers Guide - for information about writing site-specific Monitor
routines.

4.21.5 PF/PA Key Assignments

Sites with 3270-type terminals will have default PF and PA key assignments in
effect when Advantage CA-Roscoe is initially installed.

The Advantage CA-Roscoe Interactive Environment User Guide describes:

■ The default PF/PA key assignments and how to use them.
■ How individual users can change these assignments to meet their own
particular requirements.

Sites have the option of changing these assignments by modifying the

ROSPFUSE macro using product USERMOD MRO6019. See the Advantage
CA-Roscoe Interactive Environment System Reference Guide for additional
information.

Chapter 4. Advantage CA-Roscoe Installation Steps 4-31

4.21 Step 20. Review the Automatically Installed Facilities

4.21.6 Security/Accounting Exit Facilities

Advantage CA-Roscoe includes a variety of exits that can be used to customize
security and accounting procedures to meet a site's needs.

For detailed information about the types of exits provided, when they are
used, and how to write site-specific exit routines, see the Advantage CA-Roscoe
Interactive Environment Extended Facilities for System Programmers Guide. Note
that a number of sample exit routines are distributed with Advantage
CA-Roscoe to assist sites in developing their own exit routines.

4.21.7 SKETCH
SKETCH (described in the Advantage CA-Roscoe Interactive Environment Extended
Development Tools Guide) is a menu-driven RPF application that simplifies the
generation of panels used by programs running under CICS or IMS:
■ With CICS, SKETCH generates BMS (Basic Mapping Support) macros that
define panels to CICS applications.
■ With IMS, SKETCH generates the MFS (Message Format Services)
statements that define panels to IMS applications.

During the installation of Advantage CA-Roscoe, a user profile is created for

SKETCH and the RPF programs comprising this application subsystem are
automatically unloaded to the Advantage CA-Roscoe library. (The default
prefix is RSK. The default sign-on key is ROSCOE.SKETCH.)

4.21.8 User Profile System (UPS)

A profile must be defined in the User Profile System (UPS) for each person
that may use Advantage CA-Roscoe. The profiles include such information as
the user's sign-on key, prefix, password, library line limit, and security group.

See the Advantage CA-Roscoe Interactive Environment System Reference Guide for
information about:
■ Profiles that are automatically created during initialization.
■ How to create one or more user profiles.
■ Prefixes that should never be assigned to individuals.
■ Restricting the access specific individuals have to Advantage CA-Roscoe.
■ Defining security groups.

4-32 Installation Guide

4.22 Step 21. Review Available Advantage CA-Roscoe Customization Options

4.22 Step 21. Review Available Advantage CA-Roscoe

Customization Options
Advantage CA-Roscoe is customized by product USERMODs. These are
distributed in the installation sample JCL library with the prefix 'MRO60'. Each
of these product USERMODs is installed using an SMP/E RECEIVE and
APPLY. They should not be ACCEPTed so that the customization can be
redone/reworked as your environment changes.

The input for each product USERMOD is placed in the RO60OPT data set by
the SMP/E APPLY of the base Advantage CA-Roscoe function SYSMOD
CRO6000. This input may be exit source, monitor source, a table, or generation
source (such as to generate ROSGBL). A copy of this input as shipped is
placed in the distribution library by the SMP/E ACCEPT of the base
Advantage CA-Roscoe function SYSMOD CRO6000. The copy in the
distribution library is used for future SMP/E restores or for your reference
after making site changes to the original.

Each product USERMOD gives you the opportunity to modify some type of
product source or table under the control of SMP/E.

The process to install each product USERMOD has the following basic steps:
■ Modify the appropriate source member in RO60OPT.
■ Execute the product USERMOD. This will initiate an SMP/E RECEIVE and
APPLY. During the APPLY an assembly and link will take place which
will put an executable copy of the desired modification/customization into
target library RO60LIB.

The table on the following page identifies available Advantage CA-Roscoe

customization members and their respective functions. Additional information
on each customization task can be found in one of the following guides:
Advantage CA-Roscoe Interactive Environment System Reference, Advantage
CA-Roscoe Interactive Environment Extended Facilities for System Programmers,
| Advantage CA-Roscoe Interactive Environment Program and Utilities. ROSDATA
| customization is described in Chapter 19 of the Advantage CA-Roscoe Interactive
| Environment System Reference Guide.

SAMPJCL Source Function

Member Name In
Name RO60OPT
MRO6010 ROSGBL2 Modify ROSGBL for JES2
MRO6011 ROSGBL3 Modify ROSGBL for JES3
MRO6012 RCSDEF Modify your RCS definition
MRO6013 #RPSENV Modify your RPS definition

Chapter 4. Advantage CA-Roscoe Installation Steps 4-33

4.22 Step 21. Review Available Advantage CA-Roscoe Customization Options

SAMPJCL Source Function

Member Name In
Name RO60OPT
MRO6014 ETSSUB Modify ETSO SUBMIT command processor
MRO6015 IATUX30A Modify IATUX30 JES3 Exit
MRO6019 PFUSETAB Modify PFKEY definitions
MRO601B ROSXINIT Modify optional initialization parm list
MRO601C ROSXTERM Modify optional termination parm list
MRO601E RCSTTTYI Modify Translation Table for TTY input
MRO601F RCSTTTYO Modify Translation Table for TTY output
MRO6026 TSOREXX3 Modify IRXISPRM for Advantage
CA-Roscoe CLIST/REXX usage
MRO6029 ROJES2XT Install exit for JES2 SP4.1 or above
MRO602A TTYTAB Modify TTY Speed Table
MRO602B TTYID Modify TTY Verification Table
MRO602D AMSAUTH Modify AMS restrictions
MRO602E AMSDFLT Modify AMS I/O Processing
MRO602F EXPUTAB Modify EXP Output
MRO6030 ENAME Modify EXP Access restriction
MRO6031 INAME Modify IMP Access restriction
MRO6032 ZAPDFLT Modify ZAP Options
MRO6033 JCLOPTS Modify JCLCheck Options
MRO6049 RSSCSOR0 Modify SOR monitor
MRO604B SHOWMON Relink any exit with the SHOW macro
MRO6070 ACFEXIT Customize exit
MRO6072 AMSEXIT Customize exit
MRO6073 AUTEXIT Customize exit
MRO6074 BANEXIT Customize exit
MRO6075 BEXEXIT Customize exit
MRO6076 CLLEXIT Customize exit
MRO6077 CMDEXIT Customize exit
MRO6078 CONEXIT Customize exit
MRO6079 DISEXIT Customize exit

4-34 Installation Guide

4.22 Step 21. Review Available Advantage CA-Roscoe Customization Options

SAMPJCL Source Function

Member Name In
Name RO60OPT
MRO607A DSAEXIT Customize exit
MRO607B DSFEXIT Customize exit
MRO607C EXPEXIT Customize exit
MRO607D IMPEXIT Customize exit
MRO607E JOBEXIT Customize exit
MRO607F LIBEXIT Customize exit
MRO6080 MONEXIT Customize exit
MRO6081 OUTEXIT Customize exit
MRO6082 RCSEXIT Customize exit
MRO6083 RDSEXIT Customize exit
MRO6084 RPSEXIT Customize exit
MRO6085 RPVEXIT Customize exit
MRO6086 SCREXIT Customize exit
MRO6087 SETEXIT Customize exit
MRO6088 SIGEXIT Customize exit
MRO6089 SMFEXIT Customize exit
MRO608A SUBEXIT Customize exit
MRO608D ZAPEXIT Customize exit
MRO608E RTFEXIT Relink RSSCRTF0 with RTF exit

Chapter 4. Advantage CA-Roscoe Installation Steps 4-35

4.23 Step 22. Install Unicenter CA-JCLCheck Optional Tables

4.23 Step 22. Install Unicenter CA-JCLCheck Optional

Tables
The table below identifies the Unicenter CA-JCLCheck tables that you can
install. Execute the appropriate member on the CAI.SAMPJCL library. The
SAMPJCL members contain SMP/E USERMODs to install the tables.

SAMPJCL Source In Function

| Note: In all above procedures, substitute procedure CAIRO60 for CAIJ670.

4-36 Installation Guide

4.24 Step 23. Prepare to Execute Advantage CA-Roscoe.

Advantage CA-Roscoe and the distributed Computer Associates CA Common
Services for z/OS are now installed in your target libraries.

4.24.1 Set Up and Execute CAIRIM for Advantage CA-Roscoe

Before executing Advantage CA-Roscoe, an entry for Advantage CA-Roscoe
must be added to the CAIRIM initialization PARMLIB member and CAIRIM
must be started (or restarted). A sample CAIRIM parameter for Advantage
CA-Roscoe is in member RO60RIM on the installation sample JCL library. See
the CA Common Services for z/OS Services Administrator Guide and CA Common
Services for z/OS Reference Guide for details on starting or restarting CAIRIM.

4.24.2 Set Up Advantage CA-Roscoe JCL and Initialization

Parameters
The JCL to execute Advantage CA-Roscoe is in the member RO60XJCL on the
installation sample JCL library.

Before running the job, modify the JOB statement and JCL so that it conforms
to your site requirements. Refer to the installation worksheet when modifying
the execution JCL, as it includes several relevant fields. This JCL includes:
■ Required and optional DD statements which identify the:
– Accounting, AWS, and library files.
– Files required if the SORT Monitor command is to be used.
– Remote and local devices, if the site is using BTAM.
■ Initialization parameters that are based on:
– Advantage CA-Roscoe initialization parameter defaults, such as
SIGNON=ON, which allows users to sign on to Advantage CA-Roscoe.
– Frequently used facilities such as the RUN= parameters which identify
Monitor routines that are to be available.
Note: The default initialization parameters were placed in the
RO60OPT data set as member SYSIN60 during the SMP/E
APPLY. Refer to the installation worksheet when modifying
member SYSIN60; it includes several relevant fields.

Chapter 4. Advantage CA-Roscoe Installation Steps 4-37

4.24 Step 23. Prepare to Execute Advantage CA-Roscoe.

For a detailed description of the DD statements and initialization parameters

that may be included, how they may be specified, and how they are processed,
see Chapter 1 of Advantage CA-Roscoe Interactive Environment Programs and
Utilities Guide.
Note: The first time Advantage CA-Roscoe is executed after each IPL, a
system address space is created. This address space is an extension of
Advantage CA-Roscoe. Sites must not attempt to remove this address
space. See Appendix A of the Advantage CA-Roscoe Interactive
Environment System Reference Guide for additional information.

4-38 Installation Guide

4.25 Step 24. ACCEPT the Advantage CA-Roscoe Product

Member RO60ACC ACCEPTs all of the components (functional SYSMODs) of
Advantage CA-Roscoe to the Distribution libraries.

Edit the JCL to conform to your installation standards and the previously
completed worksheet.

If other CA solutions have been installed, some of these functions may have
already been accepted. The table below lists the functions on the Advantage
CA-Roscoe tape, and details those which you may already have.

Member RO60ACC contains instructions for including optional functions.

FMID(s) Service
CRO6000 Advantage CA-Roscoe - base Advantage CA-Roscoe, all
clients must install this function.
| CZ27000 Unicenter CA-JCLCheck Common Component - remove
| from the ACCEPT SELECT if already installed.
| CZ27001 Unicenter CA-JCLCheck Common Component - optional
| - for CA-1 (TMS) 4.9 Support
| CZ27002 Unicenter CA-JCLCheck Common Component - optional
| - for CA-Dynam/TLMS Support
| CZ27003 Unicenter CA-JCLCheck Common Component - optional
| - for CA-1 (TMS) 5.x Support

| Note: FMIDs CZ27001, CZ27002, and CZ27003 are mutually exclusive, and
| only one of them should be selected.

| If optional Unicenter CA-JCLCheck Common Component SYSMODs

| CZ27001, CZ27002, or CZ27003 are to be installed, your SMP/E
| procedure CAIRO60 (which was customized in STEP 9) must be
| modified to include either the BrightStor CA-1 or BrightStor
| CA-Dynam/TLMS macro libraries or another CAI.CAIMAC macro
| library which contains the necessary macros.

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

Chapter 4. Advantage CA-Roscoe Installation Steps 4-39

4.26 Step 25. Download Advantage CA-Roscoe Documentation

|4.26 Step 25. Download Advantage CA-Roscoe

| Documentation
| The Advantage CA-Roscoe Version 6.0 Service Pack installation/Maintenance
| media includes the following online documentation options:
| ■ Advantage CA-Roscoe guides in BookManager format - See SAMPJCL
| member BOOKMGR for instructions on unloading the Advantage
| CA-Roscoe guides in BookManager format.
| ■ Advantage CA-Roscoe documentation in Adobe Acrobat Reader (PDF)
| format - See SAMPJCL member PDFDOC for instructions on unloading the
| Advantage CA-Roscoe guides in Adobe Acrobat Reader (PDF) format.

4-40 Installation Guide

Chapter 5. Maintenance Steps for Advantage
CA-Roscoe

This chapter describes the steps necessary to perform maintenance on

Advantage CA-Roscoe. Provided here are:
1. Cumulative maintenance materials
2. An overview of the maintenance steps
3. Instructions for performing each step

| Caution
| Before APPLYing any new maintenance levels, the base product and all
| prior maintenance levels to Advantage CA-Roscoe must be ACCEPTed.

Chapter 5. Maintenance Steps for Advantage CA-Roscoe 5-1

5.1 Cumulative Maintenance Materials

A combined installation/maintenance tape is distributed periodically on a
standard magnetic cartridge processable by SMP/E. It contains the newly
published offical PTF SYSMODs for Advantage CA-Roscoe. This tape is to be
use only where SMP/E controls installation and maintenance of CA solutions.
This tape is in the new 'combined' format, which means that it can be used to
either install Advantage CA-Roscoe at the genlevel specified on the external
label, or the same tape can be used to apply maintenance to bring an existing
Advantage CA-Roscoe up to the genlevel specified on the external label.

A partitioned data set containing all necessary sample JCL is provided on the
tape as the ninth data set and is in IEBCOPY unload format.

To load the sample JCL, use the sample provided in the step entitled 'Load
Sample JCL Library.' The sample JCL data set contains all JCL necessary for
installation and maintenance. The maintenance-specific members are prefixed
with an 'M'.

The volume serial number for combined installation/maintenance tapes

follows the format ROyymm, where 'yymm' is the year and month of the tape.
Refer to the external label of the tape for the current volume serial number.

5-2 Installation Guide

5.2 Overview of Maintenance Steps

Caution
| Before APPLYing any new maintenance levels, the base product and all
| prior maintenance levels to Advantage CA-Roscoe must be ACCEPTed.

The following list summarizes the steps involved in the Advantage CA-Roscoe
maintenance process. Review this list before attempting to perform
maintenance on Advantage CA-Roscoe.
Step 1. Review and follow the cover letter instructions.
Step 2. Load the sample JCL from the tape.
Step 3. Customize the SMP/E procedure.
Step 4. RECEIVE Advantage CA-Roscoe maintenance.
Step 5. APPLY CHECK Advantage CA-Roscoe maintenance.
Step 6. RESTORE any applicable SYSMODs.
Step 7. APPLY Advantage CA-Roscoe maintenance.
Step 8. Re-APPLY any applicable SYSMODs.
Step 9. ACCEPT Advantage CA-Roscoe maintenance.
Step 10. Save all materials and output.

Chapter 5. Maintenance Steps for Advantage CA-Roscoe 5-3

5.3 Step 1. Review and Follow the Cover Letter Instructions

Before starting the maintenance steps below, you must first review and follow
the cover letter instructions. This letter details any additional steps which may
be required by your site.

Additionally, before starting this maintenance procedure, you should:

1. Check the packlist for Advantage CA-Roscoe against the package contents.
2. For the latest information on all PTFs (Program Temporary Fixes) and PIBs
(Product Information Bulletins), refer to http://supportconnect.ca.com.

Caution IMPORTANT
For online technical assistance and a complete list of locations, primary
service hours, and telephone numbers, contact Customer Support at
http://ca.com/support.

5-4 Installation Guide

5.4 Step 2. Load the Sample JCL from the Tape

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

//SAMPJCL EXEC PGM=IEBCOPY

Once this job has ended, your library will contain all of the JCL needed to
complete the maintenance for Advantage CA-Roscoe.

Chapter 5. Maintenance Steps for Advantage CA-Roscoe 5-5

5.5 Step 3. Customize the SMP/E Procedure

During the installation of Advantage CA-Roscoe 6.0, an SMP/E procedure was
selected and customized. If the SMP/E procedure used during the installation
of Advantage CA-Roscoe is available, this step is not required.

If that procedure is not available, a JCL procedure can be found in the sample
JCL library. Member RO60SMPE is the model JCL procedure using SMP/E.
Select and modify this member to conform with your installation standards.
Note: This procedure is used in subsequent steps.

5-6 Installation Guide

5.6 Step 4. RECEIVE Advantage CA-Roscoe Maintenance

Maintenance JCL member RM60REC RECEIVEs all of the PTFs corresponding
to Advantage CA-Roscoe maintenance. Edit member RM60REC to conform to
your installation standards.

Submit the job and verify RECEIVE processing was successful. If the SMP/E
RECEIVE completed with a return code greater than 4, review the output,
correct the problem, and resubmit.

Chapter 5. Maintenance Steps for Advantage CA-Roscoe 5-7

5.7 Step 5. APPLY CHECK Advantage CA-Roscoe Maintenance

5.7 Step 5. APPLY CHECK Advantage CA-Roscoe

Maintenance
Maintenance JCL member RM60APPC will APPLY CHECK all PTFs
corresponding to the components specified within the SMPCNTL DD
statement. The purpose of this step is to identify SMP/E USERMODs and
APARs that prevent PTF application, and to identify any PTFs already
APPLYed.

Edit member RM60APPC to conform to your installation standards. Delete any

DD statements within the SMPCNTL DD statement that correspond to
Advantage CA-Roscoe components not currently installed.

Submit the job and verify APPLY CHECK processing was successful. If the
SMP/E APPLY CHECK completed with a return code greater than 4, review
the output, correct the problem, and resubmit. Note that SMP/E APPLY
CHECK processing performs preliminary validation on SYSMODs individually.
Carefully review the SMP/E generated reports, noting any possible regression
of SYSMODs.

Computer Associates requires the removal of any SYSMOD preventing PTF

application. To allow PTF application, perform SMP/E RESTORE processing
on the SYSMODs identified during the SMP/E APPLY CHECK. The
instructions to accomplish this are in Step 6 following.

5-8 Installation Guide

5.8 Step 6. RESTORE any Applicable SYSMODs

Maintenance JCL member RM60RES contains the control statements for an
SMP/E RESTORE. This step RESTOREs SMP USERMODs and APARs
identified by APPLY CHECK processing, to allow for PTF application. If you
do not have any SYSMODs to RESTORE, you may continue to the next step.

Edit member RM60RES to conform to your installation standards. Only the

SYSMODs identified by APPLY CHECK processing need to be RESTOREd.
Type these SYSMODs within the SMPCNTL DD statement.

After you complete editing, submit the job and verify that RESTORE
processing ran successfully. If SMP/E RESTORE completed with a return code
greater than 4, review the output, correct the problem, and resubmit.

The SMP/E APPLY CHECK should be executed again to verify that there are
no additional SYSMODs which inhibit the application of maintenance.

Chapter 5. Maintenance Steps for Advantage CA-Roscoe 5-9

5.9 Step 7. APPLY Advantage CA-Roscoe Maintenance

Maintenance JCL member RM60APP will APPLY all PTFs corresponding to the
components specified within the SMPCNTL DD statement.

Edit member RM60APP to conform to your installation standards. Submit the

job and verify that APPLY processing was successful. If the SMP/E APPLY
completed with a return code greater than 4, review the output, correct the
problem, and resubmit.

5-10 Installation Guide

5.10 Step 8. Re-APPLY any Applicable SYSMODs

Review the USERMODs and APARs RESTOREd by Step 6 (RESTORE
applicable SYSMODs). If no SYSMODs were RESTOREd, skip to the next step.

SYSMODs identified by APPLY CHECK processing may be at a higher level

than the PTFs contained on the Advantage CA-Roscoe maintenance tape.

Edit maintenance JCL member RM60RAP to conform to your installation

standards. Submit the job and verify that APPLY processing ran successfully. If
the SMP/E APPLY completed with a return code greater than 4, review the
output, correct the problem, and resubmit the job.
Note: SMP/E can only handle one update per element per APPLY select
statement. It may be necessary in reAPPLYing SYSMODs to use
multiple APPLY select statements.

Chapter 5. Maintenance Steps for Advantage CA-Roscoe 5-11

5.11 Step 9. ACCEPT Advantage CA-Roscoe Maintenance

After a reasonable period of testing the batch and online features of Advantage
CA-Roscoe with the new maintenance level APPLYed, you should perform an
SMP/E ACCEPT. This will give you a solid baseline to proceed from and
make it easier to APPLY/RESTORE any test USERMODs that you may be
given by the Advantage CA-Roscoe support staff.

Maintenance JCL member RM60ACC will ACCEPT all PTFs corresponding to

the components specified within the SMPCNTL DD statement.

Edit member RM60ACC to conform to your installation standards. Submit the

job and verify ACCEPT processing was successful. If the SMP/E ACCEPT
completed with a return code greater than 4, review the output, correct the
problem, and resubmit.

5-12 Installation Guide

5.12 Step 10. Save All Materials and Output

Be sure to save all of your maintenance materials and all output from the
maintenance process. This material is essential for future problem
determination.

Chapter 5. Maintenance Steps for Advantage CA-Roscoe 5-13

5-14 Installation Guide
Chapter 6. Troubleshooting

This chapter contains information about:

■ Identifying and resolving problems
■ Contacting Computer Associates Technical Support
■ Receiving ongoing product releases and maintenance
■ Requesting product enhancements

Chapter 6. Troubleshooting 6-1

6.1 Diagnostic Procedures

Refer to the flowchart below for a summary of the procedures you should
follow if you have a problem with a Computer Associates software product.
Each of these procedures is detailed on the following pages.

6-2 Installation Guide

6.1 Diagnostic Procedures

6.1.1 Collecting Diagnostic Data

In the table below, use the left column to categorize the problem your site has
encountered. Then, follow the instructions in the corresponding right column
to generate useful diagnostic data.

Type of Problem Procedure

Installation See the Advantage CA-Roscoe
Interactive Environment Installation
Guide.
Advantage CA-Roscoe ABENDs If Advantage CA-Roscoe abends:
1. Retain the snap dump produced
by either a program check or a
user 998 abend.
2. Review all 998 and 88x abends to
determine the cause of the abend.
3. See Appendix A of the Advantage
CA-Roscoe Interactive Environment
Messages and Codes Guide for
more information on abend
codes.

6.1.2 Interpreting Diagnostic Data

When you have collected the specified diagnostic data, write down your
answers to the following questions:
1. What was the sequence of events prior to the error condition?
2. What circumstances existed when the problem occurred and what action
did you take?
3. Has this situation occurred before? What was different then?
4. Did the problem occur after a particular PTF was applied or after a new
version of the software was installed?
5. Have you recently installed a new version of the operating system?
6. Has the hardware configuration (tape drives, disk drives, and so forth)
changed?

From your response to these questions and the diagnostic data, try to identify
the cause and resolve the problem.

Chapter 6. Troubleshooting 6-3

6.2 Accessing the Online Client Support System

| SupportConnect.ca.com is an online product support and service system

| available on the Internet from CA. It contains an extensive Knowledge Base
| that allows you to retrieve many types of product-related information with a
| single search. SupportConnect also provides full product downloads and an
| easy-to-use Suggestion Box for you to submit enhancement ideas for your
| licensed products.

| SupportConnect offers everything that the previous online sites

| (eSupport.ca.com, support.ca.com, and webtrack.ca.com) offered, and much
| more.

|6.2.1 Requirements for Using SupportConnect

| With a current version of a browser and without logging in, you have access to
| a considerable amount of information on the website. This includes access to
| Technical Documents published solutions (for channel products only),
| compatibilities, virus signatures, news, CA user group information, and
| support services, and to perform general Knowledge Base searches.

| For full access to all the services related to your licensed products, including
| published solutions, license keys, newsgroups, Hyper Subscriptions, product
| and documentation downloads, issue management, and Suggestion Box, you
| must log in. These areas require that you are a registered SupportConnect
| user.

| If you enrolled at AccountConnect.ca.com, you can log into SupportConnect

| using your AccountConnect digital certificate rather than entering a login
| name and password. However, this works only on the PC where the digital
| certificate resides, and only if you are using Microsoft Internet Explorer 5.5 or
| later. If you need to access SupportConnect from another PC, or if you are
| using Netscape Navigator, you must provide a login name and password.

6-4 Installation Guide

6.2 Accessing the Online Client Support System

|6.2.2 Accessing the Technical Support Phone Services Directory

| The Computer Associates Technical Support Phone Services Directory lists
| each Computer Associates product and the telephone number to call for
| primary support for that product. To access the Support Phone Services
| Directory, click on the Support Services link on the SupportConnect.ca.com
| webpage.

|6.2.3 CA-TLC: Total License Care

| Many Computer Associates software solutions use license keys or
| authorization codes to validate your hardware configuration. If you need
| assistance obtaining a license key or authorization code, contact the CA-TLC:
| Total License Care group through SupportConnect.ca.com.

Chapter 6. Troubleshooting 6-5

6.3 Calling Computer Associates Technical Support

| For further technical assistance with this product, Technical Support is

| available 24 hours a day, seven days a week. You can obtain a complete list of
| Computer Associates locations and phone numbers by product at
| SupportConnect.ca.com at the Support Services link.

| If you are unable to resolve the problem, please have the following
| information ready before contacting Computer Associates Technical Support:
| ■ All the diagnostic information described in 6.1.1, “Collecting Diagnostic
| Data” on page 6-3.
| ■ Product name, version number, operating system, and genlevel.
| ■ Product name and version number of any other software you suspect is
| involved.
| ■ Version level and PUTLEVEL of the operating system.
| ■ Your name, telephone number and extension (if any).
| ■ Your company name.
| ■ Your site ID.
| ■ A severity code. This is a number (from 1 to 4) that you assign to the
| problem. Use the following to determine the severity of the problem:
| 1 "System down" or inoperative condition
| 2 Suspected high-impact condition associated with the product
| 3 Question concerning product performance or an intermittent
| low-impact condition associated with the product
| 4 Question concerning general product utilization or implementation

6-6 Installation Guide

6.4 Product Versions and Maintenance

| Customers are requested to operate only under currently supported versions of

| the product.

| Customers with current maintenance agreements also receive ongoing product

| maintenance. When a new version of the system is available, a notice is sent
| to all current customers.

Chapter 6. Troubleshooting 6-7

6.5 Requesting Enhancements

| Computer Associates welcomes your suggestions for product enhancements.

| All suggestions are considered and acknowledged. You can use either of two
| methods to request enhancements:
| ■ Enter your request through the Suggestion Box at SupportConnect.ca.com,
| the Computer Associates web-based, interactive support system.
| ■ Contact your Account Manager who will initiate the request for you.

6-8 Installation Guide

Appendix A. Advantage CA-Roscoe Installation and
Maintenance Worksheets

The installation and maintenance worksheet is designed to simplify modifying

the supplied JCL. Answer each question on the worksheet, filling in the blanks
with the appropriate information. Default values are noted. If the default value
is acceptable, leave the item blank on the worksheet. However, you must
supply appropriate volume serial numbers.
Note: Since you are using this worksheet at first for installation and then
again in the future for maintenance, we suggest you store the
completed copy in this binder so it is readily available for future
reference.

Appendix A. Advantage CA-Roscoe Installation and Maintenance Worksheets A-1

A.1 General Parameters

1. What is the high-level qualifier for all data 1. PREFIX=___________

sets?
Default: PREFIX='CAI.'
2. What VOL=SER do you plan to assign to the 2. VOLSER=___________
SMP/E libraries for your installation of CA
solutions? (If these libraries do not already exist,
they will be cataloged and made permanent data
sets.)
Default: VOLSER='XXXXXX'
3. Which DASD pack do you plan to use as 3. TLIB=_____________
your SMP/E temporary library volume created
during RECEIVE processing?
Default: TLIB='XXXXXX'
4. What is your installation generic unit name 4.
for permanent DASD volumes? PERMDA=___________
Default: PERMDA='SYSDA'
5. What is your installation generic unit name 5. WORK=_____________
for temporary work DASD volumes?
Default: WORK='SYSDA'
6. What is your installation standard SYSOUT 6. SYSOUT=___________
class for CA solution installs and SMP/E output?
Default: SYSOUT='*'
7. What is your installation generic unit name 7. TAPE=_____________
for a standard magnetic cartridge tape drive?
Default: TAPE=TAPE

A-2 Installation Guide

A.2 AWS Related Parameters

1. How many AWSs are needed when 1. AWSAWS#=__________

Advantage CA-Roscoe is executing?
Default: AWSAWS# = 2
2. What is the block size of the AWS data 2. AWSDBLK=__________
files?
Default: AWSDBLK = 2560
3. How many AWS data files are needed? 3. AWSDS#=__________
Default: AWSDS# = 2
4. What is the maximum number of records a 4. AWSSIZE=__________
user may have in the AWS at one time?
Default: AWSSIZE = 32000
5. What is the AWS Data File space in blocks? 5. AWSDSPC=___________
Default: AWSDSPC = 1350
6. What is the AWS Pointer File space in 6. AWSPSPC=___________
blocks?
Default: AWSPSPC = 1350
7. What is the volser of the Pointer File? 7. AWSPVOL=___________
Default: AWSPVOL = DUMSER
8. What is the volser of Data File 1? 8. AWSVOL1=___________
Default: AWSVOL1 = DUMSER
9. What is the volser of Data File 2? 9. AWSVOL2=___________
Default: AWSVOL2 = DUMSER
10. What is the volser of Data File 3? 10. AWSVOL3=___________
Default: AWSVOL3 = DUMSER
11. What is the volser of Data File 4? 11. AWSVOL4=___________
Default: AWSVOL4 = DUMSER
12. What is the volser of Data File 5? 12. AWSVOL5=___________
Default: AWSVOL5 = DUMSER
13. What is the volser of Data File 6? 13. AWSVOL6=___________
Default: AWSVOL6 = DUMSER
14. What is the volser of Data File 7? 14. AWSVOL7=___________
Default: AWSVOL7 = DUMSER
15. What is the volser of Data File 8? 15. AWSVOL8=___________
Default: AWSVOL8 = DUMSER

Appendix A. Advantage CA-Roscoe Installation and Maintenance Worksheets A-3

A.3 User Library Related Parameters

1. What is the block size of the User Library? 1. ULBLK=_________

Default: ULBLK = 2560
2. What is the User Library Index File space in 2. ULISPC=_________
blocks?
Default: ULISPC = 3000
3. What is the User Library data file space in 3. ULDSPC=_________
blocks?
Default: ULDSPC = 5000
4. What is the volser of the Index File? 4. ULIVOL=_________
Default: ULIVOL = DUMSER
5. What is the volser of Data File 1? 5. ULDVOL1=_________
Default: ULDVOL1 = DUMSER
6. What is the volser of Data File 2? 6. ULDVOL2=_________
Default: ULDVOL2 = DUMSER
7. What is the volser of Data File 3? 7. ULDVOL3=_________
Default: ULDVOL3 = DUMSER
8. What is the volser of Data File 4? 8. ULDVOL4=_________
Default: ULDVOL4 = DUMSER
9. What is the volser of Data File 5? 9. ULDVOL5=_________
Default: ULDVOL5 = DUMSER
10. What is the volser of Data File 6? 10. ULDVOL6=_________
Default: ULDVOL6 = DUMSER
11. What is the volser of Data File 7? 11. ULDVOL7=_________
Default: ULDVOL7 = DUMSER
12. What is the volser of Data File 8? 12. ULDVOL8=_________
Default: ULDVOL8 = DUMSER
13. What is the volser of Data File 9? 13. ULDVOL9=_________
Default: ULDVOL9 = DUMSER
14. What is the volser of Data File 10? 14.
Default: ULDVOL10 = DUMSER ULDVOL10=_________

A-4 Installation Guide

A.4 Accounting File Related Parameters

1. What is the block size of accounting files? 1. ACCBLK=_________

Default: ACCBLK = 1024
2. What is the LRECL of accounting files? 2. ACCLREC=__________
Default: ACCLREC = 1020
3. What is the space of Accounting File 0 in 3. ACCSPC0=__________
blocks?
Default: ACCSPC0 = 7500
4. What is the volser of Accounting File 0? 4. ACCVOL0=__________
Default: ACCVOL0 = DUMSER
5. What is the space of Accounting File 1 in 5. ACCSPC1=__________
blocks?
Default: ACCSPC1 = 7500
6. What is the volser of Accounting File 1? 6. ACCVOL1=__________
Default: ACCVOL1 = DUMSER
7. What is the space of Accounting File 2 in 7. ACCSPC2=__________
blocks?
Default: ACCSPC2 = 7500
8. What is the volser of Accounting File 2? 8. ACCVOL2=__________
Default: ACCVOL2 = DUMSER
9. What is the space of Accounting File 3 in 9. ACCSPC3=__________
blocks?
Default: ACCSPC3 = 7500
10. What is the volser of Accounting File 3? 10. ACCVOL3=__________
Default: ACCVOL3 = DUMSER
11. What is the space of Accounting File 4 in 11. ACCSPC4=__________
blocks?
Default: ACCSPC4 = 7500
12. What is the volser of Accounting File 4? 12. ACCVOL4=__________
Default: ACCVOL4 = DUMSER

Appendix A. Advantage CA-Roscoe Installation and Maintenance Worksheets A-5

A.5 Execution Parameters

1. What is the name of the security package 1. EXTSEC=__________

used at your site? (Accepted values are ACF2,
ALERT, RACF, SAC, SECURE, and TSS.) If
'none' is not specified, review the Advantage
CA-Roscoe Security Administration Guide.
Default: EXTSEC = NONE
2. What is the size of the virtual region to be 2. REGION =___________
used by Advantage CA-Roscoe?
Default: REGION = 2480K
3. What is the unique four-character Advantage 3. ROSID=___________
CA-Roscoe identification code? (the first
character must be alphabetic or a currency
symbol. The remaining characters may be
alphabetic.) If multiple Advantage CA-Roscoes
are executing at your site, each Advantage
CA-Roscoe must have a unique rosid assigned
via this parameter.
Default: ROSID = ROS1
4. What is the unit type for allocating 4. SORTWK=___________
SORTWKnn data sets?
Default: SORTWK = SYSDA
5. What is the number of minutes that 5. TIME=___________
Advantage CA-Roscoe is to execute?
Default: TIME = 1439
6. What is the name of the member in RO60LIB 6. RPSCSECT=__________
containing the RPS printing network
environment definition? (This should be
omitted if you are not using RPS.)
Default: RPSCSECT= #RPSENV
7. What is sign-on key associated with the 7. RPSKEY=___________
profile that is to be used as the RPS spool
queue? (this should be omitted if you are not
using RPS.)
Default: RPSKEY = ROSCOE.RPS
8. What is the number of VTAM terminals that 8. VTAM=___________
can be concurrently signed on to Advantage
CA-Roscoe?
Default: VTAM = 10

A-6 Installation Guide

A.5 Execution Parameters

9. What is the number of externally controlled 9. XTPM=___________

terminals that can be concurrently signed on to
Advantage CA-Roscoe? This parameter should
only be specified by sites plan to allow XTPM
access. See Appendix B of this guide for XTPM
descriptive and installation information.
Default: XTPM = 0
10. What is the number of concurrent 10. TERMSO=____________
Advantage CA-Roscoe subsessions that can be
active? (Subsessions consist of the number of
users signed on plus the number of users using
split screens.)
Default: TERMSO = 20
11. Do you want to run CLISTS and REXX 11.
procedures under Advantage CA-Roscoe at ETSOEXEC=___________
your site?
Default: ETSOEXEC = NO

Appendix A. Advantage CA-Roscoe Installation and Maintenance Worksheets A-7

A-8 Installation Guide
Appendix B. Install XTPM

XTPM is the External Teleprocessing Monitor for Advantage CA-Roscoe.

XTPM installation is optional for all sites.

The XTPM component of Advantage CA-Roscoe can be used to allow users to

access Advantage CA-Roscoe from:
■ Terminals defined to CICS/VS,
■ A TSO session, or
■ Another Advantage CA-Roscoe session.

All of the XTPM components are included on the Advantage CA-Roscoe

installation tape and are unloaded as part of the installation procedure.

Before XTPM can be used to gain access to Advantage CA-Roscoe, one or more
External Application Interface modules must be created using product
USERMODs.

Appendix B. Install XTPM B-1

B.1 Step 1: Review Installation Checklist

The following table lists the steps involved in installing XTPM components.

DONE STEP TASK

1 Review System Requirements chapter.
2 Review XTPM description.
3 Review description of XTPM generation
macro(s).
4 Determine target Advantage CA-Roscoe
selection criteria.
5 Install XTPM CICS Interface modules. Optional.
6 Review XTPM CICS Programmed Interface.
Optional.
7 Install XTPM TSO Interface modules. Optional.
8 Install XTPM Advantage CA-Roscoe Interface
modules. Optional.
9 Activate XTPM.

B-2 Installation Guide

B.2 Step 2: Review XTPM Description

XTPM provides the necessary session and terminal management services to
properly implement communications with the external environment. XTPM
operates in much the same manner as CICS MRO.

XTPM uses MVS Cross Memory Services facilities (described in Appendix A of

the Advantage CA-Roscoe Interactive Environment System Reference Guide) to
transfer data between the Advantage CA-Roscoe system and an external
application. The use of Cross Memory Services limits the scope of application
connection to a single MVS system.

Communications between the external application and a target Advantage

CA-Roscoe is implemented through the use of one or more external interface
modules. For each specific application type (for example, CICS, TSO, and
Advantage CA-Roscoe) to be used with XTPM, at least one interface module
must be created.

The source for all the XTPM environment services routines is contained in the
RO60MAC library. These routines are provided in source format to ensure that
they correctly reflect your site's system configuration and version level. This
source should not be modified since the XTPM External Application Controller
Module (ROSXAPPL) is dependent on the structure of the environment
modules. Unauthorized changes to the source modules may cause damage to
the external environment or the target Advantage CA-Roscoe system.

Appendix B. Install XTPM B-3

B.3 Step 3: Review XTPM Generation Macro(s)

Use the appropriate XTPM generation macro to create the service routines
needed for a specific environment. The XTPM generation macros (distributed
on RO60OPT) are:
CICSINST generates the CICS service routine.
XTSOINST generates the TSO service routine.
XROSINST generates the Advantage CA-Roscoe/ETSO service routine.

In all cases, the format of the generation macro is:

XTPM Generation Macro Syntax

──XTPMxxxx──ROSID=code──┬────────────────┬─────────────────────
└─,VTAM─┬─YES─┬──┘
└─NO──┘
──┬──────────────────┬──┬──────────────────┬───────────────────
└─,EXTSEC─┬─YES─┬──┘ └─,SUBSET─┬─YES─┬──┘
└─NO──┘ └─NO──┘

XTPMxxxx Identify the environment-specific generation macro by replacing

xxxx with the appropriate environment type of CICS, TSO, or
ROS.
ROSID= Four-character code that identifies the target Advantage
CA-Roscoe system(s) that may be accessed from this Interface
module.
One or more explicit or generic codes may be specified. An
explicit value is the ROSID= initialization parameter of a
particular Advantage CA-Roscoe system (as in, ROSID=ROS1).
A generic value is a pattern to be used for wildcard matching. It
must contain four characters where each character can be a
question mark (?). The value ???? is a global, generic value
indicating that this Interface module is to attempt to connect to
any active Advantage CA-Roscoe system that supports XTPM. If
???? is used, no other ROSID text may be given.
When multiple values are specified, they must be bound by
parentheses, as in:
ROSID=(ROS1,ROS2,ROS3,TEST)
where four explicit values are specified. The same Advantage
CA-Roscoes can be accessed by using a generic value with an
explicit value, as in:
ROSID=(ROS?,TEST)

B-4 Installation Guide

B.3 Step 3: Review XTPM Generation Macro(s)

VTAM= (CICSINST only.) Indicates whether VTAM terminals are to be

used with XTPM by specifying:
YES Causes the generation of an interface module to support
both BTAM and VTAM.
NO Causes VTAM to be excluded.
This operand is included on all generation macros but has no
effect for TSO or Advantage CA-Roscoe.
If omitted, the default is VTAM=YES.
EXTSEC= Indicate the presence of an external security system by specifying:
YES Causes XTPM to extract the terminal user's USERID from
an external security system.
NO Causes the terminal user to supply an Advantage
CA-Roscoe sign-on key and password. The user-supplied
sign-on key is passed to Advantage CA-Roscoe as
entered.
If omitted, the default is EXTSEC=NO.
If YES is specified, an external security system must be active in
the calling application environment. If XTPM cannot extract the
USERID, the connect attempt is aborted.
The USERID is passed to the target Advantage CA-Roscoe as is.
The SCB field SCBSSOPT for that Advantage CA-Roscoe will
have the flag SCBSSMSO turned on at entry to the site ACFEXIT.
This flag indicates that a mirrored SIGNON is active for this
session. The ACFEXIT SIGNON logic should implement
PASSCHK=NO type processing when this flag is sensed as on.
SUBSET= For use only when Advantage CA-Roscoe is being installed in
conjunction with another Computer Associates product. See the
installation instructions provided with the Computer Associates
product.
Advantage CA-Roscoe users must allow this operand to default
to NO. Specifying YES causes unpredictable results and may
cause damage to the external system.

Appendix B. Install XTPM B-5

B.4 Step 4: Determine Advantage CA-Roscoe Selection Criteria

B.4 Step 4: Determine Advantage CA-Roscoe Selection

Criteria
Each Advantage CA-Roscoe that is executed by a site is identified by a unique
four-character name. This name is specified using the ROSID= initialization
parameter.

When XTPM Interface modules are installed, their definitions include the
names (ROSID names) of one or more Advantage CA-Roscoes that may use
those modules. The definitions can contain:

The ROSID name of a single The user is always routed to that

Advantage CA-Roscoe Advantage CA-Roscoe.
A list of explicit or generic ROSIDs The user is routed to either:
1. the explicit Advantage
CA-Roscoe identified when the
user signed on, or
2. the Advantage CA-Roscoe with
the lowest current session count
if the user specified a generic
ROSID when signing on.
A global wildcard (for example, ????) Every active Advantage CA-Roscoe
ROSID system that supports XTPM is
evaluated as a candidate for
connection. The user is connected to
the Advantage CA-Roscoe with the
lowest current session count.

Note: Only Advantage CA-Roscoe of the same version can be connected. Sites
cannot connect Advantage CA-Roscoe having different version levels.

Depending on how the XTPM module definitions are established, site

management has to tell their users which ROSID names are to be used to
access Advantage CA-Roscoe at their sites. For example, assume that a site is
executing four Advantage CA-Roscoes that are identified as ROS1, ROS2,
ROS3, and TEST. Also assume that the XTPM definition contains
ROSID=(ROS?,TEST). If the user enters:

NO ROSID The user is connected to the Advantage CA-Roscoe with

the lowest current session count.
ROSID=ROS1 The user is connected to the Advantage CA-Roscoe
explicitly identified, regardless of the current session
count.

B-6 Installation Guide

B.4 Step 4: Determine Advantage CA-Roscoe Selection Criteria

ROSID=ROS? The user is connected to the Advantage CA-Roscoe with

the lowest session count and a name beginning with
ROS.
ROSID=???? The user is connected to the Advantage CA-Roscoe with
the lowest session count.

The Advantage CA-Roscoe Interactive Environment User Guide contains general

information about signing on to Advantage CA-Roscoe with XTPM. If a site is
going to allow their users to access multiple Advantage CA-Roscoes through
XTPM, you must ensure that your users know which ROSID names are to be
used.

Appendix B. Install XTPM B-7

B.5 Step 5: Install XTPM CICS Interface Modules

Skip this step if your site does not plan to allow users to access Advantage
CA-Roscoe from terminals defined to CICS/VS.

If you are going to provide this access capability, you must perform the three
steps described in this section. These include:
1. Copying the appropriate XTPM Interface installation JCL.
2. Modifying and submitting the JCL.
3. Installing the CICS Interface modules.

B.5.1 Copy the Appropriate XTPM Interface Installation JCL

Copy the member CICSINST from the installation sample JCL library.

B.5.2 Modify and Submit the JCL

Review the JCL and make any necessary changes:
■ STEP01: Modify RO60OPT member CICSINST so that ROSID= identifies a
unique four-character Advantage CA-Roscoe identification code.
■ STEP02: Verify that the STEPLIB DD statement identifies your site CICS
load library.
Verify that you did not change the module name ROSZCICS.
■ STEP03: Change the character code CAI. in the PROC definition statement
to your Advantage CA-Roscoe high-level qualifier.
■ STEP04: Verify that the SYSLIB DD statement identifies your site CICS
macro library.
■ STEP05:
– Verify that the SYSLIB DD statement correctly identifies your site CICS
load library.
– The SYSLMOD DD load library name can be changed if you do not
want your XTPM Interface module in the same library as the supplied
Advantage CA-Roscoe system.
If you are going to generate a single XTPM CICS Interface module, do
not change the module name ROSFCICS. If, however, you are going to
generate multiple Interface modules, change the load module name so
that it is unique.

Save your customized JCL. You may need this JCL to re-install your XTPM
Interface modules after maintenance. If you experience XTPM-related
problems, the Advantage CA-Roscoe Support Staff may request that you
provide a copy of your installation JCL.

B-8 Installation Guide

B.5 Step 5: Install XTPM CICS Interface Modules

Note: This JCL should be submitted only after the SMP/E ACCEPT of the
base Advantage CA-Roscoe SYSMOD CRO6000.

Submit the modified JCL.

The CICS Command Level Translator is invoked to process the environment

service routine EXEC CICS statements. If the version of CICS is less than CICS
2.1, the Translator step produces a condition code 8. This is normal; the XTPM
environment routines for CICS contain EXEC CICS statements that implement
facilities not provided before CICS 2.1. The ASSEMBLY step determines your
CICS version level and only use the services available at your version level.

The XTPM generation macros produce the necessary Linkage Editor control
cards to include the ROSXAPPL object module and provide external
environment specific linkages.

Review the output from the job. With the exception noted above, all steps
should complete with condition code 0. Print and save the assembly listings.

B.5.3 Install the CICS Interface Modules

For each Interface module created, you must define an entry for the load
module in the CICS PPT. If your site is using:
■ The DFHPPT table macros, create a new macro entry for each module as
follows:
DFHPPT TYPE=ENTRY,PROGRAM=module-name
■ RDO, create a program resource entry for each load module using the
CEDA transaction. CICS group and profile definitions should follow site
conventions.

For each interface module created, you must define one or more CICS
TRANSIDs. If your site is using:
■ The DFHPCT table macros, create a new macro entry for each TRANSID
as follows:
DFHPCT TYPE=ENTRY,TRANSID=transid,PROGRAM=module-name
■ RDO, create a TRANSID resource entry for each transaction using the
CEDA transaction. CICS group and profile definitions should follow site
conventions.

Appendix B. Install XTPM B-9

B.5 Step 5: Install XTPM CICS Interface Modules

Document the TRANSIDs and program assignments to be used with each

interface module. Your TRANSIDs and load module definitions should reflect
the intended XTPM usage from CICS. You may choose to implement multiple
Interface load modules; each with a different set of ROSID values to
automatically route CICS users to different Advantage CA-Roscoe systems.

Add the load library containing your XTPM Interface load modules to the
DFHRPL DD statement for your CICS.

B-10 Installation Guide

B.6 Step 6: Review XTPM CICS Programmed Interface

To allow for site-provided CICS/VS menu systems and automated call
facilities, the XTPM CICS Interface definition has a defined call activation
mode.

This mode is identified as XUSR mode. In this mode, the XTPM Interface
module can be activated either by EXEC CICS LINK or by EXEC CICS XCTL
with a COMMAREA. The passed COMMAREA provides the Interface module
with the data values that are to be used to activate the session and with
information about Interface termination.

The macro XUSRSTRT (distributed in RO60MAC) defines the required

structure of the passed COMMAREA. All values in the COMMAREA are
either character strings or binary integers. No bit flags or complex encoded
data types are used to allow for ease of access from COBOL programs. Review
the XUSRSTRT macro, along with the assembled XTPM CICS service routines,
for complete details about defined call implementation.
Note: ROSXAPPL expects information from the XTPM Interface module in an
internally defined form; alternation of control areas may cause Interface
failures.

The XTPM Interface logic processes the XUSRSTRT data on initial entry to the
session. The COMMAREA passed must start with the four-character value
XUSR. An improperly defined COMMAREA causes the XTPM Interface to
ignore the defined call data and proceed in the normal manner.

With the defined call mode, a site program may provide the following
information to the XTPM CICS Interface module:
1. The method XTPM is to use to exit at session termination.
A site may choose to have the XTPM Interface exit in one of the following
ways at session termination.
NORMAL Send exit data and EXEC CICS RETURN. This is the
standard XTPM termination mode.
TRANSID Send exit data and EXEC CICS RETURN TRANSID(tttt)
where the site supplies the TRANSID value (tttt) in the
XUSRSTRT COMMAREA.
PROGRAM EXEC CICS XCTL PROGRAM(pppppppp)
COMMAREA(dddd)
where XTPM termination exits to the site program identified
in XUSRSTRT passing any exit data as a COMMAREA.

Appendix B. Install XTPM B-11

B.6 Step 6: Review XTPM CICS Programmed Interface

2. The name of the site exit effector.

3. Termination message options.
With the NORMAL and TRANSID exit effectors, a site program may
choose to have XTPM suppress any exit data messages at Interface
termination.
In the case of PROGRAM termination, the XTPM Interface always passes a
COMMAREA to the site exit program.
The COMMAREA contains the text of the exit data or a null data message,
if no exit text is available. It is the responsibility of the site program to
determine appropriate cleanup requirements. The terminal screen is not
erased before exit to the site program.
4. The screen size (row/column) required for execution.
To allow for cases where the CICS/VS transaction currently active has a
different SCRNSIZE value than that desired for XTPM, the site program
may specify the value to be used by XTPM for terminal ROWS and
COLUMNS. These values override those extracted from CICS. XTPM
alters these values if they exceed the maximums supported by the Interface
program.
5. Image of the session initialization data.
Since the XTPM Interface requires session initialization data, the site
program must pass an image of the activation data. The minimum data
required is the XTPM TRANSID that is to be used during Interface
processing. Additional data may include the user's Advantage CA-Roscoe
sign-on ID and password and the ROSID= keyword.
If the activation data is not specified or is incorrect, the XTPM Interface
attempts to access a Terminal Input Area.
Note that the TRANSID specified must properly identify the XTPM
Interface Module that is called by the site program.
After XTPM Interface activation, processing is the same as if the terminal
user directly provided the initialization information.

B-12 Installation Guide

B.7 Step 7: Install XTPM TSO Interface Modules

Skip this step if your site does not plan to allow users to access Advantage
CA-Roscoe from a TSO session.

If you are going to provide this access capability, you must perform the three
steps described in this section. These include:
1. Copying the appropriate XTPM Interface installation JCL
2. Modifying and submitting the JCL
| 3. Installing the TSO Interface modules

B.7.1 Copy the Appropriate XTPM Interface Installation JCL

Copy the member XTSOINST from the installation sample JCL library.

B.7.2 Modify and Submit the JCL

In addition to editing the JCL to meet site standards for JOBCARD and JES
classes, verify the following information:
■ STEP01: Modify RO60OPT member XTSOINST to ensure that ROSID=
identifies a unique four-character Advantage CA-Roscoe identification
code.
■ STEP02: Change the character code CAI. in the PROC definition statement
to your Advantage CA-Roscoe high-level qualifier.
■ STEP03: The SYSLMOD DD load library name can be changed if you do
not want your XTPM Interface module in the same library as the supplied
Advantage CA-Roscoe system.
If you are going to generate a single XTPM TSO Interface module, do not
change the module name ROSF. If you are going to generate multiple
Interface modules, change the load module name so that it is unique.

Save your customized JCL. You may need this JCL to re-install your XTPM
Interface modules after maintenance. In addition, if you experience
XTPM-related problems, the Advantage CA-Roscoe Support Staff may request
that you provide a copy of your installation JCL.
Note: This JCL should be submitted only after the SMP/E ACCEPT of the
base Advantage CA-Roscoe SYSMOD CRO6000.

Submit the modified JCL.

Appendix B. Install XTPM B-13

B.7 Step 7: Install XTPM TSO Interface Modules

The XTPM generation macros will produce the necessary Linkage Editor
control cards to include the ROSXAPPL Object module and provide external
environment specific linkages.

Review the output from the job. All steps should complete with condition code
0. Print and save the assembly listings.

B.7.3 Install the TSO Interface Modules

Each TSO Interface module created is a standard TSO Command Processor.

Add the load library containing the TSO Interface modules to the TSO
STEPLIB for each user to access Advantage CA-Roscoe by TSO. The load
module name is also the Command Processor name. (Do not attempt to
execute TSO Interface modules under Advantage CA-Roscoe ETSO. The XTPM
External Application Controller (ROSXAPPL) will sense this and fail the
request.)

Document the Command Processor names to be used with each Interface

module. Your Command Processor load module definitions should reflect the
intended XTPM usage from TSO. You may also choose to implement multiple
Interface load modules; each with a different set of ROSID values to
automatically route TSO users to the different Advantage CA-Roscoe systems.

B-14 Installation Guide

B.8 Step 8: Install XTPM Advantage CA-Roscoe Interface Modules

B.8 Step 8: Install XTPM Advantage CA-Roscoe Interface

Modules
Skip this step if your site does not plan to allow users to access Advantage
CA-Roscoe from another Advantage CA-Roscoe session.

B.8.1 Copy the Appropriate XTPM Interface Installation JCL

Copy the member XROSINST from the installation sample JCL library.

B.8.2 Modify and Submit the JCL

In addition to editing the JCL to meet site standards for JOBCARD and JES
classes, verify the following information:
■ STEP01: Modify RO60OPT member XROSINST to ensure that ROSID=
identifies a unique four-character Advantage CA-Roscoe identification
code.
■ STEP02: Change the character code CAI. in the PROC definition statement
to your Advantage CA-Roscoe high-level qualifier.
■ STEP03: The SYSLMOD DD load library name can be changed if you do
not want your XTPM Interface module in the same library as the supplied
Advantage CA-Roscoe system.
If you are going to generate a single XTPM Advantage CA-Roscoe
Interface module, do NOT change the module name ROSXROS. If you are
going to generate multiple Interface modules, change the load module
name so that it is unique.

Submit the modified JCL.

Appendix B. Install XTPM B-15

B.8 Step 8: Install XTPM Advantage CA-Roscoe Interface Modules

The XTPM generation macros will produce the necessary Linkage Editor
control cards to include the ROSXAPPL Object module and provide external
environment specific linkages.

Review the output from the job. All steps should complete with condition code
0. Print and save the assembly listings.

B.8.3 Install the Advantage CA-Roscoe Interface Modules

Each Advantage CA-Roscoe Interface module created is an ETSO-only
Command Processor.

Add the load library containing the Advantage CA-Roscoe Interface modules
to the ETSOLIB DD statement for each Advantage CA-Roscoe that will access
other Advantage CA-Roscoes using XTPM. Do not attempt to execute an
Advantage CA-Roscoe XTPM Interface module from TSO; the XTPM External
Application Controller (ROSXAPPL) senses this attempt and aborts the
connection.

For each Interface load module created, you must add an entry to the
Advantage CA-Roscoe ETSO EPL on each system that executes the XTPM
Interface. The format of the entry is shown in the table on the following page.
Note: See the Advantage CA-Roscoe Interactive Environment System Reference
Guide for a description of the EPL (Eligible Program List).

In this entry, you must supply:

Column 1-8 The name of the program entry point.
Column 10-12 The number of concurrent users of the Interface module.
The XTPM Interface module does not require storage above the 16MB line.

Column Contents Meaning

| 1-8 ROSXROS Program entry point.
| 10-12 n Maximum number of concurrent application
| executions. (Adjust this number as needed.)
14-17 9999 Maximum number of CPU time slices.
19-24 80 Total amount of storage to be provided below the
16MB line.
26-31 000000 Total amount o storage to be provided per
GETMAIN request below the 16MB line.
33-38 000000 Total amount of storage to be provided above the
16MB line.
40-45 000000 Total amount of storage to be provided per
request above the 16MB line.

B-16 Installation Guide

B.8 Step 8: Install XTPM Advantage CA-Roscoe Interface Modules

Column Contents Meaning

47 N Dump flag.
49 Y MODESET authorization flag.
51-52 CP Command Processor Flag.

Document the names to be used with each Interface module. The load module
definitions should reflect the intended XTPM usage from Advantage
CA-Roscoe. You may also choose to implement multiple Interface load
modules; each with a different set of ROSID values to automatically route
Advantage CA-Roscoe users to different systems.

Appendix B. Install XTPM B-17

B.9 Step 9: Activate XTPM

Each Advantage CA-Roscoe that is to be the target for XTPM sessions must
have the following initialization parameter in its execution JCL:
XTPM=nnn

where nnn is a numeric value representing the number of Advantage

CA-Roscoe sessions that may be dedicated to an XTPM session.

Also, ensure that the value specified with the Advantage CA-Roscoe
TERMSO= initialization parameter reflects the additional sessions that are to be
dedicated to XTPM. For additional information about these initialization
parameters, see the Advantage CA-Roscoe Interactive Environment Programs and
Utilities Guide.

B-18 Installation Guide

Index

authorization codes, obtaining 6-5

Special Characters Authorized Library Requirements
&ros. documentation 4-40 overview 2-2
AWS
A Allocate Data Sets 4-17
Blocksize Considerations 4-17
ACCEPT
Format
Advantage CA-Roscoe Components 4-39
Data Sets 4-17
CA-JCLCheck Options 4-39
AWSAWS# Parameter 4-18
CA-PROFILE 4-39
AWSDBLK Parameter 4-18
Description 1-1
AWSDS# Parameter 4-18
ACCEPTing
AWSSIZE Parameter 4-18
Maintenance 5-12
AccountConnect 6-4
Accounting B
Allocate Data Sets 4-26 Blocksize Considerations
Accounting Files Accounting Files 4-26
Blocksize Considerations 4-26 AWS 4-17
Space Considerations 4-27 User Library 4-20
Advantage CA-Roscoe BookManager
Communications Services Advantage CA-Roscoe documentation
See RCS 4-24 online 4-40
Executing 4-37
Printing Services
See RPS C
Allocate CA Common Services for z/OS
Accounting Data Sets 4-26 CAIRIM 2-13
AWS Data Sets 4-17 LMP 2-13
Private SMP/E Libraries 4-12 LMP support 2-13
Target/Distribution Libraries 4-11 System Requirements 2-13
User Libraries 4-19 CA-JCLCheck
APPLY Accept Options 4-39
Advantage CA-Roscoe Components 4-16 Apply Options 4-16
CA-JCLCheck Options 4-16 Install 4-36
CA-PROFILE 4-16 Receive Options 4-15
Description 1-1 CA-TCC (CA Total Client Care)
APPLY CHECKing See SupportConnect
Maintenance 5-8 CA-TLC (CA Total License Care) 6-5
APPLYing CAI.SAMPJCL
Maintenance 5-10 File on tape 3-1

Index X-1
CAI.SAMPJCL (continued) Formatting
Install 4-10 AWS Data Sets 4-17
CAI.SMPCSI User Libraries 4-19
Create 4-12
Using 4-12
CAINITE5 4-12 H
CAIRIM Hardware requirements 2-4
CA Common Services for z/OS 2-13
CAI Resource Initialization Manager 2-13
CICS
I
Installation
XTPM
&ros. documentation
Interface Modules B-8
BookManager 4-40
Programmed Interface B-11
ACCEPT Advantage CA-Roscoe 4-39
Compatibility 2-12
Add LMP Keys 4-9
Conversion
APPLY Advantage CA-Roscoe 4-16
Considerations, description 4-7
CA-JCLCheck Component 4-36
Customizing
Customize SMP/E 4-13
List of Members (Advantage CA-Roscoe) 4-33
Disk Space 2-7
Reveiw Options 4-33
Documentation 3-3
SMP/E 4-13
Load Sample JCL 4-10
RECEIVE Advantage CA-Roscoe 4-15
D Saving Materials and Output 4-4
DASD devices supported 2-7 Summary 4-2
Data Set Facility Tape, Contents 3-1
Installation Overview 4-28 Worksheet
Dialog Management Facility (DMF) Completion 4-8
Installation Overview 4-29 Internet, CA site 6-4
Disk devices supported 2-7
Disk Space Requirements 2-7
Distribution Libraries
L
Libraries
Allocate 4-11
Distribution 2-8
Description 2-8
Product 2-9
Documentation, Distributed 3-3
Target 2-7
Download
license keys, obtaining 6-5
Advantage CA-Roscoe documentation 4-40
Licensing Management Program (LMP) 2-13
LMP Keys
E Adding 4-9
eSupport LMP support, CA Common Services for z/OS 2-13
See SupportConnect
ETSO
Installation Overview 4-29
M
Maintenance
Executing
ACCEPTing 5-12
Advantage CA-Roscoe 4-37
APPLY CHECKing 5-8
EXTSEC= Operand, XTPMxxxx Macros B-4
APPLYing 5-10
Customizing SMP/E Procedure 5-6
F Materials 5-2, 5-3
FAWSDS Program 4-18 RECEIVING 5-7
Saving 5-13
Steps 5-1

X-2 Installation Guide

Monitor Routines RO60ACC Member 4-39
Installation Overview 4-30 RO60ALAC Member 4-26
MRO6010 Member (JES2) 4-23 RO60ALC Member 4-11
MRO6011 Member (JES3) 4-23 RO60ALRU Member 4-19, 4-20
MRO6012 Member (RCS) 4-24 RO60APP Member 4-16
MRO6013 Member (RPS) 4-25 RO60FAWS Member 4-17
MVS Operating System RO60OPT Data Set
Supported releases 2-6 Customizing Advantage CA-Roscoe 4-33
RO60REC Member 4-15
RO60SMPE Member 4-13
O RO60SRRU Member 4-21
Operating Environments 2-6 RO60XJCL Member 4-37
Optional components 2-12 RO60ZONE Member 4-12
Overview ROSACT00 4-26
XTPM Installation B-3 ROSGBL Macro 4-23
ROSID= Operand, XTPMxxxx Macros B-4
P RPS 4-25
Installation 4-25
PF/PA Keys
Assignment
Installation Overview 4-31 S
Phone Services Directory 6-5 Saving
Printing Network Maintenance 5-13
Establish 4-25 Security/Accounting Exit Facilities
Product Libraries 2-9 Installation Overview 4-32
SKETCH
R Installation Overview 4-32
SMP/E
RCS
Customize 4-13
Installation 4-24
Customizing SMP/E Procedure 5-6
RE-APPLYing
Description 1-1
SYSMODs 5-11
Library
RECEIVE
Allocate 4-12
Advantage CA-Roscoe 4-15
Software
CA-JCLCheck Options 4-15
compatibility 2-12
CA-PROFILE 4-15
requirements 2-12
Description 1-1
Space Requirements
RECEIVING
User Libraries 4-20
Maintenance 5-7
StarTCC
Requirements
See SupportConnect
Authorized Library 2-2
SUBSET= Operand, XTPMxxxx Macros B-4
Disk space 2-7
Support Phone Services Directory 6-5
Hardware 2-4
SupportConnect 6-4
Software 2-12
Supported DASD devices 2-7
System 2-6
SYSMODs
Restore
Re-APPLYing 5-11
User Libraries 4-21
RESTORing 5-9
User Prefixes 4-21
System Address Space
RESTORing
Restrictions 4-38
SYSMODs 5-9
System Requirements
CA Common Services for z/OS 2-13

Index X-3
System Requirements (continued)
Overview 2-6

T
Tape Installation 3-1
Target libraries
Allocate 4-11
Description 2-7
Technical Support Phone Services Directory 6-5
Total License Care (CA-TLC) 6-5
Troubleshooting 6-1, 6-7
TSO
XTPM Installation
Interface Modules B-13
TTY (And Compatible) Terminals
Installation Requirements 2-10

U
User Libraries
Allocate 4-19
Blocksize 4-20
Format 4-19
Restore 4-21
Space Requirement 4-20
User Prefixes 4-21

V
VTAM
Installation Requirements 2-11
VTAM= Operand, XTPMCICS Macro B-4

X
XTPM
Activate B-18
Installation
Advantage CA-Roscoe Modules B-15
Checklist B-2
CICS Modules B-8
CICS Programmed Interface B-11
Generation Macros B-4
Overview B-3
TSO Modules B-13
XTSOINST Member B-13

X-4 Installation Guide

SIMULADO COMPLETO MD-102 1
No ratings yet
SIMULADO COMPLETO MD-102 1
275 pages
Roscoe v6.0 - Getting Started Guide
100% (1)
Roscoe v6.0 - Getting Started Guide
106 pages
ROSCOE - B001613e - Command Reference Guide
No ratings yet
ROSCOE - B001613e - Command Reference Guide
740 pages
Control-M For OS/390 and z/OS: CA-7 Conversion Guide
No ratings yet
Control-M For OS/390 and z/OS: CA-7 Conversion Guide
214 pages
FTAC InstallGuide
No ratings yet
FTAC InstallGuide
95 pages
ROSCOE - B001733e - User Guide
No ratings yet
ROSCOE - B001733e - User Guide
592 pages
ROSCOE - B001723e - System Reference Guide
No ratings yet
ROSCOE - B001723e - System Reference Guide
374 pages
CA 7 Handbook
No ratings yet
CA 7 Handbook
418 pages
A7 Database Maintenance GCuide 3.3
No ratings yet
A7 Database Maintenance GCuide 3.3
412 pages
Ca7 Job Management
50% (2)
Ca7 Job Management
414 pages
ROSCOE - B001673e - Programs and Utilities Guide
No ratings yet
ROSCOE - B001673e - Programs and Utilities Guide
326 pages
Utilities
No ratings yet
Utilities
569 pages
Unicenter CA-7 Job Management
No ratings yet
Unicenter CA-7 Job Management
698 pages
Design Facility Reference 4.1
No ratings yet
Design Facility Reference 4.1
642 pages
CA7 33 Sysprog
No ratings yet
CA7 33 Sysprog
434 pages
Tib RV Administration
No ratings yet
Tib RV Administration
457 pages
ROSCOE - B001622e - Extended Development Tools Guide
No ratings yet
ROSCOE - B001622e - Extended Development Tools Guide
126 pages
ECC AdvancedConfig
No ratings yet
ECC AdvancedConfig
144 pages
Ca7 Interface Guide
100% (1)
Ca7 Interface Guide
218 pages
CA7 Workload Automation RefGd
0% (1)
CA7 Workload Automation RefGd
378 pages
Database Maintenance PDF
No ratings yet
Database Maintenance PDF
418 pages
CA7 33 DBMaint
No ratings yet
CA7 33 DBMaint
418 pages
Wa Ca7 Commandref Enu
No ratings yet
Wa Ca7 Commandref Enu
720 pages
Alcatel - A956-RNO Acceptance Test
No ratings yet
Alcatel - A956-RNO Acceptance Test
40 pages
Avaya Multivantage
No ratings yet
Avaya Multivantage
70 pages
Sms Admin
No ratings yet
Sms Admin
764 pages
SNA12.0 Install and MigrateV2
No ratings yet
SNA12.0 Install and MigrateV2
78 pages
RV Administration
No ratings yet
RV Administration
320 pages
In 1040 InstallationForPowerCenterAndDataQuality en
No ratings yet
In 1040 InstallationForPowerCenterAndDataQuality en
287 pages
TIB Ems 8.3 Ca
No ratings yet
TIB Ems 8.3 Ca
81 pages
Ca2e Install Enu
No ratings yet
Ca2e Install Enu
72 pages
DataPrivacyManagment en
No ratings yet
DataPrivacyManagment en
238 pages
DB2 UDB For zOS V8 - Application Connectivity - Program Directories
No ratings yet
DB2 UDB For zOS V8 - Application Connectivity - Program Directories
29 pages
ECC Install
No ratings yet
ECC Install
76 pages
CA View - BestPractices
No ratings yet
CA View - BestPractices
33 pages
Advatage DatacomDB Messages Codes
No ratings yet
Advatage DatacomDB Messages Codes
790 pages
SG 247645
No ratings yet
SG 247645
160 pages
XPCICSCOBOLUserGuide PDF
No ratings yet
XPCICSCOBOLUserGuide PDF
194 pages
P550R
No ratings yet
P550R
756 pages
Procash/Ndc V3.0/00 Proconsult/Ndc V3.0/00: User Guide
No ratings yet
Procash/Ndc V3.0/00 Proconsult/Ndc V3.0/00: User Guide
438 pages
Maximo Asset Management Essentials V7.1 Implementer's Guide: Front Cover
100% (2)
Maximo Asset Management Essentials V7.1 Implementer's Guide: Front Cover
160 pages
TLE 6.2 SAP R3 and R4 Setup and User Guide
No ratings yet
TLE 6.2 SAP R3 and R4 Setup and User Guide
145 pages
CA1 52 GeneralInformation
No ratings yet
CA1 52 GeneralInformation
96 pages
1700 PAC Control Users Guide
No ratings yet
1700 PAC Control Users Guide
432 pages
Enterprise Backup Solution Design Guide
No ratings yet
Enterprise Backup Solution Design Guide
183 pages
Administering Avaya Session Border Controller For Enterprise 10-10-2019 PDF
100% (1)
Administering Avaya Session Border Controller For Enterprise 10-10-2019 PDF
644 pages
R0JOBT11PIE
No ratings yet
R0JOBT11PIE
302 pages
R0jobt11pie PDF
No ratings yet
R0jobt11pie PDF
302 pages
Installation & Maintenance Guide For Co-Resident Server
100% (1)
Installation & Maintenance Guide For Co-Resident Server
3,226 pages
Advanced Multiplayer Game Development with Ureal Engine 5: A Comprehensive Guide to C++ Scripting
From Everand
Advanced Multiplayer Game Development with Ureal Engine 5: A Comprehensive Guide to C++ Scripting
Vladimir Kiselev
No ratings yet
Mastering Python Advanced Concepts and Practical Applications
From Everand
Mastering Python Advanced Concepts and Practical Applications
Aissa Younes
No ratings yet
Cloud Computing : Beginners And Intermediate User Guide
From Everand
Cloud Computing : Beginners And Intermediate User Guide
David comer
No ratings yet
Plain JavaScript: Learning the Front-End
From Everand
Plain JavaScript: Learning the Front-End
Roger Beans-Rivet
No ratings yet
CompTIA A+ Complete Review Guide: Core 1 Exam 220-1101 and Core 2 Exam 220-1102
From Everand
CompTIA A+ Complete Review Guide: Core 1 Exam 220-1101 and Core 2 Exam 220-1102
Troy McMillan
5/5 (2)
Blog Smarter, Not Harder: SEO, Blogging, and AI Strategies to Skyrocket Your Traffic
From Everand
Blog Smarter, Not Harder: SEO, Blogging, and AI Strategies to Skyrocket Your Traffic
Jay Nans
No ratings yet
Gray Hat Hacking the Ethical Hacker's
From Everand
Gray Hat Hacking the Ethical Hacker's
Çağatay Şanlı
5/5 (1)
The SAS Programmer's PROC REPORT Handbook: Basic to Advanced Reporting Techniques
From Everand
The SAS Programmer's PROC REPORT Handbook: Basic to Advanced Reporting Techniques
Jane Eslinger
No ratings yet
Accelerated Computing With HIP: Second Edition
From Everand
Accelerated Computing With HIP: Second Edition
Yifan Sun
No ratings yet
Jess in Action: Rule-Based Systems in Java
From Everand
Jess in Action: Rule-Based Systems in Java
Ernest Friedman-Hill
3.5/5 (2)
Mastering Docker for Scalable Deployment: From Container Basics to Orchestrating Complex Work
From Everand
Mastering Docker for Scalable Deployment: From Container Basics to Orchestrating Complex Work
Kameron Hussain
No ratings yet
Web Video Business
From Everand
Web Video Business
MUHAMMAD NUR WAHID ANUAR
No ratings yet
XPEDITER/TSO - Stepping Through Program Execution: General Questions
No ratings yet
XPEDITER/TSO - Stepping Through Program Execution: General Questions
20 pages
ROSCOE - B001712e - System Commands Guide
No ratings yet
ROSCOE - B001712e - System Commands Guide
150 pages
DB2 For zOS Application Programming Topics - sg246300 PDF
No ratings yet
DB2 For zOS Application Programming Topics - sg246300 PDF
292 pages
Git - Notes
No ratings yet
Git - Notes
37 pages
7 Security
No ratings yet
7 Security
15 pages
From Tricksguide - Com "How To Configure Ilo On Your HP Proliant"
No ratings yet
From Tricksguide - Com "How To Configure Ilo On Your HP Proliant"
35 pages
Huawei OceanStor Backup Software Technical White Paper For Simpana 1
No ratings yet
Huawei OceanStor Backup Software Technical White Paper For Simpana 1
62 pages
Command Juniper Resume
No ratings yet
Command Juniper Resume
4 pages
B1W English User Manual
No ratings yet
B1W English User Manual
18 pages
Windows Server 2008 r2 Interview Questions and Answers Part1
No ratings yet
Windows Server 2008 r2 Interview Questions and Answers Part1
6 pages
Lect 10 - Configuring Web Server (IIS)
No ratings yet
Lect 10 - Configuring Web Server (IIS)
18 pages
Training Manual: Piping Spools
No ratings yet
Training Manual: Piping Spools
72 pages
Paypal L3id
No ratings yet
Paypal L3id
4 pages
Directory Mappings Aix Freebsd Hp-Ux Linux (Redhat) Solaris Tru64
No ratings yet
Directory Mappings Aix Freebsd Hp-Ux Linux (Redhat) Solaris Tru64
6 pages
IBM Worklight Mobile Application Development Essentials Sample Chapter
No ratings yet
IBM Worklight Mobile Application Development Essentials Sample Chapter
25 pages
Database Server: Advanced Application Manual
No ratings yet
Database Server: Advanced Application Manual
15 pages
SE25 49 DAW Setup Guide
No ratings yet
SE25 49 DAW Setup Guide
5 pages
Qie Install Guide
No ratings yet
Qie Install Guide
26 pages
KimiosBundleDeployer EN PDF
No ratings yet
KimiosBundleDeployer EN PDF
7 pages
Safari - O'Reilly Class Preparation
No ratings yet
Safari - O'Reilly Class Preparation
10 pages
Technical Bulletin DSm716/721
No ratings yet
Technical Bulletin DSm716/721
2 pages
STD 11 Computer MCQ PDF
No ratings yet
STD 11 Computer MCQ PDF
8 pages
ISF21 Lab Manual PDF
No ratings yet
ISF21 Lab Manual PDF
143 pages
Apache Training
No ratings yet
Apache Training
20 pages
Frida Unleashed
No ratings yet
Frida Unleashed
24 pages
Tripwire Operations Center: Provisioning Guide
No ratings yet
Tripwire Operations Center: Provisioning Guide
17 pages
Server Less
No ratings yet
Server Less
6 pages
Exceed On Demand Admin Guide
No ratings yet
Exceed On Demand Admin Guide
208 pages
NETSM410
No ratings yet
NETSM410
156 pages
ReadMe Cooker
100% (1)
ReadMe Cooker
5 pages
Guide To Program EVK1100 With AVR32studio
No ratings yet
Guide To Program EVK1100 With AVR32studio
2 pages
Computer HolidaY Homework Class 9 Cbse
No ratings yet
Computer HolidaY Homework Class 9 Cbse
25 pages