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
