Installing

You can install the BMC AMI Defender TCP/IP Receiver on one or more LPARs. The CZATRECV.LOAD library must be an authorized program facility (APF)-authorized library.

Accepting the End User License Agreement (EULA)

You must accept the End User License Agreement (EULA):

1. Open the EULA that is included in the component files (EULA.pdf or EULA.txt).
2. Read the EULA and accept the terms.
   This acceptance is legally binding. If acting on behalf of an entity, ensure that you have the authority to accept the terms of the EULA for that entity.

Performing the BMC AMI Defender TCP/IP Receiver installation

The BMC AMI Defender TCP/IP Receiver installation is a typical non-SMP/E software installation. The installation steps assume that you use TSO and ISPF.

Before you begin

Obtain the zip installation package, BMC-AMI-Defender-TCPIP-Receiver-versionNumber.zip, from BMC or as directed by BMC Support.

To install BMC AMI Defender TCP/IP Receiver

1. Extract the components of the zip installation package, BMC-AMI-Defender-TCPIP-Receiver-versionNumber.zip, to a folder of your choice.
   The zip file contains an IBM XMIT file that you must upload to your mainframe using the binary option of your file transfer option.
2. Sign on to the mainframe LPAR on which you will install the receiver.

3. Allocate a sequential data set with a fixed-blocked record format, a record length of 80, and any legal block size (an even multiple of 80 no more than 32720).

   Name the data set userid.CZATRECV.XMIT, where userid is your TSO user ID. This is a temporary file that you can delete after the installation process.

4. Using the following job, receive &hlq&.CZATRECV.XMIT:
   

   //jobname JOB ,'CZATRECV Install',
   // MSGCLASS=H,NOTIFY=&SYSUID,CLASS=A,REGION=0M
   //RECEIVE EXEC PGM=IKJEFT01,DYNAMNBR=10
   //SYSPRINT DD SYSOUT=*
   //SYSTSPRT DD SYSOUT=*    
   //SYSTSIN DD *            
   RECEIVE INDSNAME(&hlq&.CZATRECV.XMIT) DATASET(&hlq&.CZATRECV.INSTLIB)
   /*

5. Run the installation job to complete the receiver side of the installation process.

   &hlq&.czatrecv.instlib(INSTALL)’
   //&jobname JOB  (CZATRECV),'CZATRECV xxxxx',CLASS=A,MSGCLASS=X,
   //             MSGLEVEL=(1,1),NOTIFY=&SYSUID                               
   //*  You must edit the JOB statement above to conform to your
   //* standards    
   //*  You must change &hlq& to your desired high level qualifier           
   //*  You must change userid above to your TSO userid                       
   //*                                                                         
   //*  !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!    
   //*  ! You must exit from ISPF edit before this job will run          !    
   //*  !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!    
   //*                                                                        
   //RECEIVE  EXEC PGM=IKJEFT01,DYNAMNBR=10                                   
   //SYSPRINT DD   SYSOUT=*                                                   
   //SYSTSPRT DD   SYSOUT=*                                                   
   //SYSTSIN  DD   *                                                          
    RECEIVE INDSNAME('&hlq&.CZATRECV.INSTLIB(CNTL)')                           
    DATASET('&hlq&.CZATRECV.CNTL')                                             
    RECEIVE INDSNAME('&hlq&.CZATRECV.INSTLIB(LOAD)')                           
    DATASET('&hlq&.CZATRECV.LOAD')
   //             

Starting the receiver after installation

In &hlq&.CZATRECV.CNTL, use one of the following JCL samples to start the receiver:

• This sample JCL starts a task:

  CZATRECV.CNTL(CZATRECV)

• This sample JCL is for a batch job:

  CZATRECV.CNTL(JOB) 

The CZATSERV program picks up the default CZATPARM member from the CZATRECV.CNTL data set, which is specified as part of the CZATPARM DD statement. To use a member other than the default CZATPARM member, specify that member name in the PARM= parameter.