EDIT macro DCFMSGS EDIT macro DCFMSGS Author: David McRitchie formatted on 1995/04/01 06:54 for assistance contact: D. McRitchie DMcRitchie@hotmail.com -------------------------------------------------------------------------------- Macro Name. DCFMSGS users. PDF EDIT users particularly SCRIPT users type. Edit Macro resides in SYS1.TSOCLIST -------------------------------------------------------------------------------- DCFMSGS Merge in error messages into original, related to @SCRIPT Q usage -------------------------------------------------------------------------------- related @SCRIPT, DCFMSGS, EDITCHEK, EDITOL, EDITPR, PLICHK, SPELL -------------------------------------------------------------------------------- Perhaps you have trouble with DCF error messages where the line number of the line in error is the last line in a group of related error lines. Or you simply have a lot of fixing up to do. The DCFMSGS macro will merge the error messages as MSG and NOTE lines into your source document. The lines in error will be displayed the other lines will be undisplayed. ===> DCFMSGS If you have already formatted a document with ===> @SCRIPT Q in or- der to view a formatted document then you have already have the error messages at the end of the userid.S9999.LIST dataset and can save a little time by adding the @SCRIPT parameter. ===> DCFMSGS @SCRIPT DCFMSGS is used to merge error messages back into the original for ease in dealing with SCRIPT error messages which can be difficult for novices to find the actual error. Errors with tags present errors that cannot be handled because there generally is no line number re- lating back to to source. If you have macro errors you might add the following line temporarily only -- .IT˙MAC The macros EDITCHECK and SPELL are very useful and you may wish to check them out before using DCFMSGS on a troublesome document. -------------------------------------------------------------------------------- Since square brackets are not available, optional material is enclosed in European brackets <...>. ISREDIT DCFMSGS <@SCRIPT> -------------------------------------------------------------------------------- Optional parameters @SCRIPT to be used when userid.S9999.LIST has already been created for a document using @SCRIPT Q. If DCFMSGS is invoked without any operands then @SCRIPT Q will be invoked on your behalf and you will have to use PFK-3 to get out of userid.S9999.LIST before the DCFMSGS macro can do it's merge. any other parameters that can be used with @SCRIPT Q FP(1) Examples @SCRIPT Q pfk-3 to get out of userid.S9999.LIST DCFMSGS @SCRIPT DCFMSGS +------------------------------------------------------------------------------+ | EDIT ---- IS03.SHARE.TEXT(DCFMSGS) - 01.00 --------------------- COLUMNS 001 | | COMMAND ===> SCROLL ===> | | ****** ************************** TOP OF DATA *******************************| | - - - - - - - - - - - - - - - - - - - 9 LINE(S) NOT DISPLA| | 000010 Macro Name. DCFMSGS | | ==MSG> DSMDOT459I WORDS NOT FOUND: DCFMSGS | | ==MSG> DSMMOM395I 'DCFMSGS' LINE 10: Macro Name. DCFMSGS | | =NOTE= ---actual line in error may be hidden in a macro--- | | ==MSG> DSMDOT459I WORDS NOT FOUND: DCFMSGS | | ==MSG> DSMMOM395I '.(RFOOT)' LINE 200: IS03.SHARE.TEXT(DCFMSGS) 1993/10/14 1| | - - - - - - - - - - - - - - - - - - - 7 LINE(S) NOT DISPLA| | 000018 DCFMSGS Merge in error messages into original, related to @SCRIPT Q u| | ==MSG> DSMDOT459I WORDS NOT FOUND: DCFMSGS | | ==MSG> DSMMOM395I 'DCFMSGS' LINE 18: DCFMSGS Merge in error messages into or| | - - - - - - - - - - - - - - - - - - - 6 LINE(S) NOT DISPLA| +------------------------------------------------------------------------------+ The above result really only shows spelling errors, which can simply be fixed with the addition of .DU ADD DCFMSGS The macro SPELL would be more practical if there was cause for concern in actu- ally misspelled words. The use of @SCRPTDU followed by @SCRPTD3 can be be used to add words at top and delete them at the bottom. It is your responsibility to make sure that the words are legitimate. Related topics A brief review on other related macros: EDITCHECK -- check for unmatched tags EDITOL -- check for unmatched tags :LI, :ol., :ul., :sl. EDITPR -- check a pair of tags ie EDITPR :GT12. :EGT12. PINX -- create .PI entries from NX lines PINXDOIT -- create .PI entries from where there were none -- only PIR, PIR AT, PIR R -- create or modify Put Index (.PI) entries PLICHK -- check for unmatched quotes, double quotes, /* -- */ SCRIPTPS DEST(dest) -- create PostScript for those who need it. SPELL -- check for spelling errors in a document (even JCL) Each of the above Edit macros has documentation available on-line ===> TSO CLIST macro HELP Additional documentation of interest can be scripted from IS03.SHARE.TEXT(member) ===> @SCRIPT -- to print on 3900 ===> @SCRIPT Q -- to view at terminal ===> @SCRIPT TECHPSF -- to the SYSTECH laser printer PAGEDEF -- table of Page definitions available for 3900 ARTICLES -- copies of my articles published in CIS Newsletter NOTETABS -- create index tabs for notebook indexes, modify your copy. Internal Aspects 1. Initialization of variables, lists, etc. 2. @SCRIPT Q FP(1) is invoked, unless @SCRIPT is on parm 3. Messages are merged back to original as MSGLINE on first pass and NOTELINE after first pass.