INGVOTE

Purpose

The INGVOTE command displays:

All pending requests that were entered from the automation manager.
All pending votes of a specified resource.

Syntax

Parameters

resource

Specifies the resource to be displayed. The format is name/type[/system]. Wildcard is supported.

STATUS

Specifies whether to display the winning or losing requests or votes only. The default is ALL. The STATUS parameter can have the following values:

WINNING: Displays the winning requests or votes.
NOWINNING: Displays the losing requests or votes.
LOSING: Displays the losing requests or votes.
NOLOSING: Displays the winning requests or votes only.
ALL: Displays all winning and losing requests or votes. This is the default.

The values can be abbreviated. Note that if you specify a resource name the vote status is examined, otherwise the request status is examined.

SOURCE

This is used as a filter. Only those requests that originate from the named source are shown. Wildcards are supported, for example, OP*. An asterisk (*) matches a string of arbitrary length and a percentage sign (%) matches a single character.

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.

EXCLUDE

Specifies the resource type to be excluded from the display. More than one value can be specified. For example, INGVOTE EXCLUDE=SVP causes all service period resources to be filtered out from the display. Specify NO or * to reset the installation-provided default.

USER

This is used as a filter. Only those requests that originate from the specified user id are shown. Wildcard is supported. An asterisk (*) matches a string of arbitrary length and a percentage sign (%) matches a single character.

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.

REQ

This is used as a filter. Only those requests that have the specified request type are shown. The default is that all type of requests are displayed. It can be:

DESIRED: This shows just the desired status requests, which can be issued via INGREQ.
SUSPEND: This shows just the suspend requests, which can be issued via INGSUSPD.

SYSTEM

This is used as a filter. Only resources are shown that reside on one of the given systems. You can use system names or domain ids to identify those systems. An asterisk (*) also includes sysplexwide resources. The parentheses can be omitted when only one system is specified. Note that this parameter is ignored when a resource name is specified.

RESNAME

This is used as a filter for resource names in the format name/type[/system]. Only resources that match the specified resource name are shown. Wildcards are supported. An asterisk (*) matches a string of arbitrary length and a percentage sign (%) matches a single character. Note that this parameter is ignored when a resource name is specified.

SHOW

Specifies whether or not to show just the request types or also the request details. It can be:

EXPANDED: This shows request types and the request details. This is the default.
COLLAPSED: This shows just the request types.

Restrictions and Limitations

None.

Security Considerations

The INGVOTE command supports resource level security. If turned on, the following profiles in SYSAUTO are checked:

Profile	Authority	Condition
AGT.`sysplex.xcfgrp`.RES.`resname.restype[.ressys]`	UPDATE	When issuing CANCEL or KILL against requests from full screen

Usage other than listed in the table does not cause a resource level security check. Multiple requests entered on the panel are processed individually.

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

Usage

The INGVOTE command operates sysplexwide. For an overview see Overview of Commands that Operate Sysplexwide.

Examples

If you enter ingvote a panel similar to Figure 1 is displayed.

Figure 1. INGVOTE Command Dialog Panel

 INGKYRQ2                  SA z/OS  - Command Dialogs      Line  1    of 25     
 Domain ID   = IPUFA     ---------- INGVOTE  ----------    Date = 09/08/08      
 Operator ID = NETOP1          Sysplex = AOCPLEX           Time = 19:05:50      
                                                                                
 Cmd:  C Cancel request    K Kill request    S Show details    V Show votes     
 Cmd Name        Type System   Request Data                                     
 --- ----------- ---- -------- ------ ------------------------------------------
     BNKNACHT    SVP           Req : MakeUnAvailable                            
                               At  : 2008-09-08  09:39:58                       
                               Org : SCHEDULE                                   
                               Pri : 01120000  Should Be Down - Schedule        
                               Stat: Winning/Unsatisfied                        
     BZOMSCMV    SVP           Req : MakeAvailable_Only                         
                               At  : 2008-09-08  09:39:58                       
                               Org : SCHEDULE                                   
                               Pri : 02140000  Must Be Up - Schedule            
                               Stat: Winning/Unsatisfied                        
     HOURLY      SVP           Req : MakeAvailable_Only                         
                               At  : 2008-09-08  10:00:01                       
                               Org : SCHEDULE                                   
                                                                                
 Command ===>                                                                   
   PF1=Help     PF2=End        PF3=Return                        PF6=Roll       
                PF8=Forward    PF9=Refresh                      PF12=Retrieve

The Cmd field allows you to specify command codes. To use one of the command codes shown, type the appropriate letter next to the resource name and press Enter. The following command codes are available:

C

Cancels the request.

K

Cancels the request without showing the verification panel.

S

Shows details about the request.

V

Shows all the votes or requests that have been entered for that resource.
The Type field shows the type of the resource.
The Name field shows the name of the resource that the request was made against.
The Request Data field shows details about the request. See the online help for further information.

The subcommands FIND/RFIND are supported. See Varying the Format of the Command Output for more information.