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
|
