inuse - check the j/ve status of a table
SYNOPSIS
inuse [ -d | -v | -u ] table
DESCRIPTION
inuse
provides information about the status of a
table by examining it's -i binary index.
The -i index is created and maintained
by the table editors
ve
and
jve
to store and update information
about how many users are accessing a table
simultaneously using j/ve; which records have been changed or
deleted and which are currently on a user's screen;
whether automatic record numbering is turned on and if so,
the next available record number; what character is used
as the field separator, etc..
If no switches are used on the command line,
inuse
produces a table of those rows which are in use at that moment.
OPTIONS
- -d
- (debug). A 3 column table of logical record number,
row disposition flag, and row offset is produced on the standard
output.
When the row is displayed on a user's screen, it is considered to
be in use, and the
flag
field will be -1.
If the row has been modified and the overall row length has
changed, then
flag
will be the negative value of the logical row at which the
modified version resides.
The
flag
column at the new logical row will be either the original
logical row number or 0, if the row is deleted.
flag
is 0 when the row at that offset has either been deleted
or has been modified more than once.
As rows are modified or deleted, their contents
at the original locations are blanked out,
to prevent inaccurate search results.
- -v
- (verbose). This option causes a single-row
table to be produced on the standard output.
Information in the row includes the table name; the exact time of
execution; the field separation character (in octal representation);
whether or not the table has been modified and what the next
automatic record number assignment is.
- -u
- (users). This option produces nothing on the standard output
but returns the number of users as its exit status.
EXAMPLES
$ inuse inventory
Item Amount Cost Value Description
---- ------ ---- ----- -----------
2 100 5.23 500 test tubes
$ inuse -d inventory
record flag offset
------ ---- ------
1 -11 70
2 2 96
3 3 114
4 4 133
5 5 161
6 6 191
7 0 210
8 8 222
9 9 234
10 10 247
11 1 260
$ inuse -v inventory
table time fs mod users recno
--------- ------------ --- --- ----- -----
inventory 940908154804 011 y 1 12
$ inuse -u inventory
$ echo $?
1
SEE ALSO