Start Cluster Resource Group (STRCRG)

The Start Cluster Resource Group (STRCRG) command enables resilience for the specified cluster resource group on the specified recovery domain nodes. This command can be used to change the cluster resource group from a status of Indoubt or Inactive to Active.

This command will do the following for all cluster resource group types:

  1. Set the cluster resource group status to Start Pending.
  2. For primary-backup model cluster resource groups if the current recovery domain has more than one backup node and some backup nodes are not active, the recovery domain may be reordered so that all active backup nodes are ordered before inactive backup nodes. If the inactive backup nodes are already ordered after active backup nodes or if there are no inactive backup nodes, this command will not change the recovery domain.
  3. Call the exit program on all active nodes in the recovery domain with an action code of Start, if an exit program is specified for the cluster resource group.
  4. Set the cluster resource group status to Active if the exit program is successful on all active nodes in the recovery domain.
  5. If the exit program is unsuccessful on any active node in the recovery domain when processing the Undo action code, the status of the cluster resource group will be set to Indoubt on all nodes.

This command will do the following for application cluster resource groups:

  1. Verify the takeover IP address has been configured on all nodes in the recovery domain except replicates.
  2. Start the TCP/IP interface on the primary node.
  3. If the exit program is unsuccessful on any active node in the recovery domain, the exit program job on the primary node will be cancelled and the Takeover IP address will be ended on the primary node.

    For an application cluster resource group, the exit program on the primary node is not expected to complete. The status of the cluster resource group will be set to Active when the exit program job has been started on the primary and the exit program has completed successfully on all other nodes in the recovery domain.

This command will do the following for device cluster resource groups:

  1. The cluster resource group must have at least one configuration object entry.
  2. The configuration objects specified for the cluster resource group must exist on all active nodes in the recovery domain and the resource name specified in a configuration object must be the same on all active nodes in the recovery domain.
  3. If a data base name has been specified for a configuration object, it must be the same on all active nodes in the recovery domain.
  4. If a server takeover IP address is specified, it must exist on all nodes in the recovery domain.
  5. Start of change
  6. The primary node must be the current owner for the hardware resources of the configuration objects specified in the cluster resource group.End of change
  7. Starting the cluster resource group will not vary on the configuration objects or start the server takeover IP address.
  8. All members of an auxiliary storage pool group must be configured in the cluster resource group.
  9. A value of *PRIMARY for the device's configuration object online' attribute can be specified only for a secondary auxiliary storage pool.

This command will do the following for peer cluster resource groups:

  1. All nodes that are designated with a peer role will be an active access point upon successful completion of this command.

Restrictions:

Parameters

Keyword Description Choices Notes
CLUSTER Cluster Name Required, Positional 1
CRG Cluster resource group Name Required, Positional 2
EXITPGMDTA Exit program data Character value, *SAME Optional

Cluster (CLUSTER)

Specifies the cluster containing the cluster resource group.

This is a required parameter.

name
Specify the name of the cluster.

Cluster resource group (CRG)

Specifies the cluster resource group to be started.

This is a required parameter.

name
Specify the name of the cluster resource group.

Exit program data (EXITPGMDTA)

Specifies up to 256 bytes of data that is passed to the cluster resource group exit program when it is called. This parameter may contain any scalar data except pointers. For example, it can be used to provide state information. This data will be stored with the specified cluster resource group and copied to all nodes in the recovery domain. Pointers in this area will not resolve correctly on all nodes and should not be placed in the data. The data specified will replace the existing exit program data stored with the cluster resource group. If blanks are specified, then the exit program data stored with the cluster resource group will be cleared. This parameter must be set to *SAME if no exit program is specified for the cluster resource group.

*SAME
The exit program data stored with the cluster resource group specified will be passed to the exit program.
character-value
Specify the data to be passed to the exit program.
Start of change

Examples for STRCRG

End of change

STRCRG   CLUSTER(MYCLUSTER)  CRG(MYCRG)
         EXITPGMDTA('important information')

This command enables resiliency of the cluster resource group MYCRG in the cluster MYCLUSTER. The exit program, when called, is passed 'important information' in the exit program data field. The cluster resource group will be ACTIVE as a result of this command.

Start of change

Error messages for STRCRG

End of change

*ESCAPE Messages

HAE001B
Start of change
Cluster resource group not started.End of change