Add the qualification of one or more resources for any runmode
Delete runmode qualification for one or more resources
Syntax
mode-spec
resource-spec
Notes:
1 Line-mode only
Parameters
REQ
The request to be carried out.
SET
Specifies a new runmode is set
ADD
Qualifies one or more individual resources for a runmode
DEL
Deletes the runmode qualification for the given resource
RUNMODE
Specifies the runmode to be activated. The runmode must be specified
in the policy database. In full-screen mode, a question mark(?) can
be specified to display a selection list. Use *ALL to disable runmode
consideration.
PERSISTENT
Specifies whether the request should be kept across system IPL. Valid options are:
YES
The runmode request is kept in the takeover file. This is the default setting.
NO
The runmode request is removed as soon as the system leaves the sysplex. For more information,
see REMOVE=SYSGONE of the INGREQ
command.
RUNRES
Specifies the resource to be considered qualified for any runmode.
The format is name/type[/system]. In full-screen mode, if more
than one resource matches the specification, a selection panel is
displayed. In full-screen mode, for a DEL request a question mark(?)
can be specified to display a selection list of all resources previously
specified on an ADD request.
MULT
Specifies that more than one resource will be accepted when running
in line mode, if the resource wildcard specification results in multiple
resources. This command is available in line mode only.
NO
The resource specification must resolve to a single resource.
YES
Multiple resources can be processed with a single invocation of
the INGRUN command.
SYSTEM
Specifies the system for which the runmode is set.
TYPE
Specifies the type of shutdown to be used for resources that do
not qualify for the new runmode. For more information, see the INGREQ command.
PRI / PRIORITY
Specifies the priority for the shutdown of the resources that
do not qualify for the new runmode. For more information, see the INGREQ command.
OVERRIDE
Specifies the overrides that are to be considered when shutting
down resources that do not qualify for the new runmode. For more information,
see the INGREQ command.
VERIFY
Specifies if the shutdown process of resources that do not qualify
for the new runmode should be verified.
CMT / COMMENT
Specifies descriptive information, for example, why the request
was made.
To use the
INGRUN command, system operations must be initialized.
Security Considerations
The INGRUN command supports resource level security. If turned on, the following profiles
in class SYSAUTO are checked:
Profile
Authority
Condition
AGT.sysplex.xcfgrp .RES.resname.restype[.ressys]
UPDATE
Always
If multiple resources are affected, multiple profiles are checked. For SET requests, this
is the SYG resource corresponding to the selected system
(system/SYG/system). The request is carried out or rejected as a whole.
For further details, refer to IBM Z System Automation Planning and Installation.
Usage
The INGRUN command operates sysplexwide.
Examples
If you enter ingrun a panel similar to Figure 1 is displayed.
Figure 1. INGRUN Command Dialog Panel
INGKYRM0 SA z/OS - Command Dialogs
Domain ID = IPUFJ ---------- INGRUN ---------- Date = 08/11/11
Operator ID = NETOPER1 Time = 12:10:38
Request => Request type (SET, ADD or DEL)
Target => System name, domain ID or sysplex name
--- Parameters for SET request --------------------------------------------
System => System name
Runmode => Runmode name (mode or ?)
Persistent => Keep request across IPL (YES/NO)
Type => Type of processing (NORM/IMMED/FORCE)
Priority => Priority of request (FORCE/HIGH/LOW)
Override => (ALL/NO/TRG/FLG/DPY/STS/SUS)
Verify => Check affected resources (YES/NO/WTOR)
Comment =>
--- Parameters for ADD or DEL requests ------------------------------------
Resource => format: name/type/system
AOF710A VERIFY/REVISE INPUT AND THEN PRESS ENTER
Command ===>
PF1=Help PF2=End PF3=Return PF6=Roll
PF12=Retrieve
Request
Valid request types are SET, ADD, and DEL.
Target
Specifies the name of the system (system name, domain ID or sysplex
name) that the command should be routed to. This is only necessary
when you want to operate outside of the local sysplex.
The following parameters are valid for SET only:
System
Specifies the name of the system that you want to set a runmode
for.
Runmode
Specifies the name of the runmode that you want to set. You can
specify a question mark (?) to select a from a list of all available
resources.
Persistent
Specifies whether the request should be kept across system IPL.
For more information, see REMOVE=SYSGONE of INGREQ command.
Type
Specifies the type of shutdown to be used for resources that do
not qualify for the new runmode. For more information, see the INGREQ command for further details.
Priority
Specifies the priority for the shutdown of the resources that
do not qualify for the new runmode. For more information, see the INGREQ command for further details.
Override
Specifies the overrides that are to be considered when shutting
down resources that do not qualify for the new runmode. For more information,
see INGREQ for further details.
Verify
Specifies whether the shutdown process of resources that do not
qualify for the new runmode should be verified. For more information,
see INGREQ for further details.
Comment
Specifies descriptive information, for example, why the request
was made.
The following parameter is set for ADD and DEL
requests:
Resource
Specifies the name of the resource for which you want to add or
delete the qualification. The format is name/type/system or name/type
for sysplex resources. Wildcards and incomplete specifications are
supported. For DEL requests a question mark (?) can be specified which
lets you choose from a list of resources previously specified on an
ADD request.
