Configuration commands set the options that are used when the kernel run by a Microsoft Dynamics AX client or an Application Object Server (AOS) instance starts. Configuration options can be changed with the user interface in the Client or Server Configuration Utilities.

Configuration commands can be run directly from the following locations:

  • In the Configuration Command to run at kernel startupfield in the configuration utility dialog boxes.

  • From a command prompt when starting a client or AOS instance.

  • In a configuration file.

For detailed lists of configuration commands and their syntax, see the following topics:

Run a configuration command from the field Configuration Command to run at kernel startup

  1. In either configuration utility, you can run a configuration command from the Configuration Command to run at kernel startupfield. Use this method to set options that are not available from the user interface.

Note Note

No syntax checking is performed before configuration commands are passed to the Microsoft Dynamics AX kernel from the configuration utilities. A bad command can disable your system. Test any command before using it.

  1. Open either the Client Configuration Utility ( Start> All Programs> Control Panel> Administration> Microsoft Dynamics AX Configuration Utility) or the Server Configuration Utility ( Start> All Programs> Control Panel> Administration> Microsoft Dynamics AX Server Configuration Utility).

  2. In the Configuration Command to run at kernel startupfield, enter a configuration command in the format -command=value.

    To enter more than one command, leave a space between commands. For example: -command=value -command2=value

  3. Save the configuration, and close the configuration utility.

    The configuration option that is set in the Configuration Command to run at kernel startupfield is only set for the current instance of the kernel: it overrides the corresponding value in the registry or configuration file, but does not change it.

Run a configuration command when starting from a command prompt

If you start a client or AOS instance from a command prompt, you can pass configuration commands to be used as the instance starts.

  1. Open a command prompt ( Start> All Programs> Accessories> Command Prompt), and navigate to the directory in which Microsoft Dynamics AX is installed.

  2. Type Ax32.exefollowed by a configuration command. For example:

    Ax32.exe -command=value

    Microsoft Dynamics AX starts.

    The configuration option that is set using the command is only set for the current instance of the kernel: it overrides the corresponding value in the registry or configuration file, but does not change it.

Add a configuration command to a configuration file

  1. If you are not using a configuration file, open either the Client Configuration Utility ( Start> All Programs> Control Panel> Administration> Microsoft Dynamics AX Configuration Utility) or the Server Configuration Utility ( Start> All Programs> Control Panel> Administration> Microsoft Dynamics AX Server Configuration Utility).

  2. Click Manage, and then click Save configuration to a file. Choose a location and name for the configuration file, and then click Save.

    The file is saved with an .axcextension.

  3. Close the configuration utility.

  4. Open the client configuration file you are using with a text editor, such as Microsoft Notepad.

  5. Edit any configuration command that you want to change the value of, or add a configuration command that does not have an interface element. Use commands in the format command,datatype,value.

  6. Save and close the configuration file.

  7. Close any client or AOS that is using the configuration file, and then restart.