From:	CRDGW2::CRDGW2::MRGATE::"SMTP::CRVAX.SRI.COM::RELAY-INFO-VAX" 16-OCT-1989 19:54
To:	MRGATE::"ARISIA::EVERHART"
Subj:	LIBSEARCH SEARCH for VMS libraries 6/7

Message-Id:  <8910162038.AA02997@crdgw1.ge.com>
Received: From NSFNET-RELAY.AC.UK by CRVAX.SRI.COM with TCP; Mon, 16 OCT 89 11:33:31 PDT
Received: from ncdlab.ulcc.ac.uk by NSFnet-Relay.AC.UK   via Janet with NIFTP
           id aa10665; 16 Oct 89 17:16 BST
Date:           Mon, 16 Oct 89  17:24 BST
From: "Kevin Ashley - ULCC Networks Development." <KEVIN%ncdlab.ulcc.ac.uk@NSFnet-Relay.AC.UK>
To: INFO-VAX <@NSFnet-Relay.AC.UK:INFO-VAX@crvax.sri.com>
Subject:        LIBSEARCH SEARCH for VMS libraries 6/7

-+-+-+-+-+-+-+-+ START OF PART 6 -+-+-+-+-+-+-+-+
Xsubtopic names, and long subtopic names are truncated. Qualifier subtopics
Xare treated properly.
X3 V1.2
XVersion 1.2 of LIBSEARCH supports the /FORMAT qualifier in full
Xand also correctly implements message generation using VMS signals
Xrather than TYPE statements. The SET MESSAGE command now affects
Xits output, and status codes are correctly returned on failure.
X
XThe /SUBTOPIC switch has been added, and changes made to the handling
Xof difficulties opening input files.
X2 Additions
XThe following switches and features exist in LIBSEARCH, additional to those
Xprovided by SEARCH.
X
XThe /MEXCLUDE qualifier allows you exclude a particular module, or
Xwildcarded modules, from a search. It can be global (affecting all libraries
Xin the command) or local, affecting only one, or both.
X
XThe /MODULE qualifier allows you to specify that only certain modules are to
Xbe searched.
X
XThe /MEXCLUDE and /MODULE qualifiers can be used together.
X
XThe /STATISTICS and /LOG qualifiers produce information pertaining to
Xmodules searched, as well as files. /STATISTICS also reports on the match
Xcriteria used in the search.
X
XThe /MACRO,/HELP and /TEXT qualifiers cause filetype defaulting.
X
XThe /SUBTOPICS qualifier controls whether information is output on the
XHELP subtopic in which a target is found when searching HELP libraries.
X
XThe /BEFORE and /SINCE qualifiers apply to MODULES by default. If one of
Xthe /CREATED,/BACKUP,/BEFORE or /SINCE qualifiers is present, the dates
Xand times of the library files are used instead.
X
XThe output format of LIBSEARCH is slightly different from SEARCH. See topic
XOutput_format for more information.
X2 Output_Format
X The format of output from LIBSEARCH differs slightly from that produced
Xby the SEARCH command. LIBSEARCH outputs 40 asterisks between hits from
Xdifferent files, and 30 asterisks between hits from different modules. The
Xmodule name is displayed on a separate line, after the file name, before the
Xfirst hit from a specific module. In addition, if a HELP library is being
Xsearched, and the /SUBTOPIC qualifier is present, then the subtopic(s) in
Xwhich the target was found are displayed after the module name, on the same
Xline.
X
X 20 asterisks delimit output from different HELP subtopics within a single
X HELP module if the /SUBTOPIC qualifier is present (which it is by default.)
X
X 15 asterisks are present between different target windows if the /WINDOW
X qualifier is present with a non-zero value.
X2 Qualifiers
X/BACKUP
X /BACKUP
X
X Selects files according to the dates of  their  most  recent  backup.
X  This qualifier is only relevant when used with the /BEFORE or /SINCE
X  qualifier.  Use  of  the  /BACKUP  qualifier  is  incompatible  with
X  /CREATED, /EXPIRED, and /MODIFIED.  The default is none, which means
X  that the revision date of modules is used instead of that of files.
X
X/BEFORE
X /BEFORE`091=time`093
X
X Selects only those files or modules that are dated before the specified
X time. Module time is used by default, unless /CREATED,/BACKUP,/EXPIRED
X or /MODIFIED are specified.
X
X  You can specify either an absolute time or a combination of absolute
X  and delta times.  See the  VMS  DCL  Concepts  Manual  for  complete
X  information on specifying time values. You can also use the keywords
X  TODAY,  TOMORROW,  and YESTERDAY.  If no time is specified, TODAY is
X  assumed.
X/CONFIRM
X /CONFIRM
X /NOCONFIRM (default)
X
X  Controls whether a request is issued  before  each  individual file
X  or module to confirm that the operation should be performed on that
X  file or module.
X
X  When the system  issues  the  prompt,  you  can  issue  any  of  the
X  following responses:
X
X       YES      NO     QUIT
X
X       TRUE     FALSE  <CTRL/Z>
X
X       1        0      ALL
X
X                <RET> `032
X
X  You can use any combination of upper- and lowercase letters for word
X  responses.  Word responses can be abbreviated to one or more letters
X  (for example, T, TR, or TRU for TRUE).  Affirmative answers are YES,
X  TRUE, and 1.  Negative answers are NO, FALSE, 0, and <RET>.  QUIT or
X  CTRL/Z indicates that you want to stop  processing  the  command  at
X  that  point.   When  you  respond with ALL, the command continues to
X  process, but no further prompts are given.  If you type  a  response
X  other than one of those in the list, the prompt will be reissued.
X/CREATED
X /CREATED
X
X Selects files based on their dates of creation.   This  qualifier  is
X  relevant  only  when used with the /BEFORE or /SINCE qualifier.  Use
X  of the /CREATED qualifier is incompatible  with  /BACKUP,  /EXPIRED,
X  and /MODIFIED.   The default is none, which means that the revision
X  date of modules is used instead of that of files.
X/EXACT
X /EXACT
X /NOEXACT (default)
X
X  Controls whether the LIBSEARCH command  matches  the  search  string
X  exactly,  or  treats uppercase and lowercase letters as equivalents.
X  The default qualifier, /NOEXACT, causes LIBSEARCH  to  ignore  case
X  differences in letters.
X
X  Specifying the /EXACT qualifier causes the system to  use  less  CPU
X  time.   Therefore, if you are sure of the case of the letters in the
X  string, it is more efficient to use /EXACT.
X/EXPIRED
X /EXPIRED
X
X Selects files according to the dates on which they will expire.  This
X  qualifier  is  relevant  only  when  used with the /BEFORE or /SINCE
X  qualifier.  Use of  the  /EXPIRED  qualifier  is  incompatible  with
X  /BACKUP, /CREATED, and /MODIFIED. The default is none, which means
X  that the revision date of modules is used instead of that of files.
X/FORMAT
X /FORMAT=option
X
X  Controls reformatting of records during output.  You can specify one
X  of the following formatting options:
X
X  TEXT      Replaces  control  characters  in  the  text   with   ANSI
X            mnemonics  (for  example,  CTRL/C is replaced with <ETX>).
X            The terminal formatting characters <HT>, <CR>, <LF>, <VT>,
X            and <FF> are passed without change.
X
X            TEXT is the default format.
X
X  NOFF      Replaces  control  characters  in  the  text   with   ANSI
X            mnemonics  (for  example,  CTRL/C is replaced with <ETX>).
X            The terminal formatting characters  <HT>,  <CR>, <LF>  and
X            <VT> are passed without change.  Form feeds   are replaced
X            with <FF>.  It is otherwise identical to TEXT.
X
X            /FORMAT=NOFF is useful to prevent form feeds from breaking
X            up the output file, for example when a match finds a head-
X            ing in a listing file.
X
X  PASSALL   Moves characters to the output device with no  translation
X            whatsoever.   You  can use /FORMAT=PASSALL whenever you do
X            not  want  the  SEARCH  command  to  substitute  the  ANSI
X            mnemonic  for  control  characters (for example, <BEL> for
X            CTRL/G).   The  terminal  driver  cannot  send   eight-bit
X            characters    to    the   terminal   unless   either   SET
X            TERMINAL/PASSALL or SET TERMINAL/EIGHT_BIT is  already  in
X            effect.
X
X  DUMP      DUMP format is very similar to TEXT format.  However, with
X            DUMP format, all control characters (including <HT>, <CR>,
X            and <LF>) are displayed as ANSI mnemonics.
X
X  NONULLS   NONULLS is identical to the DUMP option, except  that  all
X            null  characters  are  removed  from the input file before
X            reformatting.   In  DUMP  mode,  the  null  character   is
X            displayed  as  <NUL>.
X
X/HEADING (default)
X /NOHEADING
X Includes module and file names in the output file and displays 40
X asterisks as a window separator between groups of lines that belong
X to different files, and 30 asterisks between groups of lines from different
X modules. (The /WINDOW qualifier displays 15 asterisks as a separator
X between windows.)`032
X/HELP
X The /HELP,/MACRO and /TEXT qualifiers indicate the type of library to be
X searched. Their only effect is to default the filetype to .HLB,.MLB or
X .TLB appropriately. /HELP is assumed if not present.
X/HIGHLIGHT
X /HIGHLIGHT(=option)
X /HIGHLIGHT=BOLD    (default on ANSI video terminal with advanced video)
X /HIGHLIGHT=REVERSE (default on ANSI terminal without advanced video)
X /NOHIGHLIGHT       (default for all other output)
X
X  Controls whether the actual strings which are matched are emphasized
X  in the output.  The emphasis, or highlighting, can be one of several
X  options:
X
X  BLINK     The matched  strings are  highlighted using the ANSI blink
X            character attribute.  (advanced video only)
X
X  BOLD      The  matched strings  are highlighted  using the ANSI bold
X            character attribute.  (advanced video only)
X            If /HIGHLIGHT is used without an option, BOLD is assumed.
X
X  REVERSE   The matched strings are highlighted using the ANSI reverse
X            video attribute.  (possible without advanced video)
X
X  UNDERLINE The matched  strings are  highlighted with the ANSI under-
X            line video attribute.  (possible without advanced video)
X
X            (Note  that  without  the  advanced  video  option, either
X            REVERSE or UNDERLINE will appear depending  on whether the
X            cursor is selected as block or underline.  The two options
X            REVERSE and UNDERLINE have the same effect.)
X
X  HARDCOPY(=option)
X            This specifies that the strings should be highlighted in a
X            manner  suitable for  most  hardcopy  printers.   Hardcopy
X            highlighting has two options:
X
X            OVERSTRIKE  With overstrike highlighting,  matched strings
X                        are double-printed, so that they should appear
X                        darker.
X
X            UNDERLINE   The  matched  strings are  underlined with the
X                        underscore character.
X
X            Hardcopy  printing  is  accomplished by  adding a carriage
X            return and spacing back over  the  line to  overprint  the
X            string  or  underlines.   Note  that  this  can as much as
X            double the length  of the line,  and perhaps lead to trun-
X            cation if the device buffer size is too small.
X
X  The DIGITAL LN01 printer understands the ANSI video UNDERLINE attri-
X  bute, it is therefore recommended that /HIGHLIGHT=UNDERLINE  be used
X  with this printer instead of /HIGHLIGHT=HARDCOPY=UNDERLINE. The LN01
X  does not understand OVERSTRIKE highlighting, and ignores it.
X
X  The  DIGITAL  LN03 printer understands  both the ANSI video BOLD and
X  UNDERLINE attributes, it is  recommended that either /HIGHLIGHT=BOLD
X  or  /HIGHLIGHT=UNDERLINE  be used with  this printer  instead of the
X  /HIGHLIGHT=HARDCOPY=UNDERLINE.  The  LN03  does  not  understand the
X  OVERSTRIKE highlighting, and ignores it.
X
X/LOG
X /NOLOG (default)
X Types a message to SYS$OUTPUT for each file and module searched. The
X message includes the file or module name, the number of records, and
X the number of matches for each file or module searched.
X/MACRO
X The /HELP,/MACRO and /TEXT qualifiers indicate the type of library to be
X searched. Their only effect is to default the filetype to .HLB,.MLB or
X .TLB appropriately.
X/MATCH
X /MATCH=option
X
X Indicates how the SEARCH command  matches  multiple  search  strings.
X  The /MATCH qualifier has four options:
X
X  OR        A match occurs if a record  contains  any  of  the  search
X            strings.
X
X  AND       A match occurs if and only if all of  the  search  strings
X            are present in the single record.
X
X  NOR       The negation of AND.  A match occurs only  if  the  record
X            does not contain any of the search strings.
X
X  NAND      The negation of OR.  A match occurs  only  if  the  record
X            does not contain all of the search strings.
X
X  When only one search string is specified, the  OR  and  AND  options
X  produce   identical   results.   Similarly,  NOR  and  NAND  produce
X  identical results for a single search string.
X
X`032
X/MEXCLUDE=module
X Excludes the specified module(s) from the search. Module can be a wildcard.
X If specified after the command verb, but before any libraries, applies
X to all libraries searched. If specified after a specific library name,
X applies only to that library.
X A local specification overrides any global specification.
X
X/MODIFIED
X /MODIFIED
X
X Selects files  according  to  the  dates  on  which  they  were  last
X  modified.   This  qualifier  is  relevant  only  when  used with the
X  /BEFORE or /SINCE qualifier.  Use  of  the  /MODIFIED  qualifier  is
X  incompatible  with  /BACKUP, /CREATED, and /EXPIRED.  The default is
X  none, which means that the revision date of modules is used instead
X  of that of files.
X/MODULE=module
X Only searches the specified module(s). Module can be a wildcard.
X If specified after the command verb, but before any libraries, applies
X to all libraries searched. If specified after a specific library name,
X applies only to that library.
X A local specification overrides any global specification.
X/NUMBERS
X /NONUMBERS (default)
X Includes source line numbers in the output.
X/OUTPUT`091=file-spec`093`032
X /NOOUTPUT
X Specifies an output file. The default is SYS$OUTPUT.
X/REMAINING
X /NOREMAINING (default)
X Includes in the output all records from the first matched record to
X the end of the module. This qualifier overrides n2 in /WINDOW, but
X allows /WINDOW=n1.
X/SINCE
X /SINCE`091=time`093
X
X Selects only those files or modules that are dated after the specified
X time. Module time is used by default, unless /CREATED,/BACKUP,/EXPIRED
X or /MODIFIED are specified.
X
X  You can specify either an absolute time or a combination of absolute
X  and delta times.  See the  VMS  DCL  Concepts  Manual  for  complete
X  information on specifying time values. You can also use the keywords
X  TODAY,  TOMORROW,  and YESTERDAY.  If no time is specified, TODAY is
X  assumed.
X/STATISTICS
X /STATISTICS
X /NOSTATISTICS (default)
X
X  Controls whether LIBSEARCH displays statistics about the  search. The
X  statistics displayed are:
X
X  o  Number of files searched
X
X  o  Number of modules searched
X
X  o  Number of records searched
X
X  o  Number of characters searched
X
X  o  Number of records matched
X
X  o  Number of lines printed
X
X  o  Buffered I/O count
X
X  o  Direct I/O count
X
+-+-+-+-+-+-+-+-  END  OF PART 6 +-+-+-+-+-+-+-+-

