INGMDFY

Purpose

The INGMDFY command displays the currently defined actions for the startup or shutdown of a subsystem and allows you to modify them for the next startup or shutdown.

INGMDFY also allows you to define additional actions or to delete defined actions for the startup or shutdown of a subsystem.

Syntax

Parameters

subsystem

The name of the subsystem that the defined actions are to be displayed for.

jobname

The job name of the subsystem that the defined actions are to be displayed for.

phase

This parameter is used to specify whether startup or shutdown actions are to be displayed.

START: Startup actions are to be displayed.
STOP: Shutdown actions are to be displayed.

Restrictions and Limitations

The INGMDFY command can be used only when SA z/OS® is initialized.
The INGMDFY command is provided for fullscreen mode.
To ensure consistency during the startup or shutdown process of an application, the save and reset functions are not applicable during startup or shutdown processing of the related application.
Persistence of modifications:
- NetView Recycle (or ACF COLD which should only be used in emergency cases)
  Both the modified start/stop definitions in storage and the previously loaded ACF data in the KEEP are lost. At restart, SA z/OS initializes with the automation policy data from disk.
- Configuration Refresh
  If the configuration data for a subsystem has been changed in the automation policy, both the modified start/stop definitions in storage and the previously loaded ACF data in the KEEP are lost during the configuration refresh. The new ACF data is loaded from disk.
- Temporarily Changing ACF Data with ACF REQ=REPL
  When using ACF REQ=REPL, only the currently loaded ACF data is modified. An existing KEEP remains untouched so that previously loaded ACF data is restored after the next start/stop or after INGMDFY expires.

Security Considerations

The INGMDFY 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	When saving command or reply changes

Usage

INGMDFY also displays default startup commands if no startup commands are defined for applications with a job type other than NONMVS and they can be modified.

Examples

If you enter INGMDFY followed by a subsystem name and START or STOP, a panel similar to Figure 1 is displayed.

Figure 1. INGMDFY Command Dialog Panel

 AOFKEDSS                 SA z/OS  - Command Dialogs       Line   1    of 15   
 Domain ID   = IPSNO     ---------- INGMDFY  ----------    Date = 10/16/13      
 Operator ID = NETOP1          Sysplex = KEY1PLEX          Time = 20:55:00      
                                                                                
 Subsystem:  VTAM        Category:           Extstop :  NEVER     Modified: No    
                      Subcategory:           Jobtype :  MVS
                        
 S/C Define Command  S/R Define Reply
                                
 Cmd Phase      AutoFn/* Command Text
     Pass       Retry CT Reply Text                                
 --- ---------- -------- -------------------------------------------------------
     SHUTINIT                                                                   
                NETOPER  MVS D NET,BFRUSE                                       
                                                                                
     SHUTNORM                                                                   
     PASS1               MVS Z NET,QUICK                                        
     PASS2               MVS Z NET,CANCEL                                       
                                                                                
     SHUTIMMED                                                                  
     PASS1               MVS Z NET,CANCEL                                       
                                                                                
                                                                                
                                                                                
 Command ===>                                                                   
 PF1=Help PF2=End   PF3=Return  PF4=Reset   PF5=Save Changes    PF6=Roll        
                    PF8=Forward                                 PF12=Retrieve

Use the command code S or C to overwrite the command definition of a selected row in another panel or to define a new command for an empty row.

Use the command code S or R to overwrite the reply definition of a selected row in another panel or to define a new reply in an empty row.

Only one command code can be issued at a time.

Additionally you can use the slash character (/) to make the selected line the first line of the display.

When overwriting the displayed data, the changes are at first accumulated in storage, until PF5 is used to save the changes. Thereafter the previously loaded configuration definitions are saved and the changed definitions are loaded into storage. The changed definitions are used for the next startup or shutdown of the application.

After the changed definitions have been used to start up or shut down an application, the changes are discarded and the saved configuration data is restored into storage to be used for further startups or shutdowns of the application.

The Modified flag indicates that changed startup or shutdown definitions have been loaded into storage.

PF7/PF8 lets you scroll forward and backward if more than one screen is needed to display the data.

PF10/PF11 lets you shift right and left if the defined action is longer than the screen width.

For further details about the fields on the panel, see the online help and IBM Z System Automation Defining Automation Policy.