Chapter 5: Configuring and Using Alerts

Sample nnsyreg_file.dat using a file driver

The Open Transport file driver uses files that act in the same manner as queues. To configure this transport driver, you name the files .ALERTS_PENDING, .ALERTS_HISTORY, and .ALERTS_ERROR in the OT configuration file and the file driver automatically creates the files as needed in the working directory.

Additionally, files of the same name but with a .ctl suffix are created in the working directory. The .ctl files are control files that store the current read and write positions for the data files.

Do not edit any of the files created by the Open Transport File driver. Only delete the files in pairs when no application is using them. If needed, the NNGetmsg utility can be used to drain messages from the data files.

See the section “Wrapper scripts” in Chapter 1, “e-Biz Impact Command Utilities,” of e-Biz Impact Command Line Tools Guide, and the New Era of Networks Adapter for SAP R/3 3.9 User’s Guide for more information about using the NN-related commands.

You must specify the full path for all files referenced by the file driver. This ensures that all alerts are generated into the proper alert file.

# File:    nnsyreg_file.dat

# Purpose: Sample Open Transport (OT) config for

# OT file driver

# Usage indicated above each stanza.

# Copy/append to nnsyreg.dat in working dir or

# dir specified by NNSY_ROOT environment variable

# Context for transports

OTContext.OTI_Context

     NNOT_CTX_EMULATE_TM = TRUE

     NNOT_CTX_ENFORCE_TX = FALSE

     NNOT_CTX_DEFAULT_TIL_ID = DefaultTransport

# Identifies a pseudo "queue manager"

Session.OTI_Queuing

     NNOT_SHARED_LIBRARY = dbt26file

     NNOT_FACTORY_FUNCTION = NNSesFileFactory

# Default tranport information

Transport.DefaultTransport

     NNOT_FACTORY_FUNCTION = NNMQQueueFileFactory

     NNOT_SHARED_LIBRARY = dbt26file

     NNOT_TIL_OPEN_SESSION_ID = OTI_Queuing

# The alert message input transport

# File driver will create/use files .ALERTS_PENDING

# and .ALERTS_PENDING.ctl in working dir. Transport.AlertsIn

     NNOT_FACTORY_FUNCTION = NNMQQueueFileFactory

     NNOT_SHARED_LIBRARY = dbt26file

     NNOT_TIL_OPEN_SESSION_ID = OTI_Queuing

     NNOT_TIL_OPEN_TSI = .ALERTS_PENDING

# The optional alert message history log.

# File driver will create/use files ..ALERTS_HISTORY and

# .ALERTS_HISTORY.ctl in working dir.

Transport.AlertLog
	NNOT_FACTORY_FUNCTION = NNMQQueueFileFactory

	NNOT_SHARED_LIBRARY = dbt26file

	NNOT_TIL_OPEN_SESSION_ID	= OTI_Queuing

	NNOT_TIL_OPEN_TSI		= .ALERTS_HISTORY

# The place where malformed alert messages are sent

# File driver will create/use files .ALERTS_ERROR and

# .ALERTS_ERROR.ctl in working dir.

Transport.AlertError

     NNOT_FACTORY_FUNCTION = NNMQQueueFileFactory

     NNOT_SHARED_LIBRARY = dbt26file

     NNOT_TIL_OPEN_SESSION_ID = OTI_Queuing

     NNOT_TIL_OPEN_TSI = .ALERTS_ERROR

View this book as PDF