scheduler_console_client

Jobs configured in the IBM® EMM Scheduler can be listed and kicked off by this utility, if they are set up to listen for a trigger.

What to do if SSL is enabled

When the Marketing Platform web application is configured to use SSL, the JVM used by the scheduler_console_client utility must use the same SSL certificate that is used by the web application server on which the Marketing Platform is deployed.

Take the following steps to import the SSL certificate

  • Determine the location of the JRE used by the scheduler_console_client.
    • If JAVA_HOME is set as a system environment variable, the JRE it points to is the one used by the scheduler_console_client utility.
    • If JAVA_HOME is not set as a system environment variable, the scheduler_console_client utility uses the JRE set either in the setenv script located in the tools/bin directory of your Marketing Platform installation, or on the command line.
  • Import the SSL certificate used by the web application server on which the Marketing Platform is deployed to the JRE used by scheduler_console_client.

    The Sun JDK includes a program called keytool that you can use to import the certificate. Consult the Java™ documentation for complete details on using this program, or access the help by entering -help when you run the program.

  • Open the tools/bin/schedulerconsoleclient file in a text editor and add the following properties. These differ depending on the web application server on which Marketing Platform is deployed.
    • For WebSphere®, add these properties to the file.

      -Djavax.net.ssl.keyStoreType=JKS

      -Djavax.net.ssl.keyStore="Path to your key store JKS file"

      -Djavax.net.ssl.keyStorePassword="Your key store password"

      -Djavax.net.ssl.trustStore="Path to your trust store JKS file"

      -Djavax.net.ssl.trustStorePassword="Your trust store password"

      -DisUseIBMSSLSocketFactory=false

    • For WebLogic, add these properties to the file.

      -Djavax.net.ssl.keyStoreType="JKS"

      -Djavax.net.ssl.trustStore="Path to your trust store JKS file"

      -Djavax.net.ssl.trustStorePassword="Your trust store password"

If the certificates do not match, the Marketing Platform log file contains an error such as the following.

Caused by: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target

Prerequisites

The Marketing Platform must be installed, deployed, and running.

Syntax

scheduler_console_client -v -t trigger_name user_name

scheduler_console_client -s -t trigger_name user_name

Commands

-v

List the scheduler jobs configured to listen for the specified trigger.

Must be used with the -t option.

-s

Send the specified trigger.

Must be used with the -t option.

Options

-t trigger_name

The name of the trigger, as configured in the scheduler.

Example

  • List jobs configured to listen for a trigger named trigger1.

    scheduler_console_client -v -t trigger1

  • Execute jobs configured to listen for a trigger named trigger1.

    scheduler_console_client -s -t trigger1