INGMOVE

Purpose

INGMOVE makes moving sysplex application groups easier. Rather than manipulating the preference value of each member in the sysplex application group, you simply specify where the group should be moved to.

In a sysplex application group of type MOVE, only one member is active at a time. By specifying the new location of the move group, the active member is terminated and the member associated with the new location is activated.

INGMOVE supports the moving of a sysplex application group to another system.

Syntax

To move sysplex application groups

Read syntax diagramSkip visual syntax diagram INGMOVE resource_nameSYSTEMS=(system)QUAL=ACTIVEINACTIVETO=system*ANY*HOMEfeedback optionWAIT= nnnACTION=MOVE1ACTION=PREPAREVERIFY=YES2VERIFY=NOWTOROUTDSN= dsnameOUTMODE=LINEAUTONETLOGTARGET=system_namedomain_idsaplex_name
Feedback option
Read syntax diagramSkip visual syntax diagramFDBK=(MSGMSG/ userid,,G,F,BWAIT, max_time, exp_status)
Notes:
  • 1 Can only be used in line mode.
  • 2 The default depends on the type of task that the INGMOVE command runs on. If the task that the command runs on, is an autotask associated with a *ANY* console, the default is WTOR. The default for an unattended task is NO.

Parameters

resource_name
Specifies the name of the sysplex application group. More than one name can be specified, separated by a blank or a comma. Each name can contain a wildcard.

If no group name is specified, all sysplex application groups of type MOVE are displayed.

WAIT

Specifies the number of seconds to wait before reporting that a timeout occurred if the automation manager does not provide the requested data. The maximum time interval is 999 seconds.

If omitted, the time interval is 30 seconds.

TO
Specifies the system that the application group should be moved to.

Alternatively, *ANY can be specified. This causes the application to be moved to any other viable system in the sysplex.

In the background, an INGGROUP ACTION=EXCLUDE is done. The advantage of this, however, is that the INGMOVE command checks for the successful completion of the move operation within the allowed time interval.
FDBK
Specifies the feedback parameter that causes the final result of the command to be reported back to the designated instance.
MSG
Causes message signaling of the successful or unsuccessful completion of the command to be performed.

The message is sent back to the originator of the command. The originator is determined by the NetView OPID(S) function unless the user ID is specified. Depending on the status, either message ING300I or ING301I is issued. The message text contains the command that was processed successfully or failed.

userid
Identifies the NetView user ID of the person to be notified if different to the originating user.
Use the following values to specify when to issue the message:
G
Issue the message only when the resource has reached its expected status.
F
Issue the message only if the resource did not reach its expected state in the specified time interval.
B
Issue the message in all cases.
WAIT
To wait for the completion of the command (denoted by the max_time parameter). Note that the WAIT option is rejected when the INGMOVE command executes on a work operator.
max_time
The time interval in NetView format (mm:ss, :ss, mm or hh:mm:ss) that SA z/OS® will wait. If the specified resource has not reached the expected state, the command is considered to have failed and the operation is posted in error.
exp_status (introduced in OA59461)
The observed status that the resource should be in to consider command processing to be complete. The status can be abbreviated, for example, AV for Available. More than one status can be specified and separated by a blank. Here is a list of possible Observed Status values and their shortest possible abbreviations: AVAILABLE (A), UNKNOWN (U), SYSGONE (SY), SOFTDOWN (SO), HARDDOWN (H), STARTING (STAR), DEGRADED (D), STOPPING (STO), PROBLEM (P), WASAVAILABLE (W), and STANDBY (STAN).

If a resource is of type APG with Status Determination flag CSONLY and the AOF_AAO_FDBK_HONOR_CS global variable is set to '1', then the command processing will be considered complete when the resource's compound status is SATISFACTORY, and its observed status reaches the expected status or ends up in STARTING (for a start action), or STOPPING/DEGRADED (both for a stop action).

SYSTEMS
Specifies a list of systems to be used as a filter. Only groups that can run on one of the specified systems are displayed. If more than one system is specified, they must be separated by a blank character and enclosed in parentheses.
QUAL
Specifies a qualifier for the SYSTEMS filter. It can be one of the following:
ACTIVE
Shows only those groups that are running on one of the systems specified with the SYSTEMS parameter.
INACTIVE
Shows only those groups that are not running on one of the systems specified with the SYSTEMS parameter.
ACTION
Specifies when the action is to be done. Valid values are:
MOVE
Perform the move immediately. This is the default.
PREPARE
Perform the move at the next recycle. Note that the selected member will be activated immediately if the group has no available members and the group's compound status is not SATISFACTORY.
VERIFY
Specifies whether the operator is prompted for confirmation prior to carrying out the requested action. The default depends on the type of task that the INGMOVE command runs on. It is NO for Unattended tasks, otherwise YES.
YES
Asks the operator for confirmation.
NO
No verification is performed. This setting is always for Unattended tasks.
WTOR
The list of affected resources is displayed before the requested action is carried out. The operator is prompted to verify the list via WTOR.

The default depends on the type of task that the INGMOVE command runs on. If the task the command runs on is an autotask associated with a *ANY* console, the default is WTOR. The default for an unattended task is NO.

TARGET
For information on the TARGET parameter, see TARGET Parameter.
OUTDSN
For information on the OUTDSN parameter, see OUTDSN Parameter.
OUTMODE
For information on the OUTMODE parameter, see OUTMODE Parameter.

Restrictions and Limitations

The FDBK parameter will only monitor resources within the local sysplex.

When you have invoked INGMOVE and INGGROUP in parallel and you perform a move operation of a model 2 group using INGMOVE, the CLIST INGGROUP will be canceled.

Security Considerations

The INGMOVE command supports resource level security. If turned on, the following profile in class SYSAUTO is checked:
Profile Authority Condition
AGT.sysplex.xcfgrp.RES.resname.restype UPDATE Always

If multiple resources are affected, multiple profiles are checked. The request is carried out or rejected as a whole.

For further details, refer to IBM Z System Automation Planning and Installation

Examples

If you enter ingmove, a panel similar to Figure 1 is displayed.
Figure 1. INGMOVE Command Dialog Panel
 INGKYMV0                  SA z/OS  - Command Dialogs     Group  1     of 7     
 Domain ID   = IPSNO     ---------- INGMOVE  ----------   Date = 11/23/09       
 Operator ID = NETOP1          Sysplex = KEY1PLEX         Time = 13:08:38       
                                                                                
  B Start    C Stop     D INGRELS  E INGVOTE  F INGINFO  G Members  I INGSCHED  
  J INGGROUP M Move     P Prepare  R Reset    X Box Group           / scroll    
 Cmd Group name   Obs Status          ---- Systems ----              Move to    
 --- -----------  -----------  -------- -------- -------- ---------  --------   
     ARMGROUP     SOFTDOWN     KEY1     KEY2     KEY3     KEY4                  
                               KEY5     KEY6     KEY7                           
     MOVDISRN     AVAILABLE    KEY2     KEY4                         *          
     MOVDISRY     AVAILABLE    KEY2     KEY4                         KEY2       
     MOVPLEXA     AVAILABLE    KEY1     KEY2     KEY3     KEY4       KEY2       
                               KEY5     KEY6                                    
     MOVPLEXB     SOFTDOWN     KEY1     KEY2     KEY3     KEY4                  
     MOVPLEXC     SOFTDOWN     KEY1     KEY2     KEY3     KEY4                  
     MOVPLEXD     AVAILABLE    KEY1     KEY2     KEY3                =          
                                                                                
 Command ===>                                                                   
  PF1=Help      PF2=End       PF3=Return                          PF6=Roll      
                              PF9=Refresh                        PF12=Retrieve

This panel shows all sysplex application groups of type MOVE (referred to as move groups) that match the specified filter criteria. The following information is shown:

  • The Group name column shows the name of the move group. Because the move groups are unique within a sysplex, only the first part of the resource group name is shown.
  • The Obs Status column shows the observed status of the move group as seen by the automation manager.
  • The Systems columns show a list of the systems where a member of the MOVE group exists and could run. Different colors are used to indicate the state of the system or the member of the group that is running on that system, as follows:
    • Red if the system is down
    • Yellow if the member of the group that is running on that system is not startable
    • Green if a member of the group is currently active on that system
    • Pink if the system is excluded
    • White if the system is avoided
    • Turquoise in all other cases
    The home system, or systems, which are those that have the highest preference value, are underlined.

    The system that has the highest actual preference is shown in reverse video, unless it is a home system. Note that this can be more than one system.

  • The Move to column is an input field where you can specify the system that the group should be moved to. Moving a sysplex application move group means terminating the member that is currently active and starting the member on the designated system.

    Initially, SA z/OS shows the best system to be used for a move operation in this field, based on the state of the group members and their preference points. The proposed system is shown in blue.

    You can designate the system by specifying in the Move to field:
    • The name of the system.
    • An asterisk (*). This means that the group is moved back to its home system, which is the one with the highest base preference value. If more than one home system exists, it is moved to the first one in the list.
    • An equals sign (=). This is a shorthand form that means to take the value from the nearest field above with a value specified in it.
You can enter the following action codes in the Cmd field to launch other commands:
B
Start. Calls the INGREQ command dialog to make the resource available. See INGREQ for further information.
C
Stop. Calls the INGREQ command dialog to make the resource unavailable. See INGREQ for further information.
D
Invokes the INGRELS command to display dependency information and its evaluation for the resource.
E
Invokes the INGVOTE command, showing all requests currently present for the resource. Allows the operator to cancel a request.
F
Shows details about the resource by invoking the INGINFO command.
G
Invokes the INGLIST MEMBERS=YES command to show all members for the selected application group in a new window.
I
Invokes the INGSCHED command to show the resource overrides for the selected resource.
J
Invokes the INGGROUP ACTION=MEMBERS command to show member details.
M
Moves the group to the designated system.
P
Moves the group to the designated system when the group is next recycled.
R
Resets the preference values of the group members to the values that are defined in the policy database.
X
Boxes the group. The member that is currently active acquires a preference of 2800 so that if the system is terminated the group will not move to another system.
You can use the / character to place the selected line as the first line of the display.
Note: This panel does not support the FIND and SORT subcommands.
If you specify one or more systems Figure 2 is displayed to ask you for confirmation.
Figure 2. INGMOVE Confirmation Panel
 INGKYMV1                  SA z/OS  - Command Dialogs      Line  1    of 3
 Domain ID   = IPSNO     ---------- INGMOVE  ----------    Date = 09/10/04
 Operator ID = NETOP1                                      Time = 12:23:25

     Verify the Move Group activities

     Group name   Runs on   Move to   Action
     -----------  --------  --------  --------------------
     MOVDISRN     AOCB      AOCD      now 
     MOVPLEXA     AOCA      AOCB      now
     MOVPLEXB               AOCB      at recycle
For each group that is to be moved the panel shows:
  • The name of the group
  • The name of the system where the group is currently active
  • The name of the system that the group should be moved to
  • Descriptive information about the action

Specifying GO at the command line or pressing the PF10 key carries out the move operation. Specifying CANCEL at the command line or pressing the PF11 key returns you to the previous panel.

Note: Pressing PF2 or PF3 has the same behavior as PF11.