TAA Tools
RTVDEVPRT       RETRIEVE DEVICE PRINTER                TAADEVC

The  Retrieve Device  Printer  command  retrieves information  about  a
printer device such as the type, model, port, and switch settings.

A typical command would be:

             DCL          &TYPE *CHAR LEN(10)
              .
             RTVDEVPRT    DEV(xxx) TYPE(&TYPE)

The QDCRDEVD API is used to access the information.

RTVDEVPRT command parameters                          *CMD
----------------------------

   DEV           The printer device name.

   TYPE          The  type  of device.    An  optional return  variable
                 that  if specified must be  declared as *CHAR LEN(10).

   MODEL         The model of  the type.   An optional return  variable
                 that if  specified must be declared  as *CHAR LEN(10).

   LOCADR        The  local address of the device.   An optional return
                 variable that if specified  must be declared as  *CHAR
                 LEN(10).

   SWTSET        The  switch  setting  of  the  device.    An  optional
                 return  variable that  if  specified must  be declared
                 as *CHAR LEN(1).

   PORT          The  port  on  which  the  device  is  attached.    An
                 optional return  variable  that if  specified must  be
                 declared as *CHAR LEN(5).

   DEVCLS        The  class   of  the  device.     An  optional  return
                 variable  that if specified must  be declared as *CHAR
                 LEN(10).

   AFP           Whether  the  device  is  set  for  Advanced  Function
                 Printing.    An  optional   return  variable  that  if
                 specified must be declared as *CHAR LEN(10).

   LCLLOCNAME    The  local location name  of the device.   An optional
                 return variable  that if  specified must  be  declared
                 as *CHAR LEN(10).

   RMTLOCNAME    The  SNA  remote location  name  of  the device.    An
                 optional  return variable  that  if specified  must be
                 declared as *CHAR LEN(10).

   RMTLOCNAM2    The SNA  remote  location  name of  the  device.    An
                 optional return  variable  that if  specified must  be
                 declared as  *CHAR LEN(255).  This value  may be blank
                 in some cases.

   RMTNETID      The  remote  network ID  of the  device.   An optional
                 return variable  that if  specified  must be  declared
                 as *CHAR LEN(10).

   MODE          The mode  of the device.  An  optional return variable
                 that  if specified must be  declared as *CHAR LEN(10).

   PRTERRMSG     The handling of printer  error messages.  An  optional
                 return  variable that  if specified  must be  declared
                 as *CHAR LEN(10).

   MSGQ          The   message   queue  assigned   to   receive  device
                 messages.    An  optional  return  variable  that   if
                 specified must be declared as *CHAR LEN(10).

   MSGQLIB       The library of  the message queue assigned  to receive
                 device  messages.   An optional  return  variable that
                 if specified must be declared as *CHAR LEN(10).

   CTL           The  controller which the device  is attached to if it
                 is non-switched.    An optional  return variable  that
                 if specified must be declared as *CHAR LEN(10).

   AUTOCFG       Whether the  device is  auto configured.   An optional
                 return  variable that  if  specified must  be declared
                 as *CHAR LEN(10).

   ONLINE        A *YES/*NO value for whether  the device is placed  on
                 line  at IPL.   An  optional return  variable that  if
                 specified must be declared as *CHAR LEN(10).

   IPADDR        The  IP (Internet protocol) address  in dotted decimal
                 form.  An optional  return variable that if  specified
                 must be declared as *CHAR LEN(15).

   WSCST         The  Workstation  Customizing  Object.    An  optional
                 return  variable that  if specified  must  be declared
                 as *CHAR LEN(10).

   WSCSTL        The   Workstation  Customizing  Object  library.    An
                 optional return  variable that  if  specified must  be
                 declared as *CHAR LEN(10).

   MFRTYPMDL     The Manufacturer  Type and Model.   An optional return
                 variable  that if specified must  be declared as *CHAR
                 LEN(20).

   PPRSRC1       The Paper  Source  1.   An  optional  return  variable
                 that if specified  must be declared as  *CHAR LEN(10).

   PPRSRC2       The  Paper  Source  2.   An  optional  return variable
                 that if specified must  be declared as *CHAR  LEN(10).

   ENVELOPE      The  Envelope source.    An optional  return  variable
                 that if  specified must be declared  as *CHAR LEN(10).

   LANATTACH     The  LAN  attachment.    An  optional  return variable
                 that if specified  must be declared as  *CHAR LEN(10).

   USRDFNOBJ     The  User   Defined  Object.     An   optional  return
                 variable  that if specified must  be declared as *CHAR
                 LEN(10).

   USRDFNOBJL    The User Defined Object  library.  An optional  return
                 variable that if  specified must be declared  as *CHAR
                 LEN(10).

   USRDFNOBJT    The  User  Defined Object  type.   An  optional return
                 variable that if specified  must be declared as  *CHAR
                 LEN(10).

   SYSDRVPGM     The  System  Driver  Program.     An  optional  return
                 variable that  if specified must be  declared as *CHAR
                 LEN(15).

   TRANSFORM     The  Host  Printer  Transform  option.    An  optional
                 return variable  that if  specified  must be  declared
                 as *CHAR LEN(4).

   LSTACTDAT     Last  Activity Date An  optional return  variable that
                 if  specified must be  declared as *CHAR  LEN(7).  The
                 format is CYYMMDD.

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

Because the command  returns variables, RTVDEVPRT may  only be used  in
a CL program.

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

None.

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

None, the tool is ready to use.

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

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

   RTVDEVPRT     *CMD                   TAADEVC       QATTCMD
   TAADEVCC      *PGM       CLP         TAADEVCC      QATTCL
					

Added to TAA Productivity tools August 1, 1997


Home Page Up to Top