TAA Tools
CHKIFSSPE       CHECK IFS SPELLING                     TAAIFUD

The Check  IFS  Spelling tool  checks the  spelling  of the  data in  a
stream  file.   The data  is  converted to  the TAA240  source  file in
QTEMP and the TAA CHKSPELL2 command is used to check the spelling.

You  must be authorized to the  TAACVTIFS authorization list.  The data
is limited to 240 bytes wide for the stream file.

A typical command would be:

               CHKIFSSPE STMF(abc)

The 'abc'  stream  file in  the  home directory  would be  checked  for
spelling errors.   If spelling errors exist, the  IFSSPELL spooled file
would  be displayed.  If no spelling  errors exist, the spooled file is
deleted.

The  ERRACTION  parameter  controls   what  happens  when  errors   are
detected.  The default  is to display the spooled  file.  Other choices
allow  an escape  or completion  message.  The  spooled file  is always
retained if errors exist.

The MAXERR parameter  defaults to  100 and  will cause  the command  to
end if 100 errors  are found.  This prevents excessive  checking when a
stream file is specified that does not have text.

Home Directory and Current Directory
------------------------------------

The user  profile HOMEDIR parameter  identifies a home  directory if it
exists.

When  signon occurs, the system uses  the user profile HOMEDIR value to
help  set  the  current  directory.    The  current  directory  may  be
displayed using  the DSPCURDIR command.   The current directory  may be
changed with the CHGCURDIR command.

Any  changes to the  HOMEDIR value will  not take place  in the current
job.  You must signoff and signon after making a change.

To check your current directory, enter

             WRKLNK

You should see the objects in your home directory if any exist.

There are a few  cases where the HOMEDIR value  cannot be used and  the
system will set the current directory to '/home'.

  **   If  the home  directory  does not  exist,  create  one with  the
       MKDIR command such as:

             MKDIR         DIR('/home/xxx')

where xxx is the name of your user profile.

  **   If  the  directory  is  specified  as  LNKTYPE(*SYMBOLIC).   The
       simplest solution  is to  delete or  rename this  directory  and
       use the MKDIR command described earlier.

CHKIFSSPE escape messages you can monitor for
---------------------------------------------

      TAA9892    The object is not a stream file
      TAA9893    Spelling errors exist and ERRACTION(*ESCAPE)

Escape messages from based on functions will be re-sent.

CHKIFSSPE Command parameters                          *CMD
----------------------------

   OBJ           The object  name to be  spell checked.   It must be  a
                 stream file.  Up to 5000 bytes may be entered.

                 If  the  object  name  begins  with  a '/',  the  full
                 object name must be entered.

                 If  the object  name does  not begin  with a  '/', the
                 user must  have  a current  directory and  the  stream
                 file name is appended to the current directory.

                 The  typical method of  setting the  current directory
                 is  to have  a user profile  HOMEDIR entry  and a home
                 directory.   See  the  previous  discussion  of  'Home
                 Directory and Current Directory'.

   ERRACTION     How  to  handle  spelling  errors.    If  no  spelling
                 errors exist, the spooled file is deleted.

                 *DISPLAY  is the default to  display the spooled file.
                 The spooled  file is  deleted after  it is  displayed.
                 If the command  is run in  batch and an  error occurs,
                 *DISPLAY  operates as if  *ESCAPE had  been specified.

                 *ESCAPE  may be specified to  send the TAA9893 message
                 as an escape type.  The spooled file is retained.

                 *COMPLETION may be  specified to receive  a completion
                 message.  The spooled file is retained.

   MAXERR        The  maximum number  of errors  that can  exist before
                 checking  ends.     The  default  is  100.    Using  a
                 reasonable value  prevents  excessive  errors  when  a
                 stream file is  named that contains data  not intended
                 to be spell checked.

                 The  ERRACTION  parameter controls  what  happens when
                 the maximum is reached.

   DICT          The name of a  specific dictionary to  be used.   *DFT
                 is  the default  in which  case  the DCTARA  parameter
                 takes precedence.

                 A specific  dictionary name may  be used along  with a
                 library  qualifier.    If  a  specific  dictionary  is
                 named, DCTARA(*DFT) must be used.

   DCTARA        An  optional   parameter  that   allows   a  list   of
                 dictionaries  to be  specified by  naming a  data area
                 in  library  TAADCT  that  contains  the  list.    The
                 default is *DFT.   The  list of  dictionaries must  be
                 entered according  to the  CRTDCTARA TAA Tool  and the
                 data  area containing  the dictionaries must  exist in
                 the TAADCT  library.   Up  to  8 dictionaries  may  be
                 named in the data area.

                 If *DFT is specified, the following rules exist:

                 1) If  the library TAADCT  does not exist,  the TAADFT
                 dictionary in TAATOOL is used.

                 2) If  the TAADCT library  exists, a data  area by the
                 name  of  the  user  of the  job  is  searched  for in
                 TAADCT.   If it  does not exist,  a data  area by  the
                 name of SYSTEM is searched for in TAADCT.

                 3) If  neither data area exists  the TAADFT dictionary
                 in TAATOOL is used.


Restrictions
------------

You must be authorized to the TAACVTIFS authorization list.

The stream file record size may not exceed 240 bytes.

The stream file cannot be in binary file.

Prerequisites
-------------

The following TAA Tools must be on your system:

     CHKIFSE         Check IFS entry
     CHKSPELL2       Check spelling 2
     CVTIFS          Convert IFS
     EDTVAR          Edit variable
     RSNLSTMSG       Resend last message
     RTVSYSVAL3      Retrieve system value 3
     SNDCOMPMSG      Send completion message
     SNDESCINF       Send escape information
     SNDESCMSG       Send escape message
     SNDSTSMSG       Send status message

Implementation
--------------

None, the tool is ready to use.

Objects used by the tool
------------------------

   Object        Type    Attribute      Src member    Src file
   ------        ----    ---------      ----------    ----------

   CHKIFSSPE     *CMD                   TAAIFUD       QATTCMD
   TAAIFUDC      *PGM       CLP         TAAIFUDC      QATTCL
   TAAIFUDR      *PGM       RPG         TAAIFUDR      QATTRPG
					

Added to TAA Productivity tools January 15, 2011


Home Page Up to Top