IC64902: DOCUMENTATION SHOULD INDICATE WHAT PAGE SIZE IS USED FOR THE OFFSET SIZE IN THE ONSTAT -D OUTPUT

APAR status

• Closed as documentation error.

Error description

• The current documentation of an offset in onstat -d is: "The
  offset into the file or raw device in pages"
  
  The offset size in the "onstat -d" output shows the value in
  base page size not in dbspace page size. That should be
  documented.
  
  Example:
  
  onspaces -c -d dbs2 -k 8k  -p /chunks/1150fc4/dbs2 -o 4096000 -s
  500000
  
  onstat -d
  
  
  Dbspaces
  
  address     number   flags      fchunk   nchunks  pgsize   flags
  owner
  name
  
  123044028   1        0x60001    1        1        2048     N  B
  informix rootdbs
  1241409e8   3        0x60001    3        1        8192     N  B
  informix dbs2
   3 active, 2047 maximum
  
  
  
  Chunks
  
  address    chunk/dbs     offset     size     free  bpages  flags
  
  pathname
  
  1230441c0  1      1      0          100000   25011         PO-B-
  /chunks/1150fc4/rootdbs1.1
  124140b80  3      3      2048000    62500    62447         PO-B-
  /chunks/1150fc4/dbs2
   3 active, 32766 maximum
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * All users of IDS v11.50.xC5 and earlier documentation.       *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * Documentation for the onstat -d output in the IBM Informix   *
  * Administrator's Reference is incomplete.                     *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * Upgrade to latest documentation.                             *
  ****************************************************************
  

Problem conclusion

• The following information should be added to
   the Administrator's Reference:
  
  The definition of the offset field in on onstat -d output should
  include the statement that the offset field shows the offset
  into
  the file or raw device in base page size, not in dbspace page
  size.
  

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:

Fix information

Applicable component levels