README for ELECTRONIC SERVICE AGENT FOR IBM zSeries and IBM S/390 Version 1.2.0

IBM Corporation, August 2002

Table of Contents:

-- Description
-- Documentation
-- Installation and configuration tips 


________________________________________________________________________
________________________________________________________________________

Description:

Electronic Service Agent for IBM zSeries and IBM S/390 is a program product owned by
International Business Machines Corporation or one of its subsidiaries (IBM), and is copyrighted
and licensed, not sold.  The Service Agent is a no-charge, orderable, installable program product 
that runs on the z/OS and OS/390 operating system and uses the Hardware Management Console.


The Electronic Service Agent for zSeries and S/390, combined with network centric
architecture provides information to IBM service and support personnel that results
in improved service delivery to the customer. When enabled, this code collects 
selected data and transmits it to IBM periodically.

Service Agent may be enabled to collect information from the zSeries and 
S/390 environment, including:
 
- Selected I/O hardware failures
- I/O statistical data
- System configuration data
- Installed IBM OS/390 software information
- Installed service for IBM OS/390 software
- OS/390 workload and utilization measurements 

The collected information can then be used to provide improved customer support and 
tailored service offerings.
________________________________________________________________________
________________________________________________________________________


Documentation:

The latest Users Guide in PDF format is available as sa390ugv1r2.pdf at 
ftp://ftp.software.ibm.com/s390/serviceagent/sa390ugv1r2.pdf.

The latest Electronic Service Agent Messages Manual in PDF format is
available as sa390messagesv1r2.pdf at ftp://ftp.software.ibm.com/s390/serviceagent/sa390messagesv1r2.pdf.

The latest Users Guide in BookManager READ format is available as sa390ugv1r2.boo at 
ftp://ftp.software.ibm.com/s390/serviceagent/sa390ugv1r2.boo.

The latest Electronic Service Agent Messages Manual in BookManager READ format is
available as sa390messagesv1r2.boo at ftp://ftp.software.ibm.com/s390/serviceagent/sa390messagesv1r2.boo.


UPLOADING BOOKMANAGER FILES TO THE HOST USING Personal Communications FILE TRANSFER:

Receive Bookmanager files and BKUPLOAD.BAT to your PC. From a DOS window enter the following command:

      BKUPLOAD.BAT <session-id>

where <session_id> is the ID of your Personal Communications HOST session


UPLOADING BOOKMANAGER FILE TO THE HOST USING FTP: 

1. Copy FTPLOAD.REX REXX exec and FTPLOAD.JCL to your host.
 
2. Submit FTPLOAD.JCL to upload bookmanager files to your host session, or run FTPLOAD.EXEC from your TSO session. 




_________________________________________________________________________
_________________________________________________________________________


Installation and configuration tips

The personel responsible for installing and configuring Service Agent should be familiar 
with or have a working  knowledge of zSeries and System/390 architecture, MVS system commands,  
the installation’s SMP/E CSI (Consolidated Software Inventory) structure, the UNIX System
Services environment and local RMF data gathering procedures. RACF SYSTEM authority or equivalent
will be needed to perform certain parts of the installation. The following list summarizes the steps 
necessary to install, configure and activate the Service Agent. More detailed 
information can be found in the User Guide starting in the section titled "Prerequisites": 

-  Use the IEBCOPY utility to copy sample Service Agent installation jobs from the distribution tape   
-  Allocate SMP/E target and distribution libraries 
-  Perform an SMP/E Receive, Apply and Accept
-  Create HFS paths in the UNIX System Services environment 
-  Create SMP/E DDDEF entries 
-  Enable the Hardware Management Console for Service Agent use  
-  Allocate data sets required for Service Agent by modifying and running the sample HESALOC2 job 
   provided on the distribution tape
-  APF authorize the Service Agent load library dataset  
-  Mark Java HFS files as APF authorized
-  Authorize Service Agent programs by modifying the IKJTSOxx member in SYS1.PARMLIB  
-  Create started task IDs and started task entries in the STARTED RACF class for Service Agent tasks 
-  Verify/update Java environment variables 
-  Verify/update Java time zone variable 
-  Update and add Service Agent procedures to SYS1.PROCLIB 
-  Configure Service Agent by entering environment information such as customer information, CSI information,
   SMS parameters or VOLSER information, data collection schedule, performance data shift definitions, 
   Hardware Management Console IP address and Hardware Management Console FTP password 
-  Add a step in the EREP JCL job to run and capture Service Agent data
-  Configure SYS1.PARMLIB members ERBRMF00 and SMFPRM00 for accurate collection of RMF and SMF data 
-  Configure SMF dump procedures for Service Agent data collection 
-  Verify/update parameters in a dataset for hardware data collection 

________________________________________________________________________
________________________________________________________________________