{"id":1952,"date":"2017-10-18T16:24:09","date_gmt":"2017-10-18T16:24:09","guid":{"rendered":"https:\/\/www.flagshipsoftware.com\/wordpress\/portal\/?page_id=334"},"modified":"2025-10-20T16:19:54","modified_gmt":"2025-10-20T20:19:54","slug":"command-line-options","status":"publish","type":"page","link":"https:\/\/www.flagshipsoftware.com\/fsweb\/command-line-options\/","title":{"rendered":"Command Line Options"},"content":{"rendered":"\t\t
\n\t\t\t\t\t\t
\n\t\t\t\t\t\t
\n\t\t\t\t\t
\n\t\t\t
\n\t\t\t\t\t\t
\n\t\t\t\t
\n\t\t\t\t\t

Command Line Options<\/h2>\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t
\n\t\t\t\t
\n\t\t\t\t\t\t\t\t\t

\u00a0<\/p>

iAddress\u2122 offers powerful automation functionality that allows for you to easily and flexibly automate your address management processes. Using job configuration files, you can specify all the details of how your job is run \u2013 from the input files to the correction parameters to the output files. By command line options, you can override the config file options found in the next section specific to job and merge file numbers.<\/span><\/p>

There is a limit of 8192 characters on the command line.<\/span><\/p>

Format:<\/strong><\/span><\/p>

iAddress.exe filepath\\filename.cfg [-logfile=_filename][-existingoutput={datestamp (default), error, overwrite}][-KEEP_IADDRESS_OPEN={Y(default),N}] [-J#][_FIELDNAME=_FIELDDATA][-F#][_FIELDNAME=_FIELDDATA] [-CADATE] [-USDATE]<\/span><\/p>

Example:\u00a0<\/span>
iAddress.exe \u201cc:\\work\\config\\job1.cfg\u201d<\/span><\/p>

\u00a0<\/span><\/p>

It is important to note:<\/strong><\/span><\/p>

-J# (Job Number) must be specified for all _FIELDNAME=_FIELDDATA that is relevant to a job.<\/span><\/p>

\u00a0-J# (Job Number) and -F# (Merge file Number) must be specified for _FIELDNAME=_FIELDDATA that is relevant to both a merge file and a job until -J# or -F# is re-specified the same value for J# and F# are assumed for all _FIELDNAME=_FIELDDATA that follow.<\/span><\/p>

\u00a0If J# is re-specified then F# is cleared.<\/span><\/p>

\u00a0Job numbers start at value 1 and increase.<\/span><\/p>

\u00a0Merged file numbers start at value 0 and increase.<\/span><\/p>

\u00a0The jobs and files are ordered the same way they were first selected in\u00a0iAddress\u2122.<\/span><\/p>

\u00a0<\/span><\/p>

Command Line Parameters<\/u><\/strong><\/span><\/p>

-logfile<\/strong><\/span><\/p>

Usage:<\/em><\/span><\/p>

-logfile=\u201dfull\/path\/to\/file.log\u201d<\/span><\/p>

Example:<\/em><\/span><\/p>

iAddress.exe \u201cc:\\work\\config\\job1.cfg\u201d -logfile=\u201dc:\\work\\logs\\job1.log\u201d<\/span><\/p>

Description:<\/em><\/span><\/p>

By default, the log is written to the same folder that\u00a0iAddress\u2122\u00a0resides in (On a typical installation this is C:\\Program Files\\iAddress on a 32-bit OS; C:\\Program Files (x86)\\iAddress on a 64-bit OS). The log is named automate.log and is overwritten on subsequent runs. By using this parameter you can redirect the log output and gain some control over log storage.<\/span><\/p>

-quiet<\/strong><\/span><\/p>

Usage:<\/em><\/span><\/p>

\u00a0-quiet<\/span><\/p>

Example:<\/em><\/span><\/p>

\u00a0iAddress.exe \u201cc:\\work\\config\\job1.cfg\u201d \u2013quiet<\/span><\/p>

Description:<\/em><\/span><\/p>

This parameter causes\u00a0iAddress\u2122\u00a0to suppress Message Dialogs. While running in Quiet Mode, all dialogs that notify of a critical error in the application flow will cause\u00a0iAddress\u2122\u00a0to fatally exit with an error code of 1 (which can be checked in a batch file). All message dialogs are logged to the logfile (regardless of this parameter).<\/span><\/p>

-existingoutput<\/strong><\/span><\/p>

Usage:<\/em><\/span><\/p>

\u00a0-existingoutput={datestamp, overwrite, error}<\/span><\/p>

Example:<\/em><\/span><\/p>

\u00a0iAddress.exe \u201cc:\\work\\config\\job1.cfg\u201d \u2013existingoutput=overwrite<\/span><\/p>

Description:<\/em><\/span><\/p>

This parameter controls how\u00a0iAddress\u2122\u00a0handles the scenario when defined output files (Such as the save job, \u00a0 \u00a0 \u00a0 \u00a0labels or reports) already exist on the file system. The default is to datestamp the existing file.<\/span><\/p>

Datestamp:\u00a0<\/strong>Prepends the existing file with the creation date of the file, or the current date and time if it is unable to determine the creation date.<\/span><\/p>

Overwrite:<\/strong>\u00a0Overwrites the existing file. This will cause all the existing files to be deleted prior to\u00a0iAddress\u2122\u00a0running the job.<\/span><\/p>

Error:<\/strong>\u00a0Causes\u00a0iAddress\u2122\u00a0to trigger a fatal error before the job is run.<\/span><\/p>

-KEEP_IADDRESS_OPEN<\/strong><\/span><\/p>

Usage:<\/em><\/span><\/p>

-KEEP_IADDRESS_OPEN={Y(default),N}<\/span><\/p>

Example:<\/em><\/span><\/p>

iAddress.exe \u201cc:\\work\\config\\job1.cfg\u201d \u2013KEEP_IADDRESS_OPEN=N<\/span><\/p>

Description:<\/em><\/span><\/p>

This parameter controls whether\u00a0iAddress\u2122\u00a0remains open after the job is done.<\/span><\/p>

-J#<\/strong><\/span><\/p>

Usage:<\/em><\/span><\/p>

-J# [_FIELD_NAME]=[_FIELD_DATA]<\/span><\/p>

Example:<\/em><\/span><\/p>

  • exe \u201cc:\\work\\config\\job1.cfg\u201d \u2013J1<\/span><\/li>
  • exe “c:\\work\\config\\job1.cfg” -J1 -STANDARD_MAILING_DATE=2011-01-01 -F0 INPUT_FILE=C:\\foo\\file.xls<\/span><\/li><\/ul>

    Description:<\/em><\/span><\/p>

    This parameter represents a job number and must be specified for all _FIELDNAME=_FIELDDATA that is relevant to a Job. See “Important to note:” section above for more information on the usage of -J#. See also the config file options section for fieldnames and data.<\/span><\/p>

    \u00a0<\/span><\/p>

    -F#<\/strong><\/span><\/p>

    Usage:<\/em><\/span><\/p>

    \u00a0-F# [_FIELD_NAME]=[_FIELD_DATA]<\/span><\/p>

    Example:<\/em><\/span><\/p>

    • exe \u201cc:\\work\\config\\job1.cfg\u201d \u2013F0<\/span><\/li>
    • exe “c:\\work\\config\\job1.cfg” -J1 STANDARD_MAILING_DATE=2011-01-01 -F0 INPUT_FILE=C:\\foo\\file.xls<\/span><\/li><\/ul>

      Description:<\/em><\/span><\/p>

      This parameter represents a Merged file number and must be specified for all _FIELDNAME=_FIELDDATA that is relevant to a merged file. See “Important to note:” section above for more information on the usage of -F#. See also the config file options section for fieldnames and data.<\/span><\/p>

      -USDATE<\/strong><\/span><\/p>

      Usage:<\/em><\/span><\/p>

      \u00a0-USDATE<\/span><\/p>

      Example:<\/em><\/span><\/p>

      • exe \u201cc:\\work\\config\\job1.cfg\u201d \u2013USDATE<\/span><\/li><\/ul>

        Description:<\/em><\/span><\/p>

        This option creates a file in the execution path called “USDATE.tab”. \u00a0This file contains the start and end dates of the US mailing data currently loaded on your system. USDATE.tab is a tab delimited file. This information can be used to determine if you have the data for the mailing date that you have chosen.<\/span><\/p>

        -CADATE<\/strong><\/span><\/p>

        Usage:<\/em><\/span><\/p>

        \u00a0-CADATE<\/span><\/p>

        Example:<\/em><\/span><\/p>

        • exe \u201cc:\\work\\config\\job1.cfg\u201d \u2013CADATE<\/span><\/li><\/ul>

          Description:<\/em><\/span><\/p>

          This option creates a file in the execution path called “CADATE.tab”. \u00a0This file contains the start and end dates of the Canadian mailing data currently loaded on your system. CADATE.tab is a tab delimited file. This information can be used to determine if you have the data for the mailing date that you have chosen.<\/span><\/p>

          \u00a0<\/p>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t<\/section>\n\t\t\t\t<\/div>\n\t\t","protected":false},"excerpt":{"rendered":"

          Command Line Options \u00a0 iAddress\u2122 offers powerful automation functionality that allows for you to easily and flexibly automate your address management processes. Using job configuration files, you can specify all the details of how your job is run \u2013 from the input files to the correction parameters to the output files. By command line options, […]<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"elementor_header_footer","meta":{"site-sidebar-layout":"default","site-content-layout":"","ast-site-content-layout":"default","site-content-style":"default","site-sidebar-style":"default","ast-global-header-display":"","ast-banner-title-visibility":"","ast-main-header-display":"","ast-hfb-above-header-display":"","ast-hfb-below-header-display":"","ast-hfb-mobile-header-display":"","site-post-title":"","ast-breadcrumbs-content":"","ast-featured-img":"","footer-sml-layout":"","ast-disable-related-posts":"","theme-transparent-header-meta":"","adv-header-id-meta":"","stick-header-meta":"","header-above-stick-meta":"","header-main-stick-meta":"","header-below-stick-meta":"","astra-migrate-meta-layouts":"default","ast-page-background-enabled":"default","ast-page-background-meta":{"desktop":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"ast-content-background-meta":{"desktop":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"footnotes":""},"class_list":["post-1952","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/www.flagshipsoftware.com\/fsweb\/wp-json\/wp\/v2\/pages\/1952","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.flagshipsoftware.com\/fsweb\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/www.flagshipsoftware.com\/fsweb\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/www.flagshipsoftware.com\/fsweb\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.flagshipsoftware.com\/fsweb\/wp-json\/wp\/v2\/comments?post=1952"}],"version-history":[{"count":6,"href":"https:\/\/www.flagshipsoftware.com\/fsweb\/wp-json\/wp\/v2\/pages\/1952\/revisions"}],"predecessor-version":[{"id":8160,"href":"https:\/\/www.flagshipsoftware.com\/fsweb\/wp-json\/wp\/v2\/pages\/1952\/revisions\/8160"}],"wp:attachment":[{"href":"https:\/\/www.flagshipsoftware.com\/fsweb\/wp-json\/wp\/v2\/media?parent=1952"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}