Skip to main content
Previous sectionNext section


Define the format of the terminal prompt.


[Startup]    TerminalPrompt=n


TerminalPrompt is a comma-separated string of values (0–8) which set the default terminal prompt for the instance. The default is 8,2.

The order of the values in the string determines the order the values appear in the prompt. For example

Copy code to clipboard

gives you a terminal prompt of %SYS:HostName>

  • 0 - Simple prompt. Specify 0 with no other values to use only “>” for the prompt.

  • 1 - Host name, also known as the current system name. The name assigned to your computer. For example, LABLAPTOP>. This is the same for all of your terminal processes.

  • 2 - Namespace name. For example, %SYS>. The current namespace name is contained in the $NAMESPACE special variable. It can be an explicit namespace name or an implied namespace name.

  • 3 - Config name. The name of your instance. For example, IRIS2>. This is the same for all of your terminal processes.

  • 4 - Current time, expressed as local time in 24-hour format with whole seconds. For example, 15:59:36>. This is the static time value for when the prompt was returned. This value changes for each prompt.

  • 5 - The Process ID for your terminal. For example, 2336>. This is different for each terminal process. This value can also be returned from the $JOB special variable.

  • 6 - Username. For example, fred>. This is the same for all of your terminal processes.

  • 7 - Time elapsed executing the last command, in seconds.milliseconds. For example, .000495>. Leading and trailing zeros are suppressed. This changes for each prompt.

  • 8 - Transaction Level. For example, TL1>.

Changing This Parameter

On the Startup page of the Management Portal (System Administration > Configuration > Additional Settings > Startup), in the TerminalPrompt row, select Edit. Enter a comma-separated string of values, or 0.

Instead of using the Management Portal, you can change TerminalPrompt in the Config.Startup class (as described in the class reference) or by editing the CPF in a text editor (as described in the Editing the Active CPF section of the “Introduction to the Configuration Parameter File” chapter in this book).