IT47692: THE CHECKIN LIBVOLUME FOR SCSI LIBRARIES COMMAND DOCUMENTATION NEEDS UPDATE TO REFLECT THE SEARCH PARAMETER LIMITATION

8.1.27.000-IBM-SPSRV-WindowsX64-162
8.1.27.000-IBM-SPSRV-Linuxx86_64-162
8.1.27.000-IBM-SPSRV-Linuxs390x-162
8.1.27.000-IBM-SPSRV-Linuxppc64le-162
8.1.27.000-IBM-SPSRV-AIX-162

APAR status

• Closed as documentation error.

Error description

• The CHECKIN LIBVOLUME command for SCSI libraries documentation
  in the Administrative Commands section needs an update to
  include limitation for the SEARCH parameter. The restriction for
  the SEARCH=NO parameter and provided volume name is that the
  media cartridge must be at the first Bulk/Entry-Exit slot if the
  user puts the target cartridge to an Entry-Exit port of the
  library. If the target is not at the first slot, then the server
  will not check specified target volume into the library.
  
  
  IBM Storage Protect Versions Affected:
  IBM Storage Protect server on all platforms
  
  
  Additional Keywords:
  Spectrum Protect; CHECKIN; LIBVOLUME; SEARCH=NO; Bulk;
  TS017990651
  

Local fix

Problem summary

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

Problem conclusion

• This problem was fixed.
  
  Affected platforms: AIX, Linux, and Windows.
  
  ANR8426E CHECKIN LIBVOLUME for volume ABCDEFGH in library XYZ
  failed.
  Explanation
  The background process for a CHECKIN LIBVOLUME command has
  failed.
  SystemAction
  The background process ends, but the volume has not been checked
  into the library.
  UserResponse
  For manual library, make sure the library and drive devices that
  associated with
  this command are powered on and ready, and then reissue the
  command.
  For SCSI library, if SEARCH=NO is used, the server selects only
  the volume in
  the first entry-exit port for the target volume location. Make
  sure that the target
  volume locates in the first entry-exit port, and then reissue
  the command.
  

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