Description

   The TEST command provides a mechanism to test site-supplied
   subroutines intended for use with the popstore. The purpose and
   usage of those subroutines is described in the PMDF popstore
   & MessageStore Manager's Guide. Note that the shareable image
   containing the subroutine to be tested must be installed as a
   known image with the DCL INSTALL CREATE command. Moreover, an
   executive mode logical must be used to reference the image.
   The name of that logical is specified with the image-spec
   parameter. And, any logical referenced by that logical must also
   be an executive mode logical. These requirements are OpenVMS
   requirements and are enforced by LIB$FIND_IMAGE_SYMBOL, the run-
   time library subroutine used by the popstore to dynamically load
   and link to the subroutine.

   Note that if you use the TEST command and then subsequently
   change your subroutine, then you will need to exit the utility
   and restart it before you can retest your subroutine. This is
   because LIB$FIND_IMAGE_SYMBOL won't reload the subroutine a
   second time. Also, when rebuilding a shareable image, be sure
   to use the DCL INSTALL REPLACE command to install the new version
   of the image.

   The TEST/MESSAGE_MAPPING and TEST/PROFILE_MAPPING commands test,
   respectively, MAP_MESSAGE_FILENAME and MAP_PROFILE_FILENAME
   subroutines. The command will load the subroutine from the
   specified image and then, for each stored message or profile
   file, run the filename through the subroutine. The input and
   output file names for each file will be displayed along with
   diagnostic information, should an error occur.

   The TEST/CONNECT and TEST/BLOCK_DAYS commands test, respectively,
   the COMPUTE_CONNECT and COMPUTE_BLOCK_DAYS subroutines. With
   each command, you can specify the values of the input arguments
   to be passed to those subroutines. The results produced by
   the subroutine will then be displayed. Should an error occur,
   diagnostic information will be displayed.

   Text files intended for use as PMDF_TABLE:POPSTORE_MESSAGE_PATHS.
   or PMDF_TABLE:POPSTORE_PROFILES_PATHS. files can be tested with
   the TEST /PATHS command. The command will scan the directory
   trees listed in the specified file, displaying the files found in
   each directory tree.