31-May-2004
                            DBS-SCANLOCKS V3.0

This package contains the SCAN_FILE_LOCKS, GETLKI and GETVALBLK programs
which retrieve information about locks on files and other resources.
Invoke the utilities by defining symbols thus:

	$ scanl*ocks == "$location:scan_file_locks"
	$ getlki == "$location:getlki"
	$ getval*blk == "$location:getvalblk"

SCAN_FILE_LOCKS is expecting a file name as the paramater, or you can
specify a device and file ID;

	$ SCANLOCKS filename
	$ SCANLOCKS FILE filename
	$ SCANLOCKS DEVICE somedevice: IDENTIFICATION fileid seq rvn
	$ SCANLOCKS DEVICE somedevice: FID fileid seq rvn

GETLKI and GETVALBLK expect the name of a resource, which can contain
wildcards (there is currently no way to specify binary data in the
resource name -- coming in the future).

	$ GETLKI rms$*
	$ GETVALBLK *somestring*

To build from source or to relink you will need the DBS-BUILD_LIBRARIES
package and you will need to define a LNK$LIBRARY logical to point to
either SYS_OBJECTS.OLB or DBSSYSRTL.OLB.

Contents:
---------
   File                          Description
------------------------------------------------------------------------------
AAAREADME.1ST			This file
FREEWARE_README.TXT

[.EXE]				-- The executables --
	GETLKI.ALPHA_EXE
	GETLKI.IPF_EXE
	GETLKI.VAX_EXE
	GETVALBLK.ALPHA_EXE
	GETVALBLK.IPF_EXE
	GETVALBLK.VAX_EXE
	SCAN_FILE_LOCKS.ALPHA_EXE
	SCAN_FILE_LOCKS.IPF_EXE
	SCAN_FILE_LOCKS.VAX_EXE

[.OBJ]				-- The objects --
	LINK_SCANLOCKS.COM
	GETLKI.ALPHA_OBJ
	GETLKI.IPF_OBJ
	GETLKI.VAX_OBJ
	GETVALBLK.ALPHA_OBJ
	GETVALBLK.IPF_OBJ
	GETVALBLK.VAX_OBJ
	SCAN_FILE_LOCKS.ALPHA_OBJ
	SCAN_FILE_LOCKS.IPF_OBJ
	SCAN_FILE_LOCKS.VAX_OBJ

[.OTHER]			-- Assorted stuff --
	SAMPLE.OUTPUT		Some samples of the output

[.SRC]				-- The source --
	BUILD_SCANLOCKS.COM
	GETLKI.FOR
	GETVALBLK.FOR
	SCAN_FILE_LOCKS.MAR

------------------------------------------------------------------------------

The following VMS and compiler versions were used:

              VAX        Alpha      Itanium

    VMS       7.3        7.3-2      8.1

    FORTRAN   6.6-201    7.6-3276   T8.0-3804

    MACRO     5.4-3      4.1-18     T1.0-77

Any bug reports (or fixes), comments, suggestions etc. should be directed
to me at the address below.

Dave.
-------------------------------------------------------------------------
David B Sneddon (dbs)  OpenVMS Systems Programmer   dbsneddon@bigpond.com
DBS software at ...   http://www.users.bigpond.com/dbsneddon/software.htm