DIAL_SERVER_REQUEST UTILITY Revision 1.0, 07/16/87.
DIAL_SERVER_REQUEST -- Allows the user to talk with the system dial server.
usage: DIAL_SERVER_REQUEST [-Init port<p> ] [-First_dial <n> (optional)]
[-Close port<p> ]
.. for Function Box .. [-Pfk <box> ] [-First_key <n> (optional)]
...p corresponds to sio port numbers 1, 2, or 3...
...n corresponds to dial number 1 .. 99...
(1 is the default)...
...box = "cadam" or "mcd" - identifies the function box ...
1. Introduction
----------------
The dial server request utility allows the user to send
"commands" to the dial server via a mailbox channel
for configuration of dial boxes and Function Boxes
on a particular sio port.
The dial server must be running for this
command to execute successfully (the dial server can
be started by the DM command: cps /sys/dial_server. )
Thw two supported options shown above gives the user
access to sio port & dial box initialization along
with releasing or closing of the sio port.
The -PFK option is required to initialize function boxes only.
The dial server will send a message back to the dial
server request utility indicating success or failure
of a given request.
2. Examples.
------------
$ dial_server_request -init port1
>>Server Response: ....Request Accepted: Initialize Port 1, First dial = 1....
$ dial_server_request -init port2
>>Server Response: ....Request Accepted: Initialize Port 1, First dial = 1....
$ dial_server_request -init port2 -first_dial 10
>>Server Response: ....Request Accepted: Initialize Port 1, First dial = 10....
$ dial_server_request -init port1 -pfk cadam
>>Server Response: ....Request Accepted: Initialize PFK on Port 1, First KEY = 1....
$ dial_server_request -close port1
>>Server Response: ....Request Accepted: Close Port 1....
3. Potential Error conditions
-----------------------------
>>Server Response: ....Request Failed: Box not connected or dead box....
>>Server Response: ....Request Error: Port not available....
>>Server Response: ....Request Failed: Could not open port....
***Invalid Argument: ..bad argument printed..***
4. Related Information
----------------------
The dial server sends dial events or PFK events to be
processed by the Input DeMultiplexor (IDM) system
event processor where it is serialized with other
system input events and queued. This data is
read from the IDM queue by GPR and is available
to the user through both the GPR and GMR Interfaces.