'IS03.SHARE.TEXT(NCADD)' -- ART008 April 1st, 1995 6:54 a.m. -- dev(1403W8) chars(MONO) +--------------------------------------------------------+ | | | | | The Toolbox | | | | Items in this Tooolbox: | | 1. ISPF 3.5 changes | | 2. Membername selection using patterns | | 3. Macro/Command COLS, FLIP, DCFMSGS | | 4. PA2, UNDO, SETUNDO, and recovery | | 5. Sorting data (SORT, SORTCR, SORTEM, SORTG) | | 6. JCL procedures (AMSCLUST) | | 7. Demonstration (users, date/time, traps, etc.) | +--------------------------------------------------------+ ---------------------------------------------------------+- 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. If you have comments or suggestions for the Toolbox column or need a TSO tool please contact the author. Today's Toolbox column ... Several of the items in today's column reference ISPF 3.5 which was installed in August (prior 3.3). You can examine changes made by looking at option 2.C (2=PDF, C=Changes). Membername selection In selecting the member name on the Browse and Edit entry panels, a wildcard character of * indicates any number of characters (including none). AB* will select a membername of AB or anything beginning with AB. AB*C* will select a membername of ABC and anything beginning with AB that also has a C somewhere later. ISPF 3.5 has introduced a % to indicate a single character. AB%C* then means anything beginning with AB, followed by a single character, followed by C, followed by any other character (including none). You may examine the tutorial for specific examples by forcing an UNMATCHED indication by selecting a non-existant member and then hit HELP (PF1) twice and read the five pages in the tutorial. FLIP, editor primary command Reverses NX/X (displayed/undisplayed) status of lines. Label range is optional. If you are an SPF/PC user, a macro can be obtained from IS03.SPF2.MACROS(FLIP). FLIP is especially useful when used to see the undisplayed lines then once again to get back to your originally displayed lines. COLS macro The COLS macro matches the use of COLS available in BROWSE and features the use of INFOLINE (======) an ISPF 3.5 introduction of a scrollable special line similar to NOTELINE (=NOTE=) and MSGLINE (==MSG>). DCFMSGS macro The DCFMSGS macro is an aid for SCRIPT/VS users. This macro will merge the errors as NOTELINES back to the document in edit, where you would normally use the @SCRIPT macro. UNDO and PA2 If you have made changes to your screen, but have not yet actually changed your workspace you may use PA2 to refresh your screen. If you have hit enter then you may either back out of the member with CANCEL and reenter your edit, or if you've planned ahead you may use successive UNDO commands to undo each time a change was entered (with ENTER or a PF key). UNDO allows the systematic removal of data modifications one edit interaction at a time back to the last SAVE. Until SETUNDO was introduced in ISPF 3.4 the use of a recovery dataset was mandatory (RECOVERY ON). With SETUNDO STG, changes are maintained in storage allowing the use of the UNDO command even without a recovery dataset (RECOVERY OFF). With SETUNDO REC the use of UNDO is available only when RECOVERY ON is your recovery option. Use the PROFILE edit command to check your current edit profile. RECOVERY ON provides for recovery of your edit session changes should your edit session terminate with unsaved modifications such as inadvertently powering off your terminal or being abruptly terminated. Sorting data in edit SORT, command to sort. Refer to ISPF help (SORT ?). SORTCR (sort column and row), sorts word list into columns, so words read down columns. SORTEM, sorts word list into rows and columns, so words read across rows. SORTG (sort groups), sorts groups or blocks of lines. Lines in range which are undisplayed (X) belong to the displayed line (NX) group above them within range. The NX lines will be sorted. The PDS or dataset must have sufficient room to the right to include the sort area plus a sequence number (VB 251 255 recommended). Tutorial You should familarize yourself with the Tutorial (option T from the Primary Selection panel) and particularly, the first three screens describing PFkey usage with tutorials. Keys and Commands from within Tutorial HELP PF1 - to get help on how to use the tutorial. END PF3 - to end the tutorial. UP PF7 - to display a higher level list of topics. DOWN PF8 - to go on to the next topic (S or skip). LEFT PF10 - to display the previous page (B or back). RIGHT PF11 - to display the next page, which is the same as pressing ENTER. INDEX I - to display the tutorial index TOC T - to display the table of contents Tutorial INDEX As you've seen one way to get into a TUTORIAL is by forcing an error in the syntax of the command that you want help with. Another way of locating specific tutorial information is through the alphabetized tutorial INDEX. Once you are on any tutorial screen (PF1) you can get to the index by entering either an I or the word INDEX. Items in the index should be looked up according to their names. Item numbers used in the current ISPF release (3.5) for some of the topics already mentioned are as follows: F6 FLIP primary command (edit) K2 KEYS command and PF keys M6 Member list patterns P30 PROFILE primary command (edit) P31 Program access (PA) keys R5 RECOVERY primary command (edit) S24 SETUNDO primary command (edit) S36 SORT primary command (edit) U3 UNDO primary command (edit) AMSCLUST, JCL procedure Used in place of PGM=IDCAMS or PROC=AMS will interpret the timestamp in a LISTCAT listing for a VSAM file to Greenwich mean time (GMT). Miscellaneous commands to help you find your way around Sometimes a demonstration is worth a thousand words. So here are some demonstrations that you can try. Each command can be issued from the command line from most any ISPF panel. TSO $USERS -- display list of TSO users. TSO $USERS NET -- display telephone directory information. TSO NETWORK lastname -- displays telephone directory information TSO CLIST HELP -- display online help for clists contained in IS03.CLISTHLP.HELP($HELP$). TSO CLIST SORTG -- display the clist SORTG. TSO CLIST SORTG HELP -- display the help information for clist SORTG. TSO HELP -- display HELP information. TSO TSOTRAP HELP -- trap and display HELP information. TSO LISTBC -- list the broadcast dataset. TSO LISTCAT -- list your files found in catalog. TSO LISTDD -- list all the ddnames of datasets allocated to you. TSO LISTDD SYSPRINT -- list ddnames restricted to SYSPRINT allocated to you. TSO LISTDS libr.cntl -- list dataset information for your xxxx.LIBR.CNTL dataset. TSO LISTRP -- List RACF Protection for each of your own files. TSO TIME -- display the time. Also try TIMES and TOD. Also try edit macro @DATE (and HELP key). QW -- entry into MVS/QuickRef 3.3 - Main Menu * SEARCH =R LENGTH -- from within QW search R (REXX) for character string "LENGTH". QW m=IBM* -- quick entry to messages beginning with IBM QW m=s0c4 -- quick entry to abend S0C4 information QW R= -- quick entry REXX information QW U=*=jobclass -- requests x-topic search of user database (1,2,3,4, and D) for jobclass TSO TSOTRAP LISTRP -- trap and display List RACF Protection for each of your own files. The dataset created by TSOTRAP even though created as a permanent dataset should be treated as a temporary dataset as it will be deleted once you hit PF3 (end). If you want Page REXX-1 to transfer the data to a permanent file you might use CUT/PASTE (Sept '93, and documentation). HAPPY HOLIDAYS! n ART008 on ----------------------- Notes for printing in Newsletter topic headings Topic Sub-topics This is Helvetica. This is Helvetica bold. SOMETIMES A BOLD FONT THAT IS ONE POINT SMALLER IS USED WHEN ALL CAPITALS TSO TSOTRAP LISTRP -- trap and display List RACF Protection for each of your own files. check with a same size TSO TSOTRAP LISTRP -- trap and display List RACF Protection for each of your own files. TSO TSOTRAP LISTRP -- trap and display List RACF Protection for each of your own files. TSO TSOTRAP LISTRP -- trap and display List RACF Protection for each of your own files. ---------------------------------------------------------- SCRIPT 'IS03.SHARE.TEXT(NCADD)' PRO('SCRIPT.R40.MACLIB(DSMPROFL)') L('SCRIPT.R40.MACLIB') FI('IS03.NCPDSHLP.LIST') TW CONT SYSVAR(X NO H NO D NO) M(ID TRACE) BIND(0 0) INDEX DEV(1403W8) 1995/04/01 Saturday, April 01, 1995 06:54 1403 ----------------------------------------------------------