<?xml version="1.0" encoding="utf-8"?>
<Session ID="/baanerp/tt/aad/ttaad4153m000" xml:lang="en">
	<Header>
		<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">Logging Parameters (ttaad4153m000)</Title>
	</Header>
	<HelpTopic xml:lang="en"><AimSection><Paragraph class="Default">
                                 Use this session to define the parameters for the logging of database locking and shared memory usage.</Paragraph>
		</AimSection>
		<Note><SectionTitle>
                                 Note
                              </SectionTitle>
			<Paragraph class="Default">You can only change parameters when you are logged on to the Master Application Server (MAS). The MAS is registered in the <GUIRef href="/baanerp/tt/aad/ttaad0550m000" role="session">Systems (ttaad0550m000)</GUIRef> session.</Paragraph>
		</Note>
		<GeneralSection><Paragraph class="Default">For shared memory logging, you can define a time frame in which the logging of object usage in the bshell takes place. For database locking, you can specify a threshold and a time frame.</Paragraph>
			<Paragraph class="Default">After you specified the logging parameters, click <GUIRef href="/baanerp/tt/aad/ttaad4153m000#exec.cont.process" role="command">Convert</GUIRef>. You can only run the <GUIRef href="/baanerp/tt/aad/ttaad4153m000#exec.cont.process" role="command">Convert</GUIRef> command on a Master Application Server.</Paragraph>
			<Paragraph class="Default">For details, refer to the field and form command help.</Paragraph>
		</GeneralSection>
		<RelatedTopics><SectionTitle>
                                 Related topics
                              </SectionTitle>
			<RelTopic><Link href="/baanerp/tt/stp/ttstplocklog" role="session">Generate lock graph html output (ttstplocklog)</Link>
			</RelTopic>
			<RelTopic><Link href="/baanerp/tt/aad/ttaad4152m000" role="session">Shared Memory Object Measurement (ttaad4152m000)</Link>
			</RelTopic>
			<RelTopic><Link href="/baanerp/tt/aad/ttaad4452m000" role="session">Print Shared Memory Object Measurement (ttaad4452m000)</Link>
			</RelTopic>
			<RelTopic><Link href="/baanerp/tt/aad/ttaad4156m000" role="session">Shared Memory Data (ttaad4156m000)</Link>
			</RelTopic>
			<RelTopic><Link href="/baanerp/tt/aad/ttaad4456m000" role="session">Print Shared Memory Data (ttaad4456m000)</Link>
			</RelTopic>
			<RelTopic><Link href="/baanerp/tt/aad/ttaad4155m000" role="session">Allocated Memory Shared Memory (ttaad4155m000)</Link>
			</RelTopic>
		</RelatedTopics>
	</HelpTopic>
	<Fields><FieldGroup><Title>Locking</Title>
			<FieldHelp ID="lck.threshold"><Header>
					<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">Threshold [ms]</Title>
				</Header>
				<FuncDesc>The threshold, in milliseconds, for logging database lock actions.</FuncDesc>
				<SimpleSection><Paragraph class="Default">Lock actions that last shorter than the specified threshold, are not written to the log file.</Paragraph>
					<Paragraph class="Default">Example: <Code>10</Code>. Only lock actions that last 10 milliseconds or longer are written to the log file.</Paragraph>
				</SimpleSection>
			</FieldHelp>
			<FieldHelp ID="lck.logfile"><Header>
					<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">File Name</Title>
				</Header>
				<FuncDesc>The path and name of the log file where the locking statistics will be stored.</FuncDesc>
				<SimpleSection><Paragraph class="Default">For example: <Code>${BSE_TMP}/log_locking.$$</Code>.</Paragraph>
					<Paragraph class="Default">At runtime the <Code>$$</Code> extension is replaced by a number. For example: the logging process generates the following file: <Code>log_locking.1048612</Code>.</Paragraph>
				</SimpleSection>
			</FieldHelp>
			<FieldHelp ID="lck.stime"><Header>
					<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">From</Title>
				</Header>
				<FuncDesc>Use this field to define the time frame in which the logging of database locking takes place.</FuncDesc>
				<SimpleSection><Paragraph class="Default">If you do not define a time frame, no logging is done.</Paragraph>
				</SimpleSection>
			</FieldHelp>
			<FieldHelp ID="lck.etime"><Header>
					<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">To</Title>
				</Header>
				<FuncDesc>Use this field to define the time frame in which the logging of database locking takes place.</FuncDesc>
				<SimpleSection><Paragraph class="Default">If you do not define a time frame, no logging is done.</Paragraph>
				</SimpleSection>
			</FieldHelp>
		</FieldGroup>
		<FieldGroup><Title>Shared Memory</Title>
			<FieldHelp ID="shm.stime"><Header>
					<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">From</Title>
				</Header>
				<FuncDesc>Use this field to define the time frame in which the shared memory logging takes place.</FuncDesc>
				<SimpleSection><Paragraph class="Default">If you do not define a time frame, no logging is done.</Paragraph>
				</SimpleSection>
			</FieldHelp>
			<FieldHelp ID="shm.etime"><Header>
					<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">To</Title>
				</Header>
				<FuncDesc>Use this field to define the time frame in which the shared memory logging takes place.</FuncDesc>
				<SimpleSection><Paragraph class="Default">If you do not define a time frame, no logging is done.</Paragraph>
				</SimpleSection>
			</FieldHelp>
		</FieldGroup>
	</Fields>
	<FormCommands><CommandHelp ID="exec.cont.process"><Header>
				<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">Convert</Title>
			</Header>
			<FuncDesc>Stores the entered data in the <Code>$BSE/lib/defaults/logging</Code> file. The date / time ranges are stored in UTC format.</FuncDesc>
			<SimpleSection><Paragraph class="Default">The following lines show an example of the content of the <Code>logging</Code> file:</Paragraph>
				<CodeBlock space-and-orientation="indented-estimated">log_locking_threshold:0
log_locking_logfile:${BSE_TMP}/log_locking.$$
log_locking_start:1194220740
log_locking_end:1194343140
log_shm_start:1200956400
log_shm_end:1201006920</CodeBlock>
				<Paragraph class="Default">You can only run the <GUIRef href="/baanerp/tt/aad/ttaad4153m000#exec.cont.process" role="command">Convert</GUIRef> command on a host defined as Master Application Server (MAS). If the host is not a MAS, all selection fields and the <GUIRef href="/baanerp/tt/aad/ttaad4153m000#exec.cont.process" role="command">Convert</GUIRef> command are disabled.</Paragraph>
			</SimpleSection>
		</CommandHelp>
		<CommandHelp ID="cleanup"><Header>
				<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">Cleanup</Title>
			</Header>
			<FuncDesc>Removes the currently stored shared memory measurement data.</FuncDesc>
		</CommandHelp>
	</FormCommands>
</Session>
