TAA Tools
RTVDDMA         RETRIEVE DDM ATTRIBUTES                TAADDMB

The Retrieve DDM Attributes  command retrieves the attributes of  a DDM
file.   This includes such  attributes as the Remote  File name, Remote
location  name, and Remote network identifier.   Only a file created by
CRTDDMF may be used.

A typical series of commands would be:

             DCL           &RMTFILE *CHAR LEN(10)
              .
             RTVDDMA       FILE(xxx) RMTFILE(&RMTFILE)

ACCMTH return fields
--------------------

The ACCMTHCDE  field returns the  2 byte  hex value as  defined by  the
DDM  architecture.   The  corresponding ACCMTHTXT  field  returns a  30
byte description as follows:

          X'0000'    *RMTFILE
          X'1405'    *COMBINED
          X'1406'    *KEYED *BOTH
          X'1407'    *ARRIVAL *BOTH
          X'1432'    *KEYED *SEQUENTIAL
          X'1433'    *ARRIVAL *SEQUENTIAL
          X'1434'    *KEYED *RANDOM
          X'1435'    *ARRIVAL *RANDOM

RTVDDMA escape messages you can monitor for
-------------------------------------------

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

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

   FILE          The  qualified name  of the  DDM file to  be retrieved
                 from.  The library value  defaults to *LIBL.   *CURLIB
                 may also be used.

   RTNLIB        The library  where the DDM file  exists.  This  may be
                 helpful  if *LIBL is specified  for the qualified name
                 of the file.   This  is an  optional return  parameter
                 that if used must be specified as *CHAR LEN(10).

   RMTFNAMLEN    The  length of  the  remote file  name.   This  is  an
                 optional  return  parameter   that  if  used  must  be
                 specified as *DEC LEN(3 0).

   RMTFILE       The  remote  file name.   This  is an  optional return
                 parameter that  if  used must  be  specified as  *CHAR
                 LEN(255).

   RMTLOCNAME    The  remote  location  name.    This  is  an  optional
                 return  parameter that  if used  must be  specified as
                 *CHAR LEN(254).

   RMTLOCTYP     The remote location type.   A value such as *SNA  will
                 be returned.   This  is an  optional return  parameter
                 that if used must be specified as *CHAR LEN(4).

   TEXT          The  text  description  of  the  file.    This  is  an
                 optional  return  parameter  that  if  used  must   be
                 specified as *CHAR LEN(50).

   DEV           The APPC  device description.   A  value such as  *LOC
                 may  be   returned.    This  is   an  optional  return
                 parameter  that  if used  must  be specified  as *CHAR
                 LEN(10).

   LCLLOCNAME    The local  location name.   A value  such as *LOC  may
                 be  returned.   This is  an optional  return parameter
                 that if used must be specified as *CHAR LEN(8).

   MODE          The  mode.  A  value such as *NETATR  may be returned.
                 This is  an  optional return  parameter that  if  used
                 must be specified as *CHAR LEN(8).

   RMTNETID      The remote network  identifier.  A value  such as *LOC
                 may   be  returned.    This   is  an  optional  return
                 parameter that  if used  must  be specified  as  *CHAR
                 LEN(8).

   ACCMTHCDE     The access  method  code.   The codes  are hex  values
                 that  are described  by the  ACCMTHTXT  field.   For a
                 list  of the valid  hex values and  their meaning, see
                 the  previous  section  on  'ACCMTH   return  fields'.
                 This  is an  optional  return parameter  that if  used
                 must be specified as *CHAR LEN(2).

   ACCMTHTXT     The  access  method  text.   The  text  description of
                 what the code in ACCMTHCDE  means.  For a list of  the
                 valid hex values  and their meaning, see  the previous
                 section  on  'ACCMTH  return  fields'.    This  is  an
                 optional  return  parameter  that  if  used  must   be
                 specified as *CHAR LEN(30).

   SHARE         The share  attribute.  *YES  or *NO will  be returned.
                 This  is an  optional  return parameter  that  if used
                 must be specified as *CHAR LEN(4).

   PTCCNV        The  protected  conversation attribute.   *YES  or *NO
                 will  be  returned.    This  is  an   optional  return
                 parameter  that if  used  must be  specified as  *CHAR
                 LEN(4).

   PORT          The  TCP/IP  port to  be used.    This is  an optional
                 return parameter  that if  used must  be specified  as
                 *CHAR LEN(5).

   LVLCHK        The  record format  level  check attribute.   *YES  or
                 *NO  will be  returned.   This  is an  optional return
                 parameter that  if used  must  be specified  as  *CHAR
                 LEN(4).

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

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

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

The following TAA Tools must be on your system:

     CHKOBJ3         Check object 3
     RSNLSTMSG       Resend last message
     SNDESCINF       Send escape information

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

None, the tool is ready to use.

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

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

   RTVDDMA       *CMD                   TAADDMB       QATTCMD
   TAADDMBC      *PGM       CLP         TAADDMBC      QATTCL
					

Added to TAA Productivity tools March 26, 2007


Home Page Up to Top