Description of DESCRIBE

Download count: 1 this month, 5373 altogether.
Downloads for DESCRIBE:
  VMARC archive: v-18K

 
**********************  IBM Internal Use Only  *************************
* :nick.DESCRIBE   :sec.IBM Internal Use Only         :disk.VMTOOLS
* :title.Describe the contents of files in a FILELIST/FILELELS display.
* :version.1.28    :date.97/03/18   :summary.NONE     :support.N
* :oname.Les Paton                  :onode.GNKVM      :ouser.LPATON
* :aname.Les Paton                  :anode.GNKVM      :auser.LPATON
* :sw.Rexx,XEDIT
* :ops.SP4+                         :lang.Rexx
* :doc.None
* :abs.The DESCRIBE  macro is called  from within a  FILELIST display
* and overlays  a 'description' of  the file  onto each entry  in the
* file display.  The 'description'  is the  first alphameric  line in
* the file not 'excluded' by the  EXCLUDE file. Can also be used with
* FILELELS.
* :lic.By placing material on this conference, I agree to grant
* IBM a non-exclusive, royalty-free license for the material
* as set forth in the LICENSE AGREEMNT file on this conference.
************************************************************************
* (c) Copyright International Business Machines Corporation 1988, 1997.
*                      All Rights Reserved.
* No  service,  support  or  maintenance is  expressed  or  implied.  For
* additional information refer to the LICENSE agreement for this tool.
*
      DESCRIBE LICENSE  *  License agreement
      DESCRIBE XEDIT    *
* Invoke the macro from the command line ( or a PFKey ) of the
* FILELIST display and see the file description overlayed onto the
* entry for each file.
*
      DESCRIBE LOOKUP *
* Put an entry in the lookup file for each file which has a fixed
* description.
*
      DESCRIBE INCLUDE  *
* Put an entry in the include file for each word which is to be used
* as a subject trigger when searching for a description.
*
      DESCRIBE EXCLUDE  *
* Put an entry in the exclude file for each file line which is to be
* ignored ( excluded ) when searching for a description.
*
      $FOILLST XEDIT    *
* This is an example of how to customise a FILELIST PROFILE to use the
* DESCRIBE macro.
*
      DESCRIBE HELPXEDI *
* This is the macro description.
*
* A specially modified version of EXECUTE XEDIT is available to support
* this macro. To get a copy request....
*      EXECUTE2  PACKAGE    From VMTOOLS
*
* New Releases....
*
* 1.01 Put '->' in the description so we can check for repeats.
* 1.02 Handle ADMGDF files.
* 1.03 Set GLOBALV variables for EXECUTE XEDIT macro. Add INCLUDE file.
* 1.04 FINIS file after EXECIO.
* 1.05 Add INclude and EXclude operands. See HELPXEDI file for detail.
*      Removed limit of 255 on record size. Added CURsor operand.
* 1.06 Handle PACKAGE files and a FILELIST with the FILELIST operand.
*      Handle FILELELS display.
* 1.07 If using CURSOR option and cursor is in file then leave it there
*      when macro completes.
* 1.08 HELPXEDI only updated to correct a typing error.
* 1.09 DESCRIBE XEDIT - Fix possible EXECIO error message on screen.
* 1.10 Added ADMCDATA & ADMCFORM to list of known filetypes.
* 1.11 If no file description then look for one in GLOBALV.
* 1.12 Fixed a problem which could occur when FILELIST was invoked with
*      the FILELIST operand ( as in FILELIST TEMP FILE A1 ( FILELIST ).
* 1.13 Added the DESCRIPTION option parameter.
* 1.14 Maintain the date/time display on the file line where possible.
*      Corresponding change to the supporting EXECUTE PACKAGE.
* 1.15 Added the ON and OFF option commands.
* 1.16 Changes to $FOILLST XEDIT to reflect ON/OFF commands.
* 1.17 Added additional GDDM filetypes.
* 1.18 Added ADMPC as a valid GDDM filetype.
* 1.19 Don't seek a description for a CGMxxxxx type file.
* 1.20 Improved $FOILLST XEDIT profile.
* 1.21 Added LICENSE file.
* 1.22 Added NOINCLUDE/NOEXCLUDE parameters.
* 1.23 Added F = ALL
* 1.24 Handle a FORUM/CFORUM wider than Lrecl 255.
* 1.25 Added LOOKUP file.
* 1.26 FINIS was for wrong file.
* 1.27 Improved performance when INCLUDE/EXCLUDE files not found.