IT30832: ADD AN OPTION TO FACILITATE PROGRAMMATIC PARSING OF "QUERY INCLEXCL" OUTPUT

APAR status

• Closed as new function.

Error description

• The QUERY INCLEXCL output format currently uses blank spaces to
  delimit the fields that make up the information. Although the
  output can be understood by humans, if the include-exclude
  pattern contains blank spaces, it is not easily parsed by
  computer programs such as GPFS mmbackup.
  
  The backup-archive client needs an enhancement to optionally
  display the QUERY INCLEXCL output in a format more easily parsed
  by GPFS mmbackup.
  
  This enhancement will facilitate the fix for GPFS APAR IJ20480.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * IBM Spectrum Protect backup-archive client versions 7.1.x    *
  * and 8.1.x on on AIX GPFS and Linux GPFS platforms            *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * See ERROR DESCRIPTION.                                       *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * Apply fixing level when available. This problem is projected *
  * to be fixed in levels 7.1.8.8, 8.1.9.1 and 8.1.10. Note that *
  * this is subject to change at the discretion of IBM.          *
  ****************************************************************
  

Problem conclusion

• To be able to correctly parse the inclexcl patterns that contain
  space characters, the IBM Spectrum Scale mmbackup command needs
  a 'parseable' dsmc query inclexcl command output. As a result of
  the fix, new PARSEABLE_INCLEXCL tesflag has been introduced to
  do so, with the tab character as the default delimiter.
  For example, instead of the default output with the space
  character as a delimiter:
  "Mode Function Pattern Source" e.g. "Include All /test/dir with
  space/* Inclexcl_file_path"
  the "dsmc query inclexcl -testflag=PARSEABLE_INCLEXCL" command
  will display the following output:
  "Mode\tFunction\tPattern" e.g. "Include\tAll\t/test/dir with
  space/*"
  

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:

Modules/Macros

• dsmc
  

Fix information

• Fixed component name

  TSM CLIENT

• Fixed component ID

  5698ISMCL

Applicable component levels