EDIT macro ALIGNTAB                                          EDIT macro ALIGNTAB

                                                       Author: David McRitchie
                                                   formatted on  1995/04/01 06:54
          for assistance contact: D. McRitchie                DMcRitchie@hotmail.com
--------------------------------------------------------------------------------
Macro name.  ALIGNTAB
 users.      PDF EDIT users particularly SCRIPT users
 type.       Edit Macro   resides in SYS1.TSOCLIST,  and in IS03.SPF2.MACROS for
             use on SPF/PC

--------------------------------------------------------------------------------
ALIGNTAB Align tabs(ª or ^)  within CC range to specified columns
--------------------------------------------------------------------------------
    related   REMBLANK
--------------------------------------------------------------------------------

     This macro will attempt to align tabs on column  indicated  by  moving
     TAB  and  remaining  tabs and data left by deleting spaces immediately
     left; or right by adding spaces immediately left of tab and  remaining
     tabs  and data.  Text library without sequence numbers (VB 255) is re-
     commended; otherwise, data may be truncated.

     For each line, each tab will have to be placed.  So will  be  somewhat
     CPU  intensive.   No tabs will be deleted, and tabs will only be added
     if INSERT option is used.   Lines not up to  specs  will  be  labelled
     .ERRaa,  and  lines  with  insufficient  tabs  will be labelled .FEWaa
     Process ALL lines within range unless NX  is used.

           e.g.  ===> ALIGNTAB 10 20 30 40 50 NX  .A .B

|    Will align the first tab character to 10 the next to 20, the
|    next to 30, etc.    The tab is the PLI not sign.  On a PC it is
|    the ascii x'5E' (^).  On the mainframe it is x'b0' (ª).

--------------------------------------------------------------------------------

                          Since square brackets are not available, optional
                           material is enclosed in European brackets <...>.

 ISREDIT  ALIGNTAB <lptr-range> <NX> col1 ... coln

--------------------------------------------------------------------------------

     lptr-range   A pair of line pointers can be used to restrict the lines  un-
                  der consideration.  The line pointers must be a labels.  Spec-
                  ifying  one  line  pointer  is  invalid.   The default, if not
                  specified, is .ZFIRST and .ZLAST, indicating  that  all  lines
                  are to be processed.

     CC-range     A  process  range  between  CC  line commands is an acceptable
                  line-range for this macro.

     NX           Affects only lines that are  NOT  EXCLUDED from the display

     INSERT       Insert missing tabs if missing tab position and  remainder  of
                  card  is  blank.    Suggest redoing your command afterwards to
                  recheck  .FEWxx labels.

Example

           ALIGNTAB 3 10 15 35 50


|    1...5...10...15...20...25...30...35...40...45...50...55
|    ----+----1----+----2----+----3----+----4----+----5----+
|     ^aa ^b ^cccc ^dddd ^e ee
|      ^xa  ^xb  ^xcc yfff ^xdddddd ^xeee

|    1...5...10...15...20...25...30...35...40...45...50...55
|    ----+----1----+----2----+----3----+----4----+----5----+
|      ^aa    ^b   ^cccc               ^dddd          ^e ee
|      ^xa    ^xb  ^xcc yfff           ^xdddddd       ^xeee


Internal Aspects

Internal aspects describes how the CLIST functions.  This information is partic-
ularly useful to someone who may need to  design  a  similarly  functional  edit
macro. It may also provide additional insight to the user.

You may examine the clist by entering:
     COMMAND ===> TSO CLIST ALIGNTAB

You may check for later documentation online if using hardcopy:
     COMMAND ===> TSO CLIST ALIGNTAB HELP