'IS03.SHARE.TEXT(NCADD)' -- ART003 April 21st, 1995 6:37 a.m. -- dev(1403W8) chars(MONO) +--------------------------------------------------------+ | | | | | The Toolbox | | | | Finding material in your PDS libraries | | | | Items in this section: | | 1. Searching a PDS library | | 2. EDIT macro -- @DSNQ | | 3. Command column use in DSLIST (PDF 3.4) | +--------------------------------------------------------+ ---------------------------------------------------------+- By David McRitchie (E-Mail ID - DMcRitchie@hotmail.com - MCRITCHI) Intended audience -- TSO users already familiar with the use of DSLIST under PDF (Program Development Facility) Utilities. The Toolbox column will provide information on using clists, utilities, and other in-house tools. If there are a lot of members in a PDS directory, you tend to lose track of them. Today's column will focus on finding material in your PDS libraries, including some fast path (short cut) methods of invoking the Search-For utility (PDF 3.14), and use of the COMMAND column when using DSLIST (PDF 3.4). Searching a PDS library PDS directory The directory that you see in BROWSE and EDIT can be sorted on any two fields with the name defaulting as a third. To find what was recently worked on you might issue SORT CHA. The valid arguments for a source PDS directory as they appear in the directory headings are NAM, LIB, VV, MM, CREated, CHAnged, SIZE, INIT, MOD, and ID. LIB comes into play when you have multiple GROUP names on ISPF library menus, and is useful in examining several libraries at the same time. For more information on sorting PDS directory entries, use the HELP key (PF1) while viewing any directory list. ===> SORT CHA Searching an entire PDS library Another method of finding something in a library is to search the entire library, or selected members using PDF option 3.14, or the fast path solutions described below. The macro @SEARCH4 is invoked from within edit. You may enter multiple arguments (separated by commas). If no search argument is entered the panel will reflect previous usage. You may limit the selection of members by changing (*) to (M*) on the Search-For panel to select only members beginning with M. Afterwards you may use the %SRCH400 clist to reduce the listing size increasing readability and to place you into edit of the listing. ===> @SEARCH4 toolbox,intended audience ===> TSO %SRCH400 SEARCH4 is a clist that can be entered on any panel. Unlike the @SEARCH4 macro, you must supply the fully qualified datasetname (quotes optional); otherwise, it has the same arguments. EDIT macro -- @DSNQ EDIT -- macro supplies quoted dsname and invokes TSO command @DSNQ is a macro that can be used while in edit to invoke a TSO command or clist that requires the datasetname. The first parameter will be used for the command or clist name. The datasetname enclosed within quotes will be inserted without the membername, and the remaining parameters appended. By using this macro you can invoke SEARCH4 or COMPRESS from within edit and have the required dsname supplied automatically. From within edit of 'fully.qualified.dsname(member)' the following pairs would be equivalent: ===> @DSNQ compress ===> TSO compress 'fully.qualified.dsname' ===> @DSNQ search4 arg1,'argument2',arg3 ===> tso SEARCH4 arg1,'argument2',arg3 The last two items would be functionally equivalent to ===> @SEARCH4 arg1,'argument2',arg3 Use of the Command column in DSLIST DSLIST (PDF 3.4) provides a mechanism to include the dsname as the first operand when using the command column to implement a TSO cmd, CLIST or REXX exec. The dsname enclosed in quotes will be used as the first parameter. You may append a membername, and include additional parameters if they also fit in the dsname (NAME) area without extending into the message area. For additional information, get into the DSLIST selection panel (shown below), then enter HELP, then 2 (Using TSO command, ...). DSLIST - DATA SETS BEGINNING WITH IS03.SHARE.* ROW 1 OF 2 COMMAND ===> _ SCROLL ===> CSR COMMAND NAME message VOLUME ---------------------------------------------------------- search4 IS03.SHARE.CNTL arg1,'argument2',arg3 TSOD04 e IS03.SHARE.TEXT(m*) TSOD04 ***************** END OF DATA SET LIST ******************* There are a couple of fast path entries to DSLIST that may be of value to you. Using $EDIT or $BROWSE with an asterisk in the dsname will get you into DSLIST instead of into edit or browse. Another fast path into DSLIST is to use Q DSLIST. ===> TSO $EDIT IS03.SHARE.* ===> TSO Q DSLIST The Q clist is a quick entry into several of the normal panels. The advantage of using this clist is that you return to the point of invocation when you finish. Several options exist including COMPRESS | LIBRARY (2.3.1), DATASET (2.3.2), COPY (MoveCopy 2.3.3), DSLIST (2.3.4), SEARCH4 (2.3.14), TSO | COMMAND (2.6), DIALOG (2.7) HELP Information Available Additional information can be obtained by entering each of the following commands: (You may see the actual clist by omitting the word HELP) ===> TSO clist @DSNQ help ===> TSO clist @SEARCH4 help ===> TSO clist SUPERC help ===> TSO clist Q help ===> TSO clist @SCRIPT help The text of this article is in IS03.SHARE.TEXT(ART003) and can be formatted for printing using the @SCRIPT macro, while in edit on this member. ===> @SCRIPT ç to print at Mytown ===> @SCRIPT Q ç (quick) to view formatted output ===> @SCRIPT DEST(dest) ç remote printing n ART003 on