<?xml version="1.0" encoding="utf-8"?>
<Session ID="/baanerp/tl/bct/tlbct5505m000" xml:lang="en">
	<Header>
		<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">Event Publishing Settings (tlbct5505m000)</Title>
		<Keyword ContextSensitive="No"><Level1>Event</Level1>
		</Keyword>
		<Keyword ContextSensitive="No"><Level1>Event Publishing</Level1>
		</Keyword>
		<Keyword ContextSensitive="No"><Level1>Event</Level1>
			<Level2>publish</Level2>
		</Keyword>
		<Keyword ContextSensitive="No"><Level1>Event Monitoring</Level1>
		</Keyword>
		<Keyword ContextSensitive="No"><Level1>Event</Level1>
			<Level2>monitor</Level2>
		</Keyword>
	</Header>
	<HelpTopic xml:lang="en"><AimSection><Paragraph class="Default">
                                 Use this session to configure the Event Publishing Settings.</Paragraph>
		</AimSection>
		<GeneralSection><Paragraph class="Default">This session can be started from the <Link href="/baanerp/tl/bct/tlbct5530m000" role="session">Events (tlbct5530m000)</Link> session and the <Link href="/baanerp/tl/bct/tlbct5500m000" role="session">Event Subscriptions (tlbct5500m000)</Link> overview session. If the porting set does not support BLOBs, the session cannot be started; therefore, it will also be invisible in the <GUIRef href="/baanerp/tl/bct/tlbct5530m000" role="session">Events (tlbct5530m000)</GUIRef> and <GUIRef href="/baanerp/tl/bct/tlbct5500m000" role="session">Event Subscriptions (tlbct5500m000)</GUIRef> session.</Paragraph>
			<List><ListIntro>For each event status other than ‘To be Published’, you can configure the following:</ListIntro>
				<ListItem>Whether the events must be kept after they reach this state.</ListItem>
				<ListItem>Whether the event message (XML) must be kept (for Error and Published state only).</ListItem>
				<ListItem>How long the messages must be kept.</ListItem>
			</List>
			<Paragraph class="Default">The last two settings can only be configured if the first one is switched on.</Paragraph>
			<Paragraph class="Default">The settings apply to all companies.</Paragraph>
			<Paragraph class="Default">To store the updated settings, you can choose <GUIRef href="" role="manual">OK</GUIRef>; to undo the changes and close the session, choose <GUIRef href="" role="manual">Cancel</GUIRef>. When selecting <GUIRef href="" role="manual">OK</GUIRef>, obsolete events are deleted if according to the new settings less history events must be kept.</Paragraph>
			<Paragraph class="Default">At runtime, deleting the history of a company is only done when at least one publisher is running for that company. The publisher Bshell will delete obsolete history data when starting; while running, it will recheck on an hourly basis. If the delete action fails, an error message is published. Changed settings are automatically picked up by the publisher Bshell at the next delete action; therefore, when changing the settings, you do not have to restart any publishers.</Paragraph>
			<Paragraph class="Default">When deleting the history, the last update time of an event is used because this is the time the event reached its final state, whether Irrelevant, Error, or Published. Therefore, if an event was triggered three hours ago and published one hour ago, it will not yet be deleted if it is configured to be deleted when older than two hours.</Paragraph>
			<Note><SectionTitle>
                                    Warning
                                 </SectionTitle>
				<Paragraph class="Default">Keeping event history increases the database size and will reduce event publishing performance, especially when high volumes of messages occur or the ‘Also Keep Event Message’ is switched on. Additionally, if no publisher is running for a company, no deletion will be carried out. Note that the events are stored per company, so a table instance exists per company.</Paragraph>
			</Note>
		</GeneralSection>
		<RelatedTopics><SectionTitle>
                                 Related topics
                              </SectionTitle>
			<RelTopic><Link href="/baanerp/tl/onlinemanual/event_monitoring" role="manual">Event Monitoring</Link>
			</RelTopic>
			<RelTopic><Link href="/baanerp/tl/bct/tlbct5530m000" role="session">Events (tlbct5530m000)</Link>
			</RelTopic>
		</RelatedTopics>
	</HelpTopic>
	<Fields><Title>Fields</Title>
		<FieldGroup><Title>Irrelevant Events</Title>
			<FieldHelp ID="i.keep.history"><Header>
					<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">Keep History</Title>
				</Header>
				<FuncDesc>
                                    If this check box is selected, events will be kept after they reach the Irrelevant state.</FuncDesc>
			</FieldHelp>
			<FieldHelp ID="i.delete.if.older"><Header>
					<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">Delete if older than</Title>
				</Header>
				<FuncDesc>The number of hours after which the events will be deleted.</FuncDesc>
			</FieldHelp>
		</FieldGroup>
		<FieldGroup><Title>Error Events</Title>
			<FieldHelp ID="e.keep.history"><Header>
					<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">Keep History</Title>
				</Header>
				<FuncDesc>
                                    If this check box is selected, events will be kept after they reach the Error state.</FuncDesc>
			</FieldHelp>
			<FieldHelp ID="e.also.keep.event"><Header>
					<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">Also Keep Event Message</Title>
				</Header>
				<FuncDesc>
                                    If this check box is selected, the event messages (XML) will also be kept.</FuncDesc>
			</FieldHelp>
			<FieldHelp ID="e.delete.if.older"><Header>
					<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">Delete if older than</Title>
				</Header>
				<FuncDesc>The number of hours after which the events and messages will be deleted.</FuncDesc>
			</FieldHelp>
		</FieldGroup>
		<FieldGroup><Title>Published Events</Title>
			<FieldHelp ID="p.keep.history"><Header>
					<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">Keep History</Title>
				</Header>
				<FuncDesc>
                                    If this check box is selected, events will be kept after they reach the Published state.</FuncDesc>
			</FieldHelp>
			<FieldHelp ID="p.also.keep.event"><Header>
					<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">Also Keep Event Message</Title>
				</Header>
				<FuncDesc>
                                    If this check box is selected, the event messages (XML) will also be kept.</FuncDesc>
			</FieldHelp>
			<FieldHelp ID="p.delete.if.older"><Header>
					<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">Delete if older than</Title>
				</Header>
				<FuncDesc>The number of hours after which the events and messages will be deleted.</FuncDesc>
			</FieldHelp>
		</FieldGroup>
		<FieldGroup><Title>Too Large Events</Title>
			<FieldHelp ID="t.keep.history"><Header>
					<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">Keep History</Title>
				</Header>
				<FuncDesc>
                                    If this check box is selected, events with status "Too Large" will be kept for some time.</FuncDesc>
				<SimpleSection><Paragraph class="Default">An event gets status "Too Large" if the message size exceeds the maximum specified in the <GUIRef href="/baanerp/tl/bct/tlbct5505m000#max.mess.size" role="field">Maximum Message Size</GUIRef> field. The event is skipped and an error message is published.</Paragraph>
					<Paragraph class="Default">You can check the business ID for a skipped event in the <Link href="/baanerp/tl/bct/tlbct5530m000" role="session">Events (tlbct5530m000)</Link> session.</Paragraph>
				</SimpleSection>
			</FieldHelp>
			<FieldHelp ID="t.also.keep.event"><Header>
					<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">Also Keep Event Message</Title>
				</Header>
				<FuncDesc>
                                    If this check box is selected, the event messages (XML) will also be kept.</FuncDesc>
			</FieldHelp>
			<FieldHelp ID="t.delete.if.older"><Header>
					<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">Delete if older than</Title>
				</Header>
				<FuncDesc>The number of hours after which the events and messages will be deleted.</FuncDesc>
			</FieldHelp>
		</FieldGroup>
		<FieldHelp ID="max.mess.size.set"><Header>
				<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">Restrict Message Size</Title>
			</Header>
			<FuncDesc>
                                 If this check box is selected, you can define a maximum size for messages in the <GUIRef href="/baanerp/tl/bct/tlbct5505m000#max.mess.size" role="field">Maximum Message Size</GUIRef> field. If the size of a message exceeds the maximum, the corresponding event gets status "Too Large". The event is skipped and an error message is published.</FuncDesc>
			<SimpleSection><Paragraph class="Default">Restrict the message size if the event publishing configuration allows, accidentally, publishing of very large event messages. In this way you can avoid publisher interruption.</Paragraph>
				<List><ListIntro>
                                       If this check box is cleared, ERP LN does not check the message size. If a message is too big to be handled by the porting set or Infor Integration 6.2, one of the following happens:</ListIntro>
					<ListItem>The publisher stops.</ListItem>
					<ListItem>The publisher is interrupted.</ListItem>
					<ListItem>The publisher reports a Java out of memory error.</ListItem>
				</List>
			</SimpleSection>
		</FieldHelp>
		<FieldHelp ID="max.mess.size"><Header>
				<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">Maximum Message Size</Title>
			</Header>
			<FuncDesc>The maximum number of megabytes for an event message. This setting is valid for all companies and all business objects.</FuncDesc>
			<SimpleSection><List><ListIntro>At runtime, when an event is published from ERP LN, the message size is compared to the maximum size. If the size exceeds the maximum, the event gets status "Too Large". As a result, the following happens:</ListIntro>
					<ListItem>The event is not published. The publisher continues processing the next event.</ListItem>
					<ListItem>An error message is published. This error message does not contain the complete message, but it includes a reference to the event.</ListItem>
					<ListItem>The message status cannot be restored to "To be Published".</ListItem>
				</List>
				<Paragraph class="Default">If the <GUIRef href="/baanerp/tl/bct/tlbct5505m000#max.mess.size" role="field">Maximum Message Size</GUIRef> is not filled, no check on the event message size is done.</Paragraph>
				<Paragraph class="Default"></Paragraph>
			</SimpleSection>
			<Important><SectionTitle>
                                    Important!
                                 </SectionTitle>
				<List><ListItem>The optimal <GUIRef href="/baanerp/tl/bct/tlbct5505m000#max.mess.size" role="field">Maximum Message Size</GUIRef> depends on the involved systems and network and their configuration. Therefore Infor cannot give a "universal" default size limit. As a rule of thumb, assume messages up to 20 Mb can be handled if sufficient memory is available.</ListItem>
					<ListItem>When you define a maximum message size, Infor recommends to switch on the "Keep History" for too large messages. This way you can check the business IDs for skipped events in the <Link href="/baanerp/tl/bct/tlbct5530m000" role="session">Events (tlbct5530m000)</Link> session.</ListItem>
					<ListItem><Paragraph class="Default">To activate the changes after you change the Maximum Message Size, you must restart the publisher process. To do this, complete the following steps:</Paragraph>
						<ProcedureList><ListItem>Start the <GUIRef href="/baanerp/tl/bct/tlbct5500m000" role="session">Event Subscriptions (tlbct5500m000)</GUIRef> session.</ListItem>
							<ListItem>On the <GUIRef href="" role="menu">Specific</GUIRef> menu, click <GUIRef href="/baanerp/tl/bct/tlbct5500m000#tlbct5210m000" role="command">Start/Stop Publishing</GUIRef>. The <GUIRef href="/baanerp/tl/bct/tlbct5210m000" role="session">Start/Stop Publishing (tlbct5210m000)</GUIRef> session starts.</ListItem>
							<ListItem>Stop the existing publishers.</ListItem>
							<ListItem>Restart the existing publishers.</ListItem>
						</ProcedureList>
						<Paragraph class="Default">For details, refer to the session help.</Paragraph>
					</ListItem>
				</List>
			</Important>
		</FieldHelp>
	</Fields>
</Session>
