Home
Administrator Guides
Administrator Guide
Unica Campaign utilities
Administrators use the Unica Campaign utilities to manage listeners, sessions, and flowcharts, and perform other important administrative tasks.
Unica Campaign session utility (unica_acsesutil)
Use the Unica Campaign session utility (unica_acsesutil) to perform the following tasks.
Manipulating table catalogs
You can use the Unica Campaign session utility to manipulate table catalogs outside of Unica Campaign.

Administrator Guides
- Administrator Guide
  - Unica Campaign administration overview
    The Settings menu provides access to most of the tasks that Unica Campaign administrators typically perform.
  - Security in Unica Campaign
    Security policies control user access to the objects and features in Unica Campaign.
  - Database table administration
    Unica Campaign administrators must perform initial one-time tasks and routine administration tasks that pertain to database tables.
  - Customizing campaigns
    Administrators can customize campaigns by using custom campaign attributes, initiatives, and products.
  - Offer template concepts
    Before administrators perform offer template management tasks, there are several important concepts to understand.
  - About audience level administration
    Unica Campaign is delivered with a single audience level called Customer. You can define any additional audience levels that you need. Audience levels let flowchart designers target specific groups, such as Households, in marketing campaigns.
  - Before you begin working with contact history
    Contact history is stored in the Unica Campaign system database in separate tables by audience level. Therefore, you need to set up audience levels before you begin working with contact history.
  - Response history administration
    Before you begin working with response history, you should read the audience level administration topics and set up required audience levels.
  - Monitoring and controlling flowchart runs
    Choose Campaign > Monitoring and use the All monitored runs page to view the status of all active flowcharts and suspend, resume, or stop flowchart runs.
  - Dimension hierarchy concepts
    A dimension hierarchy is a data construct that groups data into bins based on value ranges. Dimension hierarchies are the basis for a variety of reports.
  - Triggers administration
    Unica Campaign allows you to define inbound and outbound triggers that can be used in all flowcharts in a partition.
  - Unica Campaign log files
    Unica Campaign records information in several different log files.
  - JVM Parameters
  - About codes in Unica Campaign
    Each campaign, cell, offer, and treatment in Unica Campaign has an identifying code that is generated by code generators, and conforms to a specified format.
  - Accessing the Advanced settings
    When a flowchart is open for editing, administrators can choose the Advanced settings option on the Admin menu to make administrative changes that affect only the current flowchart.
  - Unica Campaign integration with other products
    Unica Campaign optionally integrates with a number of other products.
  - Unica Campaign listeners
    The listener is a key component of Unica Campaign. It provides an interface between front-end clients and back-end analytical server processes.
  - Unica Campaign utilities
    Administrators use the Unica Campaign utilities to manage listeners, sessions, and flowcharts, and perform other important administrative tasks.
    - Unica Campaign advanced search utility (advSrchUtil)
      Unica Campaign v10 introduces the ability to search flowcharts. However, flowcharts are not searchable until you index them. Use advSrchUtil to index all flowcharts in the specified partition.
    - Unica Campaign advanced search agent (advSrchAgent)
      Use advSrchAgent to automatically index flowcharts and make them available for the search function whenever flowcharts are modified.
    - Unica Campaign Listener Shutdown utility (svrstop)
      Use the Unica Campaign listener shutdown utility (svrstop) to shut down the Unica Campaign listener or the Unica Optimize listener.
    - Unica Campaign Server Manager (unica_svradm)
      The Unica Campaign Server Manager (unica_svradm) is a command-line server management utility.
    - Unica Campaign session utility (unica_acsesutil)
      Use the Unica Campaign session utility (unica_acsesutil) to perform the following tasks.
      - Unica Campaign session utility syntax
        Use the following syntax and options to run the Unica Campaign session utility. The unica_acsesutil utility operates on the .ses file.
      - Exporting and importing objects between servers
        Use unica_acsesutil to export and import campaigns, sessions, and flowcharts from one server to another.
      - Backing up sessions
        Use the Unica Campaign session utility (unica_acsesutil) to back up sessions.
      - Updating record counts and lists of distinct values
        Use the Unica Campaign session utility (unica_acsesutil) to update record counts or lists of distinct values, as well as to schedule automatic re-computation of those counts.
      - Manipulating table catalogs
        You can use the Unica Campaign session utility to manipulate table catalogs outside of Unica Campaign.
      - Documenting catalog contents
        You can use unica_acsesutil to generate an XML format report, or to print table mappings.
    - Unica Campaign cleanup utility (unica_acclean)
      Use the cleanup utility (unica_acclean) to identify and clean up temporary files and database tables in the current partition. The cleanup utility can be used on the Unica Campaign system tables database and user table databases.
    - Unica Campaign report generation utility (unica_acgenrpt)
      The unica_acgenrpt command-line report generation utility exports a flowchart cell report from a specified flowchart. The report is generated from the flowchart's .ses file.
    - Database testing utilities
      Unica Campaign provides several command-line database testing utilities that you can use to test connections to a target database, execute queries, and perform a variety of tasks.
  - Configuring the ACOOptAdmin tool
    Configure the ACOOptAdmin tool to run Unica Optimize sessions from the command line.
  - Non-ASCII data in Unica Campaign
    Unica Campaign supports the use of localized data and non-United States locales, including multiple user-preferred locales within the same installation of the application.
  - Configuration properties for Unica Campaign
    The configuration properties of Unica Campaign are located at SettingsConfiguration. For more details on the configuration properties, see the Campaign Administrator Guide.
  - About special characters
    Some special characters are not supported in any Unica Campaign object names. In addition, some objects have specific naming restrictions.
  - Introduction to character encodings
    This section provides information on character encodings and language-sensitive database considerations, and lists the encodings supported by Unica Campaign.
  - About Unica Campaign Error Codes
    Unica Campaign notifies users of error events when they occur with error messages that consist of a code number and error text.
  - Troubleshooting
- System Tables

Manipulating table catalogs

You can use the Unica Campaign session utility to manipulate table catalogs outside of Unica Campaign.

A common use of XML table catalogs is to perform global search and replace of data source names, for example to convert a table catalog developed for use against a test database, so that it works against a production database. In this case, you can export the table catalog as XML, perform global search and replace as needed, then save the XML table catalog and load it for use.

Step 1 - Convert to XML format

You use the Unica Campaign session utility only for the first step of this process, which is to generate an XML format file that contains all the data from the requested catalog. If the catalog is already in an XML format, this step is not required.

Use the command:


unica_acsesutil -t catFileName -x [-o outputFileName] [-u] [-p] 
[{-a | -n | -l}][-S dataSource -U DBUserName -P DBPassword]

Step 2 - Edit as needed

You can now edit the XML file generated in step 1 as needed. To ensure that the file remains well formed, you should use an XML editor that checks the file syntax.

Step 3 (optional) - Convert to binary format

If required, you can convert the XML catalog file back to a binary format catalog.

Use the command:

unica_acsesutil -t <catFileName> -x -o <outputFileName>

Note: Keeping catalogs in XML format risks exposing data access passwords. If you maintain catalogs in XML format, you should ensure that the file(s) are protected at the operating system level.

Step 4 - Load the new catalog in a session

Are conversion back into a binary format, you can now load the new catalog into a session.

Have feedback?
Google Analytics is used to store comments and ratings. To provide a comment or rating for a topic, click Accept All Cookies or Allow All in Cookie Preferences in the footer of this page.