INGGROUP Options

You can invoke the INGGROUP command dialog either by typing the command name at the command line or by selecting option J from the INGLIST command dialog.

INGGROUP allows you to change the policy of application groups. You may specify:

  • The target sysplex for the command via the System field. If omitted, this defaults to the local system/sysplex. Specify the system name only when viewing or changing the policy of an application group that is not part of the local sysplex.
  • The policy change that you want to make through the Action field.
  • Next you must specify either the name of the target group or a set of templates that will match one or more groups. All policy items work with a list of group name templates and apply to all Move and Server groups matching those names. While applying a policy to a Basic group is not an error, it will not achieve anything either.
  • For the EXCLUDE-AVOID-INCLUDE option, you can specify a list of systems that the policy is to be set for. Specify a question mark (?) at the System(s) line to see a list of systems within the sysplex.

    This option indicates that you want to remove movable members from a system (exclude), prohibit SA z/OS from activating movable members on a system (avoid) or that you wish to undo either of the other two actions (include).

    Note: The AVOID/EXCLUDE options are only applied to the members of the group that are applications. They are not applied to members of a group that are also groups. In other words, these options are not recursively spread out to nested application groups.
  • With the PACIFY option, you can make the specified group passive. This option will immediately revoke all votes from all of the group members. This may cause the desired state of some of its members to change, resulting in them being started or stopped.

    With the ACTIVATE option, you can make a group active. When a group becomes active, SA z/OS will propagate MakeAvailable requests to the group members that are required to make the group available. Those members that are not required will receive a MakeUnavailable request. Note that if a member has a preference of 1 it will always be propagated a MakeUnavailable request and if it has a preference of 0 (a passive member) it will never be propagated any sort of request.

  • With the ADJUST option you can indicate that you want to temporarily adjust a group's policy.
  • With the RESET option you can set the preference value assigned to each member of the group to its initial value.
  • With the DEFAULT option you can set the availability target, satisfactory target, group passive attribute and the member's preference value to the value defined in the policy.
  • With the OVERRIDES option you can display any overrides that have been made with the INGGROUP command for the specified resource groups.
  • With the POLICY option you can display the policies for the specified resource groups.
  • With the RECYCLE-CANCEL option you can initiate or halt a rolling recycle of the specified groups. This affects Server and Move groups that are within the scope of the command. Use the CHUNK parameter to recycle group members in parallel, improving performance.

    Note that if the systems in a Server group all have the same preference value, the system that is active after a rolling recycle has completed may not be the same one as before the rolling recycle. Thus, triggering a rolling recycle always results in a move occurring. If you set the preference of the original system more than 250 points higher than that of any other system, the rolling recycle is followed by a second move to return the application to that system. This leads to an increase in the application down time.