Installing the latest CoolSpools PLUS Exit

CoolSpools PLUS has now been superseded by CoolSxpools V6

The procedure described here relates to the earlier CoolSpools PLUS and describes how to apply a PTF (fix pack) for CoolSpools PLUS.

Installing a PTF for CoolSpools PLUS

Precautions

Before you start, it is strongly recommended that you:

Make sure you have the latest PTF exit programs for CoolSpools PLUS:
1. Do:
```
DSPPGM COOLSPV5R1/CP_PTFEXTR
```
2. If the Program creation date/time is 2008-10-08 or later, you already have the latest PTF exit programs and can skip to (b) below.
3. If the Program creation date/time is prior to 2008-10-08 , you should install the latest versions of the CoolSpools PLUS PTF exit programs.
Do a SAVLIB of library COOLSPV5R1 to a save file or other media.
Do a SAVLICPGM of licensed program 5COOLSP to another save file or other media.
Run the SAVREGFNC command to save your registered functions into a stream file. We suggest you call the stream file Q5CPnnnn.FNC, where nnnn is the PTF ID.
Review the cover letter which is included in the PTF zip file and consider if any of the changes included in the PTF have implications for your system.
Ensure that CoolSpools PLUS is not in use by checking for locks on product library COOLSPV5R1:
```
WRKOBJLCK COOLSPV5R1 *LIB
```
If you are running replication software (MIMIX, Data Mirror etc.) and that software replicates objects in the COOLSPV51 library, suspend replication for the duration of this procedure.

Installing a PTF for CoolSpools PLUS

This method uses FTP (File Transfer Protocol) to transfer the PTF file from your PC to your system i. It is assumed that you have stored the zip file which your downloaded from the Internet on your PC and that you have enabled an FTP link between your PC and your system i.

Commands to be run on the system i are shown in

blue

and those to be run on the PC in

green

On your PC, create a directory for the PTF installation, e.g.:
```
md c:\COOLSP
```
Save or copy the zip file that you downloaded or received into this directory.
On your PC, unzip the contents of the zip file into the directory you just created using pkunzip, WinZip, Norton UnZip etc.
On your system i, first sign off then sign back on again to ensure that you do to have any CoolSpools objects in your QTEMP library. Then decide which library you wish to use for the PTF install procedure and create a save file in that library. The name of this save file should be Q5CPnnnn, where nnnn is the PTF id, e.g.
```
crtsavf lib_name/Q5CP0001
```
where:
```
lib_name
```
is the name of the library you chose to use.
On your PC, start an FTP session to your system i. You may use FTP packages such as CuteFTP or simply go to the DOS prompt and type:
```
ftp system_i_name
```
where:
```
system_i_name
```
is the name of your system i.

You will be prompted to enter your user id and password. Please ensure that you sign on with a user id that has adequate authority. We recommend that you sign on as the Security Officer QSECOFR.

Issue the following FTP commands within the FTP session:
```
binary
```
This command instructs FTP not to carry out any conversion on the data to be sent to the system i.
```
quote site na 0
```
This makes sure the system i is using naming format 0 (library naming). This is important if your FTP attributes (CHGFTPA command NAMEFMT parameter) have the initial naming format set to *PATH (IFS path naming) rather than *LIB (library/file.member naming).
```
cd lib_name
```
where:
```
lib_name
```
is the name of the library in which your created the save file in Step 3. This command makes lib_name your current library on the system i.
```
lcd dir_name
```
where:
```
dir_name
```
is the name of the directory on your PC in which you unzipped the install files earlier. This command makes dir_name your current directory on the PC.
```
put Q5CPnnnn.sav Q5CPnnnn
```
This command transmits the contents of the file Q5CP0001.sav, which was earlier unzipped from 5CP0001.zip, and stores them in the save file called Q5CPnnnn which you created earlier on your system i.
On your system i, ensure that the previous step worked by displaying the contents of save file Q5CPnnnn:
```
dspsavf lib_name/Q5CPnnnn
```
If you see the message (No records in save file) then something has gone wrong during the preceding steps. Try following them again. If you still cannot get this procedure to work, contact ariadne support.
On your system i, issue the following command to load the PTF on to your system:
```
lodptf licpgm(5COOLSP)
       dev(*savf)
       select(5CPnnnn)
       savf(lib_name/Q5CPnnnn)
```
where:
```
lib_name
```
is the name of the library in which your created the save file in Step 3 and nnnn is the PTF ID.
On your system i, issue the following command to apply the PTF to your system:
```
apyptf licpgm(5COOLSP)
       select(5CPnnnn)
       apy(*temp)
```
where: nnnn is the PTF ID.

If you have any trouble at any point in this procedure, please contact ariadne support.