OA67534: IOEZ00844E MODIFY ZFS,FSINFO

APAR status

• Closed as documentation error.

Error description

• The MODIFY ZFS,FSINFO command documentation is incorrect.
  
  Issuing F ZFS,FSINFO,MY.FSNAME.*,EXCEPTION fails with an
  IOEZ00844E
  
  Despite the documentation indicating that BASIC is the default
  level of output, the user MUST specify a level of output for the
  command to work
  
  Ex.
  F ZFS,FSINFO,MY.FSNAME.*,BASIC,EXCEPTION
  
  
  ANALYSIS:
  zFS trace will show the command failure.
  
  KNOWN IMPACT:
  Command fails with
  IOEZ00844E Invalid option EXCEPTIONS.
  IOEZ00024E zFS kernel: MODIFY command -
  FSINFO,OMVS.PRV.*,EXCEPTIONS 656
  failed.
  
  VERIFICATION STEPS:
  IOEZ00844E Invalid option EXCEPTIONS.
  IOEZ00024E zFS kernel: MODIFY command -
  FSINFO,OMVS.PRV.*,EXCEPTIONS 656
  failed.
  
  ADDITIONAL SYMPTOMS:
  IOEZ00844E Invalid option EXCEPTIONS.
  IOEZ00024E zFS kernel: MODIFY command -
  FSINFO,OMVS.PRV.*,EXCEPTIONS 656
  failed.
  

Local fix

• BYPASS/CIRCUMVENTION:
  Specify the output level with the command
  Ex.
  F ZFS,FSINFO,MY.FSNAME.*,BASIC,EXCEPTION
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: z/OS File System (zFS) 2.5                   *
  *                 zFS FMID:HZFS450                             *
  *                                                              *
  *                 z/OS File System (zFS) 3.1                   *
  *                 zFS FMID:HZFS510                             *
  ****************************************************************
  * PROBLEM DESCRIPTION: The MODIFY ZFS,FSINFO command           *
  *                      documentation is incorrect.             *
  *                                                              *
  *                      Message IOEZ00844E was generated and    *
  *                      the request failed in response to the   *
  *                      following modify command :              *
  *                                                              *
  *                      F ZFS,FSINFO,MY.FSNAME.*,EXCEPTION      *
  ****************************************************************
  This apar is being used to clarify the MODIFY ZFS FSINO
  command. The fsinfo parameter  options are positional which
  caused the reported failure.
  

Problem conclusion

• This documentation APAR is providing information for the
  MODIFY ZFS FSINFO command in the z/OS File System
  Administration publication (SC23-6887-XX) for z/OS 2.5 and
  z/OS 3.1.
  
  In Chapter 10. z/OS system commands, some of the parameter
  sections for the modify fsinfo command are being updated.
  
  The fsinfo parameter section is being updated as follows:
  
  fsinfo
  Displays detailed information about a zFS file system, which is
  also known as a zFS aggregate. All fsinfo options are
  positional.
  
  The aggrname parameter section is being updated as follows:
  
  aggrname
  Specifies the name of the aggregate that the detailed zFS
  information is for. The aggregate name is not case-sensitive and
  is converted to uppercase. To specify multiple aggregates with
  similar names, use an asterisk (*) at the beginning, at the end,
  or both at the beginning and the end of aggrname as a wildcard.
  
   - If aggrname is specified with wildcards but no other options
     are specified, the default information display is basic.
  
   - If a single aggregate name is specified as aggrname but no
     other options are specified, the default information display
     is full.
  
   - If there are other options that are specified after aggrname,
     you must specify one of the basic, full, owner, or reset
     options.
  
  For more information, see "Usage notes for displaying file
   system information" on page 110
  and "Examples of displaying file system information" on page
  112.
  
  The all parameter section is being updated as follows:
  
  all
  Displays information for all aggregates in the sysplex. This
  uses the default information display option of basic if no
  other options are specified.
  
  The basic parameter section is being updated as follows:
  
  basic
  Displays a line of basic file system information for each
  specified file system. This option is the default in the
  following situations:
  
   - The all option is specified but no other options are
     specified.
   - aggrname is specified with wildcards but no other options
     are specified.
  For more information about what is displayed when the basic
  option is used, see Table 15 on page 200.
  
  The exceptions parameter section is being updated as follows:
  
  exceptions
  Displays information about any specified aggregate that is
  quiesced, disabled, had grow failures, is low on space, failed
  to convert a directory to version5, contains at least one
  V4 directory, disk size that exceeded the space monitoring
  threshold, or is damaged. Any specified aggregate is also
  displayed if it has had XCF communication failures or an error
  because it ran out of space or when doing I/O.
  
  This option cannot be specified with reset, select, and aggrname
  with no wildcard. An information display option must be
  specified.
  
  The reset parameter section is being updated as follows:
  
  reset
  Resets zFS statistics that relate to each specified file system.
  reset cannot be specified with basic, full, owner, exceptions,
  select, or sort. reset must be specified with aggrname or all
  option.
  
  The select=criteria  parameter section is being updated as
  follows:
  
  select=criteria
  Displays each specified file system that matches the criteria.
  
  This option cannot be specified with exceptions, reset, and
  aggrname with no wildcard. An information display option must
  be specified.
  
  To use this option, specify a selection criteria from Table 14
  on page 199. Multiple criteria are separated by spaces.
  
  The sort=sort_option parameter section is being updated as
  follows:
  
  sort=sort_option
  Sorts the displayed information using the value of sort_option.
  The default is to sort by Name.
  An information display option must be specified.
  
  This option cannot be specified with reset. For a list of the
  sorting options, see Table 17 on page 203.
  
  In the "Usage notes for displaying file system information", the
  following sentence is being added to the list of methods to
  specify aggregates, based on their names list :
  
   - all can be specified to mean all file systems that are
     currently mounted in the sysplex.
  
  The following line is being added to the supported syntax
  examples:
  
  F ZFS,FSINFO,aggrname*,BASIC,EXCEPTIONS
  

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