PURPOSE: The COMMAND AREA TRACE option controls the displaying of the commands that are built and executed internally by ACCENT R. This command is valid in a CM, PM, SF and as a direct command.
{ENABLE; DISABLE} COMMAND AREA TRACE [{IF; UNLESS} clause]
|
ENABLE |
displays internally built and executed commands whenever they occur during subsequent processing. All such commands are preceded by the flag "CA>" when they are displayed. ACCENT R builds commands to execute some functions that are implied or stated in a short form. For example, if choosing to create a DI by using the simple KEYED ON clause of the CREATE DS command, ACCENT R internally builds all the commands and statements needed to create a DI. See the example below. |
|
DISABLE |
suppresses such output and is the default setting. |
|
{IF; UNLESS} clause |
specifies certain criteria that must be met for the ENABLE or DISABLE command to take effect. |
In the following example, the user takes two short cuts: using the KEYED ON clause to create a Data Index, (DI), and then manipulating the Data Set (DS) without issuing a FORM command. COMMAND AREA TRACE is enabled so that the user can see the steps that ACCENT R takes to accomplish the short cuts. All lines that begin with CA> are generated by ACCENT R internals.
*ENABLE COMMAND AREA TRACE
*CREATE DS PROJECT SD PROJ KEYED ON NAME AND DATE
CA> DEFINE DI PROJECT
CA> INSERT 100
CA> INDEX TYPE IS RAM
CA> INDEX TO PROJECT
CA> DOMAIN NAME ON NAME
CA> DOMAIN DATE ON DATE
CA> END
CA> SAVE
*USE DS PROJECT
*ENTER WITH PROMPTS
PROJ_NAME: BOOK DISTRIBUTION
DATE: 4/22/97
RECORD.NUMBER: 1
NAME: ***
*USE DS PROJECT DI PROJECT
*EXTRACT
CA>FORM DI PROJECT CHECK
CA>EXTRACT
BOOK DISTRIBUTION 04/22/91 1