scha_resourcegroup_get(1HA)				       Sun Cluster Commands				       scha_resourcegroup_get(1HA)

NAME

       scha_resourcegroup_get - access resource group information

SYNOPSIS

       scha_resourcegroup_get  -O optag -G group [args]

DESCRIPTION

       The  scha_resourcegroup_get  command  accesses  information  about a resource group that is under the control of the Resource Group Manager
       (RGM) cluster facility.

       This command is intended to be used in shell script implementations of the callback methods for resource types. These resource types repre-
       sent  services  that  are  controlled by the cluster's RGM. This command provides the same information as the scha_resourcegroup_get(3HA) C
       function.

       Information is generated by the command to standard output (stdout) in formatted strings as described in scha_cmds(1HA). The  output  is  a
       string  or  several  strings on separate lines. The output can be stored in shell variables and parsed using shell facilities or awk(1) for
       further use by the script.

       You need solaris.cluster.resource.read role-based access control (RBAC) authorization to use this command. See rbac(5).

       You must also be able to assume a role to which the Sun Cluster Commands rights profile has been assigned to use this  command.	Authorized
       users  can issue privileged Sun Cluster commands on the command line from the pfsh(1), pfcsh(1), or pfksh(1) profile shell. A profile shell
       is a special kind of shell that enables you to access privileged Sun Cluster commands that are assigned to the Sun Cluster Commands  rights
       profile.  A profile shell is launched when you run su(1M) to assume a role. You can also use pfexec(1) to issue privileged Sun Cluster com-
       mands.

OPTIONS

       The following options are supported:

       -G group     Name of the resource group.

       -O optag     Specifies the information that is to be accessed. Depending on the optag that you specify, you might need to include an  addi-
		    tional operand to indicate the node or zone for which information is to be retrieved.

		    Note -

		      optag  values,  such as DESIRED_PRIMARIES and FAILBACK, are not case sensitive. You can use any combination of uppercase and
		      lowercase letters when you specify optag options.
		    The following optag values retrieve the corresponding resource group properties. The  value  of  the  named  property  of  the
		    resource  group  is  generated.  The RG_STATE property refers to the value on the particular node or zone where the command is
		    executed.

		      AUTO_START_ON_NEW_CLUSTER
		      DESIRED_PRIMARIES
		      FAILBACK
		      GLOBAL_RESOURCES_USED
		      IMPLICIT_NETWORK_DEPENDENCIES
		      MAXIMUM_PRIMARIES
		      NODELIST
		      PATHPREFIX
		      PINGPONG_INTERVAL
		      RESOURCE_LIST
		      RG_AFFINITIES
		      RG_DEPENDENCIES
		      RG_DESCRIPTION
		      RG_IS_FROZEN
		      RG_MODE
		      RG_PROJECT_NAME
		      RG_SLM_TYPE
		      RG_SLM_PSET_TYPE
		      RG_SLM_CPU
		      RG_SLM_CPU_MIN
		      RG_STATE
		      RG_STATE_NODE
		      RG_SYSTEM
		      SUSPEND_AUTOMATIC_RECOVERY

       Note -

	 RG_STATE_NODE requires an unflagged argument that specifies a node or zone. This optag value generates the value of the resource  group's
	 RG_STATE property for the specified node or zone. If the unflagged argument specifies a non-global zone, the format is nodename:zonename.

EXAMPLES

       Example 1 A Sample Script Using scha_resourcegroup_get

       The  following script is passed a -G argument, which provides the required resource group name. Next, the scha_resourcegroup_get command is
       used to get the list of resources in the resource group.

	 #!/bin/sh

	 while getopts G: opt
	 do
	     case $opt in
		  G)	  group="$OPTARG";;
	     esac
	 done

	 resource_list=`scha_resourcegroup_get -O Resource_list -G $group`

	 for resource in $resource_list
	 do
	     printf "Group: %s contains resource: %s0 "$group" "$resource"
	 done

EXIT STATUS

       The following exit status codes are returned:

       0	    The command completed successfully.

       nonzero	    An error occurred.

		    Failure error codes are described scha_calls(3HA).

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWscdev 		   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Stable			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       awk(1), scha_cmds(1HA), scha_calls(3HA), scha_resourcegroup_get(3HA), attributes(5), rg_properties(5), rbac(5)

Sun Cluster 3.2 						    6 Sep 2006					       scha_resourcegroup_get(1HA)