 |
Index for
Section 1 |
|
 |
Alphabetical
listing for I |
|
 |
Bottom of
page |
|
imcs(1)
NAME
imcs - Reports on Memory Channel status
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 the Memory Channel API.
PVM Region was created using the Compaq Parallel Virtual
Machine (PVM).
ID Identifier that uniquely identifies the Memory Channel region.
KEY Application-specific key that refers to the Memory Channel
region.
SIZE 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 currently unused.
OWNER User name of the owner of the region or lock set.
GROUP 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 Number of locks available in the lock set.
EXAMPLES
1. The following imcs command, with no flags specified, displays details
of Memory Channel API cluster members, active Memory Channel regions,
and Memory Channel lock sets:
/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
2.
In the following example, the -f flag is used with the imcs command.
This command displays the logical rail used under the RAIL heading and
the coherency of each allocated region under the FLAG heading, in
addition to the details displayed in the previous example. Possible
values under the FLAG heading are as follows:
+ Coherent
+ Point-to-point
+ Point-to-point coherent
+ Non-coherent
/usr/sbin/imcs -f
3.
/usr/sbin/imcs -s
In the following example, the -s flag is used with the imcs command.
This command displays details of Memory Channel API cluster members,
Memory Channel API statistics, Memory Channel API overhead, and Memory
Channel rail usage:
Memory Channel API Version V5.0-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
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 Server Highly Available Applications
|
Index for
Section 1 |
|
|
Alphabetical
listing for I |
|
 |
Top of
page |
|