grandMA3 User Manual Publication

grandMA3 onPC Terminal App

grandMA3 User Manual » grandMA3 onPC » onPC Terminal App
Version 2.5

The grandMA3 Terminal app connects to the Command Line or System Monitor of grandMA3 onPC running on the same computer or another grandMA3 station on the network.

Use the command line to enter grandMA3 commands. The system monitor provides read-only access to diagnostic messages and is generally used for troubleshooting at the request of technical support. For routine system information, use the Message Center.

To connect:

  1. Start the grandMA3 Terminal app.
  2. Enter one of the following commands:
    • To connect to the command line, enter cmdline [IP Address].
    • To connect to the system monitor, enter sysmon [IP Address].
    Replace [IP Address], including the brackets, with the IP address of the target station. To connect to grandMA3 onPC running on the same computer, use 127.0.0.1.
  3. Press Enter on Windows or Return on macOS.

grandMA3 Terminal App on Windows®

After installing grandMA3 onPC on Windows, the grandMA3 Terminal app is available in the MA Lighting folder in the Start menu.

Windows Start menu showing the grandMA3 Terminal app in the MA Lighting folder.
grandMA3 Terminal app in the Windows Start menu

If selected during installation, a shortcut to the grandMA3 Terminal app is also available on the desktop.

Windows desktop showing shortcuts to grandMA3 onPC and the grandMA3 Terminal app.
grandMA3 Terminal app shortcut on the Windows desktop

grandMA3 Terminal App on macOS®

To start the grandMA3 Terminal app on macOS, open the Applications folder and launch grandMA3 Terminal x.x.x.x. The version number identifies the corresponding version of the app.

Applications folder on macOS showing grandMA3 Terminal 2.5.0.3.
grandMA3 Terminal 2.5.0.3 in the Applications folder
Hint:
In grandMA3 versions prior to version 2.5.0.3, start grandMA3 onPC before starting the grandMA3 Terminal app on macOS.
Earlier grandMA3 launcher on macOS showing the grandMA3 Terminal button.
grandMA3 Terminal button in the earlier macOS launcher

System Monitor Example

  1. Start the grandMA3 Terminal app.
  2. Enter sysmon 192.168.211.61.
  3. Press Enter on Windows or Return on macOS.

The grandMA3 Terminal app displays system monitor messages from the station at 192.168.211.61. This connection is read-only.

grandMA3 Terminal app showing system monitor output after the sysmon command.
System monitor output in the grandMA3 Terminal app

Command Line Example

  1. Start the grandMA3 Terminal app.
  2. Enter cmdline 192.168.211.61.
  3. Press Enter on Windows or Return on macOS.

The grandMA3 Terminal app displays the command prompt of the station at 192.168.211.61. Enter grandMA3 commands and view their responses.

grandMA3 Terminal app showing the command prompt and command responses after the cmdline command.
Command prompt and responses in the grandMA3 Terminal app