MSGB(1)
USER COMMANDS
MSGB(1)
NAME
msgb - display locking status of cluster nodes

SYNOPSIS
msgb [-group scoreboard-group] [-server host[:port]] [-title title-name] [-small]

DESCRIPTION
msgb displays the locking status of cluster nodes maintained by the Compute Host Lock Server, msgbserv(8). The Compute Host Lock Server keeps track of the cluster status so cluster users may occupy cluster nodes exclusively.

The options available for msgb:

-group scoreboard-group
Specifies the node group to monitor. scoreboard-group must be defined in the scorehosts.db configuration file used by scoreboard(8). The shell environment variable SCBDSERV must be set to access the Cluster Database server

-server host[:port]
Specifies the Compute Host Lock Server hostname (and its port number if specified). If this argument is not specified, the value of the shell environment variable MSGBSERV is taken as the hostname (and the port number, if any), or the hostname and port are found by accessing scoreboard(8) if the -group option is specified

-title title-name
Set the title of the window

-small
Display the status of nodes in small, unnamed cells. Clicking the left mouse-button in the cell causes detailed information to pop up

The msgb program displays each cluster node as a cell in a matrix. The color of the cell determines the status of the node. Unlocked nodes are shown in blue. Locked nodes are shown in red.

The user id of who locked the node, the time when the node was locked, and the node name are displayed in succession.

Clicking the right mouse-button causes a menu to pop up. Each menu item is described below:

Height
Selects the number of rows of nodes displayed in the window

Autoraise
Whether to raise the window when the cluster node status changes

Blink
The interval between displaying each item of node information

Save Setting
Save the above settings to the file $HOME/.msgbrc

Quit
Quit the program

If the grid is toggled to a small size, then pressing the left mouse-button will display the hostname of the node in a pop-up window. If the node is locked then the used id of the account that locked the node, together with the hostname and date where the command was executed are also displayed.

ENVIRONMENT
MSGBSERV
Set MSGBSERV if you will not use the -server or -group options
SCBDSERV
Set SCBDSERV for the -group option to access the Cluster Database server

FILES
$HOME/.msgbrc
Configuration file for msgb display settings
(INSTALL_DIR)/etc/scorehosts.db
Cluster Database configuration file

SEE ALSO
msgbserv(8), scorehosts.db(5), scoreboard(8), scout(1), scrun(1)
CREDIT
This document is a part of the SCore cluster system software developed at PC Cluster Consortium, Japan. Copyright (C) 2003 PC Cluster Consortium.