Chapter 2: Loading APS from the Installation CD

Before you can install APS for z/OS, you must upload the installation files from the CD to the mainframe using FTP.

Pre-loading Checklist

Before you load APS from the installation CD, make a record of the information you need to supply during the process. We recommend you print this document so you can record the information in the following tables.

You should also obtain your site license now. Send an e-mail using the following format:

To:      URK@microfocus.com
Subject: APS license request s/n ________
Text:    Your Company Name
         Your Company's Address
         Your Name
         Your Telephone Number
         (optional) Original ordering company name, if known

We will send you a return e-mail with two license files attached. Save these two attached license files to a work directory on your PC, and record the location in the table below.

APS Product Prefix

Identify your APS Product Prefix. The first two nodes of your data sets are referred to symbolically as:

apshlq
Its value should be the owner name, such as, the RACF group that uses APS.
apsmlq
Its value should identify the APS release you use, such as, APS5000 (Release 5.0)

A sample value is SYS1.APS5000; it would prefix all APS libraries.

User Demo Project (Optional)

A Demo project is shipped on the CD. Installing this demo is optional for existing customers. If you are a new APS customer or if you are installing APS on a new CPU without migrating your existing project, you should plan to install the demo project.

Identify your APS demo project prefix. The first two nodes of your datasets are referenced symbolically as:

dmohlq
Its value should be the owner name, such as, the RACF group for an APS Project. This can be the same value as apshlq.
dmomlq
Its value should identify the APS group name for the demo project, such as DEMO5000.

We recommend that dmomlq be set to a unique value and not be set to the value of apsmlq. A sample value is SYS1.DEMO5000; it would prefix all demo project libraries like APSPROG or APSSCRN.

Other Information

Use the following table to record the information you need to complete the upload. This information is referenced, in the JCL and instructions below, using the lower case label that appears here italicized and within parentheses. We recommend that the Mid Level Qualifier (apsmlq) be set to the version number APS5000.

Serial Number (s/n) Note: Your serial number is on the red card shipped inside the APS for z/OS CD case.
Mainframe TCP/IP HOST name (yourmainframe)
High Level Qualifier for mainframe data set names (apshlq)
Mid Level Qualifier for mainframe data set names (apsmlq)
High Level Qualifier for mainframe demo data set names (dmohlq)
Mid Level Qualifier for mainframe demo data set names (dmomlq)
Data set VOLSER (dser)
Data set Unit (dunit)
Existing JCL Data set name (jcldatasetname)
Drive on your PC where you have inserted the APS for z/OS CD (drive)
Directory on your PC where you have stored the two license files.

Perform the Upload

Follow the steps below to upload APS for z/OS from the installation CD to your mainframe.

Refer to Table 2-2 for site-specific information as you complete this procedure.

Allocate the data sets required for the installation, as follows:
1. Using the following FTP commands, transfer the text format APSALLOC.JCL to an existing JCL data set as jcldatasetname(APSALLOC). See Sample APSALLOC.JCL Text Format.
```
ftp yourmainframe
```
  Enter your user ID and password when prompted.
```
put  drive:\apszos\apsalloc.jcl   'jcldatasetname(apsalloc)'
```
2. Edit the APSALLOC member setting APSHLQ=apshlq, APSMLQ=apsmlq, DUNIT=dunit, and DVOLSER=dser. Refer to the note in the JCL regarding data set size calculations.
3. Change the JOB card, make any other required changes to the JCL, then submit APSALLOC.
  The JCL allocates all the data sets required to continue the installation. Ensure that RC=0. If not RC=0, make the necessary corrections and rerun the JCL. Do not continue until all data sets are successfully allocated.
Populate the 16 apshlq.apsmlq.F* data sets, by entering the following FTP commands, one after the other at a command prompt on the PC.
```
ftp yourmainframe
```
Enter your user ID and password when prompted. The prompt changes from a command prompt to an FTP prompt.
```
cd 'apshlq.apsmlq'
binary
prompt
mput drive:\apsz0S\f*
```
Ensure successful completion, then end the FTP session:
```
quit
```
Edit and submit the JCL that will be used to populate the product data sets.
1. Edit the apshlq.apsmlq.F0 JCL data set making the following changes.
  //* CHANGE ALL &SOUT to SYSOUT class
  //* CHANGE ALL &APSHLQ to apshlq
  //* CHANGE ALL &APSMLQ to apsmlq
2. Change the JOB card, make any other required changes to the JCL, then submit apshlq.apsmlq.F0
Do not continue until all data sets are successfully received.
(Optional) If you are installing the demo project, using FTP, transfer the text format DMOALLOC.JCL to an existing JCL data set as jcldatasetname(DMOALLOC). The Demo project.group is used to install the getting started source code and applications. These sample programs should already be in your existing project.group data sets so installing them again is optional.
1. Start a new FTP session or insure that you are prepared to transfer a non-binary TEXT data set.
```
ftp yourmainframe
```
  Enter your user ID and password when prompted.
```
put drive:\apszos\demo\dmoalloc.jcl 'jcldatasetname(dmoalloc)'
```
2. Edit the DMOALLOC member setting DMOHLQ=dmohlq, DMOMLQ=dmomlq, DUNIT=dunit, and DVOLSER=dser. We recommend that dmomlq be set to a unique value and not set to the save value as apsmlq.
3. Change the JOB card, make any other required changes to the JCL, then submit DMOALLOC.
The JCL allocates the data sets required for the installation of the demo project. Do not continue until all data sets are successfully allocated.
(Optional) If you are installing the demo project, populate the 19 dmohlq.dmomlq.DEM* data sets by entering the following FTP commands. We assume that your FTP session is still active from the previous step.
```
cd 'dmohlq.dmomlq'
binary
prompt
mput drive:\apszos\demo\dem*
```
Ensure successful completion, then end the FTP session:
```
quit
```
(Optional) If you are installing the demo project, edit and submit the JCL that will be used to populate the DEMO data sets.
1. Edit the dmohlq.dmomlq.dem0 JCL data set making the following changes. Note that dem0 contains a numeric zero.
  //* CHANGE ALL &SOUT to SYSOUT class
  //* CHANGE ALL &DMOHLQ to dmohlq
  //* CHANGE ALL &DMOMLQ to dmomlq
2. Change the JOB card, make any other required changes to the JCL, then submit dmohlq.dmomlq.dem0.
Do not continue until all data sets are successfully received.
Transfer the license information to the mainframe as follows:
1. Go to the PC directory where you saved the two license files.
2. Start FTP at a command prompt as follows:
```
ftp yourmainframe
```
  When prompted, enter your mainframe user ID and password.
3. Set qualifiers for the mainframe CLIST data set, set the file transfer type to binary, and transfer the aps@opt file to the apshlq.apsmlq.clist PDS at the FTP prompt by entering the following commands:
```
cd 'apshlq.apsmlq.clist' 
binary
put aps@opt
```
4. Set qualifiers for the mainframe CNTL data set, set the file transfer type to binary, and transfer the site ID file to the apshlq.apsmlq.cntl PDS at the FTP prompt by entering the following commands:
```
cd 'apshlq.apsmlq.cntl'
binary
put s/n
```
5. End the FTP connection by entering quit at the FTP prompt.

The transfer of APS for z/OS files from the CD is complete. To install APS for z/OS, see the chapter Installing APS for z/OS on the Mainframe.

Note: After installation is complete the intermediate (F*) data sets can be deleted once you have successfully invoked APS for z/OS.

Sample APSALLOC.JCL Text Format

//APSALLOC JOB (APS),'ALLOCATE DATASETS',CLASS=A,MSGCLASS=A             
//*                                                                     
//*------------------------------------------------------------------*  
//*                                                                  *  
//* APS for z/OS Data Set Allocation                                 *  
//*                                                                  *  
//* This is the first job to run for APS z/OS installation.          *  
//* This job will allocate intermediate product data sets and final  *  
//* product libraries. Intermediate data sets are used as the target *  
//* of an ftp command to receive product libraries that are stored   *  
//* in unloaded format on the product CD-ROM.  When the              *  
//* unloaded libraries have been tranferred into the intermediate    *  
//* data sets a job is submitted to restore members from the         *  
//* unloaded libraries into the final product libraries.             *  
//*                                                                  *  
//* Customize the following symbolic parameters to fit your          *  
//* environment:                                                     *  
//*  SOUT   = SYSOUT clase for job print output.                     *  
//*  APSHLQ = 1st-level qualifier for data sets that are allocated.  *  
//*  APSMLQ = 2nd-level qualifier for data sets that are allocated.  *  
//*  DVOLSER= Volume serial number where data sets will be allocated.*  
//*  DUNIT  = DASD unit type of the volume specified by DVOLSER.     *  
//*                                                                  *  
//*  NOTE: The space parameter in the allocations is appropriate for *  
//*  for 3380 or 3390 devices.  You may need to change these values  *  
//*  if you are installing on another device type.                   *  
//*                                                                  *  
//*------------------------------------------------------------------*  
//*                                                                     
//APSALLOC PROC SOUT='*',      <== SYSOUT class                         
//         APSHLQ=APS,         <== 1st-level data set name qualifier     
//         APSMLQ=APS5000,     <== 2nd-level data set name qualifier     
//         DUNIT=3390,         <== DASD unit type                       
//         DVOLSER=APS001      <== DASD volume serial number            
//*                                                                     
//ALLOCTMP EXEC PGM=IEFBR14
//SYSPRINT DD SYSOUT=&SOUT;//*
//REXX     DD  DISP=(,CATLG),DSN=&APSHLQ..&APSMLQ..F0,
//         UNIT=&DUNIT,VOL=SER=&DVOLSER,SPACE=(TRK,(1,1),RLSE),
//         DCB=(DSORG=PS,RECFM=FB,LRECL=80,BLKSIZE=3120)
//*
//APSMACS  DD  DISP=(,CATLG),DSN=&APSHLQ..&APSMLQ..F1,
//         UNIT=&DUNIT,VOL=SER=&DVOLSER,SPACE=(3120,(3200,320)),
//         DCB=(DSORG=PS,RECFM=FB,LRECL=80,BLKSIZE=3120)
//*

etc.