IBM Support

About the .pid file located in VOB and View storage directories

Technote (FAQ)


Question

What is the purpose of the .pid file that is stored in the IBM Rational ClearCase VOB and View storage directory on Microsoft Windows, Linux and UNIX?

Answer

The .pid file is located in the VOB and View storage directory.

On UNIX and Linux the .pid is a one-line text file that lists the process ID of the VOBs or Views associated processes.

On Windows the .pid is a place holder file for memory that tracks the process ID of the VOBs or Views associated processes.

Example: (View on UNIX)

%> ls -al /net/host1/viewstore/view1.vws

total 28
drwxr-xr-x   6 jdoe  clearuser     512 Mar  9 14:40 .
drwxrwxrwx  21 root     other        512 Mar 21 07:20 ..
-r--r--r--   1 jdoe  clearuser     436 Dec 28 14:02 .access_info
drwxr--r--   3 jdoe  clearuser     512 Apr  5 04:30 admin
-rw-r--r--   1 jdoe  clearuser     221 Jul 26  2005 .compiled_spec
-rw-r--r--   1 jdoe  clearuser      44 Jul 26  2005 config_spec
drwxr-xr-x   2 jdoe  clearuser     512 Apr  5 04:30 db
-r--r--r--   1 jdoe  clearuser       6 Jul 26  2005 .hostname
drwx------   2 jdoe  clearuser     512 Apr  5 04:30 .identity
-rw-r--r--   1 jdoe  clearuser       7 Mar  9 14:40 .pid
-r--r--r--   1 jdoe  clearuser     373 Jul 26  2005 readme.txt
drwxr-xr-x  59 jdoe  clearuser    1024 Apr  5 04:30 .s
-r--r--r--   1 jdoe  clearuser      80 Jul 26  2005 .view
-rw-r--r--   1 jdoe  clearuser       2 Mar  9 14:41 view_db.state

Note: To view the contents of the .pid on UNIX, use the cat command.

Example:

%> cat /net/host1/viewstore/view1.vws/.pid
18763


Example: (VOB on Windows)

C:\>dir \\host1\ccstg_e\VOBs\my_test_vob.vbs

 Volume in drive \\host1\ccstg_e is Secondary
 Volume Serial Number is FC87-7DF3

 Directory of \\host1\ccstg_e\VOBs\my_test_vob.vbs

04/05/2006  09:53 AM    <DIR>          .
04/05/2006  09:53 AM    <DIR>          ..
09/13/2004  11:10 AM                 6 .hostname
08/11/2004  09:03 AM                 0 .pid
09/15/2003  05:53 PM    <DIR>          admin
09/15/2003  05:53 PM    <DIR>          c
09/15/2003  05:53 PM    <DIR>          d
04/04/2005  12:16 PM    <DIR>          db
08/11/2004  09:02 AM               120 groups.sd
08/11/2004  09:02 AM               420 identity.sd
02/28/2002  03:20 PM                42 replica_uuid
09/15/2003  05:52 PM    <DIR>          s
02/28/2002  03:20 PM                42 vob_oid
02/28/2002  03:20 PM               643 vob_server.conf
               7 File(s)          1,273 bytes
               7 Dir(s)  31,099,723,776 bytes free


Note:
Attempts to read an active .pid file on Windows will result in the following error:

C:\>type \\host1\ccstg_e\VOBs\my_test_vob.vbs\.pid

The process cannot access the file because another process has locked a portion of the file.

BACKUP CONSIDERATIONS: Depending on how your backups are run, access errors may be reported during attempts to back-up or copy the .pid file. This can be ignored as the file is recreated when needed and does not require to be backed-up.

Related information

About albd_list
About Invalid server idle from unknown child pid=###
About .compiled_spec and config_spec
About the .view file

Document information

More support for: Rational ClearCase
General Information

Software version: 7.0

Operating system(s): AIX, HP-UX, IRIX, Linux, Solaris, Windows

Reference #: 1117327

Modified date: 08 January 2007