Communicator 3000 MPE/iX Release 6.0 (Platform Software Release C.60.00) (30216-90269)

Chapter 10 199
Technical Articles
CI Enhancements
The number of processes that have the file locked (L:) is seen next.
The number of lockers includes all file system locks (semaphores)
held by all detectable processes that are accessing the file. A single
process can obtain multiple locks, and each time the count is
incremented. When a process releases a lock, the count is
decremented. The locks that are considered are the FLOCK
semaphore (used by the FLOCK intrinsic), the OPEN semaphore
(used by the file system), and the GUFD semaphore (used to control
I/O).
The number of writers (W:) and readers (R:) are displayed next. The
writer and reader counts can be greater than the number of
accessors since a single process can open the same file multiple
times. Also, when a process opens a file for append, update, or save
(read/write) access both the writer and reader counts are
incremented.
After all of the counts are shown, the file-sharing mode is displayed.
This is either "Share" for files opened shared, or "Exclusive" for files
opened exclusively. Typically when a file is opened exclusively there
is only a single accessor; however, the POSIX fork() and dup()
functions are exceptions.
The last item displayed in the access summary is the backup state. If
the file is being stored, then "Storing" is shown. If the file is being
restored, then "Restoring" is seen. If the file is being concurrently
backed up, then "ConcurrBackup" is displayed. Otherwise, nothing
additional is shown.
3. The lines after the accessor summary line reflect each job and
session accessing the file. There is one line displayed for each job and
session accessing the file, even if there are multiple processes within
the job accessing the same file.
The first field shown is the job/session number. If the accessor is a
system process then "system" is seen instead of a job ID. Following
the job ID is the user name associated with the job. This consists of
the USER.ACCOUNT preceded with an optional job name. The logon
group name is not seen.
The same counts displayed in the accessor summary line are shown
for each individual job accessor. The definitions are identical. Unlike
the summary line, the reader and writer fields are truncated if the
process and locker counts are extremely high. In this event the
right-most field is the first to be truncated and an "$" indicates that
truncation occurred.
The last field displayed depends on whether the accessor is a job, a
remote session or a local session. For jobs, the spoolfile ID is shown.
For local sessions, the LDEV number is displayed. If the accessor is
remote, the IP address is shown.