Register an application with VTAM® application
node recovery.
Issue recovery commands for all applications registered with VTAM application node recovery
when VTAM has restarted.
List applications that are registered for application node recovery.
List major nodes that are in use by applications. When
the subsystem terminates, the major nodes are automatically purged.
Syntax
Parameters
subsystem
The subsystem parameter specifies the name of the subsystem that
is registering with SA z/OS VTAM application recovery. This
parameter is required with REQ=ACTIVATE to register
a subsystem. If it is omitted with REQ=ACTIVATE,
all subsystems currently registered will have the VTAMUP message command
policy driven to allow them to take actions when VTAM is restored to active service. This parameter
is required with REQ=DEACTIVATE.
REQ
Specifies the request. It can be one of the following:
LIST
If no subsystem is specified, it lists all subsystems registered
for VTAM application node recovery.
If a subsystem is specified, it lists all the major nodes registered
for that subsystem.
ACTIVATE
If the subsystem parameter is specified, it registers the list
of major nodes as specified in the MAJNODE= parameter
and issues VTAM ACTIVATE commands
for them. If the subsystem parameter is not specified, REQ=ACTIVATE issues
the commands in the messages policy VTAMUP for every subsystem that
is registered for application node recovery.
DEACTIVATE
A subsystem must be specified for this request. This request issues VTAM INACT commands for the major
nodes that were previously registered. INACT commands are not issued
for any major node that contains model resources or is in use by another
registered application.
MAJNODE
This defines a list of VTAM application
major nodes that will be acted on.
TARGET
For information on the TARGET parameter, refer to IBM Z® System Automation Operator's
Commands.
Return Codes
0
Normal End.
4
Warning (Vary command failed).
8
Error.
Restrictions and Limitations
To use the
INGVTAM command SA z/OS must
be fully initialized.
Usage
It is recommended that you
issue the REQ=ACTIVATE and REQ=DEACTIVATE commands on the same system as the subsystems concerned.
It is recommended that you place REQ=ACTIVATE in the application's PRESTART and REFRESHSTART phase
(use STARTUP policy in the customization dialog). However,
REQ=DEACTIVATE should be placed in the application's SHUTFINAL phase (use policy SHUTDOWN policy of
the customization dialog). For the VTAM subsystem, the INGVTAM REQ=ACTIVATE command should be defined as a
command in the application's 'status' message UP (use MESSAGES/USER DATA policy of the customization dialog).
Examples
If you enter INGVTAM
REQ=LIST the output is similar to Figure 1. Figure 1. INGVTAM
REQ=LIST Output
List of subsystems registered with VTAM
Subsystem Subsystem Subsystem Subsystem
EYUCMS1A
*** End of Display ***
If you enter INGVTAM subsystem REQ=LIST the
output is similar to Figure 2. Figure 2. INGVTAM subsys REQ=LIST Output
List of major nodes registered with subsystem subsys
Major Node Type Major Node Type
KEY1BCPA APPL
*** End of Display ***
To register a subsystem for application
node recovery, specify, for example:
INGVTAM &SUBSAPPL REQ=ACTIVATE MAJNODE=(IPSMBC)
To
deregister a subsystem for application node recovery, specify, for
example:
