K007791E - Getting Started
K007791E - Getting Started
Getting Started
5.0
K00779-1E
This documentation and related computer software program (hereinafter referred to as the Documentation) is for the end users informational purposes only and is subject to change or withdrawal by Computer Associates International, Inc. (CA) at any time. This documentation may not be copied, transferred, reproduced, disclosed or duplicated, in whole or in part, without the prior written consent of CA. This documentation is proprietary information of CA and protected by the copyright laws of the United States and international treaties. Notwithstanding the foregoing, licensed users may print a reasonable number of copies of this documentation for their own internal use, provided that all CA copyright notices and legends are affixed to each reproduced copy. Only authorized employees, consultants, or agents of the user who are bound by the confidentiality provisions of the license for the software are permitted to have access to such copies. This right to print copies is limited to the period during which the license for the product remains in full force and effect. Should the license terminate for any reason, it shall be the users responsibility to return to CA the reproduced copies or to certify to CA that same have been destroyed. To the extent permitted by applicable law, CA provides this documentation as is without warranty of any kind, including without limitation, any implied warranties of merchantability, fitness for a particular purpose or noninfringement. In no event will CA be liable to the end user or any third party for any loss or damage, direct or indirect, from the use of this documentation, including without limitation, lost profits, business interruption, goodwill, or lost data, even if CA is expressly advised of such loss or damage. The use of any product referenced in this documentation and this documentation is governed by the end users applicable license agreement. The manufacturer of this documentation is Computer Associates International, Inc. Provided with Restricted Rights as set forth in 48 C.F.R. Section 12.212, 48 C.F.R. Sections 52.227-19(c)(1) and (2) or DFARS Section 252.227-7013(c)(1)(ii) or applicable successor provisions.
Contents
Chapter 1: Introduction
Unicenter CA-Bundl 5.0 Documentation ..........................................11 Downloading the Documentation ............................................12 Viewing PDF Documentation ................................................13 Related Documentation .....................................................13 Contacting Technical Support ...................................................13 Summary of Product Changes ...................................................14 Conventions Used in this Guide ............................................... 110
Contents
iii
Unicenter CA-Bundl and CA-DRAS ............................................. 33 Installation Requirements ................................................... 33 Mainframe............................................................. 33 PC Environment ....................................................... 34 Unicenter CA-Bundl Installation Materials ....................................... 34 Hardware Requirements ....................................................... 35 Target Libraries ............................................................ 35 Distribution Libraries....................................................... 35 Software Requirements ......................................................... 36 Unicenter CA-Bundl 5.0 Component SYSMODs ............................... 36 CA Common Services Component ........................................... 36 Optional CA-DRAS Component ............................................. 36 Library Authorization .......................................................... 37
iv
Getting Started
Step 8: Enter the LMP Code (Required) ......................................... LMP Key Certificate ...................................................... Defining the CA-LMP Execution Key ....................................... Multiple LMP Codes ...................................................... Step 9: Tailor the Execution JCL................................................ Step 10: Tailor the Procedures ................................................. Step 11: Initialize Test VSAM Files (Required) ................................... Initializing New VSAM Files .............................................. Step 12: Install the CICS Option (Optional)...................................... Installing the CICS Option................................................. Step 13: Install the Advantage CA-Roscoe Option (Optional) ..................... Installing the Advantage CA-Roscoe Option for Use with Unicenter CA-Bundl . Starting the Unicenter CA-Bundl Online System and End-User Facilities ....... Step 14: Install Unicenter CA-Bundl VTAM View (Optional) ..................... Installing VTAM View .................................................... Step 15: Install the TSO Interface (Optional) ..................................... Installing TSO ............................................................ Step 16: Set Up CA-LServ to Execute Unicenter CA-Bundl ........................ Step 17: Test Your Unicenter CA-Bundl Installation .............................. Step 18: Create Production VSAM Files ......................................... Upgrading CA-Bundl 4.9 to Unicenter CA-Bundl 5.0 ......................... Step 19: ACCEPT the Services (Optional) ....................................... ACCEPT Considerations with Pre-Installed Services ......................... Step 20: Using a Single File Server with Multiple Unicenter CA-Bundl Systems .....
411 411 413 414 414 418 419 421 421 422 423 423 424 424 424 426 426 427 428 429 430 432 433 434
Contents
Granting Authority to Screens and Applications ................................. 510 Creating TSF Records...................................................... 511 TSF Detail: Function Security Screen ........................................ 512 Fields and Descriptions ................................................ 512 TSF Detail: Application Security Screen ..................................... 513 Fields and Descriptions ................................................ 514 Granting or Changing Authority Through Exit Routines (Optional) ................ 514 Guidelines ............................................................... 515 Providing Logon-Level Security ............................................ 515 Types of Checking You Can Perform .................................... 516 How Passwords are Handled When SECURITY=BUNDL is Specified .......... 517 LOGONXT Exit Routine ................................................... 518 Modifying User Identifiers and Mail Code Lists at Logon Time ................ 518 Providing Mail Code-Level Security ............................................ 519 Factors That Determine Reports a User Can View ............................ 519 Defining Mail Code-Level Security ......................................... 520 VSF Detail Screen ............................................................. 521 Fields and Descriptions .................................................... 521 Establishing Defaults for Mail Code-Level Security............................... 523 Methods of Establishing Defaults ........................................... 524 Establishing Defaults Through a VSF Record ................................ 524 Establishing Defaults Through the Security Options Screen ................... 525 Authorizing Users for Specific Mail Codes ...................................... 526 Methods of Authorizing Users ............................................. 526 Activating Mail Code-Level Security ............................................ 527
vi
Getting Started
Setting Unicenter CA-Bundl Processing Options ................................ Setting Default User Options for Unicenter CA-Bundl Sessions ................... PF Definitions Screen ......................................................... Fields and Descriptions ................................................... Assigning Unicenter CA-Bundl Commands to PF Keys ..........................
Contents
vii
Online Security Exit Routines .................................................. 723 Types of Online Security Exit Routines ...................................... 724 Logon Security Exit Routine ................................................ 724 Logoff Security Exit Routine ............................................... 724 Mail Code Security Exit Routine ............................................ 725 View Print Security Exit Routine............................................ 725 Application Security Exit Routine........................................... 725 Administrative Record Access Security Exit Routine .......................... 725 Rules for Writing an Online Security Exit Routine ............................ 726 Comment: Sel, Type, and Action Allowed ................................... 727 Coding a Logon Security Exit Routine .......................................... 727 Coding a Logoff Security Exit Routine .......................................... 730 Coding a Mail Code Security Exit Routine ....................................... 731 Coding a View Print Security Exit Routine ...................................... 733 Coding an Application Security Exit Routine .................................... 735 Coding an Administrative Record Access Security Exit Routine ................... 737 Coding a TSO Report Access Logging Exit Routine............................... 739 Coding the Cooperative Processing Logon Security Exit Routine .................. 741
Index
viii
Getting Started
Chapter
Introduction
This chapter provides a summary of the key changes included in the Unicenter CA-Bundl 5.0 release as well as introductory information about this guide and an overview of the Unicenter CA-Bundl installation process.
Introduction
11
2.
Note: Use binary file transfer when transferring the PDF files to the Desktop/PC environment.
12
Getting Started
Related Documentation
See any of the following documents for more information about Unicenter CA-Bundl: Unicenter CA-Balancing System Guide Unicenter Output Management Document Viewer User Guide Unicenter Output Management Web Viewer Getting Started (intranet or internet access) CA Common Services Getting Started (formerly Unicenter TNG Framework for OS/390) IBM AFP Workbench for Windows: Technical Reference (Online) Adobe Systems Inc. Type Manager User Guide (Microsoft Windows version)
Introduction
13
14
Getting Started
The Date Filter Span on the User Options Panel (page #2) is not used for the Archive Report Selection screen in Unicenter CA-Bundl 5.0. 4. Improved Archive Recovery Options Added to DPMB037 DPMB037 is the Unicenter CA-Bundl AIF (Archive Index File) disaster recovery program. Unicenter CA-Bundl 5.0 has added more selection criteria by the date, application, and report ID to allow selective restoration of archive indexes from the archive tape. For more information about the Unicenter CA-Bundl program, DPMB037, see the chapter Using and Scheduling Unicenter CA-Bundl Jobs and Programs in the Unicenter CA-Bundl Administrator Guide. 5. New Online User Reprint Status screens All online requests for archive reprints are shown in a separate Reprint Status screen provided for each user. Each user can quickly review and change the original request using the Reprint Status screen. All archive reprint or reload requests that are pending completion or placed on hold by the Unicenter CA-Bundl Administrator will be shown. Completed requests are deleted from the screen. 6. Online Operations Reprint Status Screens A new online Operations Reprint Status screen is provided for the Unicenter CA-Bundl administrator. The screen is accessed from the Unicenter CA-Bundl Operations Menu screen by selecting option #6, Reprint Requests. All requests made since the last clean of the RIFO file are displayed on the screen. The status of the reprint requests for all users is shown on the screen.
Introduction
15
7.
Additional Reprint Processing Options A new program, DPMB005A, has been added to provide more versatility with additional processing options for reprint requests. Our new reprint job is executed in CC50J005, the reprint job stream and CC50J029, the End-ofDay Processing job stream. See the chapter Using and Scheduling Unicenter CA-Bundl Jobs and Programs in the Unicenter CA-Bundl Administrator Guide for the new PARM options provided in the Unicenter CA-Bundl program, DPMB005A.
8.
z/OS 1.2 expansion to handle job numbers greater than 99,999 Various CA-Bundl 5.0 system changes where made to support the expansion of the job number to eight positions. Expansions where made to the CA-Bundl online screens to provide the eight positions of job number. However, special handling was necessary on the Archive Selection List and the Reprint Status screens to support the larger job number display. A Job Number Flag field has been added to the Processing Options Screen to control the display of job number on the Archive Selection List and Reprint Status screens. For more information about this new field, see the topic Processing Options Screen in the chapter Setting Unicenter CA-Bundl Options and Session Defaults.
16
Getting Started
9.
The Collector, STCBUNDL, limits the number of lines collected Two new parameters have been added to the collector parameters, MAXLINES and MAXOPT. The input sample page exit program is used to control the collector line limits. This input page exit can be modified, as required, to handle special situations or specific job exceptions. See the chapter Using and Scheduling Unicenter CA-Bundl Jobs and Programs in the Unicenter CA-Bundl Administrator Guide for more information about the Unicenter CA-Bundl program, STCBUNDL.
10. CA LMP Support Unicenter CA-Bundl 5.0 requires the use of the CA License Management Program (CA-LMP) for authorization checking. CA-LMP is a standardized approach to the tracking of licensed software that uses common real-time enforcement software to validate the users configuration. CA-LMP replaces the Authorization statement found in AUTH member in the Unicenter CA-Bundl CNTL library. Unicenter CA-Bundl uses the CAI Resource Initialization Manager (CAIRIM) portion of Unicenter TNG Framework for OS/390. You must install CA Common Services before you can run Unicenter CA-Bundl. CAIRIM prepares the operating system for Computer Associates products and components, and then executes them. 11. DPMB075, the AIF Remerge program Program DPMB075 is provided in Unicenter CA-Bundl 5.0 to re-merge your AIF and AIF0-9 files into a new AIF file. The BSF split information record is updated and reset to reflect the merge of the AIF files. See the chapter Using and Scheduling Unicenter CA-Bundl Jobs and Programs in the Unicenter CA-Bundl Administrator Guide for more information about the Unicenter CA-Bundl program, DPMB075.
Introduction
17
12. Unicenter CA-Bundl 5.0 is now installed using SMP SMP is a tool that provides a simplified, yet accountable approach to MVS product integrity. It controls the installation and all subsequent maintenance of MVS products, as well as providing a log of all system activity. The primary goal of SMP processing is the stability of the running libraries. 13. New Online Reprint Request File RIFO The new RIFO file in Unicenter CA-Bundl 5.0 contains the archive reload or reprint requests. The RIFO has a new key structure to support the online reprint status screens for Unicenter CA-Bundl 5.0 A conversion program, DPMB073, is provided in Unicenter CA-Bundl 5.0 to convert the RIF file from CA-Bundl 4.9 to the new RIFO format. The conversion is not needed if all CA-Bundl v4.9 reprint requests have been completed. 14. New Processing Parms Added To Archive Clean Job streams New processing parms were added to allow greater processing flexibility after the split of the AIF file is run. See the chapter Using and Scheduling Unicenter CA-Bundl Jobs and Programs in the Unicenter CA-Bundl Administrator Guide for more information about the Unicenter CA-Bundl programs, DPMB007 and DPMB027.
18
Getting Started
15. Greater Processing Flexibility for Archive Consolidation A new processing PARM was added to the consolidation program, DPMB019. This PARM allows you to specify which AIF files are to be input to the consolidation. If you have split the AIF into separate files using the DPMB074 program, you can process the AIF0-9 files on a separate cycle from the current AIF file. Therefore, the archive files can be consolidated by year range. The consolidation frequency of the previous years archive data (AIF0-9) can be determined separately from the current year archived data (AIF). The processing performance of the consolidation will be improved greatly when the AIF only is processed for consolidation. The AIF0-9 files can be consolidated in a separate run or cycle. 16. Program DPMB008, View File Clean, Control Report Only Option Program DPMB008 can be run to produce a VPF0-9 control report regarding the status of the view page files. No clean of the VIF or VPF0-9 files will be done when this report option is coded. 17. Unicenter CA-Bundl VTAM Administrations and View The Unicenter CA-Bundl system tables can be accessed via VTAM by specifying DATA(BUNADMN) at logon. The message, BND1805 BUNADMN MODE, DATA ENTER USERID AND PASSWORD is displayed upon logon. Enter your user ID and password to complete the logon process. The default mode is Unicenter CA-Bundl View-only access via VTAM. It is not necessary to specify session DATA(BUNVIEW) for view-only access. However, session DATA(BUNVIEW) is supported at logon for view-only access. The message BND1806 BUNVIEW MODE, ENTER USERID AND PASSWORD is displayed upon log on. Enter your user id and password to complete the log on process.
Introduction
19
Generally, only Unicenter CA-Bundl administrators will have access to the Unicenter CA-Bundl system tables. Therefore, only administrators will specify the session DATA(BUNADMN) at logon.
Programmable function keys, referred to as PF keys, are represented by the uppercase letters PF followed by one or two digits: PF1 PF12 Note: On most keyboards, PF keys are located either along the top or to the right side of the main keys on the keyboard. PF keys are usually marked PF or simply F followed by a digit (for example, PF1 or F1).
Enter Key
The word Enter represents any of the following keys marked on your keyboard: ENTER, Enter, or enter RETURN, Return, or return , Enter, or enter
Text shown in the Palatino Bold typeface (for example, DEVICE ID => FICHE) indicates the actual text you type, enter, or see on a Unicenter CA-Bundl screen, data set, or in some other input medium.
110
Getting Started
Commands
Commands supported via the online facility are represented by uppercase letters, as shown in the examples below: HELP ADD DOWN
Variables
Italic text shown with a command indicates a user-defined variable where you provide an actual value or information in its place. For example, the variable n in the keyword BDn represents a Unicenter CA-Bundl date format that you specify when creating Unicenter CA-Bundl distribution rules using keywords. You enter a number between 1 and 5 for n in the BDn keyword. The number corresponds to the following formats (where m=month, d=day, y=year): n 1 2 3 4 5 Date Format mm/dd/yy dd/mm/yy yy/mm/dd yy.ddd (Julian) yyyy.ddd (Julian)
Introduction
111
Chapter
21
For more information, see the topic Unicenter CA-Bundl Installation Materials in the chapter System Requirements. 3. Install Unicenter CA-Bundl using SMP/E. See the chapter Installing Unicenter CA-Bundl for a detailed list of the steps users must perform. 4. Use options and initialization parameters to customize Unicenter CA-Bundl according to the needs of your site, as follows: Install one of the following online interface options: TSO VTAM Advantage CA-Roscoe CICS See the chapter Installing Unicenter CA-Bundl for more information.
22
Getting Started
23
Chapter
System Requirements
This chapter provides the requirements for installing and running Unicenter CA-Bundl in the following topics: CA Common Services Unicenter CA-Bundl and CA-DRAS (Demand Repository Access System) Installation materials Hardware and software requirements Library authorization
CA Common Services
CA Common Services must be installed or maintained at the genlevel indicated on the Unicenter CA-Bundl cover letter before you can use the CAIRIM, CA-LMP, and CA-LServ components. See the CA Common Services Getting Started for more information.
System Requirements
31
CA Common Services
CAIRIM performs the following tasks: Obtains SMF data Verifies proper software installation Installs MVS interfaces Automatically starts up Computer Associates products and other vendor products Proper timing and order of initialization Note: Unicenter CA-Bundl requires CAIRIM to run the required CA-LMP.
CA-LMP
CA-LMP (Computer Associates License Management Program) is a standardized automated approach to the tracking of licensed software that uses common real-time enforcement software to validate the users configuration. CA-LMP reports on activities related to the license, usage, and financial activity of program solutions. CA-LMP features include the following: A common key data set that can be shared among many CPUs The use of check digits to detect errors in transcribing key information Execution keys that can be entered without affecting any Computer Associates software solution already running No special maintenance requirements
CA-LServ
If CA-LServ has not been installed on your system, you must do so before proceeding with this installation. See your cover letter and the CA Common Services Getting Started for detailed instructions.
32
Getting Started
Installation Requirements
A summary of the Unicenter CA-Bundl and CA-DRAS installation requirements is listed below: Mainframe Unicenter CA-Bundl cooperative agents CA-LServ 3.5 TL98010 or above CA-DRAS 1.0 9910 or above CA Common Services CCI R1.1 9611 or above TCP/IP, OS/390, IBM, Interlink
System Requirements
33
PC Environment See the Unicenter Output Management Document Viewer and Unicenter Output Management Web Viewer documentation for PC environment requirements. CA-DRAS and installation are separate and must be specifically requested. For more information, see the CA-DRAS Installation and Operation Guide.
34
Getting Started
Hardware Requirements
Hardware Requirements
The following tables list the amount of disk space needed to install the Unicenter CA-Bundl target and distribution libraries. Use the tables to estimate the storage required for both libraries.
Target Libraries
Library Name CAI.CAILIB CAI.CAIPROC CAI.PPOPTION CAI.CAISRC CAI.CAIMAC CAI.CAIISPP CAI.CAIMAP CAI.CAIRPT CAI.CAICLIB Blksize 6144 3120 3120 3120 3120 3120 3120 4788 3120 Blocks 4200 50 1500 330 940 30 1500 120 50 Dir Blks 100 2 100 4 100 5 50 2 2 Description Common load library Common procedure library Common options library Common source library Common macro library Common ISPF panel library Common view panels (English) Sample Reports Common clist library
WARNING! Do not reblock the libraries listed abovestorage problems could occur.
Distribution Libraries
Library Name CAI.BNDL.CCC50MLD CAI.BNDL.CCC50LLD CAI.BNDL.CCC50ILD CAI.BNDL.CCC50RLD Blksize 3120 6144 3120 4788 Blocks 1330 580 10 50 Dir Blks 150 75 5 2 Description Macro library Load library ISPF library Report library
System Requirements
35
Software Requirements
Software Requirements
Unicenter CA-Bundl 5.0 Component SYSMODs
SYSMOD C$V5000 Description Unicenter CA-Bundl base function for the product component
36
Getting Started
Library Authorization
Library Authorization
Unicenter CA-Bundl contains authorized programs. To run successfully, these programs must be executed from an authorized library. We recommend that you authorize the CAI Common Load Library, CAILIB. Note: If other Computer Associates products have been installed, this library may already be authorized. To authorize CAILIB, modify the appropriate member IEAAPFxx in SYS1.PARMLIB to add an entry for CAILIB as follows:
CAI.CAILIB
xxxxxx,
where: CAI.CAILIB is the data set name for the CAI Common Load Library xxxxxx is the volume serial number on which it resides. An IPL may be necessary to complete the authorization.
System Requirements
37
Chapter
41
Note: See the Unicenter CA-Bundl cover letter for the Genlevel. CAIRIM and CA-LServ are the only components required for Unicenter CA-Bundl 5.0. See your CA Common Services documentation for more information. Do the following: 1. 2. Check to make sure that your system meets all the requirements listed in the chapter System Requirements. When you get to step 8, supply the LMP code.
Installation Steps
Note: Be aware that if you are upgrading from a prior release of this product, several of the steps listed below will have modifications. See the topic Upgrading CA-Bundl 4.9 to Unicenter CA-Bundl 5.0 later in this chapter for a list of the modifications. Before you begin the installation, review the following list, then use it as a checklist during the installation. Step 1. Complete the Unicenter CA-Bundl Customization Worksheet Step 2. Load the Installation Sample JCL (SAMPJCL) Library Step 3. Allocate Libraries Step 4. Customize the SMP/E Procedure Step 5. RECEIVE the Services Step 6. APPLY the Services Step 7. Authorize Program Load Libraries
42
Getting Started
Step 8. Enter the LMP Code Step 9. Tailor the execution JCL (SAMPJCL Library) Step 10. Tailor the procedures Step 11. Initialize VSAM files Step 12. Install the CICS Option (optional) Step 13. Install the Advantage CA-Roscoe Option (optional) Step 14. Install Unicenter CA-Bundl VTAM View (optional) Step 15. Install the TSO interface (optional) Step 16. Set Up CA-LServ to Execute Unicenter CA-Bundl Step 17. Test Your Unicenter CA-Bundl Installation Step 18. Create Production VSAM Files Step 19. ACCEPT the Services (optional) Step 20. Use a single file server with more than one Unicenter CA-Bundl system
43
The worksheet will assist you in preparing the information needed to customize your Unicenter CA-Bundl JCL. Whether you plan to use the customization clist (CC50CUST) or update the JCL manually, the worksheet will be helpful in listing the information required. See Step 9: Tailor the Execution JCL for more information about how to use the customization clist and manually tailor the JCL. Note: Later in this chapter, you will have to choose to either run the customization clist or manually update the JCL and PPOPTION members. At that time, you will need to determine how large to make your VSAM files. See the appendix Disk Space Allocation for more information.
CAICC50
None
44
Getting Started
Enter job card information for JCL below: Description 1:5 character job name prefix Accounting information Programmer name Job class for batch jobs MSGCLASS NOTIFY Enter JES class information below: Description Input JES class Output JES class Enter unit name information below: Description Tape device Temporary data sets Enter volser information below: Description DASD volser for CIF file Tape volser for CC50JBAK Unit name for CC50JCHK DASD volser for CC50JMSG Default SYSDA VOLSER VOLSER SYSDA Value to be Used Default CART SYSDA Value to be Used Default 5 X Value to be Used Default CC50J none none A X none Value to be Used
45
Enter Archive Tape File information below: Description GDG DSNAME (OMIT GDG QUALIFIER) ARCHIVE MODEL NAME Enter TEST or PROD for CC50J099 PARM Enter CA-LSERV subsystem information below: Description Subsystem name Unicenter CA-BUNDL file prefix CA-LSERV load library Default LSRV DPMF SMPPREF. CAILIB Value to be Used Default SMPPREF. ARCH SMPPREF. MODEL TEST Value to be Used
Enter the following information: Description Enter CA-BUNDL 4.9 VSAM file prefix Default CAI.BUNDL49 Value to be Used
Enter Unicenter CA-BUNDL 5.0 VSAM file DASD volsers below: (16 maximum, separated by commas)
46
Getting Started
Note: At least two DASD volumes are recommended for VSAM space allocation. The VSAM file definitions in the CAI.PPOPTION library have been preset for small testing volume. Review the VSAM file definitions in the CAI.PPOPTION library, after initial testing.
47
3.
Customize the JCL members to reflect valid job statements, data set names, and unit and volume serial numbers.
48
Getting Started
All space allocations are given in blocks to allow for compatibility between DASD types. The allocations listed show the minimum amounts required for installing Unicenter CA-Bundl; you can adjust these values for your installation device types. Be sure to allow enough free space for maintenance, the more free space you allocate, the less often it will be compressed during maintenance. For common libraries already present, be sure there is sufficient space for Unicenter CA-Bundl. Important! Any currently allocated CAI target libraries may require expansion to accommodate this product. See Hardware Requirements in the chapter System Requirements to make sure that the available space in your target libraries will permit a successful APPLY.
49
FMIDs
The FMID that should be received (and later APPLYd and ACCEPTed) is listed below as it pertains to each of the Unicenter CA-Bundl services. FMIDs: C$V5000
410
Getting Started
Supplement
411
Contents Name of technical contact at your site responsible for the installation and maintenance of Unicenter CA-Bundl The person to whom Computer Associates addresses all CA-LMP correspondence.
Execution Key
Encrypted code (known as LMP Code during installation) required by CA-LMP for Unicenter CA-Bundl initialization Two-character code that represents Unicenter CA-Bundl Name of the Director of MIS, or the person who performs that function at the site If the title, but not the individuals name is indicated on the Certificate, you should supply the actual name when correcting and verifying the Certificate.
CPU ID
Code that identifies the specific CPU for which installation of your Unicenter CA-Bundl is valid Building address where the CPU is installed CA-LMP is provided as an integral part of CAIRIM (Resource Initialization Manager), another TNG Framework for OS/390 service.
CPU Location
The CA-LMP execution key, provided on the key certificate, must be added to the CAIRIM parameters to ensure proper initialization of the Computer Associates software solution.
412
Getting Started
where: pp Specifies the two-character product code For any given CA-LMP software solution, this code agrees with the product code already in use by the CAIRIM initialization parameters for earlier Gen levels of Unicenter CA-Bundl. ddmmmyy tttt-mmmm Specifies the CA-LMP licensing agreement expiration date Specifies the CPU type and model (for example, 3090-600) on which the CA-LMP software solution is to run If the CPU type and/or model require less than four characters, blank spaces are inserted for the unused characters. ssssss kkkkkkkkkkkkk Specifies the serial number of the CPU on which the CA-LMP software solution is to run Specifies the execution key needed to run the CA-LMP software solution This CA-LMP execution key is provided on the Key Certificate shipped with each CA-LMP software solution. The following example shows a control card for the CA-LMP execution software parameter. Note that the CA-LMP execution key is invalid and provided as an example only.
PROD(VA) DATE(01JAN97) CPU(3090-600 /370623) LMPCODE(52H2K06130Z7RZD6)
413
See the CA Common Services Getting Started for information about defining the CA-LMP execution key to the CAIRIM parameters.
414
Getting Started
Use the answers provided on the worksheet to respond to the questions when running the customization clist. The clist will update and replace the Unicenter CA-Bundl JCL members in the CAI.SAMPJCL and CAI.PPOPTION libraries with the values provided to the clist. It is extremely important that you execute the JCL member CC50CUSC in the CAI.SAMPJCL library to copy the CAI.SAMPJCL and CAI.PPOPTION libraries prior to execution of the clist. The JCL member CC50CUSR in CAI.SAMPJCL is provided so that you can restore these libraries prior to a rerun of the clist. With the Unicenter CA-Bundl 5.0 release, new naming standards have been adopted for all JCL, VSAM file cluster definitions, and procedures. Please review the member names in the CAI.PPOPTION, CAI.SAMPJCL, and CAI.CAIPROC libraries. The new naming standards include the CCnn prefix (for example, CC50). This standard replaces the old DPM prefix that was used prior to Unicenter CA-Bundl 5.0. The following is a list of several key considerations for customizing your execution JCL for Unicenter CA-Bundl 5.0: The SMP/E prefix is used for the high-level qualifier of the system libraries (for example, CAI.PPOPTION, CAI.CAILIB, and so on) The high-level qualifier of the VSAM file names is CAICC50.DPMFXXX as delivered. If you want to change it, you can either edit the VSAM clusters and JCL (CC50Jxxx) members in the CAI.PPOPTION and CAI.SAMPJCL libraries or execute the customization clist (CC50CUST) in your CAI.SAMPJCL library. It is suggested that you do not use the same DSNAME as your current production files. The VSAM file definitions in the PPOPTION library have been preset with initial testing volumes only. A review of the PPOPTION VSAM file definitions will be needed for processing additional volumes.
415
See the appendix Disk Space Allocation for more information about space allocations for your VSAM files and for a complete list of these files and the PPOPTION members that define them. The Execution JCL is located in the CAI.PPOPTION and SAMPJCL libraries. Procedures are located in the CAIPROC library. Tailor the symbolics to customize your JCL. The following is a list of the key JCL members in CAI.PPOPTION and CAI.SAMPJCL: Member CC50CUSC CC50CUSR CC50J001 CC50J002 CC50J02A CC50J004 CC50J005 CC50J05B CC50J007* CC50J008 CC50J009 CC50J010 CC50J011 Description Backup of CAI.PPOPTION and CAI.SAMPJCL libraries Restore CAI.PPOPTION and CAI.SAMPJCL libraries Report Collector Report Distribution Special Distribution Archives Master Index and Page Reprint job stream Load archive data to be reprinted (printed on next distribution cycle) Delete expired archive records Delete expired view index and view page records Update Statistical Summary File Update Statistical Summary File from the PSF Index File Create SMF records and produce Summary Report
416
Getting Started
Member CC50J012 CC50J013 CC50J014 CC50J016 CC50J017 CC50J019* CC50J026 CC50J029* CC50J030 CC50J037 CC50J038 CC50J073 CC50J074* CC50J74C* CC50J075* CC50J080* CC50J085 CC50J090 CC50J091 CC50J095 CC50J096 CC50J097 CC50J098
Description Distribution within Job Report Report of recipients for a report Mail Code Maintenance Resequence Report Distribution File Produce Gummed Labels by Home Code Archive Consolidation of Tape Files Shut down active collectors and archive End-of-day job stream Clear BSF of active task name Archive Index Recovery List Message Log RIF File Conversion Utility for Unicenter CA-Bundl 5.0 Archive File Split Archive File Split, produce Control Report only Remerge Archive Index File Index Utility Insert/Modify Price Record in SSF Change system date without clearing files Generate sample reports to JES Spool Print Statistical Summary Report Initialize Page and Index Files Reset View System List file entries in Control Files
417
Description Initialize VSAM Files Initialize and restore AIF, BSF, and AIF0-9 for rerun of CC50J074, archive split Initialize Specific Files
*These jobs reference the AIF file and are modified for the AIF split.
418
Getting Started
419
Member Name CC50PDF0 to CC50PDF9 CC50PIF CC50PIF2 CC50PSF* CC50RDF* CC50RIF CC50RIFO CC50RPF CC50RTF* CC50SCH* CC50SHF* CC50SIF CC50SRF* CC50SSF CC50STF* CC50TSF* CC50VIF* CC50VPF0 to CC50VPF9 CC50VSF*
Description DPMFAIF0 DPMFPDF9 DPMPIF DPMPIF2 DPMFPSF DPMFRDF DPMFRIF DPMFRIFO DPMFRPF DPMFRTF DPMFSCH DPMFSHF DPMFSIF DPMFSRF DPMFSSF DPMFSTF DPMFTSF DPMFVIF DPMFVPF0 DPMFVPF9 DPMFVSF
*IMBED keyword has been changed to NOIMBED To create a new set of VSAM files, follow the steps below. Otherwise, proceed with step 12. WARNING! The PPOPTION members that are used to define the VSAM files also contain DELETEs for these files. Do not use the same high-level qualifier as your current Unicenter CA-Bundl production files when you tailor these members.
420
Getting Started
2.
3. 4. 5. 6.
421
422
Getting Started
If no, go to Step 13: Install the Advantage CA-Roscoe Option (Optional); you are done with the CICS installation. If yes, see Providing Mail Code-Level Security in the chapter Providing Security in Unicenter CA-Bundl for information about setting up mail code-level security at your organization.
Installing the Advantage CA-Roscoe Option for Use with Unicenter CA-Bundl
1. Tailor, move and rename the CC50DROS and CC50DRUS members in the CAI.CAICLIB data set to an Advantage CA-Roscoe option RPF library. Add the DPMOATSO and DPMOTSO programs, and the CAI.CAILIB members to the Advantage CA-Roscoe option eligible program table.
2.
423
424
Getting Started
2.
Copy the VTAM application definition from member CC50VDEF in CAI.PPOPTION to the SYS1.VTAMLST data set. Enter the following command:
V NET,ACT,ID=memname
3.
Where memname is the name of the SYS1.VTAMLST member that contains the VTAM definition for Unicenter CA-Bundl VTAM View. Unicenter CA-Bundl VTAM View is made into a Unicenter CA-Bundl VTAM View application. 4. Modify member CC50VPRM in CAI.PPOPTION, which contains default initialization values for VTAM View. You can specify two types of values in member CC50VPRM: SETPARMS initialization statements, which you can specify only in member CC50VPRM; you cannot change these values after you start the VTAM View task Unicenter CA-Bundl commands, such as SETOPTION, which you can specify either in member CC50VPRM or from an operators console (to change command values while VTAM View is executing) 5. 6. Tailor the startup procedure for the VTAM View started task, member CACC50B3 in CAI.CAIPROC. Do you want to restrict VTAM View users from viewing reports distributed through Unicenter CA-Bundl? If no, proceed to step 15. If yes, see the topic Providing Mail Code-Level Security in the chapter Providing Security in Unicenter CA-Bundl for more information about setting up mail code-level security at your organization. Note: See the Unicenter CA-Bundl VTAM View System Guide for more information about security and Unicenter CA-Bundl VTAM View.
425
Note: New with Unicenter CA-Bundl 5.0, the general default is DATA(BUNVIEW) to view reports only. To access the Unicenter CA-Bundl administrative files, enter DATA(BUNADMN) at logon. For example, APPLID(BUND50TS) DATA(BUNADMN) Important! The value specified for ACBNAME in member CC50VPRM must match the value specified in member CC50VDEF.
Installing TSO
1. Modify your TSO logon procedure as follows: a. If CAI.CAILIB is not in the link list, add CAI.CAILIB to the STEPLIB DD concatenation in your TSO logon procedure.
b. Add CAI.CAICLIB to the SYSPROC DD concatenation in your TSO logon procedure. Once the above changes are made, your TSO logon procedure should start as follows:
//TSOPROC //TSO //STEPLIB // //SYSPROC // PROC EXEC PGM=IKJEF01,DYNAMNBR=50,PERFORM=2 DD DSN=CAI.CAILIB,DISP=SHR DD DSN=Other.Load.Libraries,DISP=SHR DD DSN=CAI.CAICLIB,DISP=SHR DD DSN=Other.Clist.Libraries,DISP=SHR
2.
Modify the following clists in CAI.CAICLIB. The required changes are documented at the beginning of the clist. CC50CLDL CC50CLVW
426
Getting Started
427
4.
In member LDMPARM of the LSERV CNTL data set, insert the statements INCLUDE CC50DLDA and INCLUDE CC50DLDS. In member LDMMSGS of the LSERV CNTL data set, insert the statement INCLUDE CC50BMSG. Copy, to the LSERV CNTL data set, any jobs that the scheduler will submit for execution. Note: Ensure that CC50J02A is included in this set of jobs. It is the job for automatic distribution located in PPOPTION.
5. 6.
Where task represents the name of the CA-LServ started task, and parms represents one or more start-up parameters that you are overriding from the start-up procedures JCL. 2. Tailor SAMPJCL member CC50JCHK and submit it.
428
Getting Started
3.
Access the Unicenter CA-Bundl administration and view screens from any environment in which you have installed them. To do this, execute the Unicenter CA-Bundl view and administration clists from the appropriate environment. When you start the Unicenter CA-Bundl administration screens, review the screens available from the System Options menu. Note: These screens provide Unicenter CA-Bundl with important settings that are necessary to complete the installation process. The remaining chapters of this guide contain information about screens that provide security and default settings. See the Unicenter CA-Bundl Administrator Guide for information about screens used in a JES.ANY distribution.
4.
If you are upgrading Unicenter CA-Bundl from a prior release, use the instructions that follow to convert your production VSAM files to Unicenter CA-Bundl 5.0.
429
2. 3.
b. Review the archived split control report record counts and calculate the DASD space required for the new Unicenter CA-Bundl 5.0 AIF and AIF0-9 files. c. Modify the PPOPTION members, CC50AIF and CC50AIF0-9, then include the estimated number of records. The CA-Bundl 4.9 AIF file should be used as input. The output AIF and AIF0-9 files are dummy files in the CC50J74C JCL, no split will be performed. Note: The AIF0-9 files will not grow during the Unicenter CA-Bundl 5.0 processing cycle. As each clean cycle is run, the AIF0-9 files should decrease in the number of records. The AIF will always contain the current year data and grow as new archives (DPMB004) are run. Therefore, you should plan for expansion or room for growth in the CC50AIF VSAM cluster definition.
430
Getting Started
4.
Initialize your VSAM files. This step will create your Unicenter CA-Bundl 5.0 production VSAM files. Review the VSAM file cluster definitions in the PPOPTION library to define the production naming conventions and space requirements for production processing. Note: The VSAM file high-level qualifier should be different from the high-level qualifier of your current CA-Bundl 4.9 VSAM file. Tailor and submit job CC50J099 in SAMPJCL to your sites standards. Make sure to change the DPMB099 parm from TEST to PROD (for example, PRMV=PROD). Make sure the OUTCLASS is the correct JES default output class for your site. The PROD parm will clear and reset all Unicenter CA-Bundl 5.0 VSAM files with only an initialization record. a. Tailor and submit job CC50JMAP in SAMPJCL. This will initialize and build the online map files.
b. For CA-LServ, make sure the CC50DLDA, CC50DLDR, CC50DLDS members in CAI.PPOPTION have been changed to point to your Unicenter CA-Bundl 5.0 production files. See Step 16: Set Up CA-LServ to Execute Unicenter CA-Bundl for more information. 5. Tailor and run CC50REPO in SAMPJCL to load the remaining VSAM files to 5.0 from the 4.9 backup tape created in step #1 above. Note that the BSF file will not be copied from the 4.9 backup tape. You must use the BSF file initialized in step 4 in the CC50J099 job. Tailor and run CC50REP2 in SAMPJCL to load your 5.0 view files (VIF and VPF0-9) from your 4.9 files.
431
6.
If you are not splitting your AIF file, proceed with the next step (#7). Otherwise, do the following: Tailor and run CC50J074 in PPOPTION to split the AIF file into new AIF and AIF0-9 files. The DPMB074 parm is set to 1 year as the default. The AIF0-9 files will contain one year of archived data and the AIF will contain the current year plus any carryover. AIF0 will contain the oldest year data and AIF1 will contain the next oldest year data, and so on. Review the space requirements in the CC50BAIF and the CC50NAIF VSAM cluster definitions in the PPOPTION library. The CC50BAIF will be a full backup of the current AIF file. Therefore, the number of records must equal the AIF file into the split. The CC50NAIF is a new AIF file after the split and only the records for the current year will be added to this file by the DPMB074 program. If you need to rerun the CC50J074 job stream, run the CC50J99S job stream. This job stream is set to restore the AIF from the backup file, CC50BAIF, and reinitialize the BSF and AIF0-9 files with the DPMB099 program.
7.
432
Getting Started
Be sure to include any maintenance PTF SYSMODs previously RECEIVEd and received from the cumulative maintenance step. The PTF SYSMODs should be the last in the list of SYSMODs to be ACCEPTed.
433
Step 20: Using a Single File Server with Multiple Unicenter CA-Bundl Systems
Step 20: Using a Single File Server with Multiple Unicenter CA-Bundl Systems
Unicenter CA-Bundl uses the CA-LServ file server component of CA Common Services to access Unicenter CA-Bundl files. When you execute several Unicenter CA-Bundl systems at once (for example, test and production collectors), copies of Unicenter CA-Bundl can access unique sets of files through the same file server. By default, Unicenter CA-Bundl jobs and users can access files that begin with the prefix DPMF. Change the clists for TSO, the RPFs for Advantage CA-Roscoe, and the Start task for VTAM:
ALLOC F(DDN$xxxx) DUMMY
Specify a 1-to 4-character DDNAME prefix in place of xxxx. A USERMOD, member CC50CIC in CAI.SAMPJCL, should be tailored and used to change the DDNAME prefix for different CICS programs.
Example
The following is an example of the values you specify to share a file server among tasks. In this example, the Unicenter CA-Bundl test system and production system request access to different sets of files through the same file server. The ADDFILE statement for each set of files needs to be listed in the CC50DLDA member in the LSERV CNTL data set. The DDN$TEST DD DUMMY statement tells a test collector job to access files with DDNAMEs that begin with TEST. The DDN$DPMF DD DUMMY statement tells a production collector job to access files with DDNAMEs that begin with DPMF.
434
Getting Started
Step 20: Using a Single File Server with Multiple Unicenter CA-Bundl Systems
The same file server manages both sets of files, as shown below:
Tasks on CPU
Values for Test Collector JCL: //DDN$TEST DD DUMMY Values for Production Collector JCL: //DDN$DPMF DD DUMMY Test Collector Fileserver Production Collector DDprefix= DPMF
DDprefix= TEST
435
Chapter
U se r Id e n tifie r V S F D , E, F
D P M S 96 0 (o p tio n a l) A d d Y, Z a n d re m o ve D
R e vi se d list o f a llow e d m a il co d e s A , B, C , E, F , Y, Z U se r s R e p o rt S e le ctio n L ist A p p ro va l s A B C D E K L F a ilu re s D P M S 96 2 (o p tio n a l) A llo w K E V IF A cce ss S e cu rity F ilte r A B C
51
Unicenter CA-Bundl first combines mail codes specified in the Bundl view security record in the View Security File (VSF), which authorizes users to access public mail codes and mail lists for view output, with the users view security record in the VSF. Unicenter CA-Bundl then passes the list of allowed mail codes either to the logon security exit routine (DPMS960) or directly to the VIF Access Security Filter. DPMS960 examines and modifies the applications, Unicenter CA-Bundl functions, and mail codes to which users, administrators, and operators have access. The VIF Access Security Filter displays the mail codes. Optionally, your administrator can set up Unicenter CA-Bundl so that it passes failed mail codes to the mail code security exit routine DPMS962, which, if it is correctly linked, adds mail codes to, or removes mail codes from, the list of VSF mail codes to which Unicenter CA-Bundl users have access. Any failed mail codes that are subsequently approved by DPMS962 are passed to the users report selection list. See the chapter Exit Routines for a description of the security exit routines.
52
Getting Started
The levels of security in Unicenter CA-Bundl are: Function-level security restricts access to Unicenter CA-Bundl screens that enable you to perform a related set of functions You can, for example, restrict access to the Collector and Page Data Files screen, which you use to stop jobs that collect reports for distribution. Application-Level Security restricts access to administration and operations records by application identifier You can, for example, restrict Unicenter CA-Bundl users who can access payroll application records. Note: This type of security restricts access only to records you can add, change, or delete through Unicenter CA-Bundl administration and operations screens. It does not restrict access to view report data. Logon-level Security restricts access to Unicenter CA-Bundl (for VTAM View users only) and modifies mail codes a user can access. Mail Code-level Security restricts access to data in reports For example, you can restrict access to a confidential payroll report by allowing only payroll staff to access the mail codes to which a report is delivered.
53
SECURITY Mailcode => LEVELS: Function => Application => Restrict MCF Records => MAILCODE Start With MATCH: Length
=> 1 => 7
54
Getting Started
Field Function
Description Specifies whether you want to restrict access to Unicenter CA-Bundl functions by restricting access to Unicenter CA-Bundl screens Specify N for no and Y for yes. If you do not specify a value in this field, N for no, is used by default.
Application
Specifies whether you want to restrict access to records for particular applications Specify N(o) or Y(es). If you do not specify a value in this field, N for no, is used by default. When you specify Y for yes, Unicenter CA-Bundl restricts access to records by application identifier on these screens: ATF screens RTF screens RDF screens SRF screens STF screens Operations Menu screens
55
Description Specifies whether you want to restrict access to particular MCF records, which define mail codes If you specify Y(es) in this field, the applications named on a users TSF record are compared with the name of mail codes on MCF records. When these values match, the user can access the MCF record. Otherwise, the MCF record is not displayed on the user screen. If you specify Y in this field, use standard naming conventions for the mail codes that receive output for the same application. Start, for example, all mail codes for your accounts payable users with the prefix AP. Anyone who is authorized to the application AP and who has access to MCF screens can subsequently change mail codes that start with AP. If you specify N in this field, anyone with access to MCF screens can access any MCF record. If you do not specify a value in this field, N is used by default.
56
Getting Started
To modify the Security Options Record: 1. Do one of the following: Enter =4.3 on the command line of any Unicenter CA-Bundl screen. Select Option 3 on the Systems Options Menu. The Security Options Screen will display. 2. Enter the desired values in the respective fields you want and press Enter.
57
The following table describes these screens and their functions and identifies the users who generally need access to the screens. Function or Screen Current Reports List Displays current reports distributed by Unicenter CA-Bundl Archived Reports List Retrieves archived reports Operations Menu Changes the processing status of Unicenter CA-Bundl records that initiate data distribution; views, prints, deletes, holds, and releases reports; stops Unicenter CA-Bundl collectors; displays collection statistics DSF Input Data Set Indicates which reports to collect for distribution ATF Application IDs Derives application identifiers for reports RTF Report IDs Derives report identifiers and defines control items on pages System Operator Admin User
58
Getting Started
Function or Screen DTF Device Output Defines output requirements for paper and microfiche output MCF Mail Codes, Lists Creates mail codes and lists for all online view, distribution paper, and microfiche output RDF Basic Distribution Creates distribution rules STF Translation Rule Creates distribution rules SRF Standard Rule Creates distribution rules TSF Func, Appl Security Authorizes users to access Unicenter CA-Bundl functions and files, and applications for which Unicenter CA-Bundl is distributing reports VSF View Security Authorizes access to mail codes and mail lists for view output SHF Text Changes Replaces text on pages distributed through Unicenter CA-Bundl
User
59
Function or Screen LGF Banner Page Logo Defines logos that appear on Unicenter CA-Bundl banner pages SCH Scheduling Creates a schedule that Unicenter CA-Bundl uses to submit jobs System Options Menu Changes Unicenter CA-Bundl processing options, default settings for users (including PF key settings), security options, and options used in JES.ANY distributions Anyone with access to these screens can change security settings, including the master user identifier.
User
510
Getting Started
Do the following: Create one record that sets defaults for all Unicenter CA-Bundl administrators and operators Create additional records as needed for individual Unicenter CA-Bundl administrators and operators If you create a TSF record for a particular user, the authority granted on that record replaces the authority you grant on your default TSF record.
2. 3.
Enter ADD on the command line, then press Enter. The TSF Detail: Function Security Screen will display. Enter DOWN on the command line, then press Enter. The TSF Detail: Application Security Screen with values in the User ID and User Name fields will display.
511
Fields and Descriptions Field User ID Description Specifies the user for whom you are creating this TSF record Specify BUNDL for the default TSF record; otherwise, specify a TSO user identifier. User Name END USER OPERATOR and SYS ADMIN Specifies a 1- to 25-character name for the user to whom this TSF record applies Identifies a set of Unicenter CA-Bundl screens Use these fields to select screens and type of authority you are granting to users. Valid codes are: E (edit and browse records) B (browse records only) N (prevents access to the screen)
512
Getting Started
513
Fields and Descriptions Field APPLICATIONS FOR THIS USER Description Specifies applications to which the current Unicenter CA-Bundl administrator or operator is authorized Unicenter CA-Bundl compares this value to the value for the Appl ID field (on ATF, RTF, RDF, STF, and SRF records) or the Mail Code field (on MCF records). When these values match, this user is authorized to access records for that application.. You can use an asterisk (*) as a wildcard character to match a prefix that precedes the * character. For example, specify AP* to match any application identifier that starts with the characters AP. You must specify at least one character before the * character. You can also use a question mark (?) wildcard to ignore a position in the application code. For example, AP?A* to match any application identifier with AP in the first two positions, and A in the third position.
514
Getting Started
Guidelines
Use the online security exit routines as follows: To change the list of Unicenter CA-Bundl functions a user is authorized to access, you use the Unicenter CA-Bundl logon security exit routine. You can use this exit routine to change the list of screen and applications users can access. Unicenter CA-Bundl executes this exit routine at logon time, after building lists of authorized screens and applications through TSF records. To change the list of Unicenter CA-Bundl applications a user is authorized to access, you use the Unicenter CA-Bundl logon security exit routine and the Unicenter CA-Bundl application security exit routine. You can use an application security exit routine to change the list of applications users can access. This exit routine, however, is not intended for use in defining function-level security. Unicenter CA-Bundl executes this exit routine only if a user tries to access records for an unauthorized application (that is, Unicenter CA-Bundl executes this exit routine after building its list of authorized applications from TSF records or a logon security exit routine). Note: You can also create your own exit routines or use exit routines that call a security package (such as RACF, eTrust CA-ACF2, or eTrust CA-Top Secret). See the topic Online Security Exit Routines in the chapter Exit Routines for information about writing your own exit routines for online security.
515
Types of Checking You Can Perform For logon-level security, you can: Validate the password a user enters when logging on to Unicenter CA-Bundl (for VTAM View users only) Accept or reject the logon attempt, based on criteria you define in an exit routine (for VTAM View users only) Modify user identifiers or the list of mail codes a user can access, based on criteria you define in an exit routine (for any Unicenter CA-Bundl user) If you want Unicenter CA-Bundl to validate the password a user enters when logging on to VTAM View, specify a value for the SECURITY parameter in the SETPARMS statement, in the CC50VPRM member of the CAI.PPOPTION data set. Use this decision table to determine the value to which you need to set the SECURITY parameter to define how you want Unicenter CA-Bundl to validate the password a user enters when logging on to VTAM View. Value Description
SECURITY=BUNDL Validates passwords itself Unicenter CA-Bundl compares the password the user enters to the password stored in the users TSF record.
516
Getting Started
Value SECURITY=RACF
Description Allows a security package (such as RACF, eTrust CA-ACF2, or eTrust CA-Top Secret) to validate the passwords Prompts users to enter user identifiers and passwords (but does not use TSF records to validate the passwords) You can use the LOGONXT exit routine in CAI.PPOPTION to validate passwords or to reject logon attempts based on criteria you define.
SECURITY=USER
SECURITY=NONE
Allows users to log directly into Unicenter CA-Bundl without specifying their user identifier and password Unicenter CA-Bundl security and log on screens are not displayed.
517
Important! Make sure to inform new VTAM View users to use the password, BUNDL, the first time they log on, and to change the password immediately. If a user forgets their password, you cannot look up that password in the users TSF record. Instead, revert the password to BUNDL by modifying the users TSF record. You must then delete the users TSF record and add it again to reset the password. The user must logon for the first time using the password, BUNDL. A prompt to change the password to a new password will display.
518
Getting Started
If your Unicenter CA-Bundl users have a common prefix in their user identifiers, you can use the exit routine to authorize users instead of listing mail codes on the users VSF record. The exit routine provides a shorter way for you to authorize users that have common prefixes in their identifiers to mail codes they all need. Suppose, for example, that all payroll department users need to access mail codes 123 and 456. If their identifiers all start with PAY, you can use the exit routine to authorize all user identifiers that start with PAY to mail codes 123 and 456. Using the common prefix PAY is easier than specifying mail codes 123 and 456 on each of their VSF records, and it also makes it easy for you to maintain this list of common mail codes for those users. If you provide a logon security exit routine, Unicenter CA-Bundl executes that routine for all Unicenter CA-Bundl users, no matter what value you specify for the SECURITY parameter. See Coding a Logon Security Exit Routine in the chapter Exit Routines for information about how to write this exit routine.
519
The mail codes a user is authorized to view Mail code-level security enables you to restrict a users ability to view reports for certain mail codes. Note: When you have provided mail code-level security and a user tries to display reports, Unicenter CA-Bundl compares the mail code for those reports with the mail codes the user can view. When these mail codes match, Unicenter CA-Bundl displays the report on that users terminal. Otherwise, Unicenter CA-Bundl removes information about that report from the users terminal. The user does not see information about reports he or she cannot access. Unicenter CA-Bundl also uses application security to restrict access to reports that operators access through the Collected Reports List Screen.
Note: You can also use SHF records to restrict a users ability to view certain areas on the page of a report. Using SHF records for this purpose is described in more detail in the Unicenter CA-Bundl Administrator Guide.
520
Getting Started
MAIL CODES FOR THIS => B50VIEW => => => => => => => => => =>
521
Description Specifies a 1- to 10-character identifier for a device or a group of devices When a report is initially selected to queue for printing or select an archived report you want to reprint, Unicenter CA-Bundl goes through this process to fill in values in the Device ID and Mode fields: 1. If the VIF record contains the values OPERATIONS and STD for the device identifier and mode, respectively, Unicenter CA-Bundl uses that VIF record. 2. The contents of the users VSF record are checked for any values. 3. If the device identifier and mode are not yet defined, the contents of the Unicenter CA-Bundl VSF record are checked for any values. 4. If Mode field is still not defined, STD is inserted for JES2 and PRT for JES3. 5. If Device ID field is not yet defined, the mail code record is checked for a device identifier. 6. If Device ID field is not yet defined, the home code record is checked for a device identifier (if mail code record specifies a home code). 7. If the Device ID field is still not defined, DEFAULT is inserted.
522
Getting Started
Description Specifies the mail codes and mail lists that users can access Unicenter CA-Bundl users can access any view output sent to these mail codes or mail lists. If you do not want to authorize this user to any mail codes, leave this field blank. You can use the asterisk (*) wildcard character to match a prefix that precedes the asterisk (*) character. Specify, for example, AP* to match any application identifier that starts with the characters AP. You must specify at least one character before the asterisk (*) character. You can also specify the asterisk (*) wildcard character alone to access all mail codes.
523
524
Getting Started
2. 3.
Enter ADD on the command line, then press Enter. The CA-Bundl VSF Detail Screen will display. Enter the desired values in the appropriate fields, then press Enter. The VSF record is defined for user identifier, BUNDL as specified.
Suppose the fourth and fifth characters are always unique and you want users to access mail codes assigned these characters. To do this, specify 4 in the Start With field and specify 2 in the Length field, as shown here:
START WITH => 4 LENGTH => 2
Note: If you do not want Unicenter CA-Bundl to match mail codes with parts of a user identifier, specify 0 in the Start With field.
525
526
Getting Started
527
Chapter
=> 1000
61
If you do not specify a value, S is used by default. Important! We strongly recommend that you specify S. If an operator specifies the wrong processing date, you must go through a recovery procedure to correct the date, and you must delete all reports that were collected with the incorrect date. Wait Minutes Indicates how long Unicenter CA-Bundl is to suspend processing when it has no data to collect Enter a value (in minutes) from 199. If you do not specify a value, 1 is the default. Increase this value if you: Have more than 100 DSF records Execute more than two collection jobs
62
Getting Started
Field
Description
Default Min Identifies the lowest-numbered page data file that PDF will temporarily store output Values are from 09. We recommend that you use the default value, 0. This field sets the default value for all DSF records. You can override this value on a DSF record by specifying a value in the Min PDF field. Several collection jobs can share a page data file. Only one collection job is allowed to update the file at a time. Therefore, you can experience processing delays if many collection jobs share a file or if a collection job writes large amounts of data to a file while other jobs wait for that file. Default Max Identifies the highest-numbered page data file that PDF will temporarily store output from Unicenter CA-Bundl To limit a collection job to a range of page data files, enter the number of the last file in this range. We recommend that you use the default value, 9. This field sets the default value for all DSF records; you can override this value on a DSF record by specifying a value in the Max PDF field. Mail Cd Banners Specifies how many copies of each banner page Unicenter CA-Bundl is to print between mail codes in a bundle Enter a value from 1 to 9; the default is 2. Note: This field affects only reports sent directly to print and reports that a Unicenter CA-Bundl user sends to the Unicenter CA-Bundl print queue. It has no effect on output that a Unicenter CA-Bundl user sends for immediate printing.
63
Description Specifies how many copies of each banner page Unicenter CA-Bundl is to print between home codes in a bundle Enter a value from 1 to 9. If you do not specify a value, 2 is used by default. Note: This field affects only reports sent directly to print and ones that a Unicenter CA-Bundl user sends to the Unicenter CA-Bundl print queue. It has no effect on output that a Unicenter CA-Bundl user sends for immediate printing.
Indicates the output class Unicenter CA-Bundl is to use for print output if none of your DTF records applies to that output If you do not specify a value, A is used by default.
Job Number Controls how the job number displays on the Flag Archive Selection List and the Reprint Status screens Maximum job numbers for z/OS 1.2 contain the letter J followed by 7 digits, for example, Jnnnnnnn. When you enter Y, 7 digits of the job number are displayed. Also, the /s are removed from the date on the Detail List for date options 1, 2, and 3. However, the date filter requires /s for date options 1, 2, and 3. When you enter N (default), 5 digits of the job number are displayed and the /s are added to the date on the Detail List for date options 1, 2, and 3.
64
Getting Started
Description Sets a maximum number of pages that Unicenter CA-Bundl retrieves when a user enters a FIND command to search for a text string and Unicenter CA-Bundl cannot find that string Specify a value from 1999999. If you do not specify a value, 1000 is used by default. Note: Less than or equal to 5000 is recommended.
Max Reprint Sets a maximum retention period for reprint pages Retpd distributed to Unicenter CA-Bundl view users Specify a value in one of the following formats (where n represents an actual value you specify): nnn or nnD for days (998 maximum) nW for weeks (99 maximum) nM for months (99 maximum) nY for years (99 maximum) nC for cycles (99 maximum) 999 (to retain permanently) Note: Retention periods are described in detail in the Unicenter CA-Bundl System Administrator Guide. Default Banner Identifies your default banner page exit routine If you do not specify a value, DPMS951 is used by default. Note: To override this routine, use the Banner field on a DTF record. Default Device Identifies your default device control exit routine Specify #NONE in this field to indicate that there is no device control exit routine. If you do not specify a value, DPMS952 is used by default. To override this routine, use the Device field on a DTF record.
65
Description Identifies your default output page exit routine Specify #NONE in this field to indicate that there is no default output page exit routine. There is no default routine for output pages. To override this routine, use the Out Page field on a DTF record.
(1-5) ( MM/DD/YY ) (Description, Name) (Yes/No) (None, or character to use) (Top, Section, or None)
66
Getting Started
If you do not specify a value, format 1 is used by default. Selection List Qualifiers Indicates the fields Unicenter CA-Bundl is to use to identify a report on the Unicenter CA-Bundl view screens Specify one of the following values: D Uses the value in the Descrip field on the RDF Detail screen for that distribution
N Uses the values in the Report, Jobname, and Jobnum fields If you do not specify a value, D is used by default.
67
Field
Description
Auto-save Indicates when to save view settings. View Settings Specify one of the following values: N Saves these settings only when users enter a SAVE command Y Saves these settings automatically If you do not specify a value, N is used by default. Column Separator(s) Sets the default value in the Column Separator(s) field on the View Options for Report Screen Ruler Line(s) field identifies the character to use to separate columns in report displays. Specify a single character. If you do not specify a value, a split vertical bar (|), sometimes called a pipe, is used. Ruler Line(s) Sets the default value in the Ruler Line(s) field on the View Options for Report Screen Ruler Line(s) field tells Unicenter CA-Bundl where to place horizontal rulers in report displays. Specify one of these values: N Omits rulers S T Places rulers between sections (line ranges) Places rules only at the top of the screen
68
Getting Started
Description Sets the default value in the SYSOUT Class field on the View Options for Report Screen SYSOUT Class field identifies what SYSOUT class to use when printing reports requested from view screens. Specify a SYSOUT class.
Banner Pages Sets the default value in the Banner Pages field on the View Options for Report Screen The Banner Pages field tells Unicenter CA-Bundl whether to insert banner pages in output you print from view screens. Specify N or Y. If you do not specify a value, Y is used by default. Reformat Option Sets the default value in the Reformat Option field on the View Options for Report Screen The Reformat Option field tells Unicenter CA-Bundl whether to reformat columns and lines in output you print from view screens. Specify one of these values: B C L Reformats both columns and lines Reformats columns only Reformats lines only
N Prints the report in its original format If you do not specify a value, N is used by default.
69
Description Sets the default value in the Line Number(s) field on the View Options for Report Screen The Line Number(s) field tells Unicenter CA-Bundl whether to display line numbers on the left side of reports. Specify N or Y. If you do not specify a value, N is used by default.
610
Getting Started
Use the Options Page 2 screen to display and change settings for special start-up filters and immediate print default options, which enable you to permanently define parameter settings that are to be entered automatically whenever you start Unicenter CA-Bundl. The parameters you specify on the Options Page 2 screen apply only to the Current Report Selection List and Archive Report Selection List screens.
Report
Home Code
Mail Code
611
Description Specifies that Unicenter CA-Bundl is to interpret or not interpret the characters asterisk (*) and question mark (?) as wildcard characters on current and archived report list screens Note: Asterisk (*) matches any trailing set of characters; question mark (?) matches any single character, including the blank character. Y(es) tells Unicenter CA-Bundl to interpret the asterisk (*) and question mark (?) characters as wildcards when you enter them to search for or restrict the listing of reports on current or archived report list screens. N(o) tells Unicenter CA-Bundl not to interpret the asterisk (*) and question mark (?) as wildcards. If you do not specify a value in this field, the default value specified by your Unicenter CA-Bundl administrator is used. If your Unicenter CA-Bundl administrator does not specify a default value for this field, N is used. You can also enter WILDCARD OFF and WILDCARD ON on the command line of any Unicenter CA-Bundl screen to activate or deactivate this wildcard facility for the remainder of your current user session or until changed. If Y is specified in this field, ABC* is interpreted as all text strings that begin with ABC. If N is specified in this field, ABC* is interpreted as the text string ABC only.
612
Getting Started
Description Specifies if filter settings defined on the Options Page 2 screen are to be automatically carried over when you display different report selection lists (for example, when you switch from the Archive Report Selection List screen to the Current Report Selection List) Y(es) Indicates that the current filter settings are to be automatically carried over when you switch to a different report selection list. N(o) Indicates that the currently-set filters are to be cleared when you switch amongst the Current, Archived, and Collected Report Selection List screens. You can carry over values amongst the Current, Archived, and Collected Report Selection List screens only. If a value is not specified in this field, the default value specified by your Unicenter CA-Bundl administrator for this field is used. If your Unicenter CA-Bundl administrator does not specify a default for this field, N is used. You can also enter REUSE OFF and REUSE ON on the command line of any Unicenter CA-Bundl screen to activate or deactivate this facility for the remainder of your current user session or until changed.
Report Order
Specifies the order in which reports are to be listed on current and archived report list screens O Displays the oldest produced or archived reports first
613
Description Specifies the maximum number of days after the date you specify (in the Date filter field on selection list screens) that are to be listed on the Current Reports Selection List screen Enter a value between 0 and 9999 inclusive in this field. Use this decision table to determine the value to enter in this field to effect the result you want: If You Want to Then You Specify, in the Date Filter Span Field
Display all dates starting with the date of oldest Unicenter CA-Bundl report
Enter blank Display all in the Date previous dates from a number of filter field days ago up to and including the present day Display all previous dates starting from a specified date up to and including the current day Specify the date on which to start in the Date filter field
Actual number of days ago (up to and including the present day) you want The value 0 (zero)
614
Getting Started
Description If You Want to Then You Specify in the Date Filter Span Field The value 0 (zero)
Display all previous dates starting from a specified date up to and including the current day Display a range of dates starting at a specified date and ending at a specified number of days
Specify the date on which to start in the Date filter field Specify the date on which to start in the Date filter field
Actual number of days after the end date specified in the Date Filter field
If you enter Y(es) in the Retain Filters field, the previously-defined value in the Date Filter field is used by default when you initially display a Report Selection List. Notes: If the Report Order field is set to O(ldest) and you want to display a list of all reports for the period August 1, 2000 through August 20, 2000, you specify August, 1, 2000 in the Date Filter field and the value 20 in the Date Filter Span field. For the Archived Reports Selection List screen the Date Filter Span field will have no effect when the Report Order field is set to N(ewest). When the Report Order field is set to O(ldest) and a date is entered in the Date Filter field, it indicates how many days forward to search and display reports from the date entered in the Date Filter field.
615
Field Dest/Node
Description Specifies a personal immediate print default value you want automatically inserted in the Destination/Node field on the Specify Printing Parameters screen whenever you request an immediate print The value you specify in this field is subsequently displayed (until you change it) in the Destination/Node field whenever you display the Specify Printing Parameters screen.
Remote ID
Specifies a personal immediate print default value you want automatically inserted in the Remote ID field on the Specify Printing Parameters screen whenever you request an immediate print The value you specify in this field is subsequently displayed (until you change it) in the Remote ID field whenever you display the Specify Printing Parameters screen.
Form
Specifies a personal immediate print default value you want automatically inserted in the Form field on the Specify Printing Parameters screen whenever you request an immediate print The value you specify in this field is subsequently displayed (until you change it) in the Form field whenever you display the Specify Printing Parameters screen.
616
Getting Started
Field
Description
Startup Enter a command or set of commands to be command ==> executed automatically every time you start Unicenter CA-Bundl You can enter a maximum of 50 characters in this field. Notes: The fast path commands are: =n (equal sign) . (period) Selects option n on the CA-Bundl Main Menu In place of the Enter key, you can use a period
The first two characters of the startup command field must begin with an equal sign (=) followed by a valid menu option. For example, startup command ==> =2 (positions you to the archive reports screen and issues the Enter key automatically.) These commands are intended primarily for use on the Options Page 2 screen. These commands enable you to automatically jump to the screen you use most often when you start Unicenter CA-Bundl and execute Unicenter CA-Bundl commands.
617
Description To automatically turn on the display of the screen identifier and display the Archived Report Selection List screen (which includes a filtered list of reports that are listed according to the start-up options you specify) every time you access Unicenter CA-Bundl, enter the command =2.PANELID in the Startup command ==> field on the Options Page 2 screen.
618
Getting Started
Unicenter CA-Bundl uses the default user option values you specified for all new Unicenter CA-Bundl users. To make the changes affect all users, you must run CC50J080 to delete the profile for all users. See the chapter Using and Scheduling Unicenter CA-Bundl Jobs and Programs in the Unicenter CA-Bundl Administrator Guide for more information about CC50J080.
619
PF Definitions Screen
PF Definitions Screen
You can assign Unicenter CA-Bundl commands that online view users issue most often to programmable function (PF) keys. You use the administrators PF Definitions screen to assign Unicenter CA-Bundl commands to PF keys for all online view users. If an individual Unicenter CA-Bundl user does not reassign them during his or her own Unicenter CA-Bundl session, the commands you assign to PF keys on this screen are used by default. The PF Definitions screen for administrators and users is the same screen. An online view user uses the PF Definitions screen to reassign commands to PF keys for their own Unicenter CA-Bundl session. The following is a diagram of a typical PF Definitions screen. All fields are critical.
--------------------- CA-BUNDL: PF Definitions --------------------Command ==> PF1 PF2 PF3 PF4 PF5 PF6 PF7 PF8 PF9 PF10 PF11 PF12 / / / / / / / / / / / / PF13 PF14 PF15 PF16 PF17 PF18 PF19 PF20 PF21 PF22 PF23 PF24 => => => => => => => => => => => => HELP PRINT END MENU FIND COLUMNS UP DOWN BACK LEFT RIGHT FORWARD
620
Getting Started
621
Use the following procedure to assign Unicenter CA-Bundl commands to PF keys for all online view users: 1. Do one of the following: Enter =4.2 on the command line of any Unicenter CA-Bundl administration screen. Choose Option 2 from the System Options Menu. The administrators PF Definitions screen will display. 2. Move the cursor to the desired field and enter the new command you want over the current command shown in the field. Repeat the previous step to reassign other commands to PF keys until you reassign all the commands you want. Press Enter. Unicenter CA-Bundl assigns the command or commands you entered to the corresponding PF key or keys shown for all online view users. Note: Unicenter CA-Bundl retains the settings of PF keys until you change them for all online view users, or until an individual online view user changes them during a Unicenter CA-Bundl session. In order to make the administrators changes take effect for all users, you must run CC50J080 to delete the profile for all users. See the chapter Using and Scheduling Unicenter CA-Bundl Jobs and Programs in the Unicenter CA-Bundl Administrator Guide for more information about CC50J080.
3. 4.
622
Getting Started
Chapter
Exit Routines
This chapter describes the Unicenter CA-Bundl exit routines and provides instructions on how to write them.
Exit Routines
71
You can use this exit routine to do the following: Add headers to a page Place control data on a page Add, delete, modify, or replace a page Change the home code, mail code, or particular information about the input data set from which the page was collected. Limit the number of lines or pages collected from a JES data set. A page is inserted in the front of the collected data set indicating that the report has been truncated and exceeded the number of lines. The exit, SAMPEX2M, is delivered as an example of controlling the number of lines collected. Note: Unicenter CA-Bundl calls this exit routine immediately after it collects pages but before it examines those pages. Important! The sample input page exits (SAMPEXxx) shipped with Unicenter CA-Bundl are shells (frameworks) meant to assist you in creating your own exits. They are not intended for use as shipped.
72
Getting Started
Unicenter CA-Bundl arranges a page so that is has the same layout as when it is printed. When you modify, insert, or replace pages, use the same structure as the Unicenter CA-Bundl pages:
Use a line length of 204 bytes. Provide no more than 150 lines per page. Make the first character of each line an ASA carriage
control character. Or, if you do not want to use a line, make the first character of the line the value XFF. when you print it.
BND7280I PAGE EXIT ROUTINE INVALID RC BND7281I PAGE EXIT ROUTINE INVALID LINE
COUNT
Register 3 points to the exits parameter list Register 4 points to the input page exit Register 5 contains the return code issued from the exit
routines last call If a User 600 Abend occurs, then a VSAM error occurred. Use caution when testing the exit routine because the exit routine can pass Unicenter CA-Bundl data that can later cause problems. An invalid carriage control or a wrong line count, for example, does not immediately cause a 600 abend, but it can later cause problems during processing.
Exit Routines
73
Look in the SAMPEX2x members of CAI.PPOPTION for sample input page exit routines. Unicenter CA-Bundl does not execute an input page exit routine by default.
74
Getting Started
Description Note: If C appears at offset +14, you can only change the offsets with an asterisk (*) after them. +00 Four-byte hexadecimal address for the page record If you provide a replacement page or insert a page, specify the address of the page here. +04 Four-byte hexadecimal address of the subsystem options block +08 Four-byte reserved area +C Two-byte hexadecimal value for the number of lines on the page (including lines with an XFF carriage control character) If you change the number of lines on a page, use this offset to determine how many lines are now on the page. +E Two-byte hexadecimal value for the number of lines actually used on the page This value equals the number of lines on the page minus the number of lines with an XFF carriage control character. Unicenter CA-Bundl calculates this value upon return. +10 Two-byte hexadecimal value for the line length This value is always 204 bytes. Do not change this value.
Exit Routines
75
Description +12 Two-byte hexadecimal value for the Unicenter CA-Bundl status code A code of 0 indicates that the exit routine located a page. A code of 4 indicates that no page was found (that is, an end-of-file condition occurred). +14 One-character code representing the type of data set (C for catalogued, J for JES) +15 Eight-character name of the job that created the data set +1D Eight-character JES number of the job that created the data set +25 Eight-character writer name +2D Eight-character undefined value +35 Four-character form for the data set +39 Four-byte hexadecimal value for the time when this data set was created +3D Four-byte hexadecimal value for the date when this data set was created +41 One-character JES output class +42* 44-character external file name (from the DSF record) +6E 44-character DSNAME +9A Two-byte hexadecimal value for the number of copies from JES +9C* Two-byte hexadecimal value for the logical record length of the data set
76
Getting Started
Description +9E* Two-byte hexadecimal value for the block size of the data set +A0 Ten-character application identifier Use the exit routine to modify. +AA Ten-character report identifier The exit routine can modify this identifier. +B4 Four-digit hexadecimal value for the number of lines in the JES data set +B8 Eight-character name of the PROC step that created the data set +C0 Eight-character name of the step that created the data set +C8 Eight-character DDNAME of the data set+D0 Eight-character group identifier for the data set +D8 Ten-character home code (for JES.ANY distribution only) The exit routine can modify this home code. +E2 Ten-character mail code (for JES.ANY distribution only) The exit routine can modify this mail code.
Exit Routines
77
Description The functions you can perform through a return code depend on what value you receive for the Unicenter CA-Bundl status code (stored at offset +12 in the parameter list). A code of 0 indicates that the exit routine located a page; a code of 4 indicates that no page was found. When the code is 4, you can insert a page or acknowledge the end-of-file condition (EOF). If you insert a record, Unicenter CA-Bundl calls the exit routine again (with the status code set to 4). You can continue inserting records (one per call) until you acknowledge the end-of-file (EOF) condition. Specify one of the following return codes to direct the exit routine: Return Code 0 Action When Status Code=0 Action When Status Code=4
Use the Acknowledge unmodified page end-of-file (EOF) condition Use the modified Invalid page Delete the page Invalid
4 8 12 16
Replace the page Invalid Insert a page before this one Insert a page before this one
78
Getting Started
Description Return Code 20 Action When Status Code=0 Action When Status Code=4
Do not call exit Acknowledge routine again for EOF this data set Do not call the exit routine again for this collector Acknowledge EOF; do not call the exit routine again for this collector
24
Exit Routines
79
Example of STCPARM DD: MAXLINES=99999999 Maximum number of lines to collect from a JES data set. MAXLINES must be numeric, no commas MAXOPT=BYPASS MAXLINES Bypass Option INPAGEX=SAMPEX2M Input page exit for handling collector line limits When the MAXOPT=BYPASS option is coded and the collector reaches MAXLINES, a notification page is inserted by exit SAMPEX2M into the Page Data File indicating that the data set has been truncated. The remaining lines are deleted from the JES data set. Care should be taken in using the MAXOPT=BYPASS option. When the MAXOPT=BYPASS is not coded the data set is collected in full and a warning message is generated by the SAMPEX2M exit. The SAMPEX2M exit can be customized as required to handle exceptions and customizing options.
710
Getting Started
Control the devices that cut paper from continuous form rolls Insert microfiche commands for custom handling of microfiche
Exit Routines
711
2. 3.
712
Getting Started
If you do not want to use an exit routine, specify #NONE in the corresponding field. See the Unicenter CA-Bundl Administrator Guide for more information about DTF records.
Use a line length of 204 bytes. Provide no more than 150 lines per page. Space lines to match the layout of the page, as it appears
when you print it.
control character. Or if you do not want to use a line, make the first character of the line the value XFF.
Each new exit you create should be assembled and linked into CAI.CAILIB using the supplied USERMODs in SAMPJCL.
For DPMS951, use USERMOD CC5095X For DPMS952, use USERMOD CC5095Y For DPMS957, use USERMOD CC50OPX
Exit Routines
713
714
Getting Started
First-Level Indicator Distribution Break Output requirement Home code Mail code Application Report Copy Beginning of data page Final call Value D H M A R C S X
Second-Level Indicator Distribution Break Before begin banner page Before report (inventory or user) Before end banner page After begin banner page After report (inventory or user) After end banner page Value A (or 1) B C (or 9) N O P
Note: Calls for A and C are performed only when banner pages are printed. The remaining calls are performed at all times. Final call (X) is the only first-level indicator that is not paired with a second-level indicator.
Exit Routines
715
Second-Level Indicator Distribution Break Begin banner page End banner page Value A (or 1) C (or 9)
Note: The exit routine must be prepared for multiple calls. Final call (X) is the only first-level indicator that is not paired with a second-level indicator.
716
Getting Started
Note: More than one value can occur within a level. More than one mail code can occur, for example, within a home code, and more than one copy can occur within a report.
Exit Routines
717
718
Getting Started
Exit Routines
719
The Unicenter CA-Bundl device control exit routine uses the BUNOUT macro to write device control commands. Unicenter CA-Bundl includes this macro as member BUNOUT in CAI.CAIMAC. The format of the macro is: BUNOUT OUTRTN=addr1,BUFFER=addr2,BUFFLEN=len Variable addr1 Represents Entry point address of the output routine that writes lines to the output data set If you do not specify the OUTRTN parameter (optional), the value $OX@RTN is used by default. Tip: We recommend that you specify only $OX@RTN for the OUTRTN parameter. Specify a value other than $OX@RTN only if the parameter block DSECT cannot be addressed. addr2 len Address of the output buffer Length of the valid portion of the output buffer If you do not specify a value, the value 133 is used by default.
720
Getting Started
Exit Routines
721
Description +4 Points to a blank page area Build a new banner page here This exit routine uses the DPMS804 subroutine for block lettering required on the default banners. R13 This register points to the address of the standard save area R14 This register points to the return address R15 This register points to the entry point of the exit routine All other registers are undefined
722
Getting Started
Information
Description This register points to two full words: +0 Points to the parameter block shown in member DPMCOXPB in CAI.CAIMAC Points to the data page You can modify this page in any way before it is printed. R13 R14 R15 This register points to the address of the standard save area This register points to the return address This register points to the entry point of the exit routine
+4
All other registers are undefined Return Code, Register 15 0 4 Print the page Do not print the page
Exit Routines
723
724
Getting Started
Exit Routines
725
726
Getting Started
Exit Routines
727
Information
Description
Register Usage R1 This register contains the address of the at Entry parameter list, in this format: +0 Contains the address of the environment data area. For CICS, this is the DFHEISTG address +4 Contains the address of eight-byte user identifier +8 Contains address of list of mail codes Each mail code is 10 bytes long. A maximum of 65 mail codes can be included in the list. If you add to or delete from the list, you must change the total at offset +C. +C Contains the address of a full word with the number of mail codes in the list at offset +8 Change this value if the exit routine adds or deletes mail codes.
728
Getting Started
Description +10 Contains an application list address Each application identifier is 10 bytes long. A maximum of 65 application identifiers can be included in this list. If you add identifiers to or delete identifiers from this list, you must change the total at offset +14. +14 Contains the address of a full word that indicates the number of application identifiers in the application list at offset +10 If you add or delete identifiers, change this value. +18 Contains the address of the first of two full words that control access to the administration functions These full words determine whether a user has edit or browse access to Unicenter CA-Bundl screens. +1C Contains the address of a 32-byte user area passed to all exit routines R13 This register contains the address of the standard save area R15 This register contains the entry point address of the exit routine All other registers are undefined.
Exit Routines
729
Description 0 4 Continue with initialization The user identifier has been modified The new list of mail codes for the modified user identifier is appended to the existing list of mail codes. After the list is updated, the exit routine is called again. 8 Terminate this session immediately Note: You must restore all registers (except 0, 1, and 15) upon return.
730
Getting Started
Description R1 This register contains the address of the parameter list in the following format: +0 Contains the address of the environment data area. For CICS this is the address of DFHEISTG +4 Contains the address of the eightbyte user identifier +8 Contains the address of a 32-byte user area passed to all exit routines R13 R15 This register contains the address of the standard save area This register contains the entry point address of the exit routine
Exit Routines
731
Information
Description
Register Usage R1 This register contains the address of the at Entry parameter list in the following format: +0 Contains the address of the environment data area. For CICS this is the address of DFHEISTG Contains the address of the eightbyte user identifier Contains the address of the list of mail codes Each mail code is 10 bytes long, and a maximum of 65 mail codes can be included in the list. If you add mail codes or delete mail codes from this list, you must change the total at offset +C. +C Contains the address of a full word with the number of mail codes in the list at offset +8 Change the value if exit routine adds or deletes mail codes from the list. +10 Contains the address of the 10-byte mail code to be checked. +14 Contains the address of a 32-byte user area passed to all Unicenter CA-Bundl exit routines R13 This register contains the address of the standard save area R15 This register contains the entry point address of the exit routine All other registers are undefined.
+4 +8
732
Getting Started
Description Any value greater than 0 indicates that the user is authorized to view the mail code Note: You must restore all registers (except 0, 1, and 15) upon return.
Exit Routines
733
Information
Description
Register Usage R1 This register contains the address of the at Entry parameter list in the following format: +0 Contains the address of the environment data area. For CICS, this is the address is DFHEISTG. Contains the address of the eight-byte user identifier Contains the address of the nine-byte beginning page number Contains the address of the nine-byte ending page number
+4 +8 +C
+10 Contains the address of the one-byte SYSOUT class +14 Contains the address of the eight-byte device identifier +18 Contains the address of the eight-byte remote identifier +1C Contains the address of the four-byte mode +20 Contains the address of the three-byte number of copies +24 Contains the address of the DTF record for this request +28 Contains the address of a 32-byte user area passed to all Unicenter CA-Bundl exit routines R13 This register contains the address of the standard save area R15 This register contains the entry point address of the exit routine All other registers are undefined.
734
Getting Started
Description Any value greater than 0 indicates that the print request is to be canceled Note: You must restore all registers (except 0, 1, and 15) upon return.
Exit Routines
735
Description R1 This register contains the address of the parameter list in the following format: +0 Contains the address of the environment data area. For CICS this is the address of DFHEISTG +4 Contains the address of the eight-byte user identifier +8 Contains the address of the list of application identifiers Each identifier is 10 bytes long, and you can include a maximum of 65 application identifiers. If you add identifiers to or delete identifiers from this list, you must change the total at offset +C. +C Contains the address of a full word with the number of application identifiers in the list at offset +8 Change this value if the exit routine adds or deletes identifiers from the list. +10 Contains the address of the ten-byte application identifier to be checked +14 Contains the address of a 32-byte user area passed to all exit routines R13 This register contains the address of the standard save area R15 This register contains the entry point address of the exit routine All other registers are undefined.
736
Getting Started
Description Any value greater than 0 indicates that the user is authorized for that application identifier Note: You must restore all registers (except 0, 1, and 15) upon return.
Exit Routines
737
Description +4 Contains the address of the 8-byte user identifier +8 Contains the value entered in the Sel column next to the record. This value can be: B, C, D, E, or M. +C Contains a code to represent the type of change to the record that is being requested Codes and the type of change they represent are: A Add B Browse D Delete U Update
See the table in "Comment: Sel, Type, and Action Allowed" for a description on how these values correspond to the values specified in the Sel column. +10 Contains a three-byte, uppercase name of the file being accessed +14 Contains the address of the copy of the key of the record being accessed +18 Contains the application code from the record being accessed, if it appears once in the record, or low values +1C Contains the mail code from the record being accessed, if it appears once in the record, or low values +20 Contains the address of the 32-byte user area passed to all exit routines R13 R14 This register contains the address of the standard save area This register contains the return address
738
Getting Started
Information
Description This register contains the entry point address of the exit routine
All other registers are undefined. Any value greater than 0 indicates that access is to be denied Note: You must restore all registers (except 0, 1, and 15) upon return.
Exit Routines
739
Description +12 Contains the address of primary record buffer +14 Contains the address of a full word that indicates the number of application identifiers in the application list at offset +10 If you add or delete identifiers, you must change this value. +16 Contains the address of the secondary record buffer (or 0 if it is not needed) +20 Contains the address of the 100-byte message buffer If exit moves text into this area, it is written to the log as message identifier 7967. Upon entry, this buffer is always set to nulls. Upon return, the text is assumed to end at the first null (x'00) byte. If the first byte is NULL, a message is not logged. +24 Contains the address of the 32-byte static area that is passed to all exits for inter-exit communication R13 This register contains the address of the standard save area R15 This register contains the entry point address of the exit routine All other registers are undefined.
740
Getting Started
Description Any value greater than 0 indicates that the action is not to be permitted (logging is not allowed unless a message is copied to the message buffer) Note: You must restore all registers (except 0, 1, and 15) upon return.
Exit Routines
741
Description The entry environment is determined by the AMODE value for the load module This register contains the address of the parameter list (mapped by BUNDUPL), in the following format: +0 +4 +8 +C Contains the address of the 8-byte user ID Contains the address of the 8-byte user password Contains the address of the 8-byte new password Contains the address of the 24-byte area into which the short message may be returned Contains the address of the 78-byte area into which the long message may be returned Contains the address of the 8-byte cursor position Contains the address of the 8-byte cross memory connection ID
+10
+14 +18
+1C Contains the address of the exit communication area If the exit moves text into this area, the text is written to the Unicenter CA-Bundl log as message identifier 7967. Upon entry, this buffer is always set to nulls. Upon return, the text is assumed to end at the first null (x'00) byte. If the first byte is NULL, a message is not logged.
742
Getting Started
Description +20 +24 +28 Contains the address of the security area (I.E.ACEE) Contains the address of the UPL extension Contains the user exit work area of 60F
+268 Contains the user exit short message 24 characters +50C Contains the user exit long message 78 characters R13 R14 This register contains the address of the standard save area This register contains the return addressR15 This register contains the entry point address of the exit routine All other registers are undefined. Return Code, Register 15 Any value greater than 0 indicates that access is denied. The following values are set into Register 15 prior to the return to the caller: R15 value '4' - Invalid user ID/ access denied R15 value '8' - Invalid password R15 value '12' - Password expired R15 value '16' - Invalid new password R15 value '20' - Unidentified error Note: You must restore all registers (except 0, 1, and 15) upon return.
Exit Routines
743
Appendix
A1
3380 (single density) Vols. .02 .12 .60 .90 1.60 2.95 5.65 Cyls. 15 100 500 800 1400 2600 5000
3390 (single density) Vols. .01 .07 .36 .58 1.01 1.89 3.64 Cyls. 12 81 405 648 1134 2106 4050
< <
< 2,500,000 lines < 5,000,000 lines < 10,000,000 lines < 20,000,000 lines < 40,000,000 lines
A2
Getting Started
A3
A4
Getting Started
File DPMFVIF
Description View Index File The current report index that maps out the contents of the view data files. Entries are created in this file for each copy or distribution of the report.
A5
File DPMFMCF
Description Mail Code File Stores the records that define delivery information that is to appear on the banner for each mail or home code.
DPMFRTF
Report Table File Stores the records that define rules that identify each report and control break identifier used in Unicenter CA-Bundl distribution rules.
DPMFRDF
Report Distribution Table File Stores the records that describe the specific distribution rules for each particular part of a report or for the report as a whole.
DPMFSCH
Schedule File Stores the records that control job submission by Unicenter CA-Bundl.
DPMFSHF
Standard Header File Stores records that replace, alter, or add standard information to report pages.
DPMFSRF
Standard Rule File Stores records that direct parts of a report to several mail codes or mail lists or several parts of a report to go to one mail code or mail list.
DPMFSTF
Source Translate File Stores records that translate a value from a report to a specific mail code or to mail lists. Job names can also be translated into mail codes or mail lists.
A6
Getting Started
File DPMFTSF
Description Terminal Security File Stores records that define the functions a user may access when the Unicenter CA-Bundl function security is used.
DPMFVSF
View Security File Stores records that define the mail codes a user may access when Unicenter CA-Bundl mail code security is used.
Description Reprint Page Data File Stores the reports to be printed after the data has been retrieved from archive.
A7
Description Map File A collection of maps used throughout Unicenter CA-Bundl for the online, help, and tutorial screens.
DPMFPSF
Processing Statistics File Stores information about pages collected and distributed to view, paper, and fiche. File is reset during the end-of-day processing.
DPMFSSF
Statistical Summary File Stores the statistical processing information collected each day in the DPMFPSF by month and year.
A8
Getting Started
Index
archive file split procedure, 418
A
ACCEPT processing, overview of, 23 SMP, 432 ACCEPTing services, 432 access, user, 57 addressability, extended, A3 administrative record access security exit routine, 725, 737 Adobe Acrobat Reader, downloading the, 13 Advantage CA-Roscoe, installing, 423 allocating disk space, A1 distribution libraries, 48 private SMP/E libraries, 49 target libraries, 48 application security exit routine, 725, 735 table file, A5, A6 Application field, 55, 611 Applications For This User field, 514 applications, granting authority to, 510 APPLY processing, overview of, 23
Archive Index File (AIF), A4 Archived Report List screen, 58 ATF Application IDs, 58 authority, granting, 510, 514 Auto-save View Settings field, 68
B
banner page exit routine, 711, 716, 721 logo file, A5 Banner Pages field, 69 BUNOUT macro, 720
C
CA Common Services, 31 services component, 36 CA-Bundl: VSF Detail Screen, 521 CA-DRAS (Distributed Repository Access System), 36 CAI Resource Initialization Manager (CAIRIM), description of, 31 CAIDS60, 49 Index9
CAILIB (CAI Common Load Library), 37 CAINITE5, 49 CAIRIM (CAI Resource Initialization Manager), 21 CA-LMP (License Management Program), description of, 32 CA-LServ installing, 32 setting up, 427 CC50APP, 410 CC50SMPE, 410 changes in Unicenter CA-Bundl 5.0, 14 CICS, installing, 421 collection procedure, 418 Column Separator(s) field, 68 commands assigning to PF keys, 621 conventions used to represent, 111 Equals (=), 617 Startup, 617 common clist library, 35 component product codes, 414 components CA Common Services, 36 CA-DRAS, 36 product, 36 control table files, A5 DPMFATF, A5, A6 DPMFBSF, A5 DPMFDSF, A5 DPMFDTF, A5 DPMFLGF, A5 DPMFMCF, A6 DPMFRDF, A6 DPMFRTF, A6 DPMFSHF, A6 DPMFSRF, A6 DPMFSTF, A6
DPMFTSF, A7 DPMFVSF, A7 conventions commands, 111 Enter key, 110 programmable function (PF) keys, 110 special typeface, 110 variables, 111 cooperative processing, 41 logon security exit routine, 741 creating production VSAM files, 429 Current Reports List screen, 58 customization clist, 414
D
DASD, requirements for page data files, A2 Date Filter Span field, 614 Date Format field, 67 date formats, 111 Default Banner field, 65 Default Device field, 65 Default Max PDF field, 63 Default Min PDF field, 63 Default Out Class field, 64 Default Out Page field, 66 Default User Option Screen, 66 defaults establishing, 524 setting option, 619 Dest/Node field, 616 device control exit routine, 710, 714, 719 output File, A5
Index2
Getting Started
Device ID field, 522 disk space, allocation of, A1 distribution index files DPMFAIF, A4 DPMFAIF0-9, A4 DPMFPIF, A4 DPMFRIFO, A4 DPMFSIF, A4 DPMFVIF, A5 libraries, 35 output, sequence of, 718 procedure, 418 tape, product, 34 documentation list of, 11 viewing and printing, 13 DPMS960 security exit, 727 DPMS961 security exit, 730 DPMS962 security exit, 731 DPMS963 security exit, 733 DPMS966 security exit, 737 DPMS967 security exit, 739 DPMS969 security exit, 741 DSF Input Data Set, 58 DTF Device Output, 59
exit routines administrative record access security, 725, 737 application security, 725, 735 banner page, 711, 721 cooperative processing logon security, 741 device control, 710, 714, 719 granting authority through, 514 how to override for devices, 712 identifying, 712 input page, 71, 72, 74 logoff security, 724, 730 logon security, 724, 727 mail code security, 725, 731 online security, 723 output calling order of, 714 page, 711, 722 rules for writing, 713 rules for writing, 726 TSO report access logging security, 739 view print security, 725, 733 extended addressability, A3
F
fields Application, 55, 611 Applications For This User, 514 Auto-save View Settings, 68 Banner Pages, 69 Column Separator(s), 68 Date Filter Span, 614 Date Format, 67 Default Banner, 65 Default Device, 65 Default Max PDF, 63 Default Min PDF, 63 Default Out Class, 64 Default Out Page, 66 Dest/Node, 616 Device ID, 522
E
End User field, 512 end-user facilities, starting the, 424 Equals (=) command, 617 Execution JCL, 414 exit routine, banner page, 716
Index3
End UserR, 512 Form, 616 Function, 55 Home Cd Banners, 64 Home Code, 611 Job Number Flag, 64 Language Preference, 67 Line Numbers, 610 Mail Cd Banners, 63 Mail Code, 611 Mail Codes for this User, 523 Master User ID, 54 Max Pages/Find, 65 Max Reprint Retpd, 65 Operator, 512 PF, 621 Process Date, 62 Reformat Option, 69 Remote ID, 616 Report, 611 Report Order, 613 Restrict MCF Records, 56 Retail Filters, 613 Ruler Line(s), 68 Selection List Qualifiers, 67 Seq No, 521 Sys Admin, 512 SYSOUT Class, 69 Use Wildcard Filters, 612 User ID, 512, 521 User Name, 512, 521 Wait Minutes, 62 files AIF (Archive Index File), A4 application table, A5, A6 ATF Application IDs, 58 banner page logo, A5 control table, A5 DPMFATF, A5, A6 DPMFBSF, A5 DPMFDSF, A5 DPMFDTF, A5 DPMFLGF, A5 DPMFMCF, A6 DPMFRDF, A6
DPMFRTF, A6 DPMFSHF, A6 DPMFSRF, A6 DPMFSTF, A6 DPMFTSF, A7 DPMFVSF, A7 device output, A5 distribution index, A4 DPMFAIF, A4 DPMFAIF0-9, A4 DPMFPIF, A4 DPMFRIF, A4 DPMFSIF, A4 DPMFVIF, A5 DSF Input Data Set, 58 DTF Device Output, 59 input data set, A5 LGF Banner Page Logo, 510 mail code, A6 Map, A8 MCF Mail Codes, Lists, 59 PIF (Processing Index File), A4 Processing Statistics, A8 RDF Basic Distribution, 59 report distribution table, A6 table, A6 Reprint Page Data, A7 RTF Report IDs, 58 SCH Scheduling, 510 SHF Text Changes, 59 SIF (Sorted Index File), A4 source translate, A6 SRF Standard Rule, 59 standard header, A6 rule, A6 Statistical Summary, A8 STF Translation Rule, 59 storage table, A7 DPMFMAP, A8 DPMFPSF, A8 DPMFRPF, A7 DPMFSSF, A8 terminal security, A7 TSF Func, Appl Security, 59
Index4
Getting Started
Unicenter CA-Bundl system, A5 view page, A7 security, A7 VIF (View Index File), A5 VSF View Security, 59 fileserver, using Unicenter CA-Bundl with, 434 FMIDs, 410 fonts, use of special, 110 Form field, 616 formats, date, 111 Function field, 55
using SMP/E, overview of, 23 VTAM View, 424 ISPF library, 35 italics, use of, 111
J
JCL, location of sample, 34 Job Number Flag field, 64
K
keys Enter, 110 PF, 110 Return, 110
H
hardware requirements, 35 Home Cd Banners field, 64 Home Code field, 611
L
Language Preference field, 67 LGF Banner Page Logo, 510 libraries allocating, 48 distribution, 48 private SMP/E, 49 target, 48 distribution, 35 target, 35 library authorization, 37 Line Numbers field, 610 LMP (License Management Program), 32 execution key, 413 key certificate, 411 load library, 35
I
input data set file, A5 page exit routine, 71, 72, 74 installation materials, 34 testing the, 428 installing Advantage CA-Roscoe, 423 CA-LServ, 32, 427 CA-View, overview of, 21 CICS, 421 TSO Interface, 426 Unicenter CA-Bundl loading the SAMPJCL, 47
Index5
logoff security exit routine, 724, 730 logon security exit routine, 724, 727 providing, 515
O
online facility option, 111 reprint index file, A4 security exit routine, rules for writing, 726 exit routines, 723 types of, 724 system, starting the, 424 Operations Menu screen, 58 Operator field, 512 options setting defaults for, 619 setting processing, 618 Options Page 2 screen, 610 output exit routines, 710 calling order of, 714 rules for writing, 713 page exit routine, 711, 722
M
macro library, 35 macros, BUNOUT, 720 Mail Cd Banners field, 63 mail code file, A6 security exit routines, 725, 731 Mail Code field, 611 mail code-level security activating, 527 establishing defaults, 523 providing, 519 Mail Codes for this User field, 523 mail codes, authorizing users for, 526 Main Menu, displaying from any screen, 617 major SMP/E operations, 23 managing space, A3 map file, A8 Master User ID field, 54 Max Pages/Find field, 65 Max Reprint Retpd field, 65 MCF Mail Codes, Lists, 59 MCF records, 514 menus, System Options, 510 modification control statements (MCS), 23, 34
P
PF field, 621 PF keys, rules for assigning commands to, 621 PIF (Processing Index File), A4 Process Date field, 62 processing index file, A4 options, setting, 618 Processing Options Screen, 61
Index6
Getting Started
Processing Statistics File, A8 product changes, summary of, 14 codes, component, 414 tape, 34 Product Temporary Fix (PTF), 434 programmable function keys, 110
S
sample JCL, location of, 34 SCH Scheduling, 510
R
RDF Basic Distribution, 59 RECEIVE processing, overview of, 23 SMP, 410 records security options, modifying, 56 VSF, 524 Reformat Option field, 69 related documentation, list of Unicenter CA-Bundl, 13 Remote ID field, 616 report, 35 distribution table file, A6 table file, A6 Report field, 611 Report Order field, 613 reprint data file, A7 index work file, A4 requirements hardware, 35 system, 31 Restrict MCF Records field, 56 Retail Filters field, 613 routines, output exit, 710
screens Archived, 58 CA-Bundl: Security Options Screen, 54 CA-Bundl: VSF Detail Screen, 521 Current Reports List, 58 Default User Option, 66 granting authority to, 510 Operations Menu, 58 Options Page 2, 610 Processing Options Screen, 61 System Options Menu, 510 TSF Detail: Application Security Screen, 511 security activating mail code-level, 527 mail code-level, 519, 523 options record, modifying, 56 overview of, 52 providing logon-level, 515 restricting, 519, 523, 526, 527 types of, 52 security exits DPMS960, 727 DPMS961, 730 DPMS962, 731 DPMS963, 733 DPMS966, 737 DPMS967, 739 DPMS969, 741 Selection List Qualifiers field, 67 Seq No field, 521 sequence of output distribution, 718
Index7
sessions, TSO Interface, setting defaults for, 619 SHF Text Changes, 59 SIF (Sorted Index File), A4 SMP procedure, customizing, 410 sorted index file, A4 source translate file, A6 split archive index file, A4 SRF Standard Rule, 59 standard header file, A6 rule file, A6 starting the online system and end-user facilities, 424 Startup commands, 617 Statistical Summary File, A8 STF Translation Rule, 59 storage table files, A7 DPMFMAP, A8 DPMFPSF, A8 DPMFRPF, A7 DPMFSSF, A8 Sys Admin field, 512 SYSOUT Class field, 69 System Options Menu, 510 system requirements, 31
TSF Func, Appl Security, 59 TSF Detail: Application Security Screen, 511 TSO Interface, installing, 426 report access logging security exit routine, 739
U
Unicenter CA-Bundl Customization Worksheet for, 43 documentation, 11 loading the SAMPJCL, 47 related documentation, 13 security, 52 setting option defaults, 619 processing options, 618 system file, A5 using with file server, 434 upgrading Unicenter CA-Bundl from 4.9 to 5.0, 430 Use Wildcard Filters field, 612 User ID field, 512, 521 User Name field, 512, 521 users authorizing, 526 authorizing mail codes for, 526 Using a single file server with multiple Unicenter CA-Bundl systems, 434
T V
target libraries, 35 terminal security file, A7 testing the installation, 428 variables, conventions used to represent, 111
Index8
Getting Started
view index file, A5 page file, A7 print security exit routine, 725, 733 security file, A7 VIF (View Index File), A5 VSAM files creating production, 429 initializing test, 419 VSF View Security, 59 VSF records, 524 VTAM View, 418 installing, 424
W
Wait Minutes field, 62
Index9