ibm-information-center/dist/eclipse/plugins/i5OS.ic.cl_5.4.0.1/dspcrginf.htm

156 lines
6.9 KiB
HTML

<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Display CRG Information (DSPCRGINF)</title>
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
</head>
<body bgcolor="white">
<script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<a name="DSPCRGINF.Top_Of_Page"></a>
<h2>Display CRG Information (DSPCRGINF)</h2>
<table width="100%">
<tr>
<td valign="top" align="left"><b>Where allowed to run: </b>All environments (*ALL)<br>
<b>Threadsafe: </b>No
</td>
<td valign="top" align="right">
<a href="#DSPCRGINF.PARAMETERS.TABLE">Parameters</a><br>
<a href="#DSPCRGINF.COMMAND.EXAMPLES">Examples</a><br>
<a href="#DSPCRGINF.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="DSPCRGINF"></a>
<p>The Display Cluster Resource Group Information (DSPCRGINF) command is used to display or print information about cluster resource groups. It must be invoked from a node in the cluster. The information displayed or printed may not be current if the command is called on a node that has a status of Inactive or Failed. In this case, the information displayed or printed will reflect the state of the cluster when the node was last active. You can use this command to display or print a list of cluster resource groups or complete information about a cluster resource group.
</p>
<p>If CRG(*LIST) is specified, the request for information is not distributed to other nodes in the cluster. The information about the cluster resource groups shows the values obtained from the node running this command. Several conditions (for example, Cluster Resource Services not active on the node running the command) may produce inconsistent information about a cluster resource group in the cluster.
</p>
<p>When you request information for a specific cluster resource group, basic information for the cluster resource group is always shown. In addition, you can request additional details that include the recovery domain and the list of resilient devices. If Cluster Resource Services has been started, this command will return information about the cluster resource group even if it does not exist on the node from which the command is called provided at least one recovery domain node is active.
</p>
<p>If Cluster Resource Services has not been started:
</p>
<ol>
<li>The information returned may not be current
</li>
<li>Information will only be returned for a cluster resource group that exist on the node running the command
</li>
</ol>
<p>This command may be called from a cluster resource group exit program. However if the cluster resource group exit program was called as a result of the Create Cluster Resource Group (CRTCRG) command and you are requesting information for that cluster resource group, the command will fail.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPCRGINF.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="DSPCRGINF.PARAMETERS.TABLE">Parameters</a></h3>
<table border="1" cellpadding="4" cellspacing="0">
<!-- col1="10" col2="15" col3="30" col4="10" -->
<tr>
<th bgcolor="aqua" valign="bottom" align="left">Keyword</th>
<th bgcolor="aqua" valign="bottom" align="left">Description</th>
<th bgcolor="aqua" valign="bottom" align="left">Choices</th>
<th bgcolor="aqua" valign="bottom" align="left">Notes</th>
</tr>
<tr>
<td valign="top"><a href="#DSPCRGINF.CLUSTER"><b>CLUSTER</b></a></td>
<td valign="top">Cluster</td>
<td valign="top"><i>Name</i></td>
<td valign="top">Required, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#DSPCRGINF.CRG"><b>CRG</b></a></td>
<td valign="top">Cluster resource group</td>
<td valign="top"><i>Character value</i>, <b><u>*LIST</u></b></td>
<td valign="top">Optional, Positional 2</td>
</tr>
<tr>
<td valign="top"><a href="#DSPCRGINF.OUTPUT"><b>OUTPUT</b></a></td>
<td valign="top">Output</td>
<td valign="top"><b><u>*</u></b>, *PRINT</td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#DSPCRGINF.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="DSPCRGINF.CLUSTER"></a>
<h3>Cluster (CLUSTER)</h3>
<p>Specifies the cluster which contains the cluster resource groups for which information will be displayed or printed.
</p>
<p>This is a required parameter.
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the cluster.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPCRGINF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPCRGINF.CRG"></a>
<h3>Cluster resource group (CRG)</h3>
<p>Specifies the cluster resource group for which information is to be displayed or printed.
</p>
<dl>
<dt><b><u>*LIST</u></b></dt>
<dd>Indicates that the list of cluster resource groups currently defined in the specified cluster are to be displayed or printed. Descriptive information about each cluster resource group will also be printed. The information will be returned for all cluster resource groups in the cluster, even if they do not exist on the node running the command. The Work Objects (WRKOBJ) CL command can be used to provide a list of cluster resource group objects that only exist on this node. Information on all the cluster resource groups will be printed regardless of the authority of the user calling the command.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the cluster resource group.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPCRGINF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPCRGINF.OUTPUT"></a>
<h3>Output (OUTPUT)</h3>
<p>Specifies whether the output from the command is shown at the requesting workstation or printed with the job's spooled output. More information on this parameter is in commonly used parameters.
</p>
<dl>
<dt><b><u>*</u></b></dt>
<dd>Output requested by an interactive job is shown on the display. If the command is run as part of a batch job, the output is printed with the job's spooled output.
</dd>
<dt><b>*PRINT</b></dt>
<dd>The output is printed with the job's spooled output.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPCRGINF.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="DSPCRGINF.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
DSPCRGINF CLUSTER(MYCLUSTER) CRG(*LIST) OUTPUT(*PRINT)
</pre>
</p>
<p>This command will print the basic configuration information about all cluster resource groups defined in cluster MYCLUSTER.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPCRGINF.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="DSPCRGINF.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF1999</b></dt>
<dd>Errors occurred on command.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPCRGINF.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>