'IS03.SHARE.TEXT(NCADD)' -- ART004 April 1st, 1995 6:54 a.m. -- dev(1403W8) chars(MONO) +--------------------------------------------------------+ | | | | | The Toolbox | | | | Documentation aids | | | | Items in this section: | | 1. EDIT commands: exclude and use of labels | | 2. @DIR clist for selecting members | | 3. @PRINTNX print what you see while in EDIT | | 4. @PRINT and @VP to print saved member while | | still in EDIT | +--------------------------------------------------------+ ---------------------------------------------------------+- By David McRitchie (E-Mail ID - DMcRitchie@hotmail.com Intended audience -- TSO users somewhat familiar with the use of EDIT under PDF (Program Development Facility). The Toolbox column will provide information on using clists, utilities, and other in-house tools. Sometimes you may want to print what you have in edit without actually saving the data that has been changed. Today's column will focus on the use of EXCLUDE (X), printing the member currently in edit, and some documention aids not related to generating SCRIPT documents. Some EDIT commands EXCLUDE -- abbreviation is X Exclude (X) is the opposite of Find (F). You may for example exclude all lines that begin with a string. X 1 '//*' all You may exclude a block of lines by using the X9999 or lower number on the command line, or by using the block form XX to start and XX to end. Lines excluded are simply not displayed. If you actually wanted to delete all such lines, you could use DEL X ALL to delete all excluded lines. If you wanted to actually delete all of the displayed lines you could use DEL NX ALL. Labels Labels are created by overtyping a line number with a period followed by 1-5 letters. You may use a label to quickly get to a specific line, LOC .label, without knowing the line number. Because labels stand out you can use them as highlighters. Labels are available also in BROWSE by typing the label on the command line instead of overtyping the sequence numbers. More information on EDIT More information on edit is available in the tutorials, and some information can be scripted from member EDITOR by utilizing information at end of this column. @PRINTNX -- Printing what you see in EDIT @PRINTNX can be used to supply a listing of the member that you are working on as you would see it if you scrolled through the entire member from the beginning. The member need not be saved before issuing @PRINTNX. @PRINTNX will print the saved directory information for the member at the top, along with the time that @PRINTNX was issued. There will then appear an EDIT heading line similar to what you see in EDIT followed by lines showing labels, line number, line content, and for hidden lines the number of lines not shown as you would see in EDIT. Because labels, line numbers, and data appear in distinct columns the listing will be easier to follow than the actual EDIT screen which hides line numbers when labels are used. this clist can be used as a valuable documentation tool. @PRINT -- Printing a saved member in EDIT @PRINT DOWN8 -- print on 3900 in portrait mode @PRINT DEST(dest) -- print at a remote location @VP -- Printing a saved member in EDIT Invokes VPSPRINT with a default of printing at AHCENTER. Any additional VPSPRINT options may be specified, but when you do so you must specify the destination as the first operand. The @DIR clist This clist has many features, which can be examined online. There are various methods of selecting members for display. * @DIR M:MX will display on the screen all members beginning with M through through the last member beginning with MX. * @DIR MX:M will display on the screen all members beginning with MX through all remaining members beginning with M. (Would include members MX, MX3, MY, MZA, M88 if available) * @DIR LISTMEM Include directory information at the end of the member currently in edit -------------------------------- footnote1 LANDSCAPE orientation, the width is greater than the height, such as typical computer reports. footnote2 PORTRAIT orientation, the height is greater than the width, such as this newsletter. -------------------------------------------------------------------------------- Page NCAPXT-2 * @DIR BROWSE ART0:ART Browse each selected member. * @DIR EDIT @DIR MACRO(clist) Edit each selected member and optionally invoke a macro for each. Some limitations to keep in mind when using EDIT and MACRO(clist) 1. @DIR cannot edit a member that is currently in edit, and 2. will bypass the editing the member from which you invoked @DIR. 3. A failure will occur if you attempt to edit any other member that is in edit. * @DIR INDEX(ABC) Select members having ABC within membernames, * @DIR MASK(-ABC) Select members with ABC starting in postion 2, * Select on members updated since a date in the form MM/DD/YY, or by specifying two dates, members that were changed in the inclusive date range. Additional information is available online for @DIR. Additional information The text of this article is in IS03.SHARE.TEXT(ART004) and can be formatted for printing using the @SCRIPT macro, while in edit on this member. Documentation for many of the clists in use is also in this library. ===> @SCRIPT -- to print at Mytown ===> @SCRIPT Q -- (quick) to view formatted output ===> @SCRIPT DEST(dest) -- remote printing Documentation available Some information is available online without SCRIPTing by issuing ===> TSO CLIST member HELP Documented members available in this manner include the following: (most of these are EDIT macros) @COMPARE Compare members. (Jun 92 issue) @DIR Directory @PRINTNX Print the NX (displayed) lines (data need not be saved) @PRINT Print the dataset (saved) in edit. (Jun 1990 issue) @SLCT Create JCL to list members in same PDS dataset. @VP invoke VPSPRINT without specifying dataset name. CHECKDUP Checks for duplicate word (repeated word). CUT CUT, APPEND, and PASTE clists, work only in EDIT. A new feature has been added where you can paste from a PDS member in userid.LIBR.PASTE without deleting the dataset. Normally CUT creates userid.CUTDSN.LIST and PASTE without KEEP will delete the dataset created by CUT. The DOC option of CUT and APPEND provides a valuable documentation tool. EDITOR Additional information to that at the beginning of this article LABNX Label the NX (displayed) lines SPELL Checking spelling of anything in EDIT, data need not be saved. Invokes SCRIPT. TABBING Information on tabbing VPSPRINT Show same information currently available with TSO HELP VPSPRINT.