The LIMS/SM Utilities Collection (VS0067)

			MP_REPORTS.DOC

	****************************************************************
		
	NOTE:	The following has been supplied to the DECUS library
		by Digital Equipment Corporation.  This software has
		been supplied as is, with no expressed or implied 
		commitment to maintain, update, or support it or
		its use.  By supplying this, DEC and the author(s) 
		of the following are not responsible for damage,
		consequential or inconsequential, which may result
		from its use.

	*****************************************************************

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

 PURPOSE:  The purpose of this document is to describe how to use the
           reports and subroutines that are supplied to extract 
	   information from the menu processor RMS data files.

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

This utility is composed of several different kinds of files, they are:

	MP_REPORTS.DOC
	--------------

	    This file.


	MP_REPORTS.BLD
	--------------

	    This DCL command procedure compiles all of the source
	code and links together all of the appropriate object	
	modules to produce working executables.


	LIMS$MENU$MENU_NODES.DEF
	------------------------

	    This file contains a layout and description of the menu
	processor MENU_NODES RMS data file.  A full description of
	each field as well as the index structure is provided.


	LIMS$MENU$OPER_PRIV.DEF
	-----------------------

	    This file contains a layout and description of the menu
	processor OPER_PRIV RMS data file.  A full description of
	each field as well as the index structure is provided.

	
	LIST_MENU_NODES.FOR
	-------------------

	    This FORTRAN source code program provides the user with
	a report of the contents of the menu processor MENU_NODES 
	RMS data file.  Several different kinds of reports are
	available.


	LIST_OPER_PRIV.FOR
	-------------------

	    This FORTRAN source code program provides the user with
	a report of the contents of the menu processor OPER_RPIV 
	RMS data file.  Several different kinds of reports are
	available.


	QUERY_OPER_PRIV.FOR
	-------------------

	    This FORTRAN source code program provides the user with
	three different ways of querying the menu processor OPER_PRIV
	RMS data file for information.  The first way is to provide the
	subroutine a operator ID and the corresponding operator name
	will be returned.  The second mode is to provide the subroutine
	with a operator username and the corresponding operator ID will
	be returned.  The third mode of use is to supply neither the
	operator username or ID.  This will result in a dynamic string
	being produced that contains all of the operator names and
	corresponding operator IDs.


	EXAMPLE_QUERY_OPER_PRIV.FOR
	---------------------------

	    This FORTRAN source code program shows the user how to make
	all of the possible calls to the subroutine query_oper_priv.
	When the subroutine is called and a dynamic string is requested
	code is provided that demonstrates how to manipulate the
	dynamic string.


	OPEN_MP_FILES_READONLY.OBJ
	--------------------------

	    This FORTRAN object module is the only subroutine that does
	not have FORTRAN source code provided.  This subroutine opens
	either the MENU_NODES or OPER_RPIV RMS data file.  The file is
	opened shared readonly and the lun pointing to file is passed
	back to the user.
Click on FTP to download from the FTP archives.