IBM i Installation - Upgrade Installation for Maintenance Release

warning

Currently, Universal Agent 8.0.0 for IBM i does not include Universal Command (UCMD) or Universal Data Mover (UDM). Customers who require those components should use an older version of Workload Automation for IBM i. The latest version containing those components is 5.1.1. Older versions of Workload Automation for IBM i can be installed alongside version 8.0.0.

Upgrade Installation for Maintenance Release

To upgrade Universal Agent for IBM i from a currently installed release to a maintenance release, perform the following steps:

Step 1	Extract the PTF distribution file. Universal agent PTFs will be distributed via compressed tar file just like the product distribution file. The file will use the following naming convention: sb-<product_version>-ibmi-<target_release>-PTFs.tar.gz where <product_version> is the Universal Agent product version (V.R.M.L) and <target_release> is the target IBM i version (V.R) that the product objects are built for. Extracting the distribution file will yield a “readme” file containing instructions for applying the PTF and a save file containing the PTF: PFT Distribution file Contents PFT Distribution file Contents -bash-5.2$ gunzip sb-8.0.0.1-ibmi-7.3-PTFs.tar.gz | tar xvf - x P0UA0501.SAVF, 3166420224 bytes, 6184415 tape blocks x README.TXT, 2092 bytes, 5 tape blocks -bash-5.2$ ls -la total 7635040 drwxr-sr-x 2 user1 0 12288 Jan 16 14:18 . drwxr-sr-x 3 user1 0 28672 Jan 16 13:55 .. -rwx------ 1 build1 0 3166420224 Jan 16 10:35 P0UA0501.SAVF -rw-r--r-- 1 build1 0 2092 Jan 16 10:35 README.TXT -rw-r--r-- 1 user1 0 726484415 Jan 16 13:56 sb-8.0.0.1-ibmi-7.3-PTFs.tar.gz Below is an example of the README.TXT distributed with the PTF distribution package: README.TXT README.TXT Copyright (c) 2000-2025 Stonebranch, Inc. All rights reserved. Stonebranch, Inc. Universal Agent 8.0.0 IBM i PTF Installation Procedure Distribution ------------ PTF distributed as IBM i Save Files. STEP 1: Create a save file on the target IBM i system in library QGPL using the command: CRTSAVF FILE(QGPL/P1UA0501) STEP 2: Ftp the PTF save file to the save file created in step 1. A transcript of an example ftp session to place the PTF save file into the save file created in step 1 follows: NOTE: This transcript assumes that the PTF save file resides in c:\temp ftp your_IBMi Name: your_name Password: your_password ftp> cd QGPL ftp> bin ftp> lcd c:\temp ftp> put P1UA0501 P1UA0501 ftp> quit Note: Non-IBM FTP programs may require the format 'put P1UA0501 P1UA0501.SAVF' and some Windows PTF products require that the save file on the source side be named P1UA0501.SAV Installation ------------ PTFs should be installed as user QSECOFR or a user with equivalent authority. STEP 1: Load the PTF. On the IBM i, enter the following command: ===>LODPTF LICPGM(1UNV78S) DEV(*SAVF) SELECT(1UA0501) SAVF(QGPL/P1UA0501) STEP 2: Ending the UNVUBR78S subsystem. The UNVUBR78S subsystem must be ended prior to applying PTF 1UA0501. On the IBM i, enter the following command: ===>ENDSBS UNVUBR78S STEP 3: Apply the PTF. On the IBM i, enter the following command: ===>APYPTF LICPGM(1UNV78S) SELECT(1UA0501) The above command applies the PTF temporarily. If you wish to apply the PTFs permanently after successful testing, execute the command again with the parameter APY(*PERM).
Step 2	Copy Save File to QSYS.LIB. The extracted PTF save file must be copied to a save file in the QSYS.LIB system. From an SSH session on the IBM i, this can be accomplished with the following command: system "QSYS/CPYFRMSTMF FROMSTMF('/home/SEPE/dl/P0UA0501.SAVF') TOMBR('/QSYS.LIB/QGPL.LIB/P0UA0501.FILE') MBROPT(*REPLACE)" info This command can be run from the IBM i command line as well. However, it is convenient to run it from SSH - especially if you are already there after extracting the distribution file. On the other hand, the commands below are best run from the IBM i command line if possible. Doing so allows you to display the job log to see the underlying commands and messages resulting from the commands. This is particularly useful if something goes wrong. If something goes wrong, a white message will appear on the bottom of the screen. You can place the cursor on it and press F1 to view the detailed message. If no error message is generated and you just want to see the commands and messages run in the background, you can execute DSPJOBLOG, then press F10 and page up to see the messages in the job log.
Step 3	Display the status of PTFs for the Universal Agent Licensed Product. The following command will display the status of PTFs associated with the 0UNV790 licensed product: DSPPTF 0UNV790
Step 4	Load the PTF. The PTF must be loaded before it can be applied. From an SSH session, execute the following: LODPTF LICPGM(0UNV790) DEV(*SAVF) SELECT(0UA0501) SAVF(QGPL/P0UA0501) Loading the PTF copies the PTF objects into the product library.
Step 5	If the Universal Agent subsystem is running, stop it before applying the PTF: ENDSBS UNVUBR790
Step 6	Apply the PTF. The PTF can be applied temporarily with the following command: APYPTF LICPGM(0UNV790) SELECT(0UA0501) If you want to apply the PTFs permanently after successful testing, re-execute the command with the parameter APY(*PERM). tip If only temporarily applied, the PTF can be removed with the following command: RMVPTF LICPGM(0UNV790) SELECT(0UA0501) Removing the PTF temporarily will leave the PTF “loaded” and ready to be reapplied. Removing the PTF permanently will also “unload” the PTF. PTF objects will be removed from the product library. The PTF can be removed permanently with the following command: RMVPTF LICPGM(0UNV790) SELECT(0UA0501) RMV(*PERM)
Step 7	Restart UNVUBR790.