TAA Tools
CVTNETSTAT      CONVERT NETWORK STATISTICS             TAANETH

The  Convert Network  Statistics  tool  allows  the conversion  of  TCP
network  statistics to  outfiles.   Options  on the  CVTNETSTAT command
allow  conversion of TCP/IP 1)  Interface status, 2) Route information,
and 3)  Connection status.   Each of  the sub functions  is a  separate
command.  System APIs are used to access the data.

Prompting  for CVTNETSTAT  allows  you to  enter  the SELECT  parameter
which  determines which  of  the sub  commands will  be used  and which
outfile will be produced.

The QTOCNETSTS service program is used.

  SELECT  COMMAND     OUTFILE   MODEL FILE  FORMAT   API
  ------  -------     -------   ----------  ------   ---
  *IFC    CVTNETIFC   NETIFCP   TAANETHP    NETIFCR  QtocLstNetIfc
  *RTE    CVTNETRTE   NETRTEP   TAANETHQ    NETRTER  QtocLstNteRte
  *CNN    CVTNETCNN   NETCNNP   TAANETHS    NETCNNR  QtocLstNetCnn

A typical CVTNETSTAT command would be:

             CVTNETSTAT   SELECT(*IFC) OUTLIB(xxx)

The network statistics would be  converted to NETIFCP in the  specified
library.

Escape messages you can monitor for
-----------------------------------

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

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

   SELECT        The type of information to be output.

                 *IFC  is  the  default  for Interface  status.    This
                 invokes the CVTNETIFC command.

                 *RTE  may be  specified for  Route information.   This
                 invokes the CVTNETRTE command.

                 *CNN  may  be  specified  for  connection  status  and
                 additional parameters  may be  entered.  This  invokes
                 the CVTNETCNN command.

   OUTLIB        The  library  in which  the  outfile  will be  placed.
                 The default is *LIBL.

                 Three  different outfile  names are  used depending on
                 the SELECT value.

                  *IFC   Outfile is NETIFCP with a format of NETIFCR
                  *RTV   Outfile is NETRTEP with a format of NETRTER
                  *CNN   Outfile is NETCNNP with a format of NETCNNR

                 If  the outfile  does  not  already exist,  a  library
                 must  be  specified.   *CURLIB  may  be  used for  the
                 library.

   OUTMBR        The member of the outfile file to be used.

                 The  default *CMDDFT  names the  outfile based  on the
                 SELECT   parameter.       For   example,    specifying
                 SELECT(*IFC) uses NETIFCP as the member name.

                 A specific member name may be entered.

   REPLACE       A  *YES/*NO  value  for  whether  an  existing  member
                 should be cleared before writing records into it.

                 *YES  is  the  default  to  clear  the  member  before
                 writing new records.

                 *NO may be  specified to add  to the existing  member.

   NETCNNTYPE    The connection type for SELECT(*CNN).

                 *ALL is the default for all connection types.

                 *TCP  may  be  specified  for   a  TCP  connection  or
                 socket.

                 *UDP  may be  specified for  a User  Datagram Protocol
                 (UPD) socket.

                 *IPI  may be  specified for  a Internet  Protocol (IP)
                 over  Internetwork Packet  Exchange  (IPX)  connection
                 or socket.

                 *IPS  may be  specified for  a Internet  Protocol (IP)
                 Over SNA connection or socket.

   LCLIPLWR      The  lower value of the  local system internet address
                 range in dotted decimal format for SELECT(*CNN).

                 *ALL is the default.

   LCLIPUPR      The upper value of  the local system internet  address
                 range in dotted decimal format for SELECT(*CNN).

                 *LWR  is  the  default   meaning  the  same  value  as
                 LCLIPLWR.

   LCLPORTLWR    The  lower value  of the local  system port  range for
                 SELECT(*CNN).    The  value  must  be  between  1  and
                 65535.

                 *ALL is the default.

   LCLPORTUPR    The upper  value of  the local  system port range  for
                 SELECT(*CNN).    The  value  must  be  between  1  and
                 65535.

                 *LWR   is  the  default  meaning  the  same  value  as
                 LCLPORTLWR.

   RMTIPLWR      The  lower  value   of  the  remote   system  internet
                 address in dotted decimal format for SELECT(*CNN).

                 *ALL is the default.

   RMTIPUPR      The  lower   value  of  the   remote  system  internet
                 address in dotted decimal format for SELECT(*CNN).

                 *LWR  is   the  default  meaning  the  same  value  as
                 RMTIPLWR.

   RMTPORTLWR    The lower value  of the remote  system port range  for
                 SELECT(*CNN).    The  value  must  be  between  1  and
                 65535.

                 *ALL is the default.

   RMTPORTUPR    The  upper value of  the remote system  port range for
                 SELECT(*CNN).    The  value  must  be  between  1  and
                 65535.

                 *LWR is  the  default meaning  the same  value as  for
                 RMTPORTLWR.

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

   OUTLIB        The  library  in   which  the  NETIFCP  file  will  be
                 placed.   The default  is *LIBL.   If the NETIFCP file
                 does not already exist,  a library must be  specified.
                 *CURLIB may be used for the library.

   OUTMBR        The member  of the  NETIFCP file to  be used.   If the
                 member  does not exist,  it is added.   The default is
                 NETIFCP.   One  record  is written  for  each  network
                 interface.

   REPLACE       A  *YES/*NO  value  for  whether  an  existing  member
                 should be cleared before writing records into it.

                 *YES  is  the  default  to  clear  the  member  before
                 writing new records.

                 *NO may be  specified to add  to the existing  member.

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

   OUTLIB        The  library  in  which  the   NETRTEP  file  will  be
                 placed.   The default is  *LIBL.  If  the NETRTEP file
                 does  not already exist, a  library must be specified.
                 *CURLIB may be used for the library.

   OUTMBR        The member  of the NETRTEP  file to be  used.  If  the
                 member does  not exist, it  is added.  The  default is
                 NETRTEP.    One  record is  written  for  each network
                 route.

   REPLACE       A  *YES/*NO  value  for  whether  an  existing  member
                 should be cleared before writing records into it.

                 *YES  is  the  default  to  clear  the  member  before
                 writing new records.

                 *NO  may be specified  to add to  the existing member.

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

   OUTLIB        The  library  in  which  the  NETCNNP  file  will   be
                 placed.  The  default is *LIBL.   If the  NETCNNP file
                 does not  already exist, a library  must be specified.
                 *CURLIB may be used for the library.

   OUTMBR        The  member of  the NETCNNP file  to be used.   If the
                 member does not  exist, it is  added.  The default  is
                 NETCNNP.

   REPLACE       A  *YES/*NO  value  for  whether  an  existing  member
                 should be cleared before writing records into it.

                 *YES  is  the  default  to  clear  the  member  before
                 writing new records.

                 *NO may be  specified to add  to the existing  member.

   NETCNNTYPE    *ALL the default for all connection types.

                 *TCP  may  be  specified   for  a  TCP  connection  or
                 socket.

                 *UDP  may be  specified for  a User  Datagram Protocol
                 (UPD) socket.

                 *IPI may  be specified  for a  Internet Protocol  (IP)
                 over  Internetwork Packet  Exchange  (IPX)  connection
                 or socket.

                 *IPS  may be  specified for  a Internet  Protocol (IP)
                 Over SNA connection or socket.

   LCLIPLWR      The  lower value of the  local system internet address
                 range in dotted decimal format.

                 *ALL is the default.

   LCLIPUPR      The upper value  of the local system  internet address
                 range in dotted decimal format.

                 *LWR  is  the  default   meaning  the  same  value  as
                 LCLIPLWR.

   LCLPORTLWR    The  lower value of the local  system port range.  The
                 value must be between 1 and 65535.

                 *ALL is the default.

   LCLPORTUPR    The upper value of the  local system port range.   The
                 value must be between 1 and 65535.

                 *LWR  is  the  default  meaning   the  same  value  as
                 LCLPORTLWR.

   RMTIPLWR      The   lower  value  of  the   remote  system  internet
                 address in dotted decimal format.

                 *ALL is the default.

   RMTIPUPR      The  lower  value  of   the  remote  system   internet
                 address in dotted decimal format.

                 *LWR  is  the  default  meaning   the  same  value  as
                 RMTIPLWR.

   RMTPORTLWR    The  lower  value of  the  remote  system port  range.
                 The value must be between 1 and 65535.

                 *ALL is the default.

   RMTPORTUPR    The  upper  value  of the  remote  system  port range.
                 The value must be between 1 and 65535.

                 *LWR is  the default  meaning  the same  value as  for
                 RMTPORTLWR.

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

None.

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

The following TAA Tools must be on your system:

     CRTUSRSPC       Create user space
     DUPTAADBF       Duplicate TAA data base file
     EDTVAR          Edit variable
     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
   ------        ----    ---------      ----------    ----------

   CVTNETIFC     *CMD                   TAANETH       QATTCMD
   CVTNETRTE     *CMD                   TAANETH2      QATTCMD
   CVTNETCNN     *CMD                   TAANETH3      QATTCMD
   CVTNETSTAT    *CMD                   TAANETH4      QATTCMD
   TAANETHC      *PGM       CLP         TAANETHC      QATTCL
   TAANETHC2     *PGM       CLP         TAANETHC2     QATTCL
   TAANETHC3     *PGM       CLP         TAANETHC3     QATTCL
   TAANETHC4     *PGM       CLP         TAANETHC4     QATTCL
   TAANETHR      *PGM       RPGLE       TAANETHR      QATTRPG
   TAANETHR2     *PGM       RPGLE       TAANETHR2     QATTRPG
   TAANETHR3     *PGM       RPGLE       TAANETHR3     QATTRPG
   TAANETHP      *FILE      PF          TAANETHP      QATTDDS
   TAANETHQ      *FILE      PF          TAANETHQ      QATTDDS
   TAANETHS      *FILE      PF          TAANETHS      QATTDDS

Structure
---------

CVTNETSTAT  Cmd
   TAANETHC4  CL pgm

CVTNETIFC   Cmd
   TAANETHC   CL pgm
     TAANETHR   RPGLE pgm

CVTNETRTE   Cmd
   TAANETHC2  CL pgm
     TAANETHR2  RPGLE pgm

CVTNETCNN   Cmd
   TAANETHC3  CL pgm
     TAANETHR3  RPGLE pgm
					

Added to TAA Productivity tools July 15, 2006


Home Page Up to Top