OW26052: VIT FORMAT ANALYSIS TOOL 8K BUFFER

Obtain the fix for this APAR.

APAR status

• Closed as unreproducible.

Error description

• Using the VIT Analysis Tool (as documented in Chapter 9 of
  the VTAM Diagnosis Guide) to format a VTAM Internal Trace,
  multiple errors can occur.  Some errors cannot be detected and
  appear as 'missing' trace entries.
    Trace entries that produce continuation entries may be
  missing some or all of the continuation entries.
    For example, an EXIT entry might be seen with no preceding
  DSP entry
    When 8K BUFFER VIT is used, entries can be created by GTF
  that cause formatting problems by VTAM.  The entries are
  created correctly by GTF but cannot be handled by the
  VTAM formatter.  Formatting does not complete correctly.
  
    Example:
  Using VIT Analysis tool for VTAM 4.3 the following occurs:
  
  VTAM V4     Trace Analysis       Log
  
  Group for VIT entry E}   is unknown (record 6).
  
  Group for VIT entry ::   is unknown (record 6).
  
  Group for VIT entry ::   is unknown (record 6).
  
  Group for VIT entry D   is unknown (record 6).
  
  Group for VIT entry :-   is unknown (record 6).
  
    Each of the above messages indicates that the formatter is
  scanning the record looking for a valid header but fails to
  find one.
  
  A sample GTF PROC in error is listed below.......
  
  //GTF     PROC   MEMBER=ALL
  //VTAM    EXEC PGM=AHLGTF,PARM='MODE=EXT,DEBUG=NO,TIME=YES',
  //             REGION=2280K,DPRTY=(15,15)
  //IEFRDER DD   DSNAME=SYSNET.TRACE8,DISP=SHR
  //SYSLIB  DD   DSN=MY.PARMLIB(&MEMBER),DISP=SHR
  SYSNET.TRACE8  atribs:
  
  DSORG=PS, RECFM=VB, LRECL=4092, BLKSIZE=4096
  

Local fix

• The problem is caused by the 'physical' blocksize defined for
  GTF.  An LRECL/BLKSIZE of less that 8K (8192) can cause GTF to
  wrap the 8K buffer across blocks.  The block that is split
  creates a GTF record with a first character identifier that
  VTAM does not recognize - therefore the formatting error.
    Insure that the dataset attibutes of the IEFRDER DD statement
  defines a BLKSIZE of at least 8K.
  
  SYSNET.TRACE8  atribs:
  
  DSORG=PS, RECFM=VB, BLKSIZE=8196
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users.                                   *
  ****************************************************************
  * PROBLEM DESCRIPTION: The VIT extraction tool cannot extract  *
  *                      VIT records from a GTF trace when the   *
  *                      GTF record size is under 8K.            *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  The output from the VIT extraction tool contains incorrect
  summary information and the extracted VIT records are
  mis-alligned.
  

Problem conclusion

Temporary fix

Comments

• The VIT extraction modules were modified to handle small GTF
  records properly.  In addition, the user will be notified
  that blocks of trace are missing, out of sequence, or have
  not been processed.
  

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

  UW39460 UW39461

Modules/Macros

• ISTATCVT ISTITTRC ISTLBL   ISTRACRR ISTRAFCB
  ISTRAFCC ISTRAFCD ISTRAFCE ISTRAFTD ISTRAFTX ISTRAFT2 ISTVITDL
  RAFTCONS RAFTGTF
  

Fix information

• Fixed component name

  VTAM V4 MVS/ESA

• Fixed component ID

  569511701

Applicable component levels

• R201 PSY UW39460

     UP97/07/11 P F707

• R301 PSY UW39461

     UP97/07/11 P F707

Fix is available

• Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.