OA25718: TESTPORT COMMAND UTILIZES STANDARD 3 MINUTE TCP/IP TIMEOUT FOR CONNECT REQUEST. MAKE TESTPORT TIMEOUT CONFIGURABLE.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• TESTPORT command utilizes standard 3 minute TCP/IP timeout for
  CONNECT request. Make TESTPORT timeout configurable.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All Tivoli NetView for z/OS users of the     *
  *                 TESTPORT command.                            *
  ****************************************************************
  * PROBLEM DESCRIPTION: When the TESTPORT command is used to    *
  *                      test a port that is blocked by a        *
  *                      firewall, it takes over three minutes   *
  *                      for the command to timeout.             *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  The NetView TESTPORT command waits 300 seconds for a SOCKET
  command to complete within a NetView CORRWAIT pipe stage. This
  five minute value is hard coded in the pipe in CNMECKPT and is
  the cause of the long wait when the SOCKET command in the pipe
  fails to end or respond.
  

Problem conclusion

• The TESTPORT command is being enhanced to support a timeout
  parameter on the command and as a default value specifiable in a
  global variable named COMMON.IPPORTMON.PORTTO.x where x is an
  integer. The online help for the TESTPORT command is being
  changed to describe the new timeout parameter. CNMSTYLE is being
  changed to add the new timeout global variable.
  
  The following publications changes should also be made:
  o Tivoli NetView V5R3 for z/OS Administration Reference
    (SC31-8854-03), chapter named CNMSTYLE Initialization
    Statements, add a new section titled COMMON.IPPORTMON.PORTTO
    as follows:
  
      The COMMON.IPPORTMON.PORTTO statement specifies the timeout
      value after which the TESTPORT command will stop waiting for
      a response from the IP port if a response has not yet been
      received.
  
      The COMMON.IPPORTMON.PORTTO statement has the following
      syntax:
  
       >>__COMMON.IPPORTMON.PORTTO.x=sssssss______________________
  
      Where:
  
      x
  
      This is a positive integer and constitutes a numeric label
      to distinguish definitions. It must start with 1;
      consecutive numbers must be used.
  
      sssssss
  
      The timeout value specified in seconds.
  
      Usage Note: If you specify the COMMON.IPPORTMON.PORTTO
      statement, you must specify the following statements:
  
      o COMMON.IPPORTMON.INTVL
      o COMMON.IPPORTMON.IPADD
      o COMMON,IPPORTMON.PORTNUM
  
      Use the same numeric label (x) to link the COMMON.IPPORTMON
      statements together.
  
  o Tivoli NetView V5R3 for z/OS Command Reference Volume 1
    (SC31-8857-03), Chapter 3, NetView Commands and Command
    Descriptions, section TESTPORT (NCCF; CNMETSTL) change as
    follows:
  
    Change syntax diagram as follows:
  
    >>-TESTPORT-+---------------------------------------------+-><
                '- host_name port_number-+------------------+-'
                                         '-| More options |-'
  
    More options:
    |--+-------------------------------------+--|
       '- monitor_interval-+---------------+-'
                           '- port_timeout-'
  
    Add the following operand to Operand Descriptions:
  
    port_timeout
       The timeout value in seconds which when it expires will
       terminate the TCP/IP port connection request if it has not
       yet completed. The NetView default is 300 seconds. The
       TCP/IP default timeout may be less than NetView's and thus
       override the NetView timeout value.
  
    Change the last sentence in the second usage note to read as
    follows:
  
      If both port_number and host_name are specified,
      monitor_interval and port_timeout are optional.
  
    Add the following as the last sentence in the third usage
    note:
  
      If port_timeout is specified, a null value for
      monitor_interval may not be specified.
  

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:

  UA44624 UA44625 UA44626 UA44627

Modules/Macros

• CNMECKPT CNMETSTL CNMSTYLE EUYCNMSC
  

Fix information

• Fixed component name

  NETVIEW FOR Z/O

• Fixed component ID

  5697ENV00

Applicable component levels

• R53B PSY UA44624

     UP09/03/03 P F903

• R53E PSY UA44625

     UP09/03/03 P F903

• R53G PSY UA44626

     UP09/03/03 P F903

• R53J PSY UA44627

     UP09/03/03 P F903

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.