Configuration Tab › Mapping for Configuration Browser Tabs › Modules › Utilities

Utilities

The Utilities module configuration has one tab. The Default Invoke Java Operator Properties tab sets the default property values for the Invoke Java operators.

Use Strict Java Mode?

Specifies whether to enforce typed variable declarations, method arguments, and return types in the main method of the Invoke Java operator at runtime.

Values: This property can have one of the following values:

• Selected: Enforces typed variable declarations, method arguments, and return types in the main method at runtime.
• Cleared: Does not enforce typed variable declarations, method arguments, and return types in the main method at runtime.

Default: Selected.

CA Process Automation executes the main method code of the operator in a BeanShell interpreter, which supports BeanShell scripting syntax and Java syntax. When you select this field, the BeanShell interpreter runs under the Strict Java Mode, which:

• Enforces typed variable declarations, method arguments, and return types.
• Modifies the scoping of variables to look for the variable declaration first in the parent namespace. For example, a Java method inside a Java class.

Note: Many BeanShell commands do not work in Strict Java Mode.

External Jar Paths

Defines the paths to the external jars that the product loads by default when an Invoke Java operator runs on an agent.

Important: To load the JAR files, define a separate path for each file that ends with that JAR file name. To load .class files, define the path to the appropriate directory. The .class files can be in the directory. The location depends on whether this package is a named package or an unnamed package.

Paths have the following syntax rules:

• With one of the following formats, enter the full path to the JAR file that resides on the agent host:
  • Start the path with ‘/’.
  • Start the path with ‘\\’.
  • With the form: ‘^.:.*’ (caret, period, colon, period, asterisk)

    Use this form for a regular expression that starts with one character followed by a colon - : - and then the rest of the string.

    A regular expression in the form x:string, where x is a single character.

• With one of the following formats, enter the full path to a JAR file that you can download over HTTP (basic) or HTTPS (secure):
  • Start the path with 'http://'.
  • Start the path with 'https://'.

  Note: Verify that the specified path does not require an authentication and does not go through an HTTP proxy.

• Enter the relative path to a JAR file that you uploaded using the User Resources folder in the Manage User Resources palette. The product appends the JAR file path to the User Resources directory path of the agent that runs the Invoke Java operator.

  Note: The product addresses any path that does not start with / or \\, is not of the form ^.:.*, or that does not start with http or https as a relative path.

Use Default Logger?

Specifies whether to use an instance of a logger object to log data to the log file.

Values: This property can have one of the following values:

• Selected: Log data to the log file. The logger opens and closes the file. The logger is available in the context of the main method code of the Invoke Java operator. The logger can be used as 'logger.debug()', 'logger.info', and so on.
• Cleared: Do not log data to the log file.

Default: Cleared

Log File Path

Defines the path to the log file that the logger uses. This path points to a file that resides on a CA Process Automation agent host.

Log Level

Specifies the level at which to log data. Each log level prints messages for that level and all levels above it. For example, WARN prints WARN, ERROR, and FATAL messages.

Values: This property can have one of the following values:

• 0: DEBUG
• 1: INFO
• 2: WARN
• 3: ERROR
• 4: FATAL

Default: 0: DEBUG

Append to Default Log File?

Specifies whether to append new log messages to the default log file or to overwrite old logs with the new logs.

Values: This property can have one of the following values:

• Selected: Append new log messages to the default log file.
• Cleared: Delete the contents of the existing default log file before writing the new log messages.

Default: Cleared

Default Log Data Without Logging Info?

Specifies whether the logger writes log messages with or without the following prefix:

Day Month Year Hours:Minutes:Secs Logo_level [UUID of the Invoke_Java operator]:

Values: This property can have one of the following values:

• Selected: Exclude the prefix from all log messages.
• Cleared: Include the prefix with each log message.

Default: Cleared