Skip to main content

Data & Intelligence

IBM Cognos TM1 – ExecuteProcess

Another advanced (and handy) feature to be aware of is the TurboIntegrator ExecuteProcess function.

This is a very useful function. It allows you to execute a TI process from within a TI process. (Obviously, you cannot have a process call itself).

The format is as follows:

• ExecuteProcess(ProcessName, [ParamName1, ParamValue1, ParamName2, ParamValue2]);

The function will return a real value that you should always test for an acceptable return code value (and do something appropriate based upon this value).

The most important return values to know are as follows:

Data Intelligence - The Future of Big Data
The Future of Big Data

With some guidance, you can craft a data platform that is right for your organization’s needs and gets the most return from your data capital.

Get the Guide

• ProcessExitNormal(): If your ExcuteProcess returns this, it indicates that the process executed normally.

• ProcessExitMinorError(): If your ExcuteProcess returns this, it indicates that the process executed successfully but encountered minor errors.

• ProcessExitByQuit(): If your ExcuteProcess returns this, it indicates that the process exited because of an explicit quit command.

• ProcessExitWithMessage(): If your ExcuteProcess returns this, it indicates that the process exited normally, with a message written to Tm1smsg.log.

• ProcessExitSeriousError(): If your ExcuteProcess returns this, it indicates that the process exited because of a serious error.


A very simple example of using ExecuteProcess and checking the return code value would be:

returnvalue = ExecuteProcess(‘load_surfboard_daily_sales’);

if (returnvalue = ProcessExitSeriousError() )  

   ASCIIOutput(ExcpetionFile, sSeriousErrorMsg);


You can read more about IBM Cognos TM1 scripting in my book, “IBM Cognos TM1 Developer’s Certification Guide [Paperback]“.

Thoughts on “IBM Cognos TM1 – ExecuteProcess”

  1. Great post,
    It’s worth noting that Windows UAC will block TM1 from performing certain operations. E.g. in Server 2008 it’s pretty hard to get TM1 to stop or start a service like advisor or EV

Leave a Reply

Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.

Jim Miller

Mr. Miller is an IBM certified and accomplished Senior Project Leader and Application/System Architect-Developer with over 30 years of extensive applications and system design and development experience. His current role is National FPM Practice Leader. His experience includes BI, Web architecture & design, systems analysis, GUI design and testing, Database modeling and systems analysis, design, and development of Client/Server, Web and Mainframe applications and systems utilizing: Applix TM1 (including TM1 rules, TI, TM1Web and Planning Manager), dynaSight - ArcPlan, ASP, DHTML, XML, IIS, MS Visual Basic and VBA, Visual Studio, PERL, Websuite, MS SQL Server, ORACLE, SYBASE SQL Server, etc. His Responsibilities have included all aspects of Windows and SQL solution development and design including: analysis; GUI (and Web site) design; data modeling; table, screen/form and script development; SQL (and remote stored procedures and triggers) development and testing; test preparation and management and training of programming staff. Other experience includes development of ETL infrastructure such as data transfer automation between mainframe (DB2, Lawson, Great Plains, etc.) systems and client/server SQL server and Web based applications and integration of enterprise applications and data sources. In addition, Mr. Miller has acted as Internet Applications Development Manager responsible for the design, development, QA and delivery of multiple Web Sites including online trading applications, warehouse process control and scheduling systems and administrative and control applications. Mr. Miller also was responsible for the design, development and administration of a Web based financial reporting system for a 450 million dollar organization, reporting directly to the CFO and his executive team. Mr. Miller has also been responsible for managing and directing multiple resources in various management roles including project and team leader, lead developer and applications development director. Specialties Include: Cognos/TM1 Design and Development, Cognos Planning, IBM SPSS and Modeler, OLAP, Visual Basic, SQL Server, Forecasting and Planning; International Application Development, Business Intelligence, Project Development. IBM Certified Developer - Cognos TM1 (perfect score 100% on exam) IBM Certified Business Analyst - Cognos TM1

More from this Author

Follow Us