"Where am I?" - Adding extra information to the Terminal prompt
If you deal with multiple instances of Caché / Ensemble / HealthShare and sometimes have to work at the Terminal command prompt, did you know that you can easily add extra information to that prompt which may help prevent you running a command on the wrong instance?
The format of the command prompt is controlled by the TerminalPrompt setting in the [Startup] section of the CPF but it is normally manipulated via Portal. The documentation is here.
The default prompt looks like this:
USER>
USER>; TerminalPrompt="8,2"
The 2 is what provides the namespace name. Most of the time the 8 adds nothing, but you can see its effect by starting a transaction or two, then ending them:
USER>tstart
TL1:USER>tstart
TL2:USER>tcommit
TL1:USER>tcommit
USER>
When working with multiple instances, perhaps across different servers, setting TerminalPrompt="8,1,3,2" may be useful:
Node: TIN, Instance: ENS171
TIN:ENS171:USER>
TIN:ENS171:USER>; TerminalPrompt="8,1,3,2"
To check new prompt $system.Process method can be used:
Here's a description of all possible values. For me 4 (Current time) is very useful as it allows for a quick performance tracking.
And if you want to make your own prompt, you could even use your own Shell routine :
For {
Try {
Write !,$$Prompt()
Read cmd Write !
Xecute cmd
} Catch {
Write $ZE,!
}
If ($ZCVT($G(cmd),"U")="QUIT") Quit
}
Quit
Prompt() ;Create your own prompt here !
New prompt
Set prompt = $ZDate($H,4)_" - "_$ZTime($P($H,",",2))_" > "
Quit prompt
Be aware that by fetching $H twice there's a small possibility of an unwanted outcome. For example, consider what happens if the first time it returns "64382,86399" and the second time "64383,0". Harmless in Danny's prompt code, but in other contexts it could cause problems.