Refresh Date: Aug 15, 2019
Refresh Number: 70
Applies to IBM i Releases 7.2, 7.3, and 7.4
Please make sure you have the following PTFs or their supersedes installed on your system. These correct IBM problems that may cause an install failure. The problem was reported as APAR SE66239.
R710 SI63541 (if installing R68 or earlier) R720 SI63531 R730 SI63540
In addition the following PTF is required on 7.3 in order for some of the authorization list tools to work properly:
No known PTFs are required for 7.4 at this time.
Refresh 68 (April 15, 2018) was the last refresh for IBM i 7.1. Fixes to 7.1 tools will continue to be made on an “as needed” basis until April 30, 2021.
You should use the installation process and not attempt to save the TAATOOL and TAASECURE libraries from one system and restore to another system or even another partition on the same system.
If the tools do not already exist on your system, you will need both *SECADM and *ALLOBJ special authorities to do the initial install. If they do exist, then you could also do an install if you are on the TAAINSTALL authorization list with *USE authority.
The TAA Productivity Tools are licensed to a specific serial number and software tier. You may install the TAA Productivity Tools on an unlicensed system for a maximum of seven days. After this you will need a demo license or a full license. Keys for either may be obtained by contacting TAA Tools support.
You should not attempt to install the TAA Productivity Tools unless you have at least 2 GB of free space on your system. If you have less than 2 GB of free space, see the section later in this document. After the install is completed, the TAA Productivity Tools require approximately 600 MB.
The TAATOOL objects are shipped in a compressed form. The size of the TAATOOL library will increase as you use the objects.
The TAA Archive is standard and contains a compressed version of all of the source. If you have a full license, you may display or ‘copy out’ any of the source. After installing, see the CPYTAA, CPYTAA2, or CPYTAAALL commands to ‘copy out’ the source.
If you have changed the defaults for the system RSTLIB command in QSYS, you must change back to the system defaults.
You can contact support by emailing support or calling 507-258-5182. Telephone support is available Monday through Friday 9:00 AM to 5:00 PM Eastern Time.
Full documentation for all tools is available on our web site: https://taatool.com/.
After installation, all documentation for the TAA Tools is available within the tool itself. Use the WRKTAA command to see the tool documentation. Use the HELPTAA command to view all of the “How To” documentation for the tools.
TAA Productivity Tools installation can be done by physical CD or by CD image. This article explains how to install from a physical CD. See these instructions to install from a CD image.
Make sure that you can restore all of the objects including authorization lists. To do this you will need to set the system value
If the value is not
*ALL, record the current value and temporarily change it so the install can proceed.
CHGSYSVAL QALWOBJRST *ALL
Either the CD or equivalent CD image can be used to install the TAA Productivity Tools (TAATOOL) on IBM i. If you are installing from a CD image see these instructions. This will describe how to download the CD image file and create an image catalog from which you can install.
If you want to install the product on a remote system and you have a physical CD, you will also want to use these instructions and create a CD image and image catalog from a physical CD.
To install the TAA Productivity Tools, do one of the following options:
Option 1: As QSECOFR (or any user with *ALLOBJ and *SECADM) where the device is typically OPT01.
Option 2: As any user with restore authority
RSTLIB SAVLIB(TAAINSLIC) DEV(OPTxx) RSTLIB SAVLIB(TAAINS) DEV(OPTxx)
Then, as QSECOFR (or any user with *ALLOBJ and *SECADM)
Option 3: As any user authorized to the TAAINSTALL authorization list and with *SAVSYS special authority perform the previous LODRUN command.
This technique can only be used if the TAA Productivity Tools have been previously installed. It may be used for a re-install or a new refresh. See the discussion for ‘Installing as Non-QSECOFR’ on the HELPTAA menu.
The install process will display a series of prompt screens with help text and options. You may access more text about the product by using function keys. You may specify options such as whether to have a separate command library.
The install work is done by the TAAINSTALL job that is submitted to batch. You may specify when the batch job is to run. It takes about 20 minutes to install the product on a dedicated small system.
Installing the product will first delete the existing tools. You should ensure that no user is using a tool during the batch installation.
If the TAA Productivity Tools are successfully installed, the install libraries TAAINS, TAAINSLIC, and TAAINS2 are automatically deleted.
Enter the following command to determine the state of any existing install. You can gain some space to do new install by working with this existing install.
Depending on the results of this command you can do one of the following.
If the TAATOOL library does not exist
You will need to ensure that 2 GB of free space exists. Note that this space is needed to load the TAAINS library and run the install. After the install is complete, the TAA Productivity Tools product will take about 600 MB on your system, but will expand as you use the tools since the object code is shipped in a compressed format.
If the TAATOOL/TAALICENSE data area does not exist
If the TAATOOL library exists, but the TAALICENSE data area does not, it is assumed that you are not using the TAA Productivity Tools product. The TAATOOL library is probably left over from when the TAA Tools were part of OS/400 or the IBM i OS. A user with *ALLOBJ special authority can delete the TAATOOL library after ensuring an adequate backup exists. This will save some space.
If you have a working install for the same release you are installing
If the TAALICENSE data area exists in TAATOOL, it is assumed that you are installing an update to the TAA Tool Productivity Tools. Create a duplicate license in another library by doing
CRTDUPOBJ TAALICENSE TAATOOL *DTAARA <library>
Clear the library when no one is using the tools.
Install the tools using the CD (or CD image) as above and then move your TAALICENSE data area back to the TAATOOL library, replacing the temporary install license.
If you have a licensed install for an older release
Follow the step above, but after moving your license data area back to the TAATOOL library you will need to do a CHGTAAKEY to update it to a license for the new release.
If you need to free up more space to reach the 2 GB value, you may need to save some of your objects, delete the space that was used and then restore them after the TAA Productivity Tools are installed.