|
|
|
|
CoolSpools
Plus
Please note the following points and take the following precautions before you start to install a PTF.
You install PTFs at your own risk. Under no circumstances can we be held in any way responsible for any consequences arising from the application of a PTF, whether under our advice or otherwise.
Our PTF exit programs are intended to ensure that all user data is preserved and the integrity of your system ensured during the PTF install process. However, please take note of the following points.
Backups
We recommend strongly that, as a precaution, you do both of the following steps before starting the PTF procedure,
 | take a SAVLIB of library COOLSPV5R1 to a save file or other media; |
| take a SAVLICPGM of licensed program 5COOLSP to a different save file or other media. |
In the event that problems arise after the installation of a PTF, contact us and we will advise you how to recover. These saves may then be essential. If you are sure all of your data has been preserved, and no unexpected consequences are encountered after application of the PTF, these saves may be deleted after a reasonable period of time has elapsed.
Exit Programs
If you have not yet installed PTF 5CP0070, you must install the new versions of the PTF exit programs before starting the install procedure described below. If you do not install the new versions of the PTF exit programs first, the procedure could fail and there is a risk your system could become corrupted and data loss could result.
To install the PTF exit programs, follow this procedure.
Once you have followed this procedure and installed PTF 5CP0070 or later, there is no need to do this again.
User id
When applying PTFs you should sign on as QSECOFR or another user with both *SECADM and *ALLOBJ special authorites.
PTF 5CP0070 and later will not allow the PTF install process to continue unless the user running the commands has *SECADM and *ALLOBJ special authorities.
Object Locks
Before starting to apply a PTF, ensure that CoolSpools Plus is not in use. In particular, ensure that the COOLTOOLS subsystem is ended.
PTF 5CP0070 and later PTFs check for objects in use automatically.
Error messages
The PTF apply process will fail with message CPF3638 or CPF3639 if locked objects or any other issues are encountered.
If you receive error message, CPF3638, check the joblog for messages about objects being locked and resolve any locks or other issues that are reported, then restart the PTF install procedure from the apyptf Step 7 (Method A) or Step 9 (Method B)
If you receive error message CPF3639, the PTF will be flagged as damaged and must be re-loaded. Restart the PTF install procedure from the lodptf Step 6 (Method A) or Step 8 (Method B)
Support
Contact support@ariadnesoftware.co.uk if you need any assistance with installing a PTF.
This method uses FTP (File Transfer
Protocol) to transfer the PTF file from your PC to your iSeries. 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 iSeries.
Step
1
On
your PC, create a directory for the PTF
installation, either within Windows Explorer, or from the DOS prompt, or re-use
the directory you used to install originally, e.g.:
md c:\COOLSP
Save or copy the zip file that you
downloaded or received into this directory.
Step
2
On
your PC, unzip the contents of the zip file into
the directory you just created using pkunzip, WinZip, Norton UnZip etc.
Step
3
On
your iSeries, first sign off then sign back on
again to ensure that you do to have any CoolSpools Plus 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.
Step
4
On
your PC, start an FTP session to your iSeries. You
may use FTP packages such as CuteFTP or simply go to the DOS prompt and type:
ftp AS400_name
where AS400_name is the name of your
iSeries.
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 iSeries.
quote site na 0
This makes sure the iSeries 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 iSeries.
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 Q5CP0001.zip, and
stores them in the save file called Q5CPnnnn which you created earlier on your
iSeries.
Step
5
On
your iSeries, 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 us at support@ariadnesoftware.co.uk.
Step
6
On
your iSeries, 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.
Step
7
On
your iSeries, issue the following command to apply
the PTF to your system:
apyptf
licpgm(5COOLSP)
select(5CPnnnn)
apy(*temp)
where:
nnnn is the PTF
If you have any trouble at any point
in this procedure, please contact us by e-mail at support@ariadnesoftware.co.uk.
This method uses a Client Access
network drive assigned to the IFS of your iSeries to transfer the PTF from your
PC to your iSeries. It is assumed that you have stored the PTF zip file (which
your downloaded from the Internet or received via e-mail) on your PC.
Step
1
On
your PC, create an install directory for the PTF,
either within Windows Explorer, or from the DOS prompt, or use the directory you
created for the original installation, e.g.:
md c:\PC_dir
where PC_dir is the name of the
directory you wish to use for this installation.
Save or move the zip file that you
downloaded or received into this directory.
Step
2
On
your PC, unzip the contents of the zip file into
the directory you just created using pkunzip, WinZip, Norton UnZip etc.
Step
3
On
your PC, ensure that you have a network drive
assigned to a directory in the root file system of your iSeries’s IFS. This can
be done in Windows Explorer by selecting Tools, Map Network Drive.
Create a directory in the IFS to
receive the PTF. This can be done in Windows Explorer by selecting File, New,
Folder, or at the DOS prompt as follows:
md i:\IFS_dir
where I: is the network drive assigned to your iSeries and IFS_dir is the
name of the directory you wish to use for this installation.
Step
4
Copy the contents of your PC’s PTF
directory created in Step 1 above to the IFS directory created in Step 3 above
using Windows Explorer, or from the DOS prompt as follows:
copy c:\PC_dir\*.* I:\IFS_dir
where PC_dir is the name of the directory on your PC, I:
is the network drive assigned to your iSeries and IFS_dir
is the name of the directory you wish to use for this installation.
Step
5
On
your iSeries, first sign off then sign back on
again to ensure that you do to have any CoolSpools Plus objects in your QTEMP
library. Then decide which library
you wish to use for the install procedure and create a save file in that
library. The save file should be called
Q5CPnnnn,
where nnnn is the PTF id, e.g.
crtsavf lib_name/Q5CPnnnn
where lib_name is the name of the library you chose to use
and
nnnn is the PTF id.
Step
6
On
your iSeries, copy the contents of the
Q5CPnnnn.sav
file (where nnnn is the PTF id) from
the IFS directory to the save file just created, by issuing the following
command:
cpyfrmstmf fromstmf(‘/IFS_dir/Q5CPnnnn.sav’)
tombr(‘/qsys.lib/lib_name.lib/Q5CPnnnn.file’)
mbropt(*replace)
cvtdta(*none)
endlinfmt(*fixed)
tabexpn(*no)
where IFS_dir is the name of the IFS directory into which you copied the
PTF files in Step 4 above, and lib_name
is the name of the library in which you created the save file in Step 5 above.
Step
7
On
your iSeries, 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 us at support@ariadnesoftware.co.uk.
Step
8
On
your iSeries, 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.
Step
9
On
your iSeries, issue the following command to apply
the PTF to your system:
apyptf
licpgm(5COOLSP)
select(5CPnnnn)
apy(*temp)
where:
nnnn is the PTF