[aboutme]  ===>   [next page]    

The REXX Macros Toolbox
and
David McRitchie's Home Page
Welcome to my Home Page
Location --- http://www.mvps.org/dmcritchie/rexx/home.htm

Copyright (C)1997, 2000, 2001, 2004, 2006   F.  David McRitchie

Lots of REXX Edit Macros at this site


Tour Topics and Side Tours   (Separate web page for each topic)

  1. Home Page
  2. Home page (continued)
  3. SPF/PC Items of Interest
  4. The REXX Macros Toolbox has macros designed for ISPF and SPF/PC users. 
    T-Rex!T-Rex!T-Rex! This page contains an alphabetical list of all of the macros in The REXX Macros Toolbox listed with brief descriptions with links to detailed descriptions and lthe macros themselves(coding).  T-Rex!T-Rex!T-Rex!
  5. About Me

Description: REXX macros for the programmer who is already using or is familiar with any of the following: REXX, MVS, SPF, ISPF, PDF, PDS file, OS/2, or SPF/PC on mainframe or PC's.   Macros at this site were written in REXX by David McRitchie to provide functions such as reformatting text; simple syntax checks for PLI, DCF, GML, HTML, SCRIPT/VS; interface to spell check, SuperC comparison, file directory list; customized search/change an interface to DCF, and SuperC from a member in edit, and of a group of files or members. 

Keywords: REXX, macros, toolbox, MVS, SPF/PC, ISPF, TSO, mainframe, OS/2

As an applications programmer and as a systems programmer my main language for writing programs was PLI.  I also did a lot of work in DCF (SCRIPT/VS, GML), and REXX.   You will not find any PLI or DCF at this site,  but you will find macros to help you with these

What you will find is a lot of  REXX macros and executes that I wrote and used to help me write my programs, check the syntax in coding, and work with partitioned datasets.  There are also a few clists that I never got around to converting, the most notable of which is @DIR and is one of the most important ones. 

You will find macros to check paired relationships including use of quotes in checking syntax in  PLI, DCF, GML, SCRIPT/VS, HTML, or anything else for which you can define paired relationships.  Macros that check syntax include editchek, editol, HTMLOL, HTMLSYN, period, plichk.  Macros that point out possible errors but expect you to interact include period, fixpi, and fixquote

Policy in using this site and coding

The material at this site is being made universally available with the stipulation that that the original author remains credited and that no charge or licensing fee accrues to any party.  David McRitchie and the "The REXX Macros Toolbox" do not give up any copyright protection of my code, documentation, or other material at this site. 

Material provided at The REXX Macros Toolbox is provided for your use distributed directly from this site.  Redistribution of source, coding and documentation by any other means is prohibited. 

F.  David McRitchie and The REXX Macros Toolbox disclaim all warranties of software, or advice, whether express or implied, including without limitation any implied warranties of merchantability, fitness for a particular purpose, functionality, data integrity or protection. 

The following table attempts to categorize macros that can be seen in greater detail at  macros and executes on the fourth stop (main stop) on the tour.  The hypertext there is set up for viewing of the documentation, and TSO and PC versions of the macros.  All of the macros are listed there in alphabetical order.  The documentation and macro source hyperlinks can be found in the nclist.htm of The REXX Macros Toolbox

MVS - TSO, partitioned datasets, ISPF/PDF
 LANGUAGE or system macro is useful in   Browse or information Manipulate / Reformat Check Syntax / Check Spelling
  MVS (TSO)

@DIR is only available on the mainframe

@COMPARE (invokes SUPERC),

@DIR (list members in current directory or any other directory),

@DIRSTAT

@PRINT, @PRINTNX, TECHPS

 

@DIR with LISTMEM or other options. 


@DIR can invoke any macro for file members. 
  MVS (systems programming) »CPUID (Tso Times) LOADMOD (find and browse member if in LNKLST, see PROC documentation) »MURPHY's Laws GETTRID (terminal id CBT 078) @AMSRCAT, GDGNEW, »TSOOS2 CHECKSUM  for checking ISPZAP decks and to verify IDRDATA cards, @COMPUTE @listrp, »TOD», REALLOC »$FREE
  MVS (applications) SYSDSN (check if dataset exists)
@DSN (whogot), »GOTDSN see if user is already allocated to dsn,
   
  TSO Browse EDIT @TSO, @TSOX, @TSOXD, $B, $BROWSE, $EDIT,    
  MVS partitioned data sets (PDS)

(executes not macros)

PDSDD (search libraries in logon dd concatenation and browse members)

LISTDD (list datasets allocated to ddname),

Also see PROC for (AFP, CLIST, DSMPROF4, LOADMOD, PANELS, »selpanel, PDSDD, PROC, SOP)

   
  MVS partitioned data sets (PDS)

(macros)

  @DSNQ (compress) @RENAME KILL,  
  MVS partitioned data sets (PDS) @EDIT for PC, EDITMEM for TSO to edit member or file at cursor.  REFORMAT, cut & paste, REMDUPS,  
Edit member named at cursor position EDITMEM for TSO, @EDIT for PC    
ISPF, PDF, SPF/PC @SAVE  LABNX, NXNX, @MSG, @NOTE, @NOTEB,    
 LANGUAGE or system macro is useful in   Browse or information Manipulate / Reformat Check Syntax / Check Spelling

  Some Macros in italics are pointing to actual code for documentation.
» Some Rexx Executes, and Clist Procedures have also been included. 

TSO ISPF/PDF, or DOS or Windows with SPF/PC, or OS/2 with ISPF
 LANGUAGE or system macro is useful in   Browse or information Manipulate / Reformat Check Syntax / Check Spelling
CLISTS (mainframe)   CLISTBOX, FIXJCL, JOBCARD, SCLIST72 NESTCHK, PLICHK
DCF / GML

tag language

@SCRIPT, SCRIPTPS, FIXLI, FIXP, @EDITMSK show data in Edit Pane @STRAPD, @STRAPE, @TPP, ALIGNTAB, DCFBOX, DUADD, DV2MM EDITPS, FIXPI, FIXQUOTE, GML, GMLTP, INSERT, PINX, PINXDOIT, PIR, PROPER (proper names).  TAGX, UNGML, DCFMSGS, EDITCHEK, EDITOL, EDITPAGE, EDITPR, PERIOD, SPELL
  HTML CHKMISS, HTMLDOC, HTMLHYP, HTMLXX02, HTMLXX03, TXT2HTML, HTMLOL, HTMLSYN REMOVAL, SECSINCE, TAG
 LANGUAGE or system macro is useful in   Browse or information Manipulate / Reformat Check Syntax / Check Spelling
  JCL (mainframe) SUBMITIT, FIXJCL, JCLBOX !EDCHEK (vendor software for mainframe )
  PLI PLIDCLS, QCHK, REXXBOX PLICHK
  RACF @listrp    
  REXX FIXREXX, FIXREXX, REXXBOX, PLICHK, QCHK, CSIGNAL (error #16)
  SAS     NESTCHK, PLICHK
  SuperC: Compare, Search @COMPARE, @SEARCH4, SUPERC,   NESTCHK, PLICHK
  TEXT and general use @cols, @DATE, @lab, labnx, @MACRO @MSG, @NOTE, @NOTEB, @PRINT, @PRINTNX, @TIME @vp, @xmit, EOL, FLIP, HEXES, HEXSHOW, HEXUS, INSERT, NOTENX, »SHOWDATE XEVERY,

@END FGROUP

REFORMAT, cut & paste, @C, CAPS, @ICOPY (interleaved copy), @SEQ, @SMALLS, @STRAP, @STRAPD, @STRAPE, BIGS, BLOCK5, COLSUM, CSON DATE2000 FLOC, FLOW, INVERT, LCFIX, LEFT@, PROPER, REMBLANK (remove blank columns), REMDUPS (remove duplicate lines), REPEATNX, SHIFT, SHIFTNX, SORTCR (cols), SORTEM (words), SORTG (groups), »TSOTRAP @SPELLS, CHECKDUP, PERIOD, REMDUPS, SPELL
 LANGUAGE or system macro is useful in   Browse or information Manipulate / Reformat Check Syntax / Check Spelling
More macros in alphabetical order and hypertext links to coding can be found in The REXX Macros Toolbox which is the fourth stop it you proceed along the tour.  In other words the documentation and macro source hyperlinks can be found in the nclist.htm of The REXX Macros Toolbox

Strictly Documentation

  1. Introduction to using the ISPF/PDF EDITOR.
  2. SYSVAR usage and differences between CLIST and REXX.   I created this for my own reference in writing REXX and in converting from CLISTS.
  3. REXX related manuals are available on IBM's BookServer Library.
  4. PFKEYS (mainly ISPF)
  5. Sort (ISPF and SPF/PC)
  6. Tabbing with hardware and software


Using a syntax checker that is real stupid works very well for finding stupid errors.  Compilers frequently note an error as being incorrect but frequently provide little information as to where the error originated.   This is especially true when a token should be paired up with a starting or closure token.   (Do ...  End;, <h2> ...  </h2>).  Losing track of where the error actually is can be especially frustrating in GML or HTML.  You can check out your HTML coding at various places on the internet.  You can probably still use a dumb syntax checker to find the most obvious errors quickly.  Try debugging Lists in GML (:ul., :sl., :ol., :eol., :esl., :eul.).  In HTML you have the same trouble debugging lists (<ul>, <ol>, </ol>, </ul>).  Mess up on the pairings and you have major problems.  In PLI some pairs would be BEGIN, END;, DO, END;. 

Spell checking on a mainframe is not as simple as using a word processing program on a PC.  There are some programs that you may already have on the mainframe that do check spelling.   SAS and DCF (GML, SCRIPT/VS).  Through the use of macros they can be used to check spelling in any DCF or text document. 

Refer to SPELL utilizing DCF, and @SPELLS utilizing SAS. 

For updating your DCF coding with .du add and .du del cards and to update both DCF and SAS dictionaries refer to documentation for @SCRPTDU. 

Spelling errors and DCF (GML) errors are merged back into the text as NOTELINES below the misspelling or word to be checked.  The @SCRIPT macro along with @SCRPTDU, SPELL (uses DCF), or @SPELLS (uses SAS), allow one to invoke DCF (SCRIPT/VS) from a member currently being edit, to print to any printer, to check spelling, and to add words to the dictionaries (DCF and SAS).  @SCRPTDU allows you to check also creates .du add, and .du del cards for you to check over.  So that you don't need to words to the dictionary that are only used in one document. 

On of the most useful macros is @SCRIPT used to invoke SCRIPT/VS (or SCRIPTPS, for PostScript usage) from within EDIT.  With it you can view results as a 1403 printer, or can print to any printer including PostScript.  PINX, PIR, and PINXDOIT to help create index entries. 

Documentation formatting, found at this site

Documentation was created using DCF (SCRIPT/VS); however, I had nothing to convert the documentation directly into HTML because it was quite involved.  You will find text (.txt) files that were created from the DCF (SCRIPT/VS) codings.  The .txt files are pretty much the same as the files used online on the mainframe as online HELP text. 

Description of Format Used for each Document

Each document has a standardized format that allows you to quickly find what you want. 

  1. A Heading area includes the macro name, who would use it, and whether it is a macro used in edit or an execute used standalone. 
  2. Single line description.
  3. Related area includes a list of related macros that might be better suited for similar function at another time. 
  4. A longer description of the macro. 
  5. The Format of the command used with parameters.
  6. Definition and use of each parameter. 
  7. Examples, and finally:
  8. Internal Aspects of the macro, execute or CLIST are included to help you better understand what is going on and how it works.  Occasionally an entire macro or a simplified version may be included in it's entirety if it is small and can better serve the purpose of illustration.
    On the mainframe you can always use the execute CLIST macroname to see the actual code, or CLIST macroname HELP for the help information if you put the .txt entries into a partitioned dataset.  You would change the name for your own system, of course. 
    The following two documents were originally generated from DCF documentation for use on the mainframe as "text" Although they can no longer be maintained, they may give an idea of how a copy was used on a mainfame without HTML.

Additional Notes

Rules in Accessing this Site and My Materials

  • Information provided at this site is Copyrighted and describes REXX macros that I have created.  You are free copy material from my sites for your own use with the stipulation that the original author, which is usually me, remains credited and that no charge or licensing fee accrues to any party.  All rights for future publication and or profit reserved for the original author.  Please do not redistribute them as your own, thank you.  If you think a copyright notice is required please read 10 Big Myths about copyright explained.
  • Glossary for this page

  • SPF/PC looks and functions like the popular mainframe editor, ISPF/PDF, but it runs on IBM compatible personal computers with 80386 or higher processors.  SPF/PC requires either DOS Version 3.0 or greater, Windows 3.1 or greater, or OS/2 Version 2.1 or greater.  Copied directly from SPF/PC User's Guide and intended only to indicate that ISPF/PDF can be extended into the PC world.
  • Registered trademarks


    You are visitor  counter since opening on April 31, 1997

    Counter above includes 880 hits from my old ISP on 2000-04-15, and though I can't show recent statistics here -- 9,819 people had continued or gone directly to the alphabetically listed page of The REXX Macros Toolbox as of that date.

    A tour through the site has been set up and can be follow it by using the [next page] hypertext entries that appear at the top and bottom of each page. 


    Comments

    Besides the REXX Macros Toolbox, I also have some strictly PC pages on Excel.

    Copyrighted (c) 1995, 1997, 2000, 2004, 2006  F.  David McRitchie

    Jump to A Specific Page          


    T-Rex!

    The REXX Macros Toolbox is a member of the dinos Web Ring.

    Want to join the dinos Ring ?

    [Skip Prev] [Prev] [Next] [Skip Next]
    [Random] [Next 5] [List Sites]

    Little Dinosaur


    [aboutme]  ===>   [next page]