The sproxyadm command is used to administer proxy speech resources.
Synopsis
/vs/bin/sproxyadm -r
resource_type
-c
state
-f
state
-s
name
-p
port
-d -D
debug_level
-T
seconds
v
Description
The sproxyadm command is used to change the state of a given proxy speech resource or a set of resources of a given resource type. It maybe used also to display information about the state of resource(s).
Options are described in the following table:
Option |
Description |
Comments |
-r resource_type |
The type of speech resource being used |
Normally required. Resource types include:
|
-c state |
Used to "change" the state of an entire Speech Proxy resource or a Server or a single port |
Optional. The state can be:
|
-f state |
Forces the change |
Valid states are INSERV or MANOOS. |
-d |
Displays a proxy resource |
Optional |
-D debug level |
Sets the debug level flags that affects trace and log output |
Optional |
-p port |
Sets a port number to be operated on |
Only this port is affected. Note that this option requires both the -r and -s options to specify the proxy resource server being operated on. [default = all ports] |
-s name |
The name assigned to a speech proxy server |
Optional. The -r option is required to indicate which resource the server is associated with. [default = all servers] For IBM WVS servers, the name must be specified as <name |
-T seconds |
The number of seconds allowed for the Proxy Process to respond to the request |
Optional. [default = 20 seconds] |
-v |
Verbose mode |
Optional. [default = off] |
The report fields displayed in the -d option are described in the following table:
Field |
Description |
Comments |
RESOURCE |
Name of the resource |
Normally matches what is specified with the -r command line option |
PORTS AVAILABLE |
Number of ports (connections) that the proxy server supports |
|
PORT |
One of a list of available ports that information is displayed for |
|
STATE |
The state of a proxy speech resource |
May apply to the entire resource type, a server, or a single port. The state can be:
|
SERVER |
The DNS name administered to the Speech Proxy Server |
|
IP ADDRESS |
The IP address administered to the Speech Proxy Server |
|
STATUS |
The state of the server (see STATE above) |
|
CHAN |
The channel number being used for the connection. |
If a channel is not attached to the port, this field displays N/A. This field is not displayed for systems with MRCP speech servers. |
REMOTE |
The socket number of the speech server that is receiving data from the system |
This field is not displayed for systems with MRCP speech servers. |
PROCESSING |
Indicates what type of processing is being performed by the speech resource |
May be either the language or voice tag in the case of text to speech, or the grammar for speech recognition resources. This field is not displayed for systems with MRCP speech servers. |
Examples
Displaying speech recognition proxy speech resource types
The following example displays all speech recognition proxy speech resource types.
sproxyadm r SR -d
This results in the following output:
RESOURCE: SR PORTS AVAILABLE: 3
SERVER: server1 IP: 35.7.50.74 STATUS: INSERV
--------------------------------------------------------------------------
PORT STATE CHAN REMOTE PROCESSING
-------------------------------------------------------------------------
1 INSERV 21 7877 OPSR4
2 MANOOS 7877
3 INSERV 45 7877 FRUIT
When the MRCP feature has been instaled, the command displays output similar to the following:
RESOURCE: OPSR4 SUMMARY PORTS AVAILABLE: 3
SERVER: server1 IP: 35.7.50.74
PORT CAPACITY: 3 PORTS AVAILABLE: 3
--------------------------------------------------------------------------
PORT STATE CHAN
--------------------------------------------------------------------------
0 INSERV N/A
1 INSERV N/A
2 INSERV N/A
Placing resources in a MANOOS state
This command places all servers of the specified resource type into MANOOS ("MANual Out of Service") state:
sproxyadm -r OPSR4 c manoos
This command puts all ports on a speech server supporting the specified resource type into MANOOS state.
sproxyadm -r OPSR4 s recog1 c manoos
This command places port 1 on the server of the specified resource type into MANOOS state:
sproxyadm -r OPSR4 s recserve1 p1 c manoos
Placing resources in an INSERV state
This command places all servers of the specified resource type into INSERV ("In Service") state:
sproxyadm -r OPSR4 c inserv
This command puts all ports on a speech server supporting the specified resource type into INSERV state:
sproxyadm -r OPSR4 s recog2 c inserv
This command places port 24 on the server of the specified resource type into INSERV state:
sproxyadm -r OPSR4 s recog2 -p24 c inserv
See also