コマンドライン

grandMA3 ユーザマニュアル » Workspace » User Interface » Command Line

Version 2.2

The main purpose of the command line is to display active command syntax as it is entered and to display any errors generated by failed syntax. The command line also includes several helpful status indicators and quick-access buttons to frequently used features.

By default, the command line is located at the bottom of screen 1. It can also appear at the bottom of screens 2, 3, 4, 5, 6, and 7.

*Command line as it appears on screen 7*

Show or Hide the Control Bar

Tap the left arrow at the left edge of the command line to show or hide the control bar along the left edge of the screen.

Open the Command Line History

To open a temporary window showing the Command Line History:

Tap MA on the left side of the command line

The Command Line History opens.

To close the window:

Tap MA once again

-or-

Tap in the upper right corner of the window

To open the window version of the Command Line History:

Open the Add Window dialog
Tap Common + Command Line History.

To show or hide the Command Line in the Command Line History window:

To open the Command Line History Window Settings, tap MA.
Enable Show Command Line.

To select a recent command in the command line history:

Tap and hold a recent command in the history. The command gets selected, a pop-up opens, and the Command Line History background turns red.
Select one of the following options from the pop-up:
1. Copy: Copies the command in the clipboard.
2. Execute Again: Executes the command again.
3. Copy and Overwrite to Command Line: Copies the command into the command line. Existing command line content will be discarded.
4. Add to Command Line: Copies the command to the end of existing command line content.
Tap Jump To Bottom to set the Command Line History to the latest entry.

	ヒント
	The pop-up can be opened by pressing Please or by pressing the screen encoder.

The Command Line History can display a maximum number of 2 048 lines.

詳しくは Add Window を参照してください。

Open the Virtual Keyboard

To open a temporary command line window with a virtual keyboard:

Tap on the left of the command line.

The window opens with a virtual keyboard.

To minimize the virtual keyboard:

Tap .

To close the virtual keyboard:

Tap in the upper right corner of the window.

To change the language on the keyboard:

To cycle through the languages, tap the key that displays the language, for example, English, on the keyboard. 詳しくは Keyboard Keyword を参照してください。

Information in the Command Prompt

The command prompt is the point where the entered syntax appears. The prompt ends with the '>' symbol, but it contains two pieces of helpful information before the symbol.

User Name
The user name of the logged in user appears first in the command prompt.
Default Keyword
The default keyword appears in square brackets after the user name. The console uses the displayed default keyword for any numerical syntax entered without a specified object keyword.

	重要
	It is possible to navigate through the directory structure of the console using the command line. In this case, the current location in the directory replaces the default keyword displayed in the command line. When returning to the root directory, the default keyword replaces the directory path display.

Change the Default Keyword

Possible default keywords of the command line can include:

	ヒント
	Some of the listed keywords can be customized. For more information, see Custom ID.

To change the default keyword:

Enter the desired keyword into the command line. For example, press the Channel key.
Press Please.

Set the Cursor in the Command Line

When entering command line syntax using a keyboard, it is necessary to bring the keyboard focus to the command line.

To set the cursor in the command line:

Tap the command line

- or-

Press Esc one or more times. Once all open menus and pop-ups are closed, the keyboard focus returns to the command line.

- or-

Press and hold MA and subsequently press Please

The cursor is set and starts blinking after the prompt and a white box surrounds the command line.

	ヒント
	A triangle symbol () appears if the prompt is longer than the command line.

詳しくは Command Syntax and Keywords を参照してください。

Power Status

On full-size, light, full-size CRV, and light CRV consoles, which are equipped with an internal battery backup, there is an indicator of power status on the right side of the command line. The battery percentage is always displayed at the bottom of the indicator. Status indications include the following states:

Power is connected and the battery is full.
Power is connected and the battery is not full.
Power is disconnected and the battery is discharging.

Battery Status Pop-up

Tap the power status indicator to open the Battery status pop-up.

The Battery status pop-up displays multiple relevant metrics about the battery as well as A/C power.

For more information about the Power Status, see UPS Battery.

Session Status and Quick Access to the Network Menu

An indicator of network session status appears on the right side of the command line. Tapping the indicator toggles the network menu open or closed. The color of the network icon indicates one of the following session states:

Red: Standalone
Black: Startup
Gray: IdleMaster
Light Blue: GlobalMaster
Green: Connected

For more information about networking, see the Networking topic.

Phaser Values Workload

The left bar between (network) and (message center) in the command line shows the current processing workload dedicated to phaser calculation.

To show the workload of phasers, a green indicator increases with the number of parameters with actively running phasers. The exact number of phasers used is displayed as a tooltip.

For more information on Phasers, see the Phasers topic.

FlowControl

The right bar next to the Phaser indicator shows the current workload of the network. The exact intensity of the flow control is displayed as a tooltip on a scale of 0 to 255.

	ヒント
	The Flow Control Level is also indicated in the Network menu. For more information, see Session.

Open the Message Center

The envelope icon () on the right side of the command line changes color to indicate new messages in the message center. The colors (red, orange, green) are based on the different message categories Spam, Warnings, Errors, and Alerts.

Tap to open a temporary version of the Message Center window.

To view specific information about a message category, tap it. A window opens with a timestamp, sender information, and message section.
To confirm all messages, tap Confirm. All current messages will be deleted.
To open the message center on another screen, tap .;
To close the message center, tap the message center icon in the command line once again or tap in the upper right corner of the window

A notification pop-up for System Errors, MA-Net Warnings, and all Chat messages will also be displayed in the upper right corner of all big screens.

Update this description text. — Notification pop-up.

These notifications have the same background color as the indication in the message center. Messages can have different priorities: Alert (), Error (), Spam (), Warning ().

To disable the message pop-up for all notifications, disable Notifications in the title bar of the message center.
Notification Type:
- To display notifications only for a span of 5 seconds, select Timed.
- To display the notifications permanently until closing them, select Permanent.

World Server Indicator

The globe icon on the right side of the command line changes color from black to green to indicate an active connection to the world server.

For more information on the world server, see the World Server topic.

Enable or Disable Keyboard Shortcuts

Tapping the keyboard icon, with the text "ShCuts" beneath it, on the right side of the command line toggles the keyboard shortcuts on or off.

A white color indicates that keyboard shortcuts are disabled.
A yellow color indicates that keyboard shortcuts are enabled.
A red color indicates that keyboard shortcuts are enabled but temporarily blocked by a menu requiring normal keyboard input.

For more information on keyboard shortcuts, see the Keyboard Shortcuts topic.

Show or Hide the View Bar

Tap the right arrow at the right edge of the command line to show or hide the bar of view buttons along the right edge of the screen.

Hidden Progress Bar

The process, e.g. when sending an update from a grandMA3 onPC station to a grandMA3 console, is indicated by a circle with a number in it on the right side of the command line. The number inside the circle indicates how many processes are running in the background.

Tap the circle to show or hide the regular progress bar.