Using the TCQ/TCX Repair Utility (DGADTQFX)
The TCQ/TCX Repair Utility (DGADTQFX) can be used to help solve corruption problems related to the TCQ/TCX data sets.
Run the DGADTQFX utility in one of the following ways:
- Rebuild TCX mode, which creates a new TCX by using the current TCQ to indicate the existence of Processes.
- Use TCX mode, which creates a new TCQ using the current TCX to indicate the existence of Processes. When upgrading from Connect:Direct releases prior to 4.4, using TCX mode is recommended.
The Rebuild TCX mode is the preferred mode for rebuilding the TCQ/TCX after encountering TCQ corruption problems, which cause U3083 abends.
The Use TCX mode is recommended for TCQs associated with systems running versions of IBM® Connect:Direct® prior to Version 4.4. Prior to Version 4.4, completed Processes were retained in the TCQ and were not deleted.
The DGADTQFX program, located in $CD.SDGALINK, has one execution parameter for specifying the report type.
|PARM= SUMMARY | DETAIL | BACKLEVEL | REMOVEPR||Specify SUMMARY to produce a report at the Process
Specify DETAIL to produce a report, which shows steps within each Process, such as RUN TASK, RUN JOB, SUBMIT, and COPY.
Specify BACKLEVEL to create a TCQ and TCX for pre-version 4.6 IBM Connect:Direct systems.
Specify REMOVEPR to remove all Processes on the PR queue.
Normally, you run DGADTQFX with IBM Connect:Direct shut down but you could run it in production. The data sets and reports created will be correct as long as no update activity to the input TCQ takes place while the utility executes. The program issues a warning message if the VSAM timestamp for the input TCQ is changed during execution.
The return codes associated with the DGADTQFX utility are described in the following table.
|0||No errors were found in the input TCQ|
|4||At least one error was found and removed or a warning message was issued|
|8||A severe error occurred during execution and the utility was terminated|
Initializing the DTF After DGADTQFX Has Found Errors
If errors were found and corrected when you ran the DGADTQFX utility, replace the original corrupted data sets in use with the new data sets created by DGADTQFX. To allocate the new data sets to IBM Connect:Direct, use IDCAMS ALTER or regenerate the network map.