msiconf()

Name

msiconf is the configuration file for the HPOM for Windows message manager

Contents

• Synopsis
• Description
• example

Synopsis

Server MSI

<SERVER_COFIG_DIR>/msiconf
For example:
/etc/opt/OV/share/conf/OpC/mgmt_sv/msiconf

Agent MSI

<AGENT_CONFIG_DIR>/msiconf
For example:
/var/opt/OV/conf/OpC/msiconf on HP-UX

Description

The file msiconf is an ASCII file containing a list of entries consisting of an HPOM Message Stream Interface (MSI) instance name followed by an order number. Each field is separated by a space, several spaces, or a tab. Each entry is separated from the next by a newline.

The MSI instance name may be a string up to 13 alphanumeric characters. The order number may be an integer value between -127 and 127. Lines or portions of lines beginning with # are assumed to be comments and are ignored. Blank lines are also ignored.

The MSI instance name corresponds to the name of a server MSI application that registers with the HPOM message manager. The order number specifies the order in which the registered MSI application will receive a message from the message manager (lowest to highest). Registered MSI applications that are not listed in the msiconf file are given an order number of 0.

The msiconf file is read by the message manager or message agent whenever an MSI instance opens or closes a connection to the MSI.

Example

counter -10
opcecm 0
proca 10
proca 10
enhtt 20

It is possible for a registered MSI instance to alter or completely suppress a message before writing back to the message stream. The proca and procb entries in the above example demonstrate a parallel MSI configuration, where one message entering the message stream may result in two messages exiting the message stream.

Related Topics:

• opcif_open(3)
• opcif_close(3)
• opcif_read(3)
• opcif_register(3)
• opcif_write(3)
• opcregcond(3)
• opc(5)