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.