lsassocmap Command

Purpose

Displays an association map.

Syntax

lsassocmap [-c association_class] [-h] [-TV] [endpoint…]

Description

The lsassocmap command displays the association classes available on a cluster, including the endpoints of each association. Names and endpoints of Common Information Model (CIM) association classes that are registered with the CIM resource manager are listed in table format, similar to the output of the lscondresp command.

If you specify the lsassocmap command without any parameters, it displays all of the association classes, endpoints, and roles. A role is the name of the class reference property in the association class definition. Roles can be used as parameters to the -o and -R flags of the lsrsrcassoc command to filter output. See lsrsrcassoc Command for more information.

The -c flag limits the associations displayed to only those provided by a specific association class. You can specify any number of classes by using the endpoint parameter; only associations containing those classes as references (endpoints) are displayed.

Parameters

endpoint…: Specifies one or more endpoint classes. Only association classes containing references to one of the endpoint classes are displayed.

Flags

-c association_class: Displays associations for association_class.
-h: Writes the command usage statement to standard output.
-T: Writes the command trace messages to standard error. For your software service organization use only.
-V: Writes the command verbose messages to standard output.

Standard output

When the -h flag is specified, this command usage statement is written to standard output. When the -V flag is specified, this command verbose messages are written to standard output.

Standard error

When the -T flag is specified, this command trace messages are written to standard error.

Exit status

0: The command ran successfully.
1: An error occurred with RMC.
2: An error occurred with the command-line interface (CLI) script.
3: An incorrect flag was specified on the command line.
4: An incorrect parameter was specified on the command line.
5: An error occurred with RMC that was based on incorrect command-line input.
6: The specified association class cannot be found.

Implementation specifics

This command is part of the rsct.exp.cimrm fileset, in the rsct.exp package on the AIX® Expansion Pack and the Reliable Scalable Cluster Technology (RSCT) package for the Linux® operating system.

Location

Item	Description
/opt/rsct/bin/lsassocmap

Examples

To display associations that are available in a cluster, enter the following command:

lsassocmap

The following output is displayed for the AIX platform:


Association Class              Role 1          Associator 1            Role 2         Associator 2           Node
cimv2.IBMAIX_RunningOS         Antecedent      IBMAIX_OperatingSystem  Dependent      IBMAIX_ComputerSystem  c175nf14
cimv2.IBMAIX_OSProcess         GroupComponent  IBMAIX_OperatingSystem  PartComponent  IBMAIX_UnixProcess     c175nf14
cimv2.IBMAIX_CSProcessor       GroupComponent  IBMAIX_ComputerSystem   PartComponent  IBMAIX_Processor       c175nf14
cimv2.IBMAIX_HostedFileSystem  GroupComponent  IBMAIX_ComputerSystem   PartComponent  CIM_FileSystem         c175nf14

The following output is displayed for other platforms:


Association Class             Role 1          Associator 1           Role 2         Associator 2          Node
cimv2.Linux_RunningOS         Antecedent      Linux_OperatingSystem  Dependent      Linux_ComputerSystem  c175nf14
cimv2.Linux_OSProcess         GroupComponent  Linux_OperatingSystem  PartComponent  Linux_UnixProcess     c175nf14
cimv2.Linux_CSProcessor       GroupComponent  Linux_ComputerSystem   PartComponent  Linux_Processor       c175nf14
cimv2.Linux_HostedFileSystem  GroupComponent  Linux_ComputerSystem   PartComponent  CIM_FileSystem        c175nf14