IC36827: ANR8366E UPDATE FILE DEVCLASS LIBRARY PARAMETER

APAR status

• Closed as program error.

Error description

• It is possible to define, or update, a FILE devclass
  with a library definition for LANFREE purposes but
  there is no way to update the definition back to
  NULL. The following message will be generated
  following the update devclass attempt:
  .
  upd devclass file libr=""
  ANR8366E UPDATE DEVCLASS: Invalid value for LIBRARY parameter.
  ANS8001I Return code 3.
  .
  If the library field has been populated
  by mistake, and the FILE devclass is not being used
  for LANFREE, and therefore, the library is not valid,
  any attempt to utilize this devclass wiil result in a
  failure. The following are message examples
  that may occur as a result of the invalid library definition:
  .
  .
  CLIENT
  ANS1312E Server media mount not possible
  .
  SERVER
  ANR0525W (Session: XXXX, Origin: XXXX)  Transaction
  failed for session XX for node XXXX (XXX) - storage
  media inaccessible.
  .
  .
  Initial Impact: Medium
  Additional Keywords: devc update file class devclass
  

Local fix

• 1) Manually correct the device entry in the SS.Classes
  table. This is a 3 step process requiring TSM Support.
  2) Apply PTF when available.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All TSM v5.1.X and 5.2.X servers             *
  ****************************************************************
  * PROBLEM DESCRIPTION: See ERROR DESCRIPTION                   *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  The user is not able to return a library to "" in a devclass
  of type file.
  

Problem conclusion

• Under some circumstances, a customer may want to set the
  library to something in a devclass with a devtype of "FILE".
  
  If the customer set the library of that devclass it was not
  possible to remove that library value by issuing something
  like UPDATE DEVCLASS <devclas name> library="".
  
  Now the server and storage agent will allow the customer to
  remove the library value for any devclass with a devtype of
  "FILE" with the UPDATE DEVCLASS 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

• Fixed component name

  TSM SERVER 510

• Fixed component ID

  5698ISMSV

Applicable component levels

• R52W PSY

     UP

• R51H PSY

     UP

• R51L PSY

     UP

• R51S PSY

     UP

• R51W PSY

     UP

• R52A PSY

     UP

• R52H PSY

     UP

• R52L PSY

     UP

• R52S PSY

     UP