Project Sheet

TM1 Tool Configuration

The old paradigm is out. The new paradigm is AI. AI automation is InTouch AI. Complete reference for configuring TM1 tools — Chores and TurboIntegrator Processes — inside a general engine that runs them, watches them, and heals them when they break.

The TM1 Tool provides two tools for automating IBM TM1 and Planning Analytics operations. Both include InTouch AI's fanatical session management that never leaves dangling connections.

A single-purpose TM1 scripting tool can run a chore. It can't read the failure, refresh an expired session, smart-retry, and tell you the one sentence that matters. A general AI-native engine can do everything that specialized tool does — and the reverse is impossible, because you can't grow an AI core onto a config-era utility. TM1 here isn't a bolted-on connector. It's one capability sitting behind an engine that was built with AI at the center: the contract is now intelligent. "It broke. Here's why. I fixed it." No legacy TM1 scheduler can say that.

1. Run Chore Tool

Execute TM1 chores with automatic session management. Chores are server-side processes that can contain multiple TurboIntegrator processes and are managed through the TM1 server.

ParameterDescriptionRequired
ConnectionTM1 REST connection object (encrypted credentials)Yes
Chore NameName of the TM1 chore to executeYes
TimeoutMaximum wait time for chore completion (seconds)No (default: server default)
Wait for CompletionWait for chore to finish or fire-and-forgetNo (default: wait)

2. Run TurboIntegrator Process Tool

Execute one or more TI processes with dynamic parameter overrides. Run processes sequentially with different parameter values for each — ideal for parameterized data loads and processing.

ParameterDescriptionRequired
ConnectionTM1 REST connection objectYes
Process NameTurboIntegrator process name to executeYes
ParametersList of parameter name/value overrides for the TI processNo
Multiple ProcessesExecute multiple TI processes in sequence within one toolNo
TimeoutMaximum execution time per process (seconds)No
Stop on ErrorHalt the sequence on first error or continueNo (default: yes)

Session Management

Fanatical Session Management — Never Leaves Dangling Sessions

Dangling TM1 sessions are a critical operational problem. They cause severe server performance degradation, prevent users from logging in, and ultimately force server restarts that disrupt the entire organization.

InTouch AI manages TM1 sessions with obsessive precision:

Automatic Session Creation

Sessions are created only when needed and authenticated using encrypted credentials from the connection object. No credentials in scripts or config files.

Guaranteed Cleanup

Sessions are properly closed after every operation — whether the tool succeeds, fails, times out, or encounters any error. No exceptions, no dangling sessions.

Error Recovery

Even when TM1 returns unexpected errors or the network connection drops, InTouch AI ensures the session is properly terminated before exiting.

Timeout Protection

If a process exceeds the configured timeout, InTouch AI forcefully terminates the operation and still properly cleans up the session.

Connection Configuration

TM1 connections are configured as reusable, centralized objects with encrypted credentials. This is the trust floor: AES-256, referenced by name, never written into a script, never exposed even to the AI itself.

REST API Endpoint
TM1 server URL (https://host:port/api/v1)
Authentication
Encrypted username and password
SSL/TLS
Configurable SSL settings and certificate trust
Connection Validation
Pre-execution connectivity test
Access Control
Role-based access determines who can use each connection
Credential Rotation
Update one connection object — all tools use new credentials

Common Configuration

Error Handling

TM1 error codes, process error logs, and TI minor/major error statuses are all captured. Automatic notifications on failure with full diagnostic details.

Scheduling

Trigger TM1 tools on any of 7 native schedule types, file arrivals, API calls, condition-driven Monitors, or after upstream tools. Coordinate TM1 operations with SQL loads, file transfers, and other tools.

Logging & Audit

Every execution is logged with timestamps, TI process return codes, parameter values used, and session lifecycle events. Complete audit trail.

Multi-System Orchestration

Chain TM1 tools with SQL Tool, DataFrame, and Essbase tools. Build cross-platform workflows: extract from database, transform, load into TM1.

Stop Babysitting TM1 Chores

Run them on a general engine that reads the failure, heals the session, and surfaces only what matters. AI-native, not AI-retrofitted.

View TM1 Tool Product Page