TAA Tools
CHKARACDE       CHECK AREA CODE                        TAAARAF

The Check Area Code  command provides a method of checking  for a valid
area  code.  The  TAA9891 escape message  is sent  if the area  code is
invalid.   An optional  completion message is provided.   Only the area
codes provided  by  the  PRTARACDE  tool are  supported  (includes  US,
Canada, Caribbean, Samoa, etc).

A typical command would be:

             CHKARACDE     ARACDE(xxx)

If the area  code is valid, the command completes  normally.  Since the
COMPMSG  parameter  defaults to  *YES,  a completion  message  would be
sent such as:

    Area code 212 was found in NY.  The time zone is Eastern.
      Description = Manhattan, NY overlays 646/917

If the area code is invalid, TAA9891 is sent as an escape message.

CHKARACDE escape messages you can monitor for
---------------------------------------------

      TAA9891    The area code is invalid

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

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

   ARACDE        The area  code to  be checked.   Only  the area  codes
                 provided   by  the   PRTARACDE   tool  are   supported
                 (includes US, Canada, Caribbean, Samoa, etc).

   COMPMSG       A  *YES/*NO  value for  whether  a  completion message
                 will be sent with details about the area code.

                 *YES is the default to send a completion message.

                 *NO may be  specified to bypass  sending a  completion
                 message.

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

None.

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

The following TAA Tools must be on your system:

     RTVARACDE       Retrieve area code
     SNDESCINF       Send escape information
     SNDESCMSG       Send escape message

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

None, the tool is ready to use.

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

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

   CHKARACDE     *CMD                   TAAARAF       QATTCMD
   TAAARAFC      *PGM       CLP         TAAARAFC      QATTCL
					

Added to TAA Productivity tools April 15, 2006


Home Page Up to Top