TAA Tools
WRKIPDEV        WORK IP DEVICES                        TAATCPB

The Work IP Devices  command provides a work display of  the IP devices
and the currently  active job (if any).  Options  exist to 1) Work with
the  device  description,  2)  Work  with the  job,  and  3)  Work with
configuration status.   Command parameters  allow output  to a  printer
or an outfile.

If an  outfile is requested, the  model file is TAATCPBP  with a format
name of WPDEVR.

The command may be entered without any parameters such as:

             WRKIPDEV

All  display and printer IP devices would  be displayed.  This includes
remote writers which do  not have a  Device description.  The  sequence
of  the display  is  the IP  address.    Up to  9999  addresses may  be
displayed.

An  IP Address may  be named  to reduce the  number of IP  addresses on
the display such as:

             WRKIPDEV      IPADDR('192.168.100.0)

Only those  IP  addresses that  are  in  a range  of  192.168.100.1  to
192.168.100.255 would be shown.

The following chart  describes some input values and  the corresponding
'checked for'  address when a set  contains less than 3  digits, but is
not 'generic like'.

             Input Address          Checked for address
             -------------          -------------------

             123.201.056.1          123.201.056.001
             123.201.056.10         123.201.056.010
             123.2.056.10           123.002.056.010
             123.2.56.10            123.002.056.010
             123.0.56.10            123.000.056.010
             123.0.0.1              123.000.000.001

'Generic  like' addresses are written  with a single 0  in the last set
of 3 digits  or 0.0 as  the last two  sets, etc.   If a 'generic  like'
address is entered, low and high range values will be checked for.

The  following chart  describes some  input values  containing 'generic
like'  values  and  the  corresponding  low  and  high range  addresses
checked for.

       Input Address        Low Range address   High Range Address
       -------------        -----------------   ------------------

       123.101.212.0        123.101.212.000     123.101.212.255
       123.101.0.0          123.101.000.000     123.101.255.255
       123.0.0.0            123.000.000.000     123.255.255.255
       0.0.0.0              000.000.000.000     255.255.255.255
       123.0.212.0          123.000.212.000     123.000.212.255
       123.0.12.0           123.000.012.000     123.000.012.255

Note that the 5th  example has a 0  in the 2nd  set, but since the  3rd
set is not  'generic like', 000 is used  as the value for the  2nd set.
The 6th example also shows a similar value.

If  an address like 123.0.0.1  is entered, the value  is not considered
'generic like' (because the last  set is not 0)  and a full address  of
123.000.000.001 will be checked for.

If a  device  has an  internet address  that does  not have  a full  15
digits  (eg 123.20.201.111),  the device  will be  found by  entering a
short  generic  input address  (eg 123.20.201.0).   The  technique used
when the device  has an address  less than 15 digits  is to expand  the
actual address to  15 digits based on the first  chart and then compare
to the low and high range described in the second chart.

WRKIPDEV escape messages you can monitor for
--------------------------------------------

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

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

   INTNETADR     The  internet address of  the device  to be displayed.
                 *ALL  is   the  default   to  display   all   internet
                 addresses.

                 The address can  be a maximum of 15  characters in the
                 format    of    an    internet    address   such    as
                 '123.201.145.003'  or  '123.1.145.3'.     A   'generic
                 like'   type  of   entry  is   also   valid  such   as
                 '123.201.145.0' or '123.201.0.0' or '123.0.0.0'.

   DEVTYPE       The  device types  to  be  included.   The  default is
                 *BOTH for both display and printer devices.

                 *DSP may be entered for just display devices.

                 *PRT may be entered for just printer devices.

   OUTQ          Whether  Output Queues  with remote  writers that have
                 IP addresses  are  to be  included.   The  default  is
                 *NONE.

                 An entry  of xxx/*ALL will check all  Output Queues in
                 a  named  library.   The Output  Queue  name may  be a
                 specific or generic name.

                 An entry  of *ALL/*ALL  will check  all Output  Queues
                 on the system.

                 An entry  of *ALL/xxx*  will check  all Output  Queues
                 on the system for the generic name.

                 You  must be  authorized to  all  Output Queues  to be
                 checked.

   OUTPUT        How to  output  the results.    * is  the  default  to
                 display  the  results   if  the  command   is  entered
                 interactively.

                 If  the  command  is entered  in  batch  or *PRINT  is
                 specified, the results are printed.

                 *OUTFILE may be entered to write to an outfile.

   OUTLIB        The  library  where  the output  file  IPDEVP  will be
                 placed.   The  default is  *LIBL.   If  the  WRKIPDEVP
                 file  does  not  exist,  a specific  library  must  be
                 named.

   OUTMBR        The  member of  the WRKIPDEVP file  to be  added if it
                 does not already  exist.  The  default member name  is
                 WRKIPDEVP.

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

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

                 *NO may be  specified to  add records  to an  existing
                 member.

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

Up to 9999 devices may be displayed.

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

The following TAA Tools must be on your system:

     ABORT           Abort
     ADJVAR          Adjust variable
     CVTIPADR        Convert IP address
     RTVSYSVAL3      Retrieve system value 3
     SNDCOMPMSG      Send completion message
     SNDESCMSG       Send escape message
     SNDJLGMSG       Send job log message

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

None, the tool is ready to use.

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

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

   WRKIPDEV      *CMD                   TAATCPB       QATTCMD
   TAATCPBC      *PGM       CLP         TAATCPBC      QATTCL
   TAATCPBC2     *PGM       CLP         TAATCPBC2     QATTCL
   TAATCPBC3     *PGM       CLP         TAATCPBC3     QATTCL
   TAATCPBC4     *PGM       CLP         TAATCPBC4     QATTCL
   TAATCPBR      *PGM       RPG         TAATCPBR      QATTRPG
   TAATCPBR4     *PGM       RPG         TAATCPBR4     QATTRPG
   TAATCPBD      *FILE      DSPF        TAATCPBD      QATTDDS

TAATCPBC2 is  a sub program  called by TAATCPBR  to handle the  options
such as WRKDEVD.

TAATCPBC3 is a  sub program called by TAATCPBR  if the API returns less
than  15 characters for  the IP address.   It converts  a value such as
132.20.251.201 to 132.020.251.201.   This allows  a comparison for  the
low and high range of the full 15 characters.

TAATCPBC4 is a  sub program called by TAATCPBR  for OUTQ Remote writers
that  have an  IP  address without  a Device.    It calls  TAATCPBR4 to
write the  output queues  to  a temporary  work file  that is  read  by
TAATCPBR.
					

Added to TAA Productivity tools April 23, 2001


Home Page Up to Top