VTMODS

Use VTMODS to find the entry point of the VTAM® modules that reside in the VTAM private region. VTMODS reports the number of modules found and equates the entry point of each module found to its module name in the IPCS symbol table. After VTMODS executes, the VTAM modules found can be located using the module name in the IPCS LIST command.

VTMODS is useful when you are checking the PTF level of several modules or when you want to quickly verify the PTF or APAR level of a module in a dump.

Note: For VTMODS to execute successfully, the VTAM private region must have been dumped (that is, the RGN parameter must have been specified when the dump was taken). If fewer than 10 modules are found, VTAM private storage is missing from the dump.

If the dump does contain the VTAM private region but is a partial dump, VTMODS attempts to find as many VTAM modules as possible.

Operands

List: The default is N. Specify Y to receive a list of each module found, its entry point address, compile date, and PTF level, if present. The modules are in the order that they were found in storage (that is, by storage address, lowest to highest), followed by a list of the modules in alphanumeric order.

Equated symbol

For each VTAM module that is found, an IPCS symbol (the name of the module as it appears in the module eye-catcher) is equated to the entry point of the module.

Symbol: Description
module eye-catcher: Module entry point

Use the following syntax as an alternative to the panel interface.

Syntax


           .- --LIST--(--N--)-.   
>>-VTMODS--+------------------+--------------------------------><
           '- --LIST--(--Y--)-'

Additional information

The symbols created remain in the IPCS dump directory until the dump directory is deleted or until an IPCS DROPDUMP command is issued for the dump.

VTMODS scans VTAM private storage for the character string IST. When IST is found, a check is made to determine whether this occurrence of IST represents a VTAM module eye-catcher. Most VTAM modules have a branch instruction hexadecimal 47F0F0xx at the entry point to the module to branch around the eye-catcher. If hexadecimal 47F0F0xx appears 5, 7, or 9 bytes before the module eye-catcher, the location is considered in most cases to be a VTAM module entry point.

Storage is scanned starting at the lowest address of private storage to the top of the private region (below the 16 MB line). The scan then continues starting at the lowest address of extended private storage (above the 16 MB line) and continues for about hexadecimal 400 000 bytes.

Sample output

VTMODS LIST(Y)
 
                             VTMODS Analysis
Address      Module     Compiled      PTF
--------    --------    --------    -------
000063CA    ISTATM00    91.322
00006A70    ISTINCBX    91.322
00006CD0    ISTINCRS    91.320
000072E0    ISTIECHS    91.320
0000772A    ISTCPM01    91.319
00007768    ISTSSCXY    91.329
00009DC8    ISTCPCIT    91.322
0000A488    ISTINCR4    91.322
0000B7E8    ISTPUCWI    91.320
0000BD10    ISTSSCXX    91.320
0000C0F0    ISTCSCEX    91.322
0000CDA0    ISTPDCLU    91.322
0000EAA8    ISTPDCSE    91.320
00011588    ISTPUCX0    91.320
000124B0    ISTCSCSD    91.319
00015C00    ISTENQIO    91.336
00015EC0    ISTENQPR    91.326
00016A18    ISTENQIN    91.320
00016D90    ISTENQRT    91.320
02A00138    ISTINM01    91.338
02A01C68    ISTLUCQD    91.320
02A01EB0    ISTCPCQD    91.353
02A021B0    ISTPUCQD    91.319
02A021F8    ISTINCXR    92.003
02A02788    ISTSCCIT    92.002
02A02BC8    ISTINCCT    91.352
02A02EA8    ISTINCIT    91.352
02A03100    ISTINCPD    91.352
02A03E78    ISTINFIC    91.352
02A04680    ISTCICPR    91.352
02A082A0    ISTCICDF    91.352
02A08968    ISTINCCP    91.350
02A094E0    ISTORCEI    91.346
02A0EE88    ISTCICTR    91.346
02A10DA0    ISTINCTR    91.346
02A11EC0    ISTINCCF    91.346
02A132F0    ISTDRCIT    91.344
02A13B50    ISTINCSA    91.344
⋮
02C31168    ISTXP1WB    91.351
02C31848    ISTXP1WC    91.351
02C31D48    ISTXP1WR    91.351
02C32748    ISTXP1WS    91.351