 |
Index for
Section 1 |
|
 |
Alphabetical
listing for I |
|
 |
Bottom of
page |
|
imcs(1)
NAME
imcs - Reports on Memory Channel status
LIBRARY
Memory Channel API library (libimc.a) (provided in Production Server and
Memory Channel Software configurations)
SYNOPSIS
/usr/sbin/imcs [-m] [-l] [-r] [-f] [-h] [-s]
FLAGS
-m Displays the names of all hosts that have initialized the Memory
Channel Application Programming Interface (API).
-l Displays information about all lock sets in use in the Memory
Channel API cluster.
-r Displays information about all allocated regions in the Memory
Channel API cluster.
-f Displays full Memory Channel status information.
-h Displays a user help message on the imcs command.
-s Displays Memory Channel statistics and rail usage.
DESCRIPTION
The imcs command writes information to the standard output about currently
active Memory Channel facilities. The details displayed vary according to
the flags used with the command. If no flags are specified, the imcs
command displays the names of all Memory Channel API cluster members, and
information about active Memory Channel regions and Memory Channel lock
sets.
The information is displayed as a list of regions or lock sets under the
following headings:
Type The type of the subsystem that created the region. Possible
values are:
IMC Region was created using Memory Channel API.
PVM Region was created using Compaq's Parallel Virtual
Machine (PVM).
ID An identifier which uniquely identifies the Memory Channel
region.
KEY An application-specific key that refers to the Memory Channel
region.
SIZE The size, in bytes, of the Memory Channel address space region
allocated.
MODE The access mode of the region or lock set. The access mode
consists of nine bits and is similar to the UNIX permission
convention, except that there is no execute bit. There are three
sets of three bits each. The first set of three bits refers to
the owner's permissions; the next set refers to permissions of
others in the user group of the region; and the last set refers
to all other permissions.
Within each set of three bits, the first character indicates
permission to read the region, the second character indicates
permission to write to the region, and the last character is
currently unused. The permissions are indicated as follows:
r Read permission is granted
w Write permission is granted
- This character is not used at present
OWNER The username of the owner of the region or lock set.
GROUP The group of the owner of the region or lock set.
RAIL Specifies the Memory Channel logical rail used for the region.
The first logical rail is numbered 0, the second logical rail is
numbered 1, and so on, up to a maximum defined by a constant,
IMC_MAXRAILS.
FLAG Specifies whether an allocated region was created as coherent,
point-to-point, point-to-point coherent, or non-coherent. Flags
apply only to Memory Channel regions, not to locks.
NLOCKS The number of locks available in the lock set.
EXAMPLES
1. /usr/sbin/imcs
Memory Channel Cluster Members:
member1.mydmn.myorg
member2.mydmn.myorg
member3.mydmn.myorg
Memory Channel Regions:
Type ID KEY SIZE MODE OWNER GROUP
IMC 1740 5634309 204800 rw-rw-rw- user1 users
IMC 1686 5634307 204800 rw-rw-rw- user2 users
IMC 1627 5634306 483228 rw-rw-rw- user2 users
IMC 1626 5634305 8192 rw-rw-rw- user3 users
PVM 1576 17231442411520 393216 rw-rw-rw- user4 users
IMC 612 611 4382720 r-------- user5 users
Memory Channel Lock Sets:
Type KEY MODE OWNER GROUP NLOCKS
IMC 37231 rw-rw-rw- user1 users
PVM 17231442345984 rw-rw-rw- user2 users
IMC 612 ------rw- root users
When the imcs command is entered with no flags specified, details of
Memory Channel API cluster members, active Memory Channel regions, and
Memory Channel lock sets are displayed, as shown in this example.
2. /usr/sbin/imcs -f
When the -f flag is used with the imcs command, the logical rail used
is displayed under the RAIL heading, and the coherency of each
allocated region is displayed under the FLAG heading, in addition to
the details displayed in the previous example. Possible values under
the FLAG heading are:
+ Coherent
+ Point-to-point
+ Point-to-point coherent
+ Non-coherent
3. /usr/sbin/imcs -s
Memory Channel API Version V1.6-0
Memory Channel Cluster Members:
member1.mydmn.myorg (0)
member2.mydmn.myorg (2)
Memory Channel API Statistics:
Total regions allocated: 11
Total lock sets allocated: 1
Memory Channel API Overhead (MB) 0.21
Maximum Clusterwide allocation (MB) 10.00
Current Clusterwide allocation (MB) 0.09
Maximum Receive attaches on this host (MB) 10.00
Current Receive attaches on this host (MB) 0.09
Memory Channel Rail Usage:
Rail State Allocates Rx Attaches Tx Attaches
0 Active 42 42 22
When the -s flag is used with the imcs command, details of Memory
Channel API cluster members, Memory Channel API statistics, Memory
Channel API overhead, and Memory Channel rail usage are displayed, as
shown in this example.
RELATED INFORMATION
Introduction: imc(3)
Command: imc_init(1)
Functions: imc_api_init(3), imc_asalloc(3), imc_asattach(3),
imc_asattach_ptp(3), imc_lkacquire(3), imc_lkalloc(3)
TruCluster Software Products Memory Channel Application Programming
Interfaces
|
Index for
Section 1 |
|
|
Alphabetical
listing for I |
|
 |
Top of
page |
|