CTRL-Verify, Utilities, Toggle DCL command procedure verification on and off. Copyright © 1994 by Brian Schenkenberger. All rights reserved. ------------------------- This software is provided "as is" and is supplied for informational purpose only. No warranty is expressed or implied and no liability can be accepted for any actions or circumstances incurred from the use of this software or from the information contained herein. The author makes no claim as to the suitability or fitness of this software or information contained herein for a particular purpose. ------------------------- This software may be copied and distributed only with the inclusion of this copyright notice. >-------------------------------------------------------------------------< *** CTRL-Verify (V2) *** Description: =========== CTRL-Verify provides the capability to enable and disable DCL command file verification by typing a CTRL-V while the procedure is executing. CTRL-Verify was initially created with the intention of demonstrating the mechanics for loading code into a process's P1 space on OpenVMS AlphaAXP. CTRL-Verify demonstrates how to load code into P1 space using a mechanism which provides a common code base on both OpenVMS platforms, AlphaAXP and VAX. >-------------------------------------------------------------------------< Release Information: =================== This is an update release of CTRL-Verify. (v2.4%253) This release was updated to add several code modifications to allow this package to be installed for use as an actual system utility. Originally, this package was intended *only* as a demonstration for loading P1 space, however, a number of sites were using CTRL-Verify wholey for its ability to toggle the DCL verify bit. This release supports installing the load routine with privileges. The installation information has been modified to detail additional installation requirements. These changes are due to the image activator's security counter-measures which will be 'in force' when the image is installed and are do to the ramifications of installing a routine with privileges. In addition, the LOAD_CTRLV program is now executed as a foreign command to load the AST code. The addition of the command qualifier, /KEY, can be specified with a key-name to associate the CTRL-Verify Out-of-Band AST with a key other than the default key, CTRL-V. CTRL-Verify can now be used to establish an out-of-band AST in the context of a sub-process. OpenVMS VAX V5.5 or greater and OpenVMS AXP V6.1 will properly support this feature. CTRL-Verify may still be used on systems prior to these versions, however, the use of the ATTACH command may cause the AST not to be delivered in a process which loaded CTRL-Verify. Distribution Information: ======================== CTRL-Verify requires both CMEXEC and LOG_IO privilege and executes code in executive and kernel access modes. Therefore, CTRL-Verify is distributed in source form for inspection. This package contains the following files: ========================================= $$$CTRL-VERIFY.INFO ...... This file. Background/release information. BUILD.COM ................ Compile and link the sources. DESCRIP.MMS .............. MMS (MMK) build rules. LOAD_CTRLV.MAR ........... The CTRL-Verify loader. VAST_SHARE.MAR ........... The verify AST routine. CTRLVCMD.CLD ............. The command definition file. VAST_SHARE.OPT ........... OpenVMS VAX linker option file VAST_SHARE.AXP_OPT ....... OpenVMS AXP linker option file CTRLV.CLD ................ Define CTRLV as a DCL command .CLD CTRLV.RNH ................ RUNOFF help file source INSTALL_CTRLV.TEMPLATE ... A template procedure to install CTRL-Verify STARTUP_CTRLV.TEMPLATE ... A template procedure to startup CTRL-Verify Installation Information: ======================== The logical VAST_SHARE must be defined to point to the location of the P1 AST routine shareable image, VAST_SHARE.EXE, prior to executing the loader image, LOAD_CTRLV.EXE. When the loader image, LOAD_CTRLV.EXE, is installed with the privileges CMEXEC and LOG_IO, the VAST_SHARE logical must be defined SYSTEM/EXEC. $ DEFINE/SYSTEM/EXEC VAST_SHARE {dev}:[{dir}]VAST_SHARE.EXE ----- The LOAD_CTRLV.EXE routine requires the privileges: CMEXEC and LOG_IO. LOAD_CTRLV.EXE may be installed with these privileges to permit a non- privileged user to load the CTRL-Verify AST. $ INSTALL ADD/PRIV=(CMEXEC,LOG_IO) {dev}:[{dir}]LOAD_CTRLV.EXE If the LOAD_CTRLV.EXE image is installed with privileges, VAST_SHARE.EXE must be installed as well. $ INSTALL ADD {dev}:[{dir}]VAST_SHARE.EXE ----- The VAST_SHARE.EXE image must be accessible to the process issuing the load. If CTRL-Verify is to be executed by all processes on the system, VAST_SHARE.EXE it should have WORLD:READ,EXECUTE file protection. ----- To use CTRL-Verify, define the foreign command CTRLV for executing the LOAD_CTRLV.EXE image. $ CTRLV:==$device:[directory]LOAD_CTRLV.EXE Note: The file CTRLV.CLD is supplied if you wish to add CTRLV to your DCL command tables. If you opt to add CTRLV to your command tables, you will need to define the system logical LOAD_CTRLV to point to the location of the LOAD_CTRLV.EXE image. ----- The CTRL-Verify AST may be loaded with the command: $ CTRLV/KEY= See the CTRLV.HLP file for the keywords. -------------------------------------------------------------------------- Any feedback on CTRL-Verify will be greatly appreciated. Send comments or suggestions to: or . -------------------------------------------------------------------------- .END.