MODIFY INOPDUMP command

Read syntax diagramSkip visual syntax diagramMODIFY procname,INOPDUMP= OFFON ,TRLE=trle_name(,trle_name)

Abbreviations

Operand Abbreviation
MODIFY F

Purpose

INOPDUMP controls the automatic dumping of VTAM® when an inoperative condition occurs in one of VTAMs data link control layers (DLCs). There are three separate but related controls:
  • The global INOPDUMP status, which is also the VTAM INOPDUMP start option. The global INOPDUMP status can be set for all DLCs or it can be selectively set for a subset of resources that are associated with an INOPDUMP control group. If the global INOPDUMP status is on for all resources, or is on for the BASE control group, this controls automatic dumping when an inoperative condition is declared on a resource that is not defined within a TRLE (transport resource list entry). The global INOPDUMP status is copied to the TRLE when a TRLE is activated if the TRLE InOpDump status has not been explicitly set.
  • The TRLE INOPDUMP status which controls automatic dumping when an inoperative condition is declared on a resource that is defined within the TRLE.
  • The INOPCODE status, which controls whether a given code in the module detecting the inoperative condition is enabled for automatic dumping. See MODIFY INOPCODE command for more details on the interaction between INOPDUMP and INOPCODE.

Use MODIFY INOPDUMP to alter either the global or TRLE INOPDUMP status. Use the MODIFY VTAMOPTS, INOPDUMP command to alter the INOPDUMP global status selectively using control groups.

Operands

procname
The procedure name for the command. If procname in the START command was specified as startname.ident, where startname is the VTAM start procedure and ident is the optional identifier, either startname.ident or ident can be specified for procname.

If procname in the START command was startname, startname must be specified for procname.

INOPDUMP=ON
Specifies that either the global or TRLE inopdump status is to be set on for all resources.
INOPDUMP=OFF
Specifies that either the global or TRLE inopdump status is to be set off for all resources.
TRLE=trle_name
Specifies the TRLE name or names for which the INOPDUMP status is to be altered.
Note:
  1. If the TRLE operand is not specified, both the global and TRLE statuses are altered. If the TRLE operand is specified, only the status of the TRLE for the name or names specified is altered and the global status remains unchanged.
  2. The response to a successful global Modify INOPDUMP command will always include the global INOPDUMP status. If the TRL major node was available at the time of the command, you will receive a reminder message that the status for all TRLEs has also been changed. The response to a successful Modify INOPDUMP command that includes the TRLE option will always include the global INOPDUMP status along with the TRLE name or names that were processed.

Examples

Modifying INOPDUMP information: 
f vtam,inopdump=off,trle=trle1a 
   IST097I MODIFY ACCEPTED 
   IST1865I GLOBAL INOPDUMP = OFF   
   IST1866I TRLE = TRLE1A   INOPDUMP = OFF 
   IST314I END 
   IST223I MODIFY INOPDUMP COMMAND COMPLETED