Home / System Administration Guide / Using Multiple Instances of InterSystems IRIS / Connecting to an InterSystems IRIS Instance

System Administration Guide
Connecting to an InterSystems IRIS Instance
Previous section           Next section
InterSystems: The power behind what matters   

Connecting to an InterSystems IRIS Instance
Once you have started InterSystems IRIS, you can log into InterSystems IRIS on the command line using the iris session command, as follows:
iris session <instname> [arguments]
where instname is the name of the instance that you are managing, and [arguments] indicates one or more of the optional arguments described in the following table. On a Windows system, you must execute the command from its location, the install-dir\bin directory of an InterSystems IRIS instance, or include the full path in the command, for example:
c:\InterSystems\IRIS27\bin\iris session IRIS4
As shown in the preceding example, the instance name you specify can be different from the instance of the iris session binary you are executing, but is always required, even if they are the same.
InterSystems IRIS iris session Command and Arguments
Command Description
iris session instname -B
Provides system administrator emergency login.
To execute an emergency startup on Windows, you must open the Command Prompt using the Run as Administrator option. See also Emergency Access in the “System Management and Security” chapter of the Security Administration Guide for information about starting and logging into InterSystems IRIS in emergency access mode.
iris session instname -U namespace Specifies the login namespace.
-U has no effect if you are starting InterSystems IRIS with a user account whose Startup Namespace is specified (see Properties of Users in the “Users” chapter of the Security Administration Guide).
iris session instname -b partition_size Specifies the maximum partition size (in KB) for the process.
iris session instname "[label[+offset]]^routine"
Specifies the name of a COS program to run in user mode.
In addition to the specified formats, you can pass parameter lists consisting of string and/or numeric literals, as well as omitted (void) parameters, as follows:
where, for example, parameter-list is specified in the form "string literal",,-+-000123.45600E+07, and omitted parameters are passed to the target as $Data(parameter)=0.
Whitespace and shell meta characters must be quoted in an operating-system dependent form.
To use the iris session command or the iris command (see Controlling InterSystems IRIS Instances) on a remote server, use iris session or Terminal, or a remote connection through Terminal or Telnet/ssh client.

Previous section           Next section
View this book as PDF
Copyright © 1997-2019 InterSystems Corporation, Cambridge, MA
Content Date/Time: 2019-03-17 22:37:05