E-SRF EKC Security Reporting Facility Release 2.1 Installation Guide

Similar documents
E-SRF. Security Signature Analysis. Release EKC Security Reporting Facility GENERAL AVAILABILITY. September 1, 2005 EKC Inc.

Compute (Bridgend) Ltd

E-SRF. Messages and Codes. Release 2.1. EKC Security Event Reporting Facility. E-SRF V2R1 GENERAL AVAILABILITY, Revised February 13, 2005 EKC Inc.

Program Directory for IBM z Systems Development and Test Environment Tools

BEARS IMS. Installation and Maintenance Manual VIO Systems Limited. 1988, 2010 VIO Systems Limited. All rights reserved

E-SRF. Masterfile and Data Dictionary Reference. Release 2.1. EKC Security Event Reporting Facility

XPAF 5.0 Upgrade from XPAF 3.0.4/XPAF 4.0 Quick Reference. August 2011

IBM. Program Directory for. IBM z Systems Development and Test Environment Tools. V Program Number 5725-G39 FMID HALMB00.

Program Directory for IBM Migration Utility V Program Number 5697-N44 FMID HMGU320. for Use with z/os OS/390. Document Date: July 2009

Program Directory for IBM Tivoli NetView Monitoring for GDPS US English. Version 6 Release 2, Modification Level 01. Program Number 5698-BMP

Program Directory for IBM Security zsecure Suite: CARLa-driven components V Program Number 5655-N16/N17/N20/N21/AD8. FMIDs HCKR221, HC4R221

Program Directory for IBM Security zsecure Compliance and Administration V Program Number 5655-N25. for Use with z/os

E-SRF. Command Reference. Release 2.1. EKC Security Event Reporting Facility. E-SRF V2R1 GENERAL AVAILABILITY, Revised February 13, 2005 EKC Inc.

Program Directory for IBM Security zsecure CICS Toolkit V Program Number 5655-N18. FMIDs HCQT221. for Use with z/os

IBM. Program Directory for IBM Security zsecure Administration V Program Number 5655-N23. for Use with z/os. Document Date: August 2017

Program Directory for IBM Security zsecure Command Verifier V Program Number 5655-N19. FMIDs HC4R230, JC4R230.

Program Directory for IBM Service Management Suite for z/os Suite ID V1.R5.M0. Program Number 5698-AAF FMID HMSG150.

Program Directory for IBM Explorer for z/os V Program Number 5655-EX1 FMID HALG310. for Use with z/os V or later

Program Directory for IBM Tivoli NetView for z/os Enterprise Management Agent US English V Program Number 5697-NV6 FMID HNV620A

CA Common Services CA RS 1504 Service List

E-SRF EKC Security Reporting Facility Access Analysis Reports Guide for RACF

Program Directory for IBM Security zsecure Admin RACF-Offline V Program Number 5655-N16 FMID HB8R23F. for Use with z/os

Program Directory for IBM Tivoli License Compliance Manager for z/os V Program Number 5698-A86. FMIDs HAUD41B, JAUD41C, JAUD41D

Program Directory for IBM Management Console for IMS and DB2 for z/os V Program Number 5655-TAC FMID HDYW110.

Program Directory for IBM Security zsecure Suite: CARLa-driven components V Program Number 5655-N16/N17/N20/N21/AD8. FMIDs HCKR230, HC4R230

Program Directory for IBM Common Data Provider for z Systems System Data Engine V Program Number 5698-ABJ. FMIDs HHBO11E, HHBO11D

Program Directory for CICS Transaction Server for z/os Value Unit Edition V5.4 - activation module V Program Number 5722-DFJ FMID HCV7100

XPAF 8.0 Upgrade from XPAF 6.0/XPAF 7.0 Quick Reference. October 2016

Program Directory for IBM DB2 Backup and Recovery Solution Pack for z/os V Program Number 5655-BR1. for Use with z/os

Program Directory for Cryptographic Support for z/os V1R13 - z/os V2R2. Program Number 5650-ZOS FMID HCR77B1. for Use with z/os V1R13 - z/os V2R2

StorageTek Nearline Control Solution (MVS Implementation)

Program Directory for IBM DB2 High Performance Unload for z/os V Program Number 5655-HP5 FMID HINZ510. for Use with z/os

Program Directory for IBM Tivoli System Automation for z/os V Program Number 5698-SA3. FMIDs HWRE310, JWRE31C, JWRE31I, JWRE311, JWRE312

Program Directory for IBM Content Manager OnDemand Servers for z/os V Program Number 5697-CM1 FMID H272A10.

Program Directory for IBM Tivoli Workload Scheduler for z/os (English) Version Program Number 5698-T08. for Use with z/os

Program Directory for IBM Workload Scheduler for z/os (English) Version Program Number 5698-T08. for Use with z/os. Document Date: June 2015

OM OMCS/z Web Server INSTALLATION & OPERATION GUIDE. OMCS/z Web Server Version 1.0

Scheduling with the Agent for z/os

CA Common Services CA RS 1612 Service List

Program Directory for IBM Open Data Analytics for z/os V1R1. Program Number 5655-OD1. FMIDs HANA110, HMDS120, HSPK120

CA 1 Tape Management CA RS 1403 Service List

IBM Education Assistance for z/os V2R1

Scheduling with the agent for z/os

Program Directory for IBM WebSphere Application Server OEM Edition for z/os for Rational Team Concert for System z V Program Number 5724-V82

Program Directory for IBM Machine Learning for z/os V Program Number 5698-ML1 FMID HAQN110. for Use with z/os. Document Date: October 2017

Transporting files between MVS and MVS or between MVS and a Workstation

Appendix B WORKSHOP. SYS-ED/ Computer Education Techniques, Inc.

Failures under MVS p. 67 General p. 67 JCL Errors p. 68 Syntactical JCL Errors p. 68 Allocation JCL Errors p. 69 ABEND Failures p.

Installation Guide r12.5, Second Edition

CA Disk Backup and Restore Installing

SystemPac Enrichment Form for IBM Rapid Deployment of z/os and DB2 (Version 1.1)

Version 1 Release 2. IBM IMS Cloning Tool User's Guide IBM SC

Hardware Interface Service

CA Vantage Storage Resource Manager CA RS 1509 Service List

IOF (Interactive Output Facility) TSO Installation Guide Release 8E

CA JCLCheck Workload Automation CA RS 1404 Service List

IBM. User's Guide. SMP/E for z/os SA

Program Directory for IBM OMEGAMON Dashboard Edition on z/os V Program Number 5698-T06. for Use with z/os. Document Date: September 2017

IBM InfoSphere Guardium S-TAP for DB2 on z/os User's Guide. Version9Release1

Virtual Tape Control Software

Chapter 1 RUNNING A SIMPLE JOB. SYS-ED/ Computer Education Techniques, Inc.

Hitachi Device Manager Mainframe Agent Release Notes Contents

Mainstar : Backup & Recovery Manager Suite

Program Directory for IBM Rational Host On-Demand Version 11 V Program Number 5733-A59 FMID HHOJB00. for Use with z/os V1.08.

StorageTek Enterprise Library Software

IBM. MVS Installation Exits. z/os. Version 2 Release 3 SA

USING SAS SOFTWARE TO COMPARE STRINGS OF VOLSERS IN A JCL JOB AND A TSO CLIST

COMPUTER EDUCATION TECHNIQUES, INC. (JCL ) SA:

IBM. Scheduling with the Agent for z/os. IBM Workload Scheduler. Version 9 Release 4

PIE/TSO Dynamic Steplib Administrator Guide. Release 3.2.1

The Web Version of this chapter is split into 4 pages - this is page 2 - page contents are as follows:

IBM. DFSMS Installation Exits. z/os. Version 2 Release 3 SC

CA FAVER VSAM Data Protection

Program Directory for IBM DB2 Administration Tool for z/os V Program Number 5655-DAT FMID H0IHB20. for Use with z/os

IBM. DFSMS Managing Catalogs. z/os. Version 2 Release 3 SC

CA Panvalet. Installation Guide. r14.6. Third Edition

EMC ControlCenter PLANNING AND INSTALLATION GUIDE VOLUME 2 (MVS AGENTS) 6.0 P/N REV A02

RA/2 RACF CLI Version 1 - Release 1

Data Center Management Systems

Successful Practices for Installing and Rolling Out z/os Maintenance User Experience

IBM. IBM Software Manufacturing Solutions. Attached to this memorandum: Summary of Changes. List of Program Material. Installation Instructions.

Rocket Software Strong Authentication Expert

Program Directory for IBM Tivoli Storage Manager for Mail Data Protection for Lotus Domino. Version 5 Release 2. Program Number 5698-A12 FMID HDN5120

IBM DB2 RepliData for z/os. Installation. Version 3 Release1 ISRD-INST-03

Program Directory for IBM System Automation for z/os V Program Number 5698-SA4. FMIDs HWRE410, JWRE41F, JWRE41C, JWRE41I, JWRE411, HKAH35T

IBM z Systems Development and Test Environment Tools User's Guide IBM

CA Top Secret Security for z/os CA RS 1404 Service List

Hitachi Business Continuity Manager

A-LOG. User s Manual. Version 3.8

CA Allocate DASD Space and Placement CA RS 1708 Service List

Stonebranch Solutions

Administrator s Guide. Version 3 Release 2

USING EXISTING DATASETS

Program Directory for IBM Multi-Factor Authentication for z/os V Program Number FMID HMFA130. for Use with z/os V2.

ELS Read Me First

"Charting the Course... z/os Technical Bootcamp Course Summary

EDBC for CA-Datacom/DB

Configuring ISPF for Fun and Profit

CA Common Services CA RS 1706 Service List

CA Vantage Storage Resource Manager CA RS 1807 Service List

Transcription:

E-SRF EKC Security Reporting Facility Release 2.1 Installation Guide E-SRF V2R1 EKC Inc. E0109101-0

E-SRF is a proprietary product developed and maintained by EKC Inc. 10400 West Higgins Road Rosemont, Illinois 60018 USA (847) 296-8010 Technical Support: (847) 296-8035 EKC, Inc. provides only software program products which fully comply with, and maintain MVS integrity. The vendor hereby warrants that: 1) E-SRF ("Software") performs only those functions which are described in the published specifications; 2) there are no methods for gaining access to the Software or other computer resources or data of Licensee (such as a master access key, ID, password, or trap door) other than set forth in the published specifications; 3) the Software does not introduce any MVS integrity exposures. The program code, with the exception of one utility, runs totally in non-authorized, problem state. The one utility, EKCRXCAT, requires APFauthorization to read the MVS System Catalogs. A non-apf authorized utility, EKCRGCAT, is supplied to perform the same function, but at a considerably slower speed. 4) the software shall be year 2000 compliant, and shall function correctly in the next century according to published specifications as long as regular software maintenance is applied. Copyright EKC Inc. USA 1996, 1997, 2003 All Rights Reserved Reproduction of this manual without written permission of EKC Inc. is strictly prohibited. Version 2, Release 1 All product names referenced herein are trademarks of their respective companies. Printed in USA ii Revised May, 2005

TABLE of CONTENTS: E-SRF PUBLICATIONS...IV E-SRF INSTALLATION PROCEDURE... 5 E-SRF INSTALLATION DIAGRAM... 6 E-SRF INSTALLATION STEPS... 7 E-SRF MAINTENANCE INSTALLATION PROCEDURE... 18 E-SRF SECURITY EVENT SYSTEM MASTERFILE SETUP... 20 E-SRF Installation Guide iii

E-SRF Publications Name Installation Guide Contents E-SRF installation including: installation and maintenance steps, startup and shutdown considerations, and backup and recovery procedures. Change Summary Guide Contains all new features and system function changes. General Overview Resource Grouping Facility Guide Access Analysis Reports Guide for ACF2 Access Analysis Reports Guide for RACF Event Reporting User Guide An overview of E-SRF and its components. Brief overview of the Resource Grouping Facility, its relationship to E-SRF, language command syntax, TSO commands and JCL. Brief overview of Access Analysis reports, explanation of the DataOwner and Userid/LogonidOwner reports, command syntax, utilities necessary for creating input to reports, and JCL. A How To guide for users of E-SRF Event Reporting. Event Reporting Facility - Command Reference Explains the Event Reporting Facility command processor, command syntax, and JCL. Event Reporting Facility - Masterfile and Data Dictionary Reference Event Reporting Facility - Messages and Codes Event Reporting Facility - Report Overlays Guide Explains the structure of the E-SRF Masterfile and describes all Masterfile fields. Lists Event Reporting Facility messages and codes. An overview of the report overlays provided with the Event Reporting Facility. iv Revised May, 2005

E-SRF Installation Procedure Each step described below must execute without errors unless otherwise noted. If an error occurs in a step, it is necessary to halt the installation process and resolve the error before continuing. An error in any of the SMP/E procedures may require that the function for E-SRF be rejected and the installation process resumed from the start of the SMP/E steps. This installation may include some of the following function SYSMODs: FMID Description ESA2100 - E-SRF Access Analysis Reporting System for ACF2 (optional). ESC2100 - E-SRF Common Modules. ESE2100 - E-SRF Event Reporting System (optional). ESR2100 - E-SRF Access Analysis Reporting System for RACF (optional). The installation tape has a Volume Serial number of SC2100 and contains the following files: File Data set Name Description 1 SMPMCS SMP/E SMPPTFIN control statements 2 ESC2100.F1 E-SRF Common Module JCLIN and Sample Install Materials 3 ESC2100.F2 E-SRF Common Module program components 4 ESA2100.F1 E-SRF ACF2 Reporting System JCLIN 5 ESA2100.F2 E-SRF ACF2 Reporting System program components 6 ESA2100.F3 E-SRF ACF2 Reporting System Sample Jobs 7 ESE2100.F1 E-SRF Event Recording System JCLIN 8 ESE2100.F2 E-SRF Event Recording System program components 9 ESE2100.F3 E-SRF Event Recording System Sample Jobs 10 ESR2100.F1 E-SRF RACF Recording System JCLIN 11 ESR2100.F2 E-SRF RACF Recording System program components 12 ESR2100.F3 E-SRF RACF Recording System Sample Jobs 13 ESRF.PTFS E-SRF APARs and PTFs (included in the E-SRF FMID) 14 ESRF.OPT.PTFS E-SRF Optional PTFs E-SRF 2.1 - Installation Guide 5

E-SRF Installation Diagram Determine Installation Parms Analyze installation parameters and determine values for the E-SRF libraries, SMP/E ds's, etc. Accept any previous maintenance. (Install Steps 1 and 2) Install Tape Download Installation JCL library from tape. (Install Step 3) Modify Installation JCL Modify JCL for the jobs that will define SMP/E data sets, E-SRF data sets, create an SMP/E proc to be used for the install, RECEIVE, APPLY, and ACCEPT the product elements. (Install Steps 4 through 13) Run Install Jobs Run jobs and check for valid completion. (Also, Install Steps 4 through 13) NO Successful Completion? Correct and rerun if necessary. YES Apply Maintenance APPLY any maintenance supplied with tape. Refer to separate maintenance section for procedures. (Install Step 14) (Maintenance Section Steps 1 through 9) Copy Modules to Run-Time Libraries Copy executable modules to Run-Time Libraries. (Install Step 16) Update System LNKLST (Install Step 17) Update System APF List Update APF-authorized library list. (Install Step 18) Perform E-SRF Setup Perform E-SRF set up according to product requirements. (Install Step 20) Test E-SRF Test the E-SRF products. Refer to the product-specific manuals for assistance. 6 Revised: September, 2001

E-SRF Installation Steps 1 Begin Installation Process The ESRF installation process begins with evaluating the installation parameters and manually entering the values for these parameters on the following pages. You will use these parameters during all subsequent steps of the install. Review the parameters and their defaults; revise them as needed. Beginning with Step 2, you will have to modify the procedures and jobs for all subsequent steps based on the decisions made here. E-SRF Libraries The library names defined during the E-SRF install include 4 load libraries. 1) SMP/E target load library for E-SRF modules to be APF-authorized 2) SMP/E target load library for non-apf E-SRF modules 3) Run-time load library for E-SRF modules to be APF-authorized (optional) 4) Run-time load library for non-apf E-SRF modules (optional) You may not need to allocate all 4 libraries. If your SMP/E target load libraries are used as production run-time libraries you do not need to allocate separate run-time libraries. However, most installations do not run this way. That is why we supply the additional parameters to allocate run-time load libraries. Later in the install, you will be asked to put the names of the load libraries from which you will be executing into the system LNKLST. Therefore, the names selected for these data sets must be cataloged in the Master Catalog. Also, you have the option of allocating a separate APF load library for the E-SRF module, EKCRXCAT. EKCRXCAT must run APF-authorized. This module is used by the E-SRF Access Analysis component to examine the master catalog and create a list of data set names. The UNIT and VOLUME SERIAL information for the system and SMP/E data sets are not required if the data sets are cataloged on the system the installation is to be performed on. All the parameters for the E-SRF data sets must be reviewed including the UNIT and VOLUME SERIAL since these data sets will be allocated during the installation process. E-SRF 2.1 - Installation Guide 7

Parameters for E-SRF Libraries E-SRF Macro and Sample JCL Libraries: PARM DEFAULT YOUR SPECIFICATION DESCRIPTION ESRFDX SYS1. ESRF SMP/E TARGET LIBRARIES HIGH LEVEL INDEX ESRFU SYSDA SMP/E TARGET LIBRARIES UNIT ESRFV XXXXXX SMP/E TARGET LIBRARIES VOL-SER //////////////// /////////////////// /////////////////////////////////////////////////// ////////////////////////////////////////////////////////////////// ESRDDX SYS1. ESRF SMP/E DISTRIBUTION LIBRARIES HIGH LEVEL INDEX ESRDU SYSDA SMP/E DISTRIBUTION LIBRARIES UNIT ESRDV XXXXXX SMP/E DISTRIBUTION LIBRARIES VOL-SER Parameters for E-SRF APF-Authorized Load Library: PARM DEFAULT YOUR SPECIFICATION DESCRIPTION APFL 0 ALLOCATION INDICATOR: 0=Allocate separate target SMP/E APF load library 4=Do not allocate APFLDS SYS1.ESRF. DATA SET NAME: ESRFLAPF APFLDU SYSDA UNIT NAME APFLDV XXXXXX VOL-SER Parameters for E-SRF Non-APF Authorized Load Library: PARM DEFAULT YOUR SPECIFICATION DESCRIPTION ESRLDS SYS1.ESRF. DATA SET NAME: ESRFLOAD ESRLU SYSDA UNIT NAME ESRLV XXXXXX VOL-SER Parameters for E-SRF Module Library: PARM DEFAULT YOUR SPECIFICATION DESCRIPTION ESRMOD SYS1.ESRF. DATA SET NAME: ESRFMOD ESRMLU SYSDA UNIT NAME ESRMLV XXXXXX VOL-SER 8 Revised: September, 2001

Parameters for SMP/E Libraries SMPCSI, SMPPTS, SMPMTS, ETC.: PARM DEFAULT YOUR SPECIFICATION DESCRIPTION SMPIX SYS1. ESRF SMP/E CSI, SMPPTS, etc. DATA SETS HIGH LEVEL INDEX SMPU SYSDA SMP/E DATA SETS UNIT SMPV XXXXXX SMP/E DATA SETS VOL=SER SMPTU SYSDA SMP/E TEMPORARY DATA SETS UNIT SMPTV XXXXXX SMP/E TEMPORARY DATA SETS VOL=SER SMPWU SYSDA SMP/E WORK DATA SETS UNIT Parameters for System Libraries SYS1.YS1.MACLIB, SYS1.MODGEN, SYS1.AMACLIB, ETC. PARM DEFAULT YOUR SPECIFICATION DESCRIPTION SYSC (blank) System data sets cataloged (blank=yes) SYSIDX SYS1 High level index for system data sets SYSU SYSDA UNIT for system data sets SYSV XXXXXX VOL-SER for system data sets SYSVD XXXXXX VOL-SER for system distribution data sets Miscellaneous E-SRF Parameters: PARM DEFAULT YOUR SPECIFICATION DESCRIPTION ESRFLBS 6144 E-SRF load library block size (for all load libraries containing E-SRF modules) SEC 15 E-SRF data set secondary allocation ESRFL (blank) Additional tape label parms required for installations using tape management systems blank = no additional parms, = JCL continuation for additional parms SMS, SMS volume control blank = SMS will assign volume, = installer will assign volume ESRFP TAPE UNIT for the E-SRF installation tape REG 4096 SMP/E region size E-SRF 2.1 - Installation Guide 9

Optional Run-Time Library Parameters: APF AUTHORIZED RUN-TIME LIBRARY PARAMETERS: PARM DEFAULT YOUR SPECIFICATION DESCRIPTION RAC 4 ALLOCATION INDICATOR: 0=Allocate separate run-time APF load library 4=Do not allocate SYSADS SYS1. DATA SET NAME LOADAPF SYSADU SYSDA UNIT NAME SYSADV XXXXXX VOL-SER NON-APF AUTHORIZED RUN-TIME LIBRARY PARAMETERS: PARM DEFAULT YOUR SPECIFICATION DESCRIPTION RLC 4 ALLOCATION INDICATOR: 0=Allocate separate run-time non-apf load library 4=Do not allocate SYSLDS SYS1. DATA SET NAME LOADLIB SYSLDU SYSDA UNIT NAME SYSLDV XXXXXX VOL-SER 10 Revised: September, 2001

2 Accept Prior Maintenance If this release of E-SRF is being installed over a previous release, insure that all maintenance for the prior release has been accepted. Run ESRFLIST in ESRFJOBS to list the E-SRF function and all associated maintenance. Any maintenance that has not been accepted will appear in the listing for the global zone. If there is no maintenance outstanding for E-SRF the listing for the global zone will show a status of NOT FOUND for the SYSMOD. 3 Create Installation JCL Library The ESRFJOBS library contains jobs to install and maintain E-SRF. If you are installing from files loaded from our ftp server, ftp.ekcinc.com you do no need to run this job. If you are installing from tape run the JCL below to load the ESRFJOBS library from the install tape.. Note that this job will delete a previously installed ESRFJOBS library. Modify the PROC Parameters to match the selections made in Step 1. //LOAD JOB (ACCOUNT),'NAME',MSGLEVEL=(1,1) //* //*LOAD RESTORE INSTALLATION JOBS TO DASD FROM TAPE //* //LOAD PROC ESRFDX='SYS1.ESRF', // ESRFL='', // ESRFP=TAPE, // ESRFU=SYSDA, // ESRFV=XXXXXX //DELETE EXEC PGM=IEFBR14 //ESRFJOBS DD DISP=(MOD,DELETE),DSN=&ESRFDX..ESRFJOBS, // UNIT=&ESRFU,SPACE=(TRK,0) //* //LOAD EXEC PGM=IEBCOPY //SYSUT3 DD UNIT=SYSDA,SPACE=(TRK,(15,15)) //SYSUT4 DD UNIT=SYSDA,SPACE=(TRK,(15,15)) //SYSPRINT DD SYSOUT=* //IJOBS DD DISP=OLD,DSN=ESC2100.F1, // LABEL=(2,SL&ESRFL), // UNIT=&ESRFP,VOL=SER=SC2100 //OJOBS DD DISP=(NEW,CATLG),DSN=&ESRFDX..ESRFJOBS, // UNIT=&ESRFU,SPACE=(TRK,(5,15,72)), // VOL=SER=&ESRFV, // DCB=(LRECL=80,BLKSIZE=3120,RECFM=FB) //* // PEND //* //ESRF EXEC LOAD //LOAD.SYSIN DD * COPY INDD=((IJOBS,R)),OUTDD=OJOBS E-SRF 2.1 - Installation Guide 11

4 Allocate SMP/E Data Sets ALLOCSMP in the ESRFJOBS library defines the SMP/E CSI and allocates other SMP/E data sets. This step is OPTIONAL. You may choose to install E-SRF into existing SMP/E CSI and SMP/E data sets instead of allocating new ones. However, if you wish to use a separate SMP/E CSI and SMP/E data sets for the installation and maintenance of E-SRF, the job ALLOCSMP is provided as an example of how to allocate and initialize these data sets. Modify the PROC parameters in the member ALLOCSMP to reflect any changes made to the parameter defaults selected in Step 1. Modify the job card and include any additional JCL required to conform to your installation standards for jobs. Scroll down to the DEFINE CLUSTER statement and modify the name of the SMP/E CSI. Run the job. 5 Edit the ESRFSMPE Procedure ESRFSMPE in the ESRFJOBS library is the SMP/E Procedure used to install E-SRF. Modify the member ESRFSMPE to reflect any changes made to the parameter defaults selected in Step 1. 6 Allocate the E-SRF Data Sets ESRFALC in the ESRFJOBS library allocates various E-SRF distribution, target, and procedure libraries. Modify the PROC parameters in the member ESRFALC to reflect any changes made to the parameter defaults selected in Step 1 ESRFALC will optionally create a separate SMP/E target load library for APF authorized program EKCRXCAT. APF(0) allocate a separate APF authorized target library APF(4) do not allocate a separate library ESRFALC will optionally allocate a separate set of run-time libraries, if you choose not to use the SMP/E target load libraries to run in production. RAC (0) - allocate a run-time APF authorized library RLC (0) - allocate a run-time load library It will be necessary to copy the E-SRF components from the SMP/E target libraries to the run-time libraries at the end of the installation. This is done in a subsequent step. Modify the job card and include any additional JCL required to conform to your installation standards for jobs. Run this job. 12 Revised: September, 2001

7 Copy the E-SRF SMP/E Proc to a Procedure Library COPYSMP in the ESRFJOBS library copies the ESRFSMPE procedure to an active procedure library. Modify the PROC parameters in the member COPYSMP to reflect any changes made to the parameter defaults selected in Step 1. Run the job. 8 Initialize the SMP/E Environment SMPINIT in the ESRFJOBS library executes UCLIN to initialize your SMP/E environment. If you ran Step 4 to define a separate SMP/E CSI and data sets for E-SRF you must run the SMPINIT job. If you are using an existing GLOBAL CSI, it will probably be necessary to modify or even delete some of the UCLIN definitions specified in SMPINIT since this information would already be defined. This job assumes a new GLOBAL CSI has been allocated along with the associated SMP/E data sets, and the initial record from SYS1.MACLIB (GIMZPOOL) has been put in the CSI data set. This job defines the names of the GLOBAL, TARGET, and DISTRIBUTION ZONES, the data sets associated with these ZONES, the REPORT ZONES SETS, and the defaults to be used when installing E-SRF. If you ran step 4 and you modified the SMP/E CSI data set name, then you will need to also change the data set name specified in the UCLIN ZONEINDEX statements. SMP/E requires defining an assembler utility within a target zone, therefore, UCLIN statements are included to do this even though E-SRF will not be assembling source code. IEV90 is assumed to be the name of the assembler. If this is not the name us use, change the appropriate UCLIN statements to reflect the name of the assembler program you have installed. (IE: You may have ASMA90 if you are MVS/ESA V5.) E-SRF 2.1 - Installation Guide 13

9 Define the E-SRF SMP/E Environment SMPDDDEF in the ESRFJOBS library supplies UCLIN to define the E-SRF data sets to SMP/E. Examine the list below and modify the default values in SMPDDDEF to match the requirements of your installation. The values specified here were defined in SMPINIT and are referenced in the jobs ESRFRECV, ESRFAPLY, ESRFACPT, and ESRFLIST. If you modified the default values in SMPINIT you must also modify SMPDDDEF and the aforementioned jobs. Use the SMP/E LIST statement, if necessary, to list your current SMP/E definitions. PARM DEFAULT YOUR SELECTION GLOBALZONE GLOBAL DLIBZONE ESRFDLB TARGETZONE ESRFTGT DLIB ZONESET ESRFDZS TARGET ZONESET ESRFTZS DSPREFIX $SMPIX$.SMPET TARGET ZONEINDEX DS $SMPIX$.CSI DLIB ZONEINDEX DS $SMPIX$.CSI 10 Setup/Run SMP/E Receive ESRFRECV in the ESRFJOBS library receives the E-SRF function modification IDs. Review the comments and remove any FMIDs that do not apply to your resident security system. Modify the boundary for SMP/E RECEIVE to correspond to your selection for the GLOBAL ZONE as specified in Step 9. If you are installing from tape modify the UNIT parameter of the SMPPTFIN DD statement if necessary to specify the correct device type. If you are installing from CD or FTP files then do the following: Change all occurrences of &HLI to your selected high level index for SMP/E DASD relfiles. Modify the SMPPTFIN DD to reference the ESRF210 SMPMCS on DASD (DSN=&HLI.ESRF210.SMPMCS). Modify and uncomment the RFPREFIX SMP/E control statement modify the SMPPTFIN DD statement to DSN=&HLI.ESRF210.SMPMCS.. Modify the job card and include any additional JCL required to conform to your installation standards for jobs and then run this job. 14 Revised: September, 2001

11 12 13 Setup/Run SMP/E Apply ESRFAPLY in the ESRFJOBS library will install the E-SRF functions into the E-SRF SMP/E target libraries. This job will be run twice. SMP/E Apply Check - This job is set up to execute SMP/E apply check. Modify your selection for the target zone as specified in Step 9. Remove any of the SYSMOD FMIDs from the select parameter that were not received during the receive step. Modify the job card and include any additional JCL required to conform to your installation standards for jobs and then run this job. SMP/E Apply - Carefully examine the output from the ESRFAPLY. If you are satisfied with the verification, comment the line containing the CHECK BYPASS (ID) and resubmit the job to perform the SMP/E APPLY. Setup/Run SMP/E Accept Check ESRFACPT in the ESRFJOBS library will install the E-SRF function modifications into the E-SRF SMP/E distribution libraries. This job will be run twice. SMP/E Accept Check - This job is set up to execute SMP/E apply check. Modify your selection for the distribution zone as specified in Step 9. Remove any of the SYSMOD ids from the select parameter that were not received during the receive step. Modify the job card and include any additional JCL required to conform to your installation standards for jobs and then run this job. SMP/E Accept - Carefully examine the output from the ESRFACPT. If you are satisfied with the verification, comment the line containing the CHECK BYPASS (ID) and resubmit the job to perform the SMP/E ACCEPT. Apply Maintenance ESRFMNT in the ESRFJOBS library will install maintenance to the E-SRF function modifications. Refer to the E-SRF Maintenance chapter at the end of the installation steps for detailed instructions. 14 Run SMP/E Report (Optional) ESRFLIST in the ESRFJOBS library will list the E-SRF function modifications. This job is optional. 15 Copy Executable Modules to Run-Time Libraries (Optional) COPYRUN in the ESRFJOBS library will copy the components from the target libraries to the run-time libraries. If your installation will be running the E-SRF facility from the SMP/E target data set, this step may be skipped. Modify the PROC parameters in the COPYRUN JCL to reflect any changes made to the parameter defaults selected in Step 1. Run this job. E-SRF 2.1 - Installation Guide 15

16 Update LNKLST You are able to run E-SRF reports using a //JOBLIB or //STEPLIB DD that contains the data set name of your ESRFLOAD. If you do not wish to do this then you must update the system link list. E-SRF includes sample input to update either LNKLSTxx or PROGxx in SYS1.PARMLIB. LNKLSTxx contains sample input to add the name of the E-SRF executable load library and optional APF authorized library to LNKLSTxx in SYS1.PARMLIB RMLIB. PROGxx contains sample input to add the name of the E-SRF executable load library and optional APF authorized library in PROGxx in SYS1.PARMLIB. The following parameters will be used. ESRLDS and APFLDS (optional APF authorized library) will determine the names of the libraries if you plan to execute E-SRF using SMP/E target libraries. SYSLDS and SYSADS (optional APF authorized library) will determine the names of the libraries if you are using separate run-time libraries. 17 Update APF-Library List APF authorization is required to execute EKCRXCAT. EKCRXCAT obtains a list of data set names by reading the system catalog. As an alternative, EKCRDMSK generates a list of data set names from ACF2 rules and does not require APF authorization. IEAAPFxx contains sample input to add the name of the E-SRF APF authorized library to IEAAPFxx in SYS1.PARMLIB. PROGxx contains sample input to include the name of the E-SRF APF authorized library in PROGxx in SYS1.PARMLIB. The following parameters will be used. ESRLDS or APFLDS (optional separate APF authorized library) will determine the names of the libraries if you plan to execute E-SRF using SMP/E target libraries. SYSLDS or SYSADS (optional separate APF authorized library) will determine the names of the libraries if you are using separate run-time libraries.. 16 Revised: September, 2001

18 Activate LNKLSTxx, IEAAPFxx or PROGxx changes If any changes were made to LNKLSTxx, IEAAPFxx, or PROGxx members of SYS1.PARMLIB, in a static APF environment it will be necessary to IPL the system for these changes to take effect. If changes were only made to the PROGxx member and your system specifies APF FORMAT (DYNAMIC), these changes may be implemented by issuing the MVS command: SET PROG=xx Or, SETPROG APF,ADD,DSNAME=library name,{sms VOLUME=vol-ser} ** CONGRATULATIONS, You have just installed E-SRF! ** E-SRF 2.1 - Installation Guide 17

E-SRF Maintenance Installation Procedure ESRFMNT in the ESRFJOBS library will install maintenance to the E-SRF function modifications. Separate job steps execute SMP/E at each phase of the maintenance process. Each step is set to be bypassed or executed depending upon the COND parameter coded on the EXEC statement. COND=(0,EQ,DUMMY) COND=(0,NE,DUMMY) the step will be bypassed. the step will be executed. 1 Prepare ESRFMNT Job Modify the job statement and insert any additional JCL required to conform with your installation standards for jobs. If you have changed the E-SRF SMP/E zone names to something other than the defaults, you must modify the SMP/E SET control statement in each of the steps. For additional information, refer to Step 9 of the installation procedures in the E-SRF Installation Guide. The default zone names are GLOBAL, ESRFTGT and ESRFDLB. Modify the SMPPTFIN DD statement to point the ESRFPTFS data set. additional DASD or tape information that you require. 2 Receive E-SRF Maintenance Add any Modify the COND parameter of the RECEIVE step to COND=(0,NE,DUMMY) to execute the RECEIVE step. Run the ESRFMNT job to receive all the maintenance from the installation tape. Expect a return code of 12 when this step is run for the first time. The return code of 12 is due to the fact that the E-SRF maintenance sysmods are not defined to SMP/E when the REJECT statement is performed for the first time. If for any reason it is necessary to rerun this step, you can expect a return code of 4. Restore the COND parameter in this step to its original setting COND=(0,EQ,DUMMY). 3 SMP/E Apply Check of E-SRF Maintenance Modify the COND parameter of the APPLYCHK step to COND=(0,NE,DUMMY) to execute this step. Run the ESRFMNT job to test the apply of the E-SRF maintenance. Restore the COND parameter in this step to its original setting COND=(0,EQ,DUMMY). 4 SMP/E Apply E-SRF Maintenance Modify the COND parameter of the APPLY step to COND=(0,NE,DUMMY) to execute this step. Run the ESRFMNT job to apply the E-SRF maintenance. Expect a return code of 4 from this step due to the LIST command not finding any DLIB entries for the maintenance. 18 Revised: September, 2001

Restore the COND parameter in this step to its original setting COND=(0,EQ,DUMMY). 5 SMP/E Accept Check of E-SRF Maintenance Modify the COND parameter of the ACCEPTCK step to COND=(0,NE,DUMMY) to execute this step. Run the ESRFMNT job to test the SMP/E accepts of the E-SRF maintenance. Restore the COND parameter in this step to its original setting of COND=(0,EQ,DUMMY) if necessary. 6 SMP/E Accept E-SRF Maintenance Restore the COND parameter of the ACCEPTCK step to its original setting of COND=(0,EQ, DUMMY) if necessary. Modify the COND parameter of the ACCEPT step to COND=(0,NE, DUMMY) to execute this step. Run the ESRFMNT job to accept the E-SRF maintenance. Expect a return code of 4 from this step due to unresolved references in some module link edited into the distribution libraries. Restore the COND parameter in this step to its original setting COND=(0,EQ,DUMMY). 7 Repeat Maintenance If any maintenance was not applied due to conflicts identified by SMP/E and repeat steps 2 through 6 as many times as necessary to apply all the maintenance. 8 Copy Executable Modules to Run-Time Libraries (Optional) COPYRUN in the ESRFJOBS library will copy the components from the target libraries to the run-time libraries. If your installation is executing the E-SRF facility from the SMP/E target libraries this step may be skipped. 9 Update the System If you have made changes to the installation libraries that already exist in the LNKLST, then it will be necessary to refresh the link list look aside to make the maintenance available to the users. From the operator s console issue the command: F LLA, REFRESH ** You have now completed applying the maintenance to E-SRF.** E-SRF 2.1 - Installation Guide 19

E-SRF Security Event System Masterfile Setup The E-SRF Masterfile is used to store Security Event data (security loggings) and is only required if you are working with the ESRF Event Reporting Facility. Access Analysis does not require the Masterfile. Normally, the E-SRF Event Reporting Masterfile VSAM cluster is established and provisioned on your system in the same manner as any other application VSAM cluster. Disk space must be located, a VSAM cluster must be defined. Several jobs must be run to make the cluster useful for Event Reporting. The entire procedure is detailed in Chapter four of the E-SRF Users Guide. The necessary Job Control and other related commands are provided in the sample library you just installed. If part of the installation is to provide this cluster, you may want to review Chapter four after your installation has been completed and before you attempt to run E-SRF Event Reporting. Access Analysis may require some VSAM clusters for it s processing. These requirements are outlined in the E-SRF Access Analysis documentation. 20 Revised: September, 2001