MODIFY INOPCODE command


                                           .-ALL--------.     .-ALL------.                          
>>-MODIFY-- --procname--,--INOPCODE--=--(--+------------+--,--+----------+--,--+-DUMPENABLE--+--)-><
                                           +-ALL--------+     +-ALL------+     +-DUMPDISABLE-+      
                                           '-modulename-'     '-inopcode-'     '-DUMPDEFAULT-'

Abbreviations

Operand	Abbreviation
MODIFY	F
DUMPENABLE	DUMPE
DUMPDISABLE	DUMPD
DUMPDEFAULT	DUMPDEF

Purpose

INOPCODE is used to control the setting of the inoperative condition (InOp) code attributes:

A dump attribute of DUMPENABLE indicates that if the inoperative condition specified by the module and code occurs, and INOPDUMP is enabled for the resource, VTAM® will not avoid taking a dump.
A dump attribute of DUMPDISABLE indicates that if the inoperative condition specified by the module and code occurs, VTAM will avoid taking a dump.
A dump attribute of DUMPDEFAULT applies the original, IBM® supplied attributes.

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.

Positional Parameters:

Positional parameter 1 specifies the modules which contain the inopcodes to be altered.
Positional parameter 2 specifies the inopcode within the modules to be altered.
Positional parameter 3 specifies the dump attribute to be applied

Restrictions:

When specifying an InOpCode for the second positional parameter, always specify three digits by including any leading zeros.
When positional parameter 1 is ALL, positional parameter 2 must also be ALL.

Tip: The value of using ALL for either positional parameters 1 or 2, or both when applying a dump attribute of DUMPENABLE is questionable, especially when a resource is InOpDump active. Use caution with the ALL values when enabling.

Examples

Setting the dump attribute of ISTTSC8E inopcode 202 to DUMPDISABLE:

f vtam,inopcode=(isttsc8e,202,dumpd) 
   IST097I MODIFY ACCEPTED                                       
   IST1919I INOPCODES FOR MODULE ISTTSC8E:                              
   IST1920I   DUMP ENABLED:                                         
   IST1921I     002 003 004 005 006 007 008 009 010 011 012 013 014 100
   IST1921I     101 102 103 200 201 205 206 207 208                    
   IST1922I   DUMP DISABLED:                                           
   IST1921I     001 033 034 035 037 038 039 040 041 042 132 133 202 203
   IST1921I     204                                                    
   IST314I END
   IST223I MODIFY COMMAND COMPLETED

Restoring all IBM supplied defaults (does nothing unless at least one InOpCode has been modified):

f vtam,inopcode=(all,all,dumpdef)
   IST097I MODIFY ACCEPTED 
   IST1189I INOPCODE = DUMPDEFAULT
   IST223I MODIFY COMMAND COMPLETED

Using InOpDump and InOpCode together:

The following example assumes the trlename, modulename, and inopcode have been remembered from a previous InOp message.

Enable only a single InOpCode:

f procname,inopcode=(all,all,dumpd)
   IST097I MODIFY ACCEPTED 
   IST1189I INOPCODE = DUMPDISABLE
   IST223I MODIFY COMMAND COMPLETED

f procname,inopcode=(modulename,inopcode,dumpe)
   IST097I MODIFY ACCEPTED 
   IST1919I INOPCODE FOR MODULE modulename:
   IST1920I   DUMP ENABLED:
   IST1921I     inopcode
   IST1922I   DUMP DISABLED:
   IST1921I     rest of codes in modulename
   IST314I END
   IST223I MODIFY COMMAND COMPLETED

The above two commands, by themselves, will not result in a dump when the InOp occurs. This is because the resource is not yet enabled for InOpDump.

Enable the trlename for InOpDump:

f procname,inopdump=on,trle=trlename
   IST097I MODIFY ACCEPTED 
   IST1865I GLOBAL INOPDUMP = OFF
   IST1866I TRLE = trlename  INOPDUMP = ON
   IST314I END
   IST223I MODIFY INOPDUMP COMMAND COMPLETED

Now the dump will be taken if the condition leading to the use of the module inopcode occurs. After the problem is recreated and a dump has been acquired, restore the environment.

Set InOpDump off for all resources and restore all InOpCode IBM supplied defaults:

f procname,inopdump=off
   IST097I MODIFY ACCEPTED 
   IST1865I GLOBAL INOPDUMP = OFF
   IST1867I INOPDUMP = OFF FOR ALL TRLE-BASED RESOURCES
   IST314I END
   IST223I MODIFY INOPDUMP COMMAND COMPLETED

f procname,inopcode=(all,all,dumpdef)
   IST097I MODIFY ACCEPTED 
   IST1189I INOPCODE = DUMPDEFAULT
   IST223I MODIFY COMMAND COMPLETED