Step I – Installation of the Powertech Products

To successfully install any Powertech product in a High Availability (HA) environment, the Powertech product must be installed on the HA system before the production system.

This is necessary because replication software could be setup with global settings to replicate non-library objects such as user profiles, authorization lists, IFS directories, etc. Many of the Powertech products check for the existence of these objects (especially user profiles) prior to installation, and will not install if these objects already exist.

Step II – Data Thread Setup

In Data Thread, the customer has the option to use triggers or journals to monitor the activity on their files. If using journals, the customer can use Data Thread’s journal (DATATHREAD/DTJOURNAL) or a journal in their application library to monitor the activity.

The preferred method when using Data Thread with a replication software is to setup Data Thread to use the ‘U’ (User’s) journal. Use this ‘U’ (user’s) journal as the HA journal to send the transactions from the source to the HA system.

Step III – Use Object Synchronization Replication Software

Synchronization of the objects needs to be done on the individual object. Never use the ‘Library Synchronization’ feature of the HA product as it will clear the product’s library and replicate just the objects that are defined to be replicated. The licensed objects should never be replicated from the source to the HA system (see Step IV – Data Thread Replication below). The product will not function on the HA system because the licensed objects would be deleted and restored from the source system if ‘Library Synchronization’ was performed.

If 'Library Synchronization' was done, then the product will have to removed and reinstalled on the HA system again for the product to function properly and replication setup to use Object Synchronization.

Step IV – Data Thread Replication

Omit the following files and data queues from being replicated in the DATATHREAD library. Add an ‘Omit’ filter for each file and data queue listed below:

LIBRARY OBJECT TYPE
DATATHREAD IDTOVR *FILE
DATATHREAD IDTOVR2 *FILE
DATATHREAD IDTLIC *FILE
DATATHREAD IDTPRO *FILE
DATATHREAD IDTJRN *FILE
DATATHREAD IDTALO *FILE
DATATHREAD *ALL *DTAQ

Note: After the ‘Omit’ filters have been set for the objects in DATATHREAD library, add an ‘Include’ filter to replicate all of the other objects in the DATATHREAD library.

‘Include’ Filter for all of the objects in the DATATHREAD.

LIBRARY OBJECT TYPE
DATATHREAD *ALL *ALL

Step V – License Objects

Data Thread 3.06 or later has the ability to enter multiple licenses (press F7 – License List on License Setup screen). This allows you to enter the HA system’s license before the role swap so you don’t need to contact Powertech technical support for an emergency (temporary) key.

In the event that you are Not using multiple licenses, you will need to add the following object to the Omit list of objects to Not be replicated.

LIBRARY OBJECT TYPE
DATATHREAD PDT9800U *USRSPC

Step VI – How to start Data Thread?

Role Swap done to my HA System, How do I start Data Thread?

Before Data Thread is started, the IDTJRN file can be cleared and the data queues can be deleted. The data queues will get recreated when starting Data Thread.

The IDTJRN file contains information on the journals used by Data Thread. Just in case the IDTJRN file does get replicated or restored from the source system, it is a good practice to simply clear this file before starting Data Thread. The IDTJRN record(s) will be recreated with the appropriate values for the journals on the target (HA) system when Data Thread is started. Use the following command to clear the IDTJRN file:

CLRPFM FILE(DATATHREAD/IDTJRN)

In the event the Data Queues were replicated or restored, it is good practice to delete the data queues in Data Thread. The data queues will be recreated when Data Thread is started. Use the following to delete the Data Queues:

WRKOBJ OBJ(DATATHREAD/IDTLOGQ*) OBJTYPE(*DTAQ)

Note: This will list the IDTLOGQ data queues A-G, select option '4' next to each one and hit ENTER to delete them. 

Use the following command to delete the IDTINDXQ data queue. This will also be recreated when starting Data Thread.

WRKOBJ OBJ(DATATHREAD/IDTINDXQ) OBJTYPE(*DTAQ)

Note: This will display the IDTINDXQ data queue, select a 4 next to it and hit ENTER to delete.(DATATHREAD will recreate the queue upon restart)

DataThread License:

Before starting Data Thread on the target (the HA) system in a mirrored environment, you will need to first verify that the HA system has a valid, permanent license or get a temporary license from Powertech Sales/Support.

  • STRDT
  • Option 18 – Enter Data Thread Software License Key
  • Start Data Thread:
  • Start the Data Thread subsystem.
  • STRSBS QUSRSYS/DATATHREAD
  • Start the manager job by issuing the STRMGR command in the Menu Option 17 of Data Thread.
  • STRDT
  • Option 17 – Data Thread Manager
  • STRMGR on Command Line
  • F5 Clear
  • DSPALL
  • Note: If the IDT470 job doesn’t start, use the REFJRM command to refresh the journal reader.
  • DSPALL

[[{"fid":"1027","view_mode":"default","fields":{"format":"default","field_file_image_alt_text[und][0][value]":false,"field_file_image_title_text[und][0][value]":false},"type":"media","link_text":null,"field_deltas":{"1":{"format":"default","field_file_image_alt_text[und][0][value]":false,"field_file_image_title_text[und][0][value]":false}},"attributes":{"height":666,"width":860,"class":"media-element file-default","data-delta":"1"}}]]

Another way to verify that all of the Data Thread jobs are active in the DATATHREAD subsystem is to display the subsystem using WRKSBS, option 8 next to DATATHREAD.

D_A1JRNA PTGM-IDT470 (User Journal)
D_DTJOURNA PGM-IDT470 (DataThread Journal)
D_SYSJRN PGM-IDT475 (QAUDJRN Journal)
DT_MANAGER PGM-IDT460 (DataThread Manager)
DT_MONITOR PGM-IDT450 (DataThread Monitor)
DT_WIM_SCK PGM-IDTSOCK (Socket Listener for Email)
DT_WIM_490 PGM-IDT490 (Socket Responder Email)

Note: If job DT_MANAGER job has any messages, it may not start the other Data Thread jobs until the message is replied to. i.e. - If CPF9810 message, Library xxxlib not found, review your replication settings for this library on the source system to get the library on the HA system, then reply with an ‘R’ to retry the DT_MANAGER job to continue to start the other Data Thread jobs.

Note 2: Verify that the IDT470 job is running for each monitored journal. There will be one job for each journal used in Data Thread.

Note 3: Verify that the IDT475 job is active for the system audit journal (QAUDJRN).

Note 4: For email, the two jobs need to be active, the listener job - IDTSOCK and the responder job - IDT490. These two jobs require that the SMTP server jobs are active – QTSMTPxxxx in subsystem QSYSWRK. If no jobs are active, verify the SMTP setup on the HA system to the source/production system. These include the SMTP attributes and directory entries. The socket used for the these jobs is on port 3074.


Still have questions? We can help. Submit a case to Technical Support.

Last Modified On: May 11, 2018