<!--
* 
*
*  ProLinga-Doc
*
*  Copyright (C) 2002-2008 Xobas Software.
*  All rights reserved.
*  
*  This file is part of ProLinga-Doc.
*
*  ProLinga-Doc is free software: you can redistribute it and/or modify
*  it under the terms of the GNU General Public License as published by
*  the Free Software Foundation, either version 3 of the License, or
*  (at your option) any later version.
*
*  ProLinga-Doc is distributed in the hope that it will be useful,
*  but WITHOUT ANY WARRANTY; without even the implied warranty of
*  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
*  GNU General Public License for more details.
*
*  You should have received a copy of the GNU General Public License
*  along with ProLinga-Doc.  If not, see <http://www.gnu.org/licenses/>.
*
*  More information is available at the following addresses:
*
*  Website     : http://www.prolinga.org
*
*  Email       : prolinga-list@prolinga.org
*
*
-->
<refentry id="cmd_control">
  <refmeta>
    <refentrytitle>CONTROL Command</refentrytitle>
    <manvolnum>1</manvolnum>
  </refmeta>

  <refnamediv>
    <refname>CONTROL</refname>
    <refpurpose>Execute a control command.</refpurpose>
  </refnamediv>

  <refsynopsisdiv>
    <cmdsynopsis>
      <command>CONTROL</command>
      <arg choice='plain'><replaceable>control_function</replaceable></arg>
      <arg rep='repeat' choice='op'><replaceable>argument</replaceable></arg>
    </cmdsynopsis>
  </refsynopsisdiv>

  <refsect1 id="cmd_control_introduction">
    <title>Introduction</title>
    <para>
      The <link linkend="cmd_control">CONTROL</link> command executes built-in 
      control commands.
    </para>
  </refsect1>
  <refsect1 id="cmd_control_arguments">
    <title>Arguments</title>
    <variablelist>
      <varlistentry>
	<term><replaceable>control function</replaceable></term>
	<listitem>
            <simplelist type='horiz' columns='3'>
            <member><command>Control Function</command></member>
            <member><command>Argument(s)</command></member>
            <member><command>Description</command></member>
            <member>appndev</member>
            <member><replaceable>application_name</replaceable></member>
            <member>Sets the internal variable APPNDEV() to the name of the 
              application being developed. Only to be used in developer 
              applications like 'Advance'.</member>
            <member>datamanager</member>
            <member>build <replaceable>table_name</replaceable></member>
            <member>Start a data manager function (can be used in development 
              application only).</member>
            <member>exit</member>
            <member>--</member>
            <member>Exit the application.</member>
            <member>logon</member>
            <member><replaceable>appn_name</replaceable></member>
            <member>Logon to an application.</member>
            <member>logout</member>
            <member>--</member>
            <member>Logout from an application and go to logon screen.</member>
            <member>painter</member>
            <member>--</member>
            <member>Start the screen painter (can be used in development application only).</member>
            <member>user</member>
            <member><replaceable>user_name</replaceable></member>
            <member>Sets the internal variable USER().</member>
            <member>validate</member>
            <member><replaceable>object_name</replaceable></member>
            <member>Validate a base object (can be used in development application only).</member>
          </simplelist>
	</listitem>
      </varlistentry>
    </variablelist>

  </refsect1>

  <refsect1 id="cmd_control_example">
    <title>Example</title>
<programlisting>
. . .
. . .
CONTROL exit
. . .
. . .
</programlisting>
  </refsect1>

  <refsect1 id="cmd_control_related">
    <title>Related Commands</title>
    <para>
      None.
    </para>
  </refsect1>

</refentry>

