Configuration and command line parameters

Edit online

All parameters not specified "optional" in the following table must be specified, either in the configuration file or in concert with the command line flags.

Even if a parameter is optional, it may be required by your database configuration.

If the command line is malformed to the extent that further processing cannot proceed, the output file cannot be determined, or a fatal file operation occurs, a message will display on the screen that describes the error. In this case, nothing will be written to an output file. A record of the fatal error will display in your Windows Event Viewer, under the Application Log group, with a source name of XML Autoload. Examples include failing to close a quote in a parameter, or being unable to create an output file due to permission errors. All other errors will be reported in the output file.

Warning: Use care when specifying output file options. If you specify "overwrite" the contents of the last output file will be lost; you will not be prompted of this condition. If a file is overwritten a warning will appear in the output file.

In addition, remember the following as you work with these command line options:

  • All parameter values are case sensitive except file names.
  • All XML tags and command line flags must be lowercase.
  • XML tags must be entered in the order displayed (the DTD validation will fail otherwise)
  • The command line flags can be listed in any order, but cannot be repeated.
    Configuration Parameter Command Line Notes
    Not applicable -cf Configuration file name: specify the configuration file to run unattended.
    Required to run in unattended mode. Parameter value, if not specified, will default to PMAutoloadConfig.xml.
    <xmlsource> -xs XML Input file. When used in the command line enclose in quotes if contains a space or a dash.
    <pwprotection> Password protection: 0=clear text (no protection) 1=protected. Tells system format of passwords listed below.
    <dsn> ODBC Data Source Name.
    <dbuser> Database user name. Optional; may be required for your database.
    <dbpass> Database password. Optional; may be required for your database.
    <database> Database name. Optional; may be required for your db.
    <dbvendor> Database vendor: Access, DB2, SQL Server, Oracle, Sybase
    <pmuser> Partner Manager User ID. Optional; required if users are defined in Partner manager
    <pmpass> Password for Partner Manager User ID. Optional; required if <pmuser> above has a password.
    <rptformat> Report Format Option: d=Detailed, s=Summary.
    <exceedmax> Data exceeding Max Len: r=Reject, t=Truncate.
    <runoption> Run Option: r=Run, v=Validation Only.
    <updateoption> Update Options: a=Allow Add, c=Allow Change, d=Allow Delete. Can combine; for example, to allow all:

    <update option>acd</update option>
    <errors> Change/Delete Error Processing Control: a=Abort, c=Continue
    <outputfile>

    		-of File to write of all messages/errors. Optional; default: PMAutoloadOut.txt, in same directory as exe.
    <outputcontrol> -oc If output file exists, a=Append, o=Overwrite. No warning issued when overwriting, but a message will appear in output file. Default is "a" (Append)