Troubleshooting

The CTOFANCI utility analyzes text in input scripts (rules) to determine how, or whether, to handle them during the conversion process.

While most types of i nput are properly handled by utility CTOFANCI, an unexpected combination of conditions can cause utility CTOFANCI to fail. Use the information provided below to handle CTOFANCI failures and to minimize their effect on your automation conversion effort.

Bypassing CTOFANCI Problems

If the CTOFANCI utility ended abnormally due to problems with a specific input dataset or member, you can skip the problematic dataset or member using parameters RESTARTDS or RESTARTMEM (described in Chapter 4, "Utility CTOFANCI").

Analyzing the order of files in report RPTFILES and the order of member patterns for each file can locate the problematic member. In most cases, the problematic member is the one selected immediately following the last member listed in report RPTSRC.

Preventing Infinite Loops

Use the following methods to prevent infinite loops during a run of utility CTOFANCI:

• Specify a time limit in the JCL JOB statement that is used to activate utility CTOFANCI.

• Manually monitor execution of the conversion utility.

• Under normal circumstances, new rules are added to the RPTRULES report every few seconds. The number of rules that can be observed at runtime depends on the block size of the file to which the report is being written. If the RPTRULES report is not updated at the expected frequency, cancel execution of utility CTOFANCI.

• Manually monitor the messages produced by the utility.

• Utility CTOFANCI issues progress message CTOF28I each time a specified number of input rules and/or members are processed. If this message stops appearing at the expected frequency, cancel execution of utility CTOFANCI.

If an infinite loop occurs, cancel the job and use the instructions in Appendix B to report the problem to your BMC Customer Support representative.