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

Message-Id:  <8910161859.AA00758@crdgw1.ge.com>
Received: From NSFNET-RELAY.AC.UK by CRVAX.SRI.COM with TCP; Mon, 16 OCT 89 11:31:13 PDT
Received: from ncdlab.ulcc.ac.uk by NSFnet-Relay.AC.UK   via Janet with NIFTP
           id aa10677; 16 Oct 89 17:17 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 7/7

-+-+-+-+-+-+-+-+ START OF PART 7 -+-+-+-+-+-+-+-+
X  o  Number of page faults
X
X  o  Elapsed CPU time
X
X  o  Elapsed time
X
X  o  Value of /MATCH and /EXACT switches
X/SUBTOPICS
X /SUBTOPICS (default)
X /NOSUBTOPICS
X Determines, when searching HELP libraries, whether the subtopic(s) as
X well as the module in which targets are found is output. Has no effect
X if /NOHEADER is used.
X/TEXT
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/WINDOW
X /WINDOW`091=(n1,n2)`093
X /NOWINDOW (default)
X
X  Controls the number of lines that are listed  along  with  the  line
X  containing the matching string.
X
X  If you specify the /WINDOW qualifier with a  single  number  n,  n-1
X  additional  lines are displayed with each line containing the search
X  string.  Half of the additional lines  are  listed  above  the  line
X  containing  the  match, and half are listed below.  If n-1 is an odd
X  number, the extra line is listed below the search string.
X
X  For example, if you specify /WINDOW=10, nine  additional  lines  are
X  listed  along with the line containing the search string, four lines
X  are listed above the line containing  the  search  string  and  five
X  lines are listed below it, making a total of ten lines.
X
X  If you specify /WINDOW without  specifying  a  number,  the  default
X  number  of five lines---two above, one containing the search string,
X  and two below---is used.
X
X  If the form /WINDOW=(n1,n2) is used, n1  refers  to  the  number  of
X  lines  above  the  matched line and n2 refers to the number of lines
X  below.  Either of these numbers can be zero.
X
X  If /WINDOW=0 is specified, SEARCH will display the file name of each
X  file  containing  a  match,  but  no  records.   You  can  use  this
X  specification to create a file (using the  /OUTPUT  qualifier)  that
X  can  be  inserted  into  a  command  file  to  manipulate  the files
X  containing matches.
X
X  If you omit the /WINDOW qualifier entirely, only the line  in  which
X  the match is satisfied is displayed.
X2 Examples
X
X   1. $ LIBSEARCH/HELP SYS$HELP:HELPLIB/WINDOW=0 compar
X
XThis command searches the system help library to find all help topics
Xwhich refer to compar (in order to find references to compare and
Xcomparison, for instance.) By specifying /WINDOW=0 only the topic and
Xsubtopic names appear, without the actual matching lines.
X
X   2. $ LIBSEARCH/text SYS$LIBRARY:FORSYSDEF FAB/exact
X
XThis command searches FORSYSDEF.TLB, the system include file for FORTRAN
Xprogrammers, to find which module or modules reference FABs. By specify-
Xing /EXACT, only matches involving actual definitions or references are
Xlikely to be found, rather than comments.
X
$ CALL UNPACK LIBSEARCH.HLP;21 1447822458
$ create/nolog 'f'
X1 TEST
Xthis is a test of helping
X2-aug-1989 is not a valid subtopc
X2 Sub1
Xbut this is a valid subtopic
X/QUAL1
X /qual1 gives us a qualifier
X  25 is just division
X is something else
X/Xify
X /Xify is certainly a subtopic
X3 SUBSUB2
XIs this a subtopic of Xify ?
X/Yify
Xor what ?
X2 SUB3
Xa different subtopic
X3 DOWNALOT
Xwith its own depths
$ CALL UNPACK TEST.HLP;3 1750022731
$ create/nolog 'f'
X.title LIBSEARCH FACILITY messages
X.FACILITY LIBSEARCH,1001
X!
X!
X.SEVERITY Informational
X
X!STATS
XNOMATCH       <!AS, !SL module!%S, !SL record!%S> /FAO=3
XNOMATCHMOD    <module !AS, !SL record!%S> /FAO=2
XNOMATCHALL    <No strings matched.>
XMATCHEDMOD    <module !AS, !SL record!%S, !SL match!%S> /FAO=3
XMATCHED       <!AS, !SL module!%S, !SL match!%S,!/!_!_ !SL record!%S, !SL ma
Vtch!%S> /FAO=5
X
X.Severity Warning
X
X!$DISK1:`091KEVIN.LIBSEARCH`093PRSFIL.FOR;23
X
XTOOMNYFIL <No more than !SL files.>/FAO=1
XTOOMNYEXC <No more than !SL files in /EXCLUDE list.>/FAO=1
XINVLANS   <Invalid answer "!AS".>/FAO=1
X
X!$DISK1:`091KEVIN.LIBSEARCH`093PRSTARGET.FOR;9
X
XTOOMNYTRG <No more than !SL strings.> /FAO=1
X
XOPENIN    <Error opening !AS for input> /FAO=1
X
X.Severity Error
X
XNOFILES   <No files found>
X
X.Severity Severe
X
X.SEVERITY FATAL
X
X!$DISK1:`091KEVIN.LIBSEARCH`093LIBSEARCH.FOR;26
X
XNOTTXTMAC  <Not a text,macro or help library>
X
X!$DISK1:`091KEVIN.LIBSEARCH`093PRSCOM.FOR;17
X
XWINPARONE  <First parameter to /WINDOW must be less than !SL> /FAO=1
XWINPARBAD  <Value for /WINDOW must be less than !SL.> /FAO=1
XINVNUMFMT  <Invalid number format !AS> /FAO=1
XWDW_MAXPRM <Too many window parameters - maximum is 2>
$ CALL UNPACK LIBSEARCHMSG.MSG;9 725188451
$ create/nolog 'f'
Xdefine type CONFIRM_TYPES
X  keyword FILE,nonnegatable
X  keyword MODULE,nonnegatable
Xdefine type SEARCH_FORMATS
X   keyword PASSALL
X   keyword TEXT
X      default
X   keyword DUMP
X   keyword NOFF,nonnegatable
X   keyword NONULLS
Xdefine type SEARCH_MATCHES
X   keyword AND,nonnegatable
X   keyword OR,nonnegatable
X      default
X   keyword NAND,nonnegatable
X   keyword NOR,nonnegatable
Xdefine type HARDCOPY_MODES
X   keyword OVERSTRIKE
X   keyword UNDERLINE
X      default
Xdefine type HIGHLIGHT_MODES
X   keyword REVERSE
X   keyword BOLD
X      default
X   keyword BLINK
X   keyword UNDERLINE
X   keyword HARDCOPY
X      value (type=HARDCOPY_MODES)
Xdefine verb LIBSEARCH
X!   image SYS$TOOLS:libSEARCH
X   parameter P1 , label=SOURCE , prompt="Library Filename(s)"
X      value (required,list,type=$infile)
X   parameter P2 , label=STRING , prompt="String(s)"
X      value (required,list)
X   qualifier BACKUP
X   qualifier BEFORE
X      Value (Default="TODAY",Type=$datetime)
X   qualifier CREATED
X   qualifier CONFIRM
X    value (Type=confirm_types,default="MODULE")
X   qualifier EXACT
X   qualifier EXCLUDE
X      nonnegatable
X      value (required,Type=$infile)
X   qualifier EXPIRED
X   qualifier FORMAT
X      nonnegatable
X      default
X      value (default="TEXT",type=SEARCH_FORMATS)
X   qualifier HEADING
X      Negatable,default
X   qualifier HIGHLIGHT
X      value (type=HIGHLIGHT_MODES)
X   qualifier LOG
X   qualifier MATCH
X      nonnegatable
X      default
X      value (required,type=SEARCH_MATCHES)
X   qualifier MEXCLUDE
X      nonnegatable
X      value (required)
X     Placement=Positional
X   qualifier MODIFIED
X   qualifier MODULES
X     nonnegatable
X     value (required)
X     Placement=Positional
X   qualifier NUMBERS
X   qualifier OUTPUT
X      default
X      value (default="SYS$OUTPUT",type=$outfile)
X   qualifier REMAINING
X   qualifier SINCE
X      Value (Default="TODAY",Type=$datetime)
X   qualifier SUBTOPICS
X      Negatable,default
X   qualifier STATISTICS
X   qualifier WINDOW
X      value (list,default="5",type=$number)
X! Types of library
X   Qualifier HELP
X    Nonnegatable
X     Placement=Positional
X   Qualifier MACRO
X    Nonnegatable
X     Placement=Positional
X   Qualifier TEXT
X    Nonnegatable
X     Placement=Positional
$ CALL UNPACK LIBSEARCH.CLD;27 1662550980
$ v=f$verify(v)
$ EXIT

