Electronic installation for libraries


Installation Step 1

With the electronic installation, instructions are sent in an e-mail for installing the libraries. The e-mail installation instructions supersede these example instructions and should be used if any differences are noted.

The order acknowledgment e-mail looks similar to:

From: Order@compuware.com
To: customer@company.com
Subject: *** Mainframe Evolution Delivered. Compuware Order # 1234567 Client # 123456 ***

Hello Customer Name,There's nothing we love more than helping our customers get the most out of their mainframe investments and assets. We hope you'll appreciate the innovative solutions our products provide as much as we appreciate your business. Here's to taking the next step in your mainframe modernization journey.Your Compuware order is now available and will remain accessible for three weeks.
Please follow the instructions below to download your order. Take a look and let us know if you have any questions or feedback. We'd love to hear from you.This order is for FDR Product Group including the following options:FDRPASCustomer Order Number.:1234567Customer Number..........:123456Company Name.............:Company NameCustomer Contact..........:Customer NameProduct Version.............:05.04.91Expiration Date.............:yyyy.dddIDPREC Password..........:1234567890ABCDEFImplementation Instructions
Your products will be delivered in a Self-extracting Installer. Use the FDRPAS.BIN link to HTTPS download our Self-extracting Installer in XMIT format to your workstation, and then upload the file to your mainframe. Use the mainframe file characteristics identified on the 'locsite' statement in the attached file 'INSJCL.TXT'. Note that you will also need to execute the TSO RECEIVE step once the file is on the mainframe.
Sample JCL 'INSJCL.TXT' to FTP the Self-extracting Installer to your Mainframe and perform a TSO RECEIVE. The Installer is customized for this product order.Support Resources
If you have any questions concerning your order, please contact License Management at 800-538-7822 or by email at lmnotifications@Compuware.comIf you are located outside of North America, please contact your local Compuware office.
Visit the Support Center for additional support. We look forward to continuing our partnership and helping you maximize the value of your mainframe assets.
Sincerely,

This e-mail contains the product(s) and version(s) that are included in the install package, the expiration date (if the product has an expiration date), and a unique IDPREC password that is required for the install process.

Installation Step 2

Follow the instructions as directed in the INSJCL.TXT file included in the acknowledgment e-mail to retrieve the product package from the BMC Compuware FTP site.

(Step “B” of the INSJCL.TXT file)

Expanding the product distribution file on your z/OS host is a two-step process. Login to your z/OS host and enter a TSO READY session (outside of ISPF). This TSO session must have access to an ISPF environment because the z/OS install process expects to employ ISPF panels to complete the installation. The steps described below assume TSO PROFILE NOPREFIX is NOT used.


If your site uses PDSFAST in place of IEBCOPY, ensure that you disable PDSFAST prior to this step so that you do not get a FASTCOPY error from PDSFAST. PDSFAST can be disabled by issuing the TSO ALLOC command:

TSO ALLOC FILE(NPDSFAST) DUMMY


  1. Enter:
    RECEIVE INDATASET(PAS.BIN)

    Where the INDATASET(…) value is the name that you created during the file transfer to z/OS.

    This creates a partitioned data set containing two load modules. After the RECEIVE is completed, the name of the PDS is “userid.IDPREC.LOAD”. If you want a different name, then at the prompt:

    Data set FDRSYS.IDPREC.LOAD from FDRCFG on JESCPUA

    Enter restore parameters or 'DELETE' or 'END' +

    enter:

    DSN(desired.name)

    or take the default by pressing Enter.

  2. Enter:
    Enter:

CALL 'userid.IDPREC.LOAD(IDPREC)'

or, if you gave the PDS a different name:

CALL 'dsn(IDPREC)'

A welcome message is displayed. Enter appropriate responses to data set name and SYSOUT class prompts.

You are also prompted to enter the 16-digit IDPREC PASSWORD supplied in the Order Acknowledgment (first) e-mail.

Follow the instructions on the ISPF panel to complete the installation of the distribution files.

Installation Step 3: Data Set Name Selection

This screen allows you to specify the data set names that are used for the data sets you are loading from the installation package. These may be existing data sets to be updated, or they may be new data sets that are allocated and cataloged (new data sets are recommended). Do not install FDRPAS, FDRMOVE, and/or FDRERASE into existing libraries containing other FDR products, since they may share common modules

IDP Product Install (Screen1)

-------------------------- IDP Product Install (Screen1) ------------------Command ===>Press Enter to accept changes
Press End to continue install
Enter Can to quit
Product ==> PAS Version ==> 05.04/91
Input DSN (from FTP site) ==> IDP.PAS.SHIPPDS
Output DSN:High Level Qualifier ==> IDP
2nd Level Qualifier ==> PAS5491
Low Level Qualifiers: ('X ' Will Bypass File Processing)CLIST ==> CLIST SKELETON ==> SKELETON
LOADLIB ==> LOAD TABLES ==> NOT.SHIPPED
MESSAGES ==> MESSAGES ICL ==> ICL
PANELS ==> PANELS JCL ==> JCL
STORCLAS ==> MGMTCLAS ==>VOLUME ==> UNIT ==>Resulting Data Set NamesCLIST ==> IDP.PAS5491.CLIST
LOADLIB ==> IDP.PAS5491.LOAD
MESSAGES ==> IDP.PAS5491.MESSAGES
PANELS ==> IDP.PAS5491.PANELS
SKELETON ==> IDP.PAS5491.SKELETON
TABLES ==> ------------------------ICL ==> IDP.PAS5491.ICL
JCL ==> IDP.PAS5491.JCL

The load library must be an APF authorized library. If necessary, you can authorize it after the installation by using the SETPROG console command (see the IBM z/OS MVS System Commands (SA22-7627) manual for details).

The names shown above are the default names provided by the IDPREC installation program (when the default user of IDP being used). You may change these names in one of two ways:

  1. 101_ListNumber_999878  1. To change the High or 2nd Level qualifiers for all data sets, change the values in the corresponding field for the Output DSN section.
  2. 101_ListNumber_999826  2. To change an individual Low Level qualifier, change desired Low Level Qualifier for the data set(s) that you want to change.

The resulting data set names that are used are displayed at the bottom area of the panel.

You can also specify the SMS attributes (if they are to be SMS-managed) or VOLUME/UNIT information on this panel to allocate these data sets when creating them as NEW.

Electronic Installation Screen2 – IDP Product Installation

This screen documents the process that is used to create the product libraries. When you press Enter to continue, it shows you the status of each of the data sets being created. A completion message is displayed once all the product libraries have been created.

IDP Product Install (Screen2)

-------------------------- IDP Product Install (Screen2) ------------------Command ===>Press Enter to continue
Enter Can/Cancel to quit
The TSO RECEIVE command will be invoked to create each fileselected from the previous menu. Before each file is created
by using TSO RECEIVE the target data set will be deleted.
The install will display messages below indicating installprogress and results. If a file RECEIVE fails the user is giventhe option to continue or quit. The user can view RECEIVE outputby looking at the RECEIVE sysout allocation under their TSO usersession. If any dialog file fails to RECEIVE it is suggested thatthe user NOT continue to the next screen.
The next step will change member ABRALLOC in the Clist library
that is used to allocate libraries and invoke the product dialog.

Installation Step 4: Installation Data Sets Have Been Received

This screen documents that all the product libraries have been created and received and goes to the Primary Options Menu to continue the installation process and customize the product. You can exit the menu at this time as all the necessary libraries have been loaded.

IDP Product Install (Screen3)

-------------------------- IDP Product Install (Screen3) ------------------Command ===>Press Enter to continue
Enter Can/Cancel to quit
The PAS installation data sets have been received.
If you would like to display the FDR PRIMARY OPTIONS MENUand continue with the Installation process, press ENTER;
otherwise press CANCEL.

Proceed to Invoking the Installation ISPF Dialog (Panel A.I) to complete the installation.


 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*