Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• F resolver,refresh,setup='/etc/resolver/setup' was issued using
  a setup file that had MAXTTL(600) coded. This results in error
  message EZZ9295I INCORRECT STATEMENT SYNTAX ON LINE xx. The
  Resolver parser code is incorrectly handling the MAXTTL value if
  it is less than 4 characters when UNIX HFS files are used.
  

Local fix

• change the MAXTTL value in the UNIX file to a 4 character value.
  ex   change MAXTTL(600) to MAXTTL(0600)
  
  or
  
  use an MVS dataset as the setup file input
  Also the Resolver's sample setup file RESSETUP(EZBRECNF)
  will be corrected to have the MAXTTL value set to
  the default value instead of (600).
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of the IBM Communications Server   *
  *                 for z/OS Version 1 Release 11 IP: Resolver   *
  ****************************************************************
  * PROBLEM DESCRIPTION: When using a file system file to        *
  *                      change the resolver's MAXTTL value      *
  *                      message EZZ9295I is incorrectly issued  *
  *                      if the number of seconds specified      *
  *                      is less than 4 digits long.             *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  The resolver configuration routine when reading a file system
  file incorrectly handled the length of line returned for its
  read. This caused the resolver to treat any MAXTTL value less
  than four digits long to be a syntax error.
  The following message was issued.
  EZZ9295I INCORRECT STATEMENT SYNTAX ON LINE nnnn
  The resolver setup statement sample, EZBRECNF ALIAS(RESSETUP),
  had the incorrect default value for the MAXTTL statement.
  +-------------------------------------------------------------+
  + Please check our Communications Server for OS/390 homepages +
  + for common networking tips and fixes.  The URL for these    +
  + homepages can be found in Informational APAR II11334.       +
  +-------------------------------------------------------------+
  

Problem conclusion

• The resolver is amended to correctly process the MAXTTL setup
  statement. The EZBRECNF ALIAS(RESSETUP) sample is changed
  to specify the MAXTTL default value of MAXTTL(2147483647)
  
  After applying the maintenance, use the following guidelines to
  stop and restart the resolver:
  
  1. If you have LLA running, then refresh it with the system
     operator command
        MODIFY  LLA,REFRESH
  
  2. Stop the resolver
     a. If you have not customized the resolver, issue the system
        operator command
           STOP RESOLVER
     b. If you have customized the resolver, issue the system
        operator command
           STOP <procname>
           where <procname> is the name of your PROCLIB member
  
  3. Restart the resolver
     a. If you have not customized the resolver, issue the system
        operator command
           START IEESYSAS.RESOLVER,PROG=EZBREINI,SUB=MSTR
     b. If you have customized the resolver, issue the system
        operator command
           START <procname>  or  START <procname>,SUB=MSTR
           where <procname> is the name of your PROCLIB member
   ----------------------------------------------------------
  
  The following documentation changes are also made:
  z/OS Communications Server IP Configuration Guide
  Version 1 Release 11
  Document Number SC31-8775-15
  
  Chapter: Understanding resolvers
  Section: Resolver customization
  Subject: Create a resolver setup file (MVS data set or z/OS UNIX
            file)
  
  In the current sample described after sentence
  "The z/OS Communications Server provided sample setup file can
  be found as member EZBRECNF (alias RESSETUP) in SEZAINST:"
   Change MAXTTL(600) to MAXTTL(2147483647)
  
  =====================================================
  
  z/OS Communications Server IP Messages:
  Volume 4 (EZZ, SNM)
  Version 1 Release 11
  SC31-8786-11
  Document Number SC31-8786-11
  
  Message: EZZ9298I resolversetupstatement - setupstatementvalue
  In the table describing the resolversetupstatement MAXTTL change
  its setupstatementvalue description to
  
  The maximum time to live (TTL) setting, in seconds, that the
  resolver can use when creating cache entries that represent
  response information from the name server.
  
  In the Example:
   Change EZZ9298I MAXTTL - 600S to EZZ9298I MAXTTL - 600
  
  
  Message: EZZ9304I resolversetupstatement
  In the Example:
   Change EZZ9298I MAXTTL - 600S to EZZ9298I MAXTTL - 600
  
  =====================================================
  
  z/OS Communications Server IP System Administrator's Commands
  Version 1 Release 11
  Document Number SC31-8781-09
  
  Chapter: Querying and administrating a Domain Name System (DNS)
  Section: Using the TSO NSLOOKUP command
  Add the following:
  Rule: The NSLOOKUP command does not use Resolver caching.
  
  
  Chapter: Querying and administrating a Domain Name System (DNS)
  Section: Using the z/OS UNIX onslookup/nslookup command
  Add the following:
  Rule: The onslookup/nslookup command does not use Resolver
  caching.
  
  
  Chapter: Querying and administrating a Domain Name System (DNS)
  Section: Using the TSO DIG command
  Add the following:
  Rule: The DIG command does not use Resolver caching.
  
  
  Chapter: Querying and administrating a Domain Name System (DNS)
  Section: Using the z/OS UNIX dig command
  Add the following:
  Rule: The dig command does not use Resolver caching.
  
  
  * Cross Reference between External and Internal Names
  EZBRECNF (RESSETUP)
  

Temporary fix

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

  UK49352

Modules/Macros

•    EZBRECFG EZBRECNF
  

Publications Referenced

SC31877514

SC31878611

SC31878109

Fix information

• Fixed component name

  TCP/IP V3 MVS

• Fixed component ID

  5655HAL00

Applicable component levels

• R1B0 PSY UK49352

     UP09/10/02 P F910

Fix is available

• Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.

IBM, the IBM logo and ibm.com are trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the Web at "Copyright and trademark information" at www.ibm.com/legal/copytrade.shtml.

Product categories:

Software

Networking

Enterprise Connectivity

z/OS Communications Server

All

Operating system(s):

z/OS

Software version:

1B0

Reference #:

PK92896

IBM Group:

IBM Server Group

Modified date:

2009-11-04