IT48897: DSMULOG DOCUMENTATION REQUIRES IMPROVEMENTS

8.2.1.000-IBM-SPSRV-WindowsX64
8.2.1.000-IBM-SPSRV-Linuxx86_64
8.2.1.000-IBM-SPSRV-Linuxs390x
8.2.1.000-IBM-SPSRV-Linuxppc64le
8.2.1.000-IBM-SPSRV-AIX

APAR status

• Closed as documentation error.

Error description

• The "dsmulog" documentation in the Knowledge Center, for
  
  example https://www.ibm.com/docs/en/storage-protect/8.1.27?
  topic=su-dsmulog-capture-storage-protect-server-messages-use
  r-log-file, requires correct examples and needs updating.
  
  Some examples (none-exhaustive list):
  
   - The syntax diagram indicates a comma-separated list must
  
     be used but the example shows a list without commas.
   - A size option can be specified to limit the size of the log
  
     files.  This is not mentioned in the syntax diagram.
  
  
  IBM Storage Protect Versions Affected:
  IBM Storage Protect Server version 8.1.0 and higher and 8.2.0
  
  on all supported platforms
  
  
  Additional Keywords: TSM, TS020955585, dsmulog
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * All IBM Storage Protect server users                         *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * See error description.                                       *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * Apply fixing level when available. This problem is currently *
  * projected to be fixed in level 8.2.1. Note that this is      *
  * subject to change at the discretion of IBM.                  *
  ****************************************************************
  

Problem conclusion

• The DSMULOG command does not support using commas to specify
  multiple log file names. To specify more than one log file,
  enter each file name separated by a space. The syntax diagram is
  updated to remove the comma requirement.
  The documentation is also updated to include information about
  using the -s size parameter.
  
  This update will be available in the IBM Storage Protect server
  8.2.1 documentation at the following topic URL:
  https://www.ibm.com/docs/en/storage-protect/8.2.1?topic=su-dsmul
  og-capture-storage-protect-server-messages-user-log-file
  
  Affected platforms:
  AIX and Linux.
  

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