RTVLINASC RETRIEVE LINE DESCRIPTION ASYNC TAACFGT |
The Retrieve Line Description ASYNC tool retrieves information about
an ASYNC line. Because many parameters exist, 2 commands are
provided (RTVLINASC and RTVLINASC2). This provides the current
information about the line. The QDCRLIND API is used to retrieve the
data.
A typical command would be:
DCL &LINESPEED *DEC LEN(9 0)
.
RTVLINASC LINE(xxx) LINESPEED(&LINESPEED)
RTVLINASC escape messages you can monitor for
---------------------------------------------
TAA9891 The line is not a ASC type.
Escape messages from based on functions will be re-sent.
RTVLINASC2 escape messages you can monitor for
----------------------------------------------
TAA9891 The line is not a ASC type.
Escape messages from based on functions will be re-sent.
RTVLINASC Command parameters *CMD
----------------------------
LIND The ASYNC line to retrieve information for.
ONLINE Whether the line is varied on at IPL. This is an
optional return variable that if used must be
specified as *CHAR LEN(4).
VARYWAIT Whether the line should be varied on at IPL. A
value of -15 = *NOWAIT. This is an optional return
variable that if used must be specified as *CHAR
LEN(4).
LINESPEED The speed of the line in bits per second. This is
an optional return variable that if used must be
specified as *DEC LEN(9 0).
INACTTMR The time that the system waits for activity on a
line before disconnecting. This is an optional
return variable that if used must be specified as
*DEC LEN(9 0).
MAXBUFFER The maximum size of the incoming and outgoing
buffers. This is an optional return variable that
if used must be specified as *DEC LEN(9 0).
IDLTMR The maximum allowable time between characters before
the adapter forwards the receive buffer to the
system. This is an optional return variable that if
used must be specified as *DEC LEN(9 0).
DSRDRPTMR The length of time that the system should wait for
the modem to drop Data Set Ready after the system
has dropped Data Terminal Ready before signalling an
error. This is an optional return variable that if
used must be specified as *DEC LEN(9 0).
CTSTMR The length of time that the system should wait for
the modem (DCE) to raise or drop Clear to Send (CTS)
before signalling an error. This is an optional
return variable that if used must be specified as
*DEC LEN(9 0).
RMTANSTMR The length of time that the system should wait for
the modem (DCE) to raise Data Set Ready (DSR) after
dialing before signalling an error. This is an
optional return variable that if used must be
specified as *DEC LEN(9 0).
CMNRCYLMTC The number of second-level recovery attempts to be
automatically performed. This is an optional return
variable that if used must be specified as *DEC
LEN(9 0).
CMNRCYLMTI The length of time in minutes in which the specified
number of recoveries can be attempted. This is an
optional return variable that if used must be
specified as *DEC LEN(9 0).
RSRCNAME The unique name that is assigned by the system to
the physical equipment attached to the system. This
is an optional return variable that if used must be
specified as *CHAR LEN(10).
INTERFACE The type of physical communications line interface
that this communications adapter port and cable will
be attached to. This is an optional return variable
that if used must be specified as *CHAR LEN(10).
CNN The type of line connection. This is an optional
return variable that if used must be specified as
*CHAR LEN(10).
SNBU Whether a switched network backup capability exists.
This is an optional return variable that if used
must be specified as *CHAR LEN(10).
ACTSNBU Whether a switched network backup capability is
active. This is an optional return variable that if
used must be specified as *CHAR LEN(10).
AUTOCALL An associated automatic call unit. This is an
optional return variable that if used must be
specified as *CHAR LEN(10).
BITSCHAR The data bits per character. This is an optional
return variable that if used must be specified as
*CHAR LEN(10).
PARITY The type of parity. This is an optional return
variable that if used must be specified as *CHAR
LEN(10).
STOPBITS The number of bits to be added to the end of each
character to keep the local and remote ends of the
line synchronized. This is an optional return
variable that if used must be specified as *CHAR
LEN(10).
DUPLEX Whether the system will leave the request-to-send
(RTS) modem signal on continuously or whether the
RTS will be raised when the system must transmit
data and dropped when it is finished transmitting.
This is an optional return variable that if used
must be specified as *CHAR LEN(10).
ECHO Whether the system is to send back (echo) to the
remote system none of the characters it receives,
all of the characters, but not including the
end-of-record character. This is an optional return
variable that if used must be specified as *CHAR
LEN(10).
MODEM The type of modem diagnostic tests to be used on the
line. This is an optional return variable that if
used must be specified as *CHAR LEN(10).
MODEMRATE Whether the modem is being operated at its full or
at an alternate or half speed. This is an optional
return variable that if used must be specified as
*CHAR LEN(10).
SWTCNN Whether the line can be used for incoming and
outgoing calls, incoming calls only, or outgoing
calls only. This is an optional return variable
that if used must be specified
AUTOANS Whether the modem's automatic answer function should
be used. This is an optional return variable that
if used must be specified as *CHAR LEN(10).
AUTODIAL Whether the modem's automatic call function should
be used to dial the remote system or network to
establish a line connection. This is an optional
return variable that if used must be specified as
*CHAR LEN(10).
DIALCMD The dial command type used to establish a connection
with a remote system. This is an optional return
variable that if used must be specified as *CHAR
LEN(10).
ACRSCRNAME The name that is assigned by the system to a
communications port from which a communications line
is attached to an automatic call unit. This is an
optional return variable that if used must be
specified as *CHAR LEN(10).
NBRCTL The number of attached non-switched controllers.
This is an optional return variable that if used
must be specified as *DEC LEN(5 0).
NONSWTCTL The list of non-switched controllers with each
controller taking 10 bytes. Any excess space will
be set to blanks. This is an optional return
variable that if used must be specified as *CHAR
LEN(3000).
RTVLINASC2 Command parameters *CMD
-----------------------------
LIND The ASYNC line to retrieve information for.
CALLNBR The local connection number of a line. This is an
optional return variable that if used must be
specified as *CHAR LEN(32).
THRESHOLD The level of error threshold that is monitored by
the system. This is an optional return variable
that if used must be specified as *CHAR LEN(10).
FLOWCNTL Whether XON or XOFF flow control characters exist to
control the flow of data to the system. This is an
optional return variable that if used must be
specified as *CHAR LEN(10).
XONCHAR The hexadecimal value used to tell the line to start
sending data. This is an optional return variable
that if used must be specified as *CHAR LEN(10).
XOFFCHAR The hexadecimal value used to tell the line to stop
sending data. This is an optional return variable
that if used must be specified as *CHAR LEN(10).
AUTOANSTYP The method to be used by the system and modem to
answer incoming calls. This is an optional return
variable that if used must be specified as *CHAR
LEN(10).
AUTOCFGS36 Whether the line was automatically configured for
AS/36. This is an optional return variable that if
used must be specified as *CHAR LEN(10).
SETMDMASC The V25BIS command that is used to set the modem to
ASYNC mode. This is an optional return variable
that if used must be specified as *CHAR LEN(40).
MDMINZCMD The command string to send to the modem. This is an
optional return variable that if used must be
specified as *CHAR LEN(60).
CURMSGQ The message queue to which operational messages are
currently being sent. This is an optional return
variable that if used must be specified as *CHAR
LEN(10).
CURMSGQLIB The message queue library to which operational
messages are currently being sent. This is an
optional return variable that if used must be
specified as *CHAR LEN(10).
NBRSWTCTL The number of switched controllers attached. This
is an optional return variable that if used must be
specified as *DEC LEN(5 0).
SWTCTL The list of switched controllers attached. Each
controller is 10 bytes. Any excess bytes are filled
with blanks. This is an optional return variable
that if used must be specified as *CHAR LEN(3000).
NBREORCHR The number of End-of-Record characters. This is an
optional return variable that if used must be
specified as *DEC LEN(5 0).
EORCHR The list of End-of-Record characters. This is an
optional return variable that if used must be
specified as *CHAR LEN(200).
TEXT The text description of the line. This is an
optional return variable that if used must be
specified as *CHAR LEN(50).
Restrictions
------------
Because the commands return variables, RTVLINASC and RTVLINASC2 may
only be used in a CL program.
Prerequisites
-------------
The following TAA Tools must be on your system:
SNDESCINF Send escape information
SNDESCMSG Send escape message
Implementation
--------------
None, the tool is ready to use.
Objects used by the tool
------------------------
Object Type Attribute Src member Src file
------ ---- --------- ---------- ----------
RTVLINASC *CMD TAACFGT QATTCMD
RTVLINASC2 *CMD TAACFGT2 QATTCMD
TAACFGTC *PGM CLP TAACFGTC QATTCL
TAACFGTC2 *PGM CLP TAACFGTC2 QATTCL
Structure
---------
RTVLINASC Cmd
TAACFGTC CL pgm
RTVLINASC2 Cmd
TAACFGTC2 CL pgm
|
Added to TAA Productivity tools September 15, 2007
