56.1. OPC resource

The OPC service (Operator's Panel Control) shows the CTI ports' status and the information about the current telephone calls. The OPC allows authorized users to initiate and transfer calls simply using the mouse.

In order to run the OPC, both the HTTP and OPC resources must be active.

[Tip]Tip

Interesting chapter: Chapter 43, HTTP - HyperText Transfer Protocol.

56.1.1. Activating the OPC resource

Add the resource to the Abilis system with the following command:

[16:27:36] ABILIS_CPX:a res:opc

COMMAND EXECUTED

The OPC resource may already exist in the system, but may not yet be active: set it active with the following command.

[16:27:41] ABILIS_CPX:s p opc act:yes

COMMAND EXECUTED

The OPC resource may collect call information from the local as well as from remote Abilis. The operator can view the call status of several sites in the same web page. The parameter abilisid of the OPC resource has the purpose to permit the programmer to choose which is the wished ABILIS target.

[16:38:12] ABILIS_CPX:s p opc abilisid:myabilis

COMMAND EXECUTED

The new abilisid is available at runtime for both local and remote.

[Tip]Tip

Refer to Section 56.1.2, “OPC resource parameters” to have more information about collecting information from a remote Abilis. A how to is available directly at this link.

56.1.2. OPC resource parameters

The following command shows the current values of the OPC parameters (use d p opc ? for a short online help).

[16:48:43] ABILIS_CPX:d p opc

RES:Opc -----------------------------------------------------------------------
Run    DESCR:Operator_Panel_Collector
       LOG:NO          ACT:YES         XML-TOUT:60       XML-MIN-DELAY:200  
       maxusers:200    maxcalls:200    maxclients:20     maxremotes:2      
       ABILISID:local
       - OPC Remote collectors ------------------------------------------------
       REM:0  ABILISID:Test                              ENABLED:NO
              SRCADD:R-ID (192.168.029.254)              TOS:0-N
              SERVER:192.168.020.254
              PROT:PLAIN   PORT:AUTO    RETRY-DELAY:60
              LOGIN:opc2
              PASSWORD:********
              NUM-PREFIX:
       -----------------------------------------------------------------
       REM:1  ABILISID:                                  ENABLED:NO
              SRCADD:R-ID (192.168.029.254)              TOS:0-N
              SERVER:
              PROT:PLAIN   PORT:AUTO    RETRY-DELAY:60
              LOGIN:
              PASSWORD:
              NUM-PREFIX:
       -----------------------------------------------------------------

Meaning of the most important parameters:

DESCR

Resource description. Max 79 chars. Spaces require double quotes (E.g. "str1 str2").

LOG

State changes log and alarm generation [NO, D, S, A, L, T, ALL] [+E] (D: Debug Log; S: System Log; A: Alarm view; L: Local audible alarm; T: SNMP traps; +E: Extended Log of state changes, see ref. manual).

ACT

Operation activation [NO, YES].

XML-TOUT

Maximal timeout for the generation of the XML file containing updates [30..90 sec.].

XML-MIN-DELAY

Minimal delay between submission of a request and its completion [10..1000 ms].

maxusers

Maximum number of users that can be stored into OPC table [1..1000].

maxcalls

Maximum number of calls that can be stored into OPC table [1..1000].

maxclients

Number of monitors that can require information from OPC [1..250].

[Note]Note

An equal of greater number of HTTP sessions must be available.

maxremotes

Maximum number of external remote collector that can be stored locally [0..50].

ABILISID

Abilis ID used when exporting information outside local collector. Max 32 alphanumeric characters ['0'..'9', 'A'..'Z', 'a'..'z'].

REM

Remote collector index [0..(maxremotes - 1)] or A or ALL.

ENABLED

Enable/disable connection to the server [NO, YES].

SRCADD

Source IP address for outgoing connections [R-ID, OUT-IP, 1-126.x.x.x, 127.0.0.1, 128-223.x.x.x].

TOS

TOS or DS field: - p-t: PRECEDENCE-TOS, 'p' [0..7], 't' [N, D, T, R, C] - bbbbbb: DS value bit by bit, 'b' [0, 1].

SERVER

IP address [1-126.x.x.x, 127.0.0.1, 128-223.x.x.x] or FQDN name of max 64 characters in the range ['0'..'9', 'a'..'z', '-', '.' ]. FQDN name is forced to lower case.

PROT

Select the transport type [PLAIN, SSL].

PORT

Port to be used for the selected transport [AUTO, 1..65535], when AUTO port 80 for PLAIN and port 443 for SSL are used.

RETRY-DELAY

Delay between subsequent TCP reconnections [30..3600 sec.]. NOTE: There is no limit to the reconnection attempt.

LOGIN

Login used to authenticate to the remote Abilis. Max 32 ASCII characters. Space not allowed.

PASSWORD

Password used to authenticate to the remote Abilis. Max 32 ASCII printable characters. Space not allowed.

NUM-PREFIX

Number prefix to be added to all numbers assigned to user of remote Abilis which are obtained through the remote collector. Max 6 digits ['0'..'9'].

The syntax for setting the OPC parameters is the usual one: s p opc parameter:value

[Caution]Caution

As usual, changes on parameters whose name is displayed in UPPERCASE can be committed with the command init res:opc, whilst changes on parameters written in LOWERCASE require a new system's startup (save conf and warm start).

[Tip]Tip

Refer to chapter Section 81.13, “How to configure OPC to collect call information from a remote Abilis” to configure OPC to collect call information from a remote Abilis.