INGPAC
Purpose
The INGPAC command has the following functions:
- Displays characteristics and runtime statistics of one, multiple, or all pacing gates.
- Lists the pacing gates associated with a resource or lists the resources associated with a pacing page.
- Displays the resources that are waiting for access to a pacing gate.
- Releases a resource to immediately start or stop the resource.
Syntax
Parameters
- pgnamelist
- A list of one or more pacing gate names, separated by blank or comma, enclosed in parentheses. Parentheses can be omitted if the list consists of only one element.
- RESOURCE=resname
- The fully qualified name of the application in automation manager notation for which the associated pacing gates are listed.
- DETAILS=pgname
- Displays the list of resources currently being paced by the single pacing gate denoted by the pgname variable. This option is only valid in combination with filter criteria keyword TYPE.
- RELEASE=resname
- Immediately releases the resource denoted by the resname variable.
- filter-criteria
- Specifies filter to further reduce the set of pacing gates being displayed. The following
filters are displayed:
- TYPE
- Specify START to only display pacing gates effective for starting of applications.
Specify STOP to only display pacing gates effective for stopping of applications.
- SYSTEM
- Specify the name of a system to only display pacing gates defined for that system.
- 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.
- WAIT
- Specifies whether or not to wait until the request is complete. The default is
YES.
nnn is the number of seconds to wait before giving up and reporting that a timeout has occurred. The maximum time interval is 999 seconds.
Restrictions and Limitations
None.
Security Considerations
The INGPAC command supports resource level security. If turned on, the following profile in class
SYSAUTO is checked:
| Profile | Authority | Condition |
|---|---|---|
| AGT.sysplex.xcfgrp.RES.pacing_gate.PAC | Update | Release a resource waiting in front of a pacing gate. This is the case, when command code R is issued to release a resource on the INGPAC detail panel, or when the RELEASE parameter is used on the INGPAC command line. |
Usage other than listed in the table does not cause a resource level security check. For further details, refer to IBM Z System Automation Planning and Installation.
Examples
If you enter INGPAC a panel similar to that shown in Figure 1 is displayed:
INGKYPA0 Automation Control - Command Dialogs Line 1 of 10
Domain Id . : IPUFL ------------ INGPAC ------------ Date . . : 07/11/14
Operator Id : JMH Sysplex = AOC6PLEX Time . . : 15:38:14
CMD: D Details L List Resources
CMD Pacing Gate Type System Limit Num Res Num Wait Avg Wait
--- -------------------- ----- -------- -------- -------- -------- --------
AWASGATE Start AOC6 2 0 0 4
AWASGATE Stop AOC6 3 0 0 12
WASGATE Start AOC6 2 18 16 491
WASGATE Stop AOC6 NOLIMIT 0 0 -
WASGATEA Start AOC6 1 0 0 -
WASGATEA Stop AOC6 NOLIMIT 0 0 -
WASGATEB Start AOC6 1 0 0 -
WASGATEB Stop AOC6 NOLIMIT 0 0 -
WASGATEC Start AOC6 1 0 0 -
WASGATEC Stop AOC6 NOLIMIT 0 0 -
Command ===>
F1=Help F2=End F3=Return F6=Roll
F9=Refresh F10=Previous F11=Next F12=Retrieve The amount of data depends on the screen size. Press PF10/11 to scroll horizontally.
- The CMD field lets you specify command codes. To use one of the command codes shown, type the
appropriate letter next to the pacing gate and press Enter. The following command codes are available:
- D to display a detail panel showing pacing gate statistics and providing a snapshot of resources currently using the pacing gate or waiting for use.
- L to list all resources that potentially may use this pacing gate for start or stop activities.
The SORT, FIND, and RFIND subcommands are supported. See Varying the Format of the Command Output or online help for further information.
Refer to the online help on the panel (PF1) for a description of individual fields.
If you enter command code D for a pacing gate, a panel similar to Figure 2 is displayed here:
Domain Id . : IPUFL ------------ INGPAC ------------ Date . . : 07/11/14
Operator Id : JMH Sysplex = AOC6PLEX Time . . : 15:38:14
Pacing gate: WASGATE Type: Start System: AOC6
Description: WebSphere startup pacing gate Limit : 2
Wait time(s) Active time (s) Number Resources
------------------ --------------------- ------------------
Current: 541 Current: 21 Waiting: 7
Average: 500 Average: 78 Active: 2
Maximum: 903 Maximum: 303 Other: 0
CMD: I Resource Info R Release
CMD Resource Name Status Wait Actve Total Req Date
--- ------------------------- -------- --------- --------- --------- --------
WAS05/APL/AOC6 Starting 602 28 630 07/09/14
WAS25/APL/AOC6 Starting 614 13 627 07/09/14
WAS21/APL/AOC6 Waiting 329 0 329 07/09/14
WAS22/APL/AOC6 Waiting 329 0 329 07/09/14
WAS26/APL/AOC6 Waiting 626 0 626 07/09/14
WAS27/APL/AOC6 Waiting 626 0 626 07/09/14
WAS28/APL/AOC6 Waiting 626 0 626 07/09/14
WAS29/APL/AOC6 Waiting 626 0 626 07/09/14
WAS30/APL/AOC6 Waiting 626 0 626 07/09/14
Command ===>
F1=Help F2=End F3=Return F6=Roll
F9=Refresh F10=Previous F11=Next F12=Retrieve
The amount of data depends on the screen size. Press PF10/11 to scroll horizontally.
- The CMD field lets you 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:
- I to display a panel with details about this application
- R to release the resource to let it start or stop regardless of the pacing gate status at the moment.
The SORT, FIND, and RFIND subcommands are supported. See Varying the Format of the Command Output or the online help for further information.
Refer to the online help on the panel (PF1) for a description of the individual fields.