PM69330: CLEARTOOL PROTECTVOB MAN PAGE SHOULD STATE THAT IT SHOULD ONLY BE RUN ON A VOB NOT BEING ACCESSED

Rational ClearCase Fix Pack 05 (8.0.0.5) for 8.0
Rational ClearCase Fix Pack 11 (8.0.0.11) for 8.0
Rational ClearCase Fix Pack 12 (8.0.0.12) for 8.0
Rational ClearCase Fix Pack 13 (8.0.0.13) for 8.0
Rational ClearCase Fix Pack 14 (8.0.0.14) for 8.0
Rational ClearCase Fix Pack 15 (8.0.0.15) for 8.0
Rational ClearCase Fix Pack 16 (8.0.0.16) for 8.0
Rational ClearCase Fix Pack 17 (8.0.0.17) for 8.0
Rational ClearCase Fix Pack 18 (8.0.0.18) for 8.0
Rational ClearCase Fix Pack 19 (8.0.0.19) for 8.0
Rational ClearCase Fix Pack 20 (8.0.0.20) for 8.0
Rational ClearCase Fix Pack 21 (8.0.0.21) for 8.0

APAR status

• Closed as program error.

Error description

• In older versions of the IBM Rational ClearCase cleartool man
  page for protectvob it states, 'Execute this command only while
  a VOB is quiescent (no active users); it stops and restarts the
  associated vob_server process, which prevents access to storage
  pools.'
  
  The man page in version 7.x and 8.x do not clearly state this.
  Since this is not stated clearly some customer have attempted to
  run the command on a VOB being accessed and protectvob failures
  are seen with errors such as:
  
  vob_server.exe(2644): Error: Temporarily unavailable, admin
  process running as pid 65535
  Albd(2284): Error: Server vob_server.exe (pid=2644) on
  'C:\vobs\VOB1.vbs' died on startup; marking it as 'down'.
  vobrpc_server.exe(3292): Error: Problem starting vob_server for
  vob vobserver1.company.com:C:\vobs\VOB1.vbs
  vobrpc_server.exe(3292): Error: See albd or vob error logs on
  host vobserver1.company.com
  
  
  WORKAROUND:
  Run the protectvob command only on a VOB which is not being
  accessed at all by any user or process.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  The IBM Rational ClearCase cleartool man page for protectvob
  in versions 7.x and 8.x does not clearly state the
  restriction that the command should only be executed while a
  VOB is quiescent.
  

Problem conclusion

• This has been corrected in ClearCase 7.1.2.9 and 8.0.0.5.
  

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

  CC&CC MSITE WIN

• Fixed component ID

  5724G3300

Applicable component levels

• R712 PSN

     UP