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
|
