How To Guide

Updating Data Thread from 3.01 to 3.x

Last Updated:
August 25, 2016

Before You Update

Note: If your version is V3R2M0 or lower, refer to Upgrading Data Thread.

The Data Thread update is installed over your existing Data Thread installation. Powertech recommends saving a backup of your existing Data Thread library before updating.

Note: When installing Data Thread in an HA environment: 

  1. Stop the replication of user profiles from production to HA system by either ending the replication software or ending the replication of the user profiles. 
  2. Install Data Thread on the HA and production systems.
  3. Setup Data Thread replication per the HA Setup instructions (see Data Thread Setup in an HA Environment)
  4. Start replication (including the user profiles).


Data Thread requires that you enter a valid license key. Contact if you need to request a new license key.

System Values

It is Powertech’s goal not to change system values on customer systems because we recognize that security-conscious organizations have rigorous change control processes in place for even small changes to system values. Therefore, we ask you to make any system value changes that are needed. However, the Data Thread installation process could change a system value to allow the install to proceed if a system value is not set as specified below. If the Installation Wizard changes a system value during install, it changes it back to its original value when the install completes. To install Powertech Data Thread on your system, the following system values that control object restores must be configured as shown.

  • Set QALWOBJRST to *ALWPGMADP (at a minimum) to allow the system to restore programs that adopt authority. Many Powertech Data Thread programs adopt the authority of the product owner, rather than forcing you to give authority directly to administrators and end users. (Note: For some system configurations, *ALL is required temporarily.)
  • QALWUSRDMN controls which libraries on the system can contain certain types of user domain objects. You should set the system value to *ALL, or include QTEMP and the name of the Data Thread product library DATATHREAD for the product to function properly.
  • QVFYOBJRST can be 1, 2, or 3. This allows Data Thread to restore all objects regardless of their signature. 
  • Set QFRCCVNRST (Force conversion on restore) to 0, Do not convert anything. 

System Requirements

Data Thread requires that IBM i (i5/OS, OS/400) version V6R1 or higher be installed on your system.
Note: During installation an FTP connection is initiated. The FTP server responds with messages that prompt for FTP login credentials. The standard port reserved to establish an FTP connection to the IBM i is port 21. Consequently, it is required that this port is open and ‘listening’ on the server in order to establish a connection with the Installation Wizard and facilitate a successful installation.

Updating Data Thread

The Data Thread installation process is completely automated.

Note: It is best to update at a time when your system is not particularly busy. Only end Data Thread when you are ready to begin the update procedure.

Ensure the following servers are available and running prior to installation:

  • FTP Server
  • Remote Command Server 

Do the following to update Data Thread:

  1. Download the Data Thread Installer (setupDataThread.exe) to your PC. To do so, go to the HelpSystems website and click My Account
  2. End Data Thread using STRDT, option 17, ENDALL. Once all subsystem jobs have ended, you can end the Data Thread subsystem. Back out of any Data Thread menu screens you or others may have open.
  3. Double-click the .exe file to start the Wizard. When prompted, enter the name of the system on which you want to update Data Thread, a user profile, and password.

    Note: Make sure the user profile is a member of the user class *SECOFR and has at least the following special authorities: *ALLOBJ, *SECADM, *JOBCTL, *IOSYSCFG, and *AUDIT. The user profile should have Limit capabilities set to *NO.

  4. The Wizard updates Data Thread on your system. When the update completes, you can select to view the install log. 
  5. When you are finished updating, click Finish to remove the Wizard from your PC. The installation process displays the job log name, user, and job log number. Use the WRKSPLF command to display the job log for complete information on the Data Thread update.

Your Data Thread installation includes the following product libraries, user profiles, and command on your system. It also creates the DATATHREAD subsystem if it doesn’t already exist.

Installed on System Description

Product Library


User Profiles

DATATHREAD, which has a user class of *USER

The profile is set to Password = *NONE so it can’t be used to sign on to the system.





Restart Data Thread

To start Data Thread, enter the following commands:

STRSBS Datathread

option 17, STRMGR

Related Products