OA66933: PROGRAM HSIXINQ MSGHSIX007E RC86 RSN06B3 FOR UFS OWNED BY OTHER SYSTEM

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• When program HSIXINQ encounters a UFS (Union File System) owned
  by another system, it receives return code ENOSYS (134) and
  reason code JRUFSSYSPLEXNOTSUPPORTED (1715) for service call
  BPX1LST which results in message HSIX007E and CC=08 even though
  this is not a condition requiring attention.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All IBM Z Software Asset Management V8.2     *
  *                 and V8.3 customers.                          *
  ****************************************************************
  * PROBLEM DESCRIPTION: When program HSIXINQ is scanning the    *
  *                      UNIX file system:                       *
  *                      1. Message HSIX007E is issued when a    *
  *                         UFS directory not owned by the       *
  *                         execution system is encountered,     *
  *                         unnecessarily raising the step       *
  *                         completion code to 8.                *
  *                      2. Message HSIX004I is issued to        *
  *                         report that files smaller than       *
  *                         8 bytes could not be read when       *
  *                         they were read entirely.             *
  *                      3. The /proc directory is               *
  *                         unnecessarily scanned even though    *
  *                         it contains no software files.       *
  ****************************************************************
  1. As UNIX directory entries are read, they are processed by
     making an lstat (BPX1STA) call. Any non-zero return code
     from BPX1STA is treated as an error, including RC=x'86'.
  2. Whenever the read (BPX1RED) return value is less than 8
     it is treated as an error, even though only negative values
     are errors and positive values are the bytes-read count.
  3. The /proc directory is treated as a normal directory.
  

Problem conclusion

• Program HSIXINQ is changed such that:
  
  1. Return code x'86' (ENOSYS - function not implemented) will no
     longer be treated as an error but as an indication that the
     file system entity cannot be processed on the execution
     system. If PTHMSG or ALLMSG is specified in the program
     parameter string then a message listing the entity as
     skipped will be produced. A count of these skipped items will
     be reported as "exotic entries skipped". Note that no check
     for the JRUFSSYSPLEXNOTSUPPORTED reason code (1715=x'6B3')
     is made - all reason codes for return code ENOSYS will be
     treated the same with no change to the step completion code.
  
  2. Message HSIX004I reporting BPX1RED errors will only be
     issued when the return value is -1. Further, files smaller
     than 256 bytes will be assumed to not be program objects and
     will not be read.
  
  3. The /proc directory will be automatically skipped in the
     same way that the /dsfs (data set file system) directory is.
  

Temporary fix

Comments

APAR Information

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

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

  UJ95901 UJ95902

Modules/Macros

• HSIXINQ
  

Fix information

• Fixed component name

  TIV ASSET DISC

• Fixed component ID

  5698B39TD

Applicable component levels

• R820 PSY UJ95902

     UP24/09/06 P F409

• R830 PSY UJ95901

     UP24/09/06 P F409

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.