File Listener form
Completing the Properties tab

Field

Description

Select to control how listeners start: 5.5 GRP-308

• Run on all nodes — The listener is run on all nodes — all servers in a cluster.
• Node based startup — The listener is started only on specified nodes.
• Host based startup — The listener is started on a specified number of nodes on specific servers within the cluster.

Appears when the Node based startup option is selected. In a multinode PRPC cluster, using the SmartPrompt, enter the node ID of the server host node or nodes where this listener is to run. When a PRPC server starts it activates the listener on the current node if the current node matches any node in the list (and if other requirements are met).

• If a node is specified, the current node must match a name in the list for PRPC to activate the listener.
• If a node is not specified, PRPC does not activate the listener on any node.

When multiple file listeners tend the same directory, the order in which messages are processed may not be the order in which they were put into the directory. If your application relies on processing files in the order in which they are sent to the email inbox, use a single listener on one node.

See More about File Listeners. C-759

Appears when the Host based startup option is selected. Enter a number of nodes on which the listener is to start.

Deletes all the instances from the class Log-Connect-AssignedNodes, so that listeners can be started.

Field

Description

Identify a directory in which the listener looks for input files. Listener requests require read and write access to this directory.

This field supports the Global Resource Settings syntax (=.PageName.PropertyName). The default property name for this field is pySourceLocation. For more information, see Using the Global Resource Settings feature.

B-7668Enter a mask used to select the files in the Source Location directory to be processed.

You can use an asterisk as a wildcard match. For example, BA*.TXT causes the system to find all files with type of TXT that start with the two letters BA. Case is significant in matching files on UNIX systems.

B-3423 You can include one asterisk character "*" as a wildcard in the root of the mask (before the period) and one asterisk character "*" as a wildcard in the file type. Don't use more than one asterisk in each part.

If you leave this blank or use a mask of *.*, the listener selects every file in the directory identified in the Source Location field (skipping over any files that are themselves directories). B-2777

R-10352 Enter 1 or a small positive integer to determine the number of threads per server node this listener requestor creates when it starts. C-759 B-18880 SR-2745 B-18979 SR-7395 B-21479 Each thread operates on a single file; multithreading has no benefit unless multiple files are available at the same time for processing.

If the node on which this listener runs has available JVM memory and CPU cycles, and multiple files are available for processing, use of two to five threads can increase throughput. B-10407

Each listener links to a single Rule-Service-File rule. Select the first key part of a Service File rule instance. B-5273

Select the second key part of the Service File rule. B-5273

Select the third key part of the Service File rule. C-759

C-605 R-7937 Optional. Click this button at any time after you have completed this tab and saved the form to confirm that PRPC can find the directory identified.

C-1704The system attempts to create the listener thread (on the current node) and access the device and directory. presents test results in a separate window, identifying the parameters used in the test, the steps attempted, and the outcome of each step.

(If the Blocked checkbox is selected when you click this button, testing ends with a Failed message.) SOLOM B-17285 1/26/05

Field

Description

These two fields are used as user name and password if the Service File rule requires requestors to be authenticated.

Optional. Select the Operator ID that this listener uses to log in to PRPC. The Operator ID determines the access group (and so the RuleSet list) of the listener.

Optional. Enter a password for this Operator ID.

Field

Description

The Remote Logging feature streams the contents of the PRPC log file to the LogFactor5 application installed on your workstation. When you add your workstation as an active logger through the Logging and Tracing > Remote Logging menu item in the System Management application, your workstation receives all messages for all processes running on the server. To view only those log messages that are about the service rule this listener listens for, complete the fields in this section. Remember to start the LogFactor5 window on your workstation before using this form to identify your workstation as a logger.

C-606 Optional. Enter the network name of your computer. See How to install and use remote logging.

Optional. Enter the TCP/IP port number that the log4j package on your computer listens on. By default this port is 8887.

C-407 LACOD 6/18/03 Select to prevent this listener from being started by any means. If cleared, this listener starts with system startup, or can be started using the System Management application. 04-02 HITZM See More about File Listeners.