INGAUTO
Purpose
The INGAUTO command lets you change the settings of the automation flags for the specific subsystem, for the MVSESA, SUBSYSTEM or DEFAULTS resources or for a minor resource under one of those major resources. You can change the setting to ON, OFF, EXITS or LOG. If an INTERVAL is specified the changes are effective for the specified time period.
Any changes are only effective until a NetView recycle or the ACF COLD command being issued. You can also ask for a flag to be set back to the value specified in the current configuration file.
Syntax
Parameters
If you do not specify a resource (MVSESA, SUBSYSTEM, DEFAULTS, resname or subcomponent) and are running in full screen mode, a menu appears prompting you for a resource name. If you are in line mode, a resource is a required parameter.
- EXITS
- Enables user exits for the flag that you specify.
- OFF
- Sets the automation flag that you specify to off.
- ON
- Sets the automation flag that you specify to on.
- RESET
- Resets the automation flag to the values that you specified in your policy database.
- LOG
- Writes the commands and replies to the netlog if an event occurs that triggers the automated action.
- DEFAULTS
- Specifies the value DEFAULTS. This sets automation flags for all resources that do not have their own flags defined.
- SUBSYSTEM
- Sets defaults for all subsystems.
- MVSESA
- Sets defaults for all MVS subcomponents.
- resname
- Specifies the name of a particular resource, for example, a subsystem name like
JES2 or a resource under MVSESA such as WTOBUF. You can specify any resource known to the Automation
Agent.
Wildcards are supported, for example, IMS* or *PRD.
- subcomponents
- Specifies the subcomponents of the resource. Enter a period (.) between each subcomponent name. When specifying a subcomponent without specifying a major resource, MVSESA is used as a major resource. The period (.) in front of the subcomponent must then be omitted.
- SCOPE
- Specifies whether to change automation for this resource and its
dependent resources, dependent resources only, or this resource alone.
Valid options are the following:
- ONLY
- Specifies this resource alone. This is the default.
- ALL
- Specifies this resource and its dependent resources.
- CHILDREN
- Specifies dependent resources only.
- FLAG
- Specifies the automation flags to set on, off, reset, or enable a user exit for,
(depending on whether you specified INGAUTO ON, OFF, RESET or EXITS). See IBM Z System Automation Customizing and Programming for further information on automation flags. Valid
options are the following:
- AUTOMATION
- This sets the Automation flag, which is the controlling flag. If you set the Automation flag to OFF, SA z/OS® turns all automation off. If the Automation flag is ON, SA z/OS checks the other flags.
- INITSTART
- Sets the Initstart flag. This is checked after SA z/OS initialization for the first start of an application. If this flag is on, SA z/OS will start the resource, provided its goal is to be available and all other conditions for its startup have been met.
- RECOVERY
- Sets the Recovery flag. If this is set to on, SA z/OS will perform recovery actions other than restarting a resource.
- RESTART
- Sets the Restart flag. If this is set to on, SA z/OS will restart the resource if possible.
- START
- Sets the Start flag. If this is set to on, SA z/OS will manage and complete the startup of the resource.
- TERMINATE
- Sets the Terminate flag. If this is set to on, SA z/OS will process automated shutdown requests for the resource.
- INTERVAL=dd:hh:mm
- Specifies the period of time the flag will be changed for. At the end of the interval, the flag is reset to the state defined in the agent's configuration file.
- TARGET
- For information on the TARGET parameter, see TARGET Parameter.
- OUTMODE
- For information on the OUTMODE parameter, see OUTMODE Parameter.
Restrictions and Limitations
- The INGAUTO command can be used only when SA z/OS is initialized.
- A flag cannot be reset for an interval.
- If a resource has been suspended by the INGSUSPD command, you cannot use INGAUTO to manipulate the flags. Use INGSUSPD to reset the AUTOMATE flag to its original value.
Usage
If the Automation flag is currently set to off, and you have changed one of the other flags, your change will not be effective until the Automation flag is set to on. Occurrences will be detailed in the netlog.
If you have selected EXITS for an automation flag, and none have been specified in your automation control file, automation will be set to on. Occurrences will be detailed in the netlog.
SCOPE=ONLY is the only valid scope for DEFAULTS, a resource type, and subcomponents. ALL and CHILDREN are not valid.
Make sure you specify the correct subcomponent name. Even if you specify a subcomponent that does not exist, the message FUNCTION SUCCESSFULLY COMPLETED will appear.
Examples
ingauto on,tso,flag=automation,interval=00:02:00ingauto on,mvsesa.wto AOFKAASF SA z/OS - Command Dialogs
Domain ID = IPUN8 ---------- INGAUTO ---------- Date = 09/02/03
Operator ID = NETOP1 Time = 17:23:40
Resource name => MVSESA Specific or group resource or DEFAULTS
Sub-components => WTO Resource sub-components
Note : Be sure to specify the correct sub-component name
Target => AOC8 System name, domain ID, sysplex name, *ALL
Scope => ONLY Change automation for:
ONLY - only this resource
CHILDREN - dependants
ALL - resource and dependants
Automation => Specify new settings for automation flags
Initstart => Y - flag is always on
Start => N - flag is always off
Recovery => Y E - exits called if specified
Terminate => L - resulting commands are logged only
Restart => R - return to automation control file
settings
Interval => Specify duration of change (dd:hh:mm)
or leave blank for an indefinite change
Command ===>
PF1=Help PF2=End PF3=Return PF6=Roll PF12=Retrieve