:DDT Debug Date and Time Commands

These commands display, set, enable, and disable the debug date and time for an application.

 Caution

Debug date and time is for debugging purposes only. It should not be used in a production environment.

By default, when your application is started, the debug date and time is set to zero and turned off. When the debug date and time is turned on, the new time remains in step with system time. For example, if you set your debug date and time to 11 p.m., December 31 2004, and turn it on, then two hours later the debug date and time is 1 a.m., January 1 2005.

All dates and times that are visible to users, such as Status line messages and the Ispec screen header, show the debug date and time. External interfaces, such as HUB, OLTP, ROC, NOF, GLI, extract files, Report synchronization, and error log files, still use the system date and time, except for properties that are under user control. For example, ROC Reports show the real date and time in the ROC database, but the print lines show the debug date and time.

The highest account month (HAM) is adjusted automatically to the new year and month when the next transaction is entered. When the debug date and time is disabled, it is restored to its previous value. In the event of a system crash, HAM remains set to its new value, and you will have to restore it to an appropriate value. The lowest account month (LAM) is not affected.

The debug date and time are automatically turned off and reset to zero when you shut down your application.

The :DDT Setting is stored in your database. When your application is initiated, stored settings are reapplied. Security level is Controller.

To set the debug date and time, enter:

:DDT date [time]

Where:

For example, :DDT 04/05/2010 sets the debug date to April 5th, 2010, in US date format.

If the time is not specified, the system time is used. You cannot reset the debug date and time while it is enabled.

To enable the new date and time, use the :DDT+ command. If you attempt to turn on the debug date and time before setting the value, an error message is displayed.

To disable the debug date and time, use the :DDT- command. This returns the values of the debug date and time to their default values of zero.

The :DDT command without date and time parameters displays the current debug date and time and its status.

The debug date and time can be set independently for each Specification, but not for ROC. Only user dates and times are changed; internal dates and times are not affected. External interfaces, such as HUB, OLTP, ROC, NAP, NOF, GLI, extract files and report synchronization, use the system date and time, except for properties that are under user control. The debug date and time is used for the highest and lowest account months (HAM and LAM), for the MoveDate and MoveTime commands and for the following built-in attributes: