Syntax
ROC [ expression [ expression | “Clear” ]]
Parameters
expression (first)
A string expression naming the class or ispec to invoke when ROC is terminated. Acceptable values include: a classname, an ispecname, a quoted alias, or an attributename, where the attribute contains the class’s alias.
expression (second)
The command for ROC to interpret. This command is limited to a maximum length of 50 characters.
"Clear"
Instructs ROC to clear the usercode and history station information for the current station, and then return immediately to the specified ispec. This command option is typically used where station assignment is dynamic and the user was logging on or off.
Description
The Roc logic command accesses the Report Output Control system (ROC) from logic. Before using this command from the Winforms client, the Winforms client must be configured to support switching to ROC. Refer to Configuring Winform in the Agile Business Suite Installation and Configuration Guide for more information.
If the Roc logic command specifies an ispec, the Construct method of the specified ispec is invoked when ROC is terminated.
If the Roc logic command does not specify an ispec, the Construct method of the calling ispec is invoked if the ispec's Refresh property is set to true and the value of the Glb.Error built-in segment attribute is equal to the Glb.Spaces built-in segment attribute.
In either case, all logic following the Roc logic statement is ignored.
Restrictions
The following restriction applies to use of the Roc logic command: When processing an OLTP-originated transaction, the Roc logic command behaves as if ROC is not available.
When processing an OLTP-originated transaction, the Roc command functions as if the Report Output Control System is not available. If you have specified a return Ispec, that Ispec is recalled (otherwise the _Construct method of the current Ispec is executed).
Note: The use of Recall logic command is invalid in Reports and Messengers.