<?xml version="1.0" encoding="utf-8"?>
<ManualTopic ID="/baanerp/tt/onlinemanual/shm_shared_memory" xml:lang="en">
	<Header>
		<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">Shared Memory</Title>
		<Keyword ContextSensitive="No"><Level1>Shared Memory</Level1>
			<Level2>fill</Level2>
		</Keyword>
		<Keyword ContextSensitive="No"><Level1>Shared Memory</Level1>
			<Level2>configure</Level2>
		</Keyword>
	</Header>
	<GeneralSection><Paragraph class="Default">The shared memory is a part of physical memory intended for common use. Programs communicate with each other through shared memory. Shared memory results in faster access to the components loaded in shared memory. Before starting the application, shared memory must be initialized and setup. A prerequisite for using shared memory is that it should be supported by the hardware and have sufficient internal memory at its disposal.</Paragraph>
		<Paragraph class="Default">To enhance the performance of your ERP LN system, you can load program objects and report objects into the shared memory.</Paragraph>
	</GeneralSection>
	<ProcedureSection><SectionTitle>To load objects into the shared memory</SectionTitle>
		<ProcIntro><Paragraph class="Default">After the installation of ERP LN, various objects are already loaded in the shared memory.</Paragraph>
			<Paragraph class="Default">This section describes the procedure to load additional objects into the shared memory.</Paragraph>
			<Paragraph class="Default">
                                 ERP LN uses a lot of DLLs; therefore, it is difficult to decide which objects should be loaded into the shared memory. Before you fill the shared memory, you can use measurement tools to identify which objects are frequently used and suitable to load into the shared memory.</Paragraph>
			<Paragraph class="Default">A shared memory configured based on the measurement information improves the processing speed of your ERP LN application.</Paragraph>
		</ProcIntro>
		<Steps><StepsIntro>To load objects into the shared memory, complete the following steps:</StepsIntro>
			<Step><StepTitle>Activate logging</StepTitle>
				<Paragraph class="Default">To gather statistics on the usage of objects, start the <Link href="/baanerp/tt/aad/ttaad4153m000" role="session">Logging Parameters (ttaad4153m000)</Link> session.</Paragraph>
				<Paragraph class="Default">Optionally, click <GUIRef href="/baanerp/tt/aad/ttaad4153m000#cleanup" role="command">Cleanup</GUIRef> to remove the currently stored shared memory measurement data.</Paragraph>
				<Paragraph class="Default">Specify the time frame in which shared memory logging must take place. If you do not define a time frame, no logging will be done.</Paragraph>
				<Paragraph class="Default">After you specify 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">The measurement will start for all bshells started after the conversion is run, taking the defined time frame into account. The logged information of a bshell is stored when the bshell is closed.</Paragraph>
				<Paragraph class="Default">For details, refer to the session help.</Paragraph>
			</Step>
			<Step><StepTitle>View object usage statistics</StepTitle>
				<Paragraph class="Default">After the period of shared memory measurement has ended, start the <Link href="/baanerp/tt/aad/ttaad4152m000" role="session">Shared Memory Object Measurement (ttaad4152m000)</Link> session.</Paragraph>
				<Paragraph class="Default">
                                    Use this session to view statistics on the object usage in the bshell. The session displays, among other things, the number of times an object was loaded during the measurement period. This information helps identify which objects are frequently used and should be loaded into the shared memory.</Paragraph>
				<Paragraph class="Default">Optionally, click <GUIRef href="" role="manual">Print</GUIRef> to print a Shared Memory Object Measurement report.</Paragraph>
				<Paragraph class="Default">Optionally, on the <GUIRef href="" role="menu">Specific</GUIRef> menu, click <GUIRef href="/baanerp/tt/aad/ttaad4152m000#cleanup" role="command">Cleanup</GUIRef> to remove the shared memory measurement data.</Paragraph>
				<Paragraph class="Default">For details, refer to the session help.</Paragraph>
			</Step>
			<Step><StepTitle>Optional: Allocate shared memory for package combinations</StepTitle>
				<Paragraph class="Default">Start the <Link href="/baanerp/tt/aad/ttaad4156m000" role="session">Shared Memory Data (ttaad4156m000)</Link> session and click <GUIRef href="/baanerp/tt/aad/ttaad4156m000#goto.allocate" role="command">Allocate</GUIRef>. The <Link href="/baanerp/tt/aad/ttaad4155m000" role="session">Allocated Memory Shared Memory (ttaad4155m000)</Link> session starts. Specify, per package combination, the amount of memory (in MB) allocated for object usage in shared memory.</Paragraph>
				<Paragraph class="Default">For details, refer to the session help.</Paragraph>
				<Paragraph class="Default"><Emphasis>Note:</Emphasis> This step is optional. If you do not allocate memory for a package combination, or if you allocate 0 MB for a package combination, the amount of shared memory for the package combination will be unlimited.</Paragraph>
			</Step>
			<Step><StepTitle>Specify shared memory data</StepTitle>
				<Paragraph class="Default">Start the <Link href="/baanerp/tt/aad/ttaad4156m000" role="session">Shared Memory Data (ttaad4156m000)</Link> session. In this session, you can specify shared memory data in the following ways.</Paragraph>
				<TABLE border="1" borderstyle="default" space-and-orientation="indented-estimated"><TBODY><TR><TD rowspan="1" colspan="1">Import objects from measurement <Paragraph class="Default">(Recommended)</Paragraph>
							</TD>
							<TD rowspan="1" colspan="1">
								<Paragraph class="Default">On the <GUIRef href="" role="menu">Specific</GUIRef> menu, click <GUIRef href="/baanerp/tt/aad/ttaad4156m000#ttaad4255m000" role="command" Update="No">Import Objects from Measurement</GUIRef>. The <Link href="/baanerp/tt/aad/ttaad4255m000" role="session">Import Objects from Measurement (ttaad4255m000)</Link> session starts.</Paragraph> <List><ListIntro>
                                                   Use this session to do one of the following:</ListIntro>
									<ListItem>Import a range of program objects and/or report objects from the object measurements into the shared memory data.</ListItem>
									<ListItem><Paragraph class="Default">Import the most frequently used objects until the allocated memory, defined in the <Link href="/baanerp/tt/aad/ttaad4155m000" role="session">Allocated Memory Shared Memory (ttaad4155m000)</Link> session, is reached. To do this, you must select the <GUIRef href="/baanerp/tt/aad/ttaad4255m000#fill.all.mem" role="field">Fill remaining allocated memory with most counted objects</GUIRef> check box. The current shared memory data is deleted first, except the objects marked as Fixed.</Paragraph>
										<Paragraph class="Default">This option is recommended. A shared memory filled with the most frequently used objects improves the processing speed of your ERP LN application.</Paragraph>
									</ListItem>
								</List>
							</TD>
						</TR>
						<TR><TD rowspan="1" colspan="1">Import objects from DD</TD>
							<TD rowspan="1" colspan="1">
								<Paragraph class="Default">On the <GUIRef href="" role="menu">Specific</GUIRef> menu, click <GUIRef href="/baanerp/tt/aad/ttaad4156m000#ttaad4254m000" role="command" Update="No">Import Objects from DD</GUIRef>. The <Link href="/baanerp/tt/aad/ttaad4254m000" role="session">Import Objects from DD (ttaad4254m000)</Link> session starts. Use this session to import a range of program objects and/or report objects from the Data Dictionary (DD) into the shared memory data.</Paragraph>
							</TD>
						</TR>
						<TR><TD rowspan="1" colspan="1">Manually add objects</TD>
							<TD rowspan="1" colspan="1">
								<Paragraph class="Default">To manually enter objects in the grid, click <GUIRef href="" role="manual">New</GUIRef>.</Paragraph>
							</TD>
						</TR>
					</TBODY>
				</TABLE>
				<List><ListTitle>
                                       Note
                                    </ListTitle>
					<ListItem>If one or more objects are defined for a package combination, the domains and table definitions of that package combination will also be loaded into the shared memory. You cannot add individual domains and table definitions.</ListItem>
					<ListItem>Tools objects (objects of packages tt and tl) do not belong to a package combination, and are therefore stored in the dummy &lt;empty&gt; package combination. To create a list of Tools objects to be loaded into shared memory, leave the <GUIRef href="/baanerp/tt/aad/ttaad4156m000#ttaad456.pacc" role="field">Package Combination</GUIRef> field empty.</ListItem>
					<ListItem>You can mark objects as Fixed. Fixed objects will not be removed from the shared memory data when you run the <Link href="/baanerp/tt/aad/ttaad4255m000" role="session">Import Objects from Measurement (ttaad4255m000)</Link> session with the <GUIRef href="/baanerp/tt/aad/ttaad4255m000#fill.all.mem" role="field">Fill remaining allocated memory with most counted objects</GUIRef> check box selected.</ListItem>
				</List>
				<Paragraph class="Default">For details, refer to the session help.</Paragraph>
			</Step>
			<Step><StepTitle>Convert the shared memory data to Runtime</StepTitle>
				<Paragraph class="Default">On the <GUIRef href="" role="menu">Specific</GUIRef> menu in the <Link href="/baanerp/tt/aad/ttaad4156m000" role="session">Shared Memory Data (ttaad4156m000)</Link> session, click <GUIRef href="/baanerp/tt/aad/ttaad4156m000#exec.user.0" role="command">Convert to Runtime</GUIRef>. You can only run this command on a host defined as Master Application Server (MAS).</Paragraph>
				<Paragraph class="Default">When the conversion is complete, click <GUIRef href="" role="manual">OK</GUIRef> and close the session.</Paragraph>
			</Step>
			<Step><StepTitle>Restart the shared memory</StepTitle>
				<Paragraph class="Default">The procedure to restart the shared memory depends on the operating system of the ERP LN server.</Paragraph>
				<TABLE border="1" borderstyle="default" space-and-orientation="indented-estimated"><THEAD><TR><TD rowspan="1" colspan="1">Operating System</TD>
							<TD rowspan="1" colspan="1">Procedure</TD>
						</TR>
					</THEAD>
					<TBODY><TR><TD rowspan="1" colspan="1">Windows</TD>
							<TD rowspan="1" colspan="1">
								<ProcedureList><ListIntro>To restart the shared memory, complete the following steps:</ListIntro>
									<ListItem>Start the Enterprise Server Service Manager.</ListItem>
									<ListItem>Right-click the Shared Memory Service, and on the shortcut menu, click <GUIRef href="" role="manual">Stop</GUIRef>.</ListItem>
									<ListItem>Right-click the Shared Memory Service again, and on the shortcut menu, click <GUIRef href="" role="manual">Start</GUIRef>.</ListItem>
								</ProcedureList>
							</TD>
						</TR>
						<TR><TD rowspan="1" colspan="1">UNIX</TD>
							<TD rowspan="1" colspan="1">
								<ProcedureList><ListIntro>To restart the shared memory, complete the following steps:</ListIntro>
									<ListItem>Log off from ERP LN.</ListItem>
									<ListItem>Log onto the ERP LN server as user root.</ListItem>
									<ListItem><Paragraph class="Default">Enter the following commands:</Paragraph>
										<Paragraph class="Default"><Code># cd $BSE/bin</Code>
										</Paragraph>
										<Paragraph class="Default"><Code># ./srdd_init6.2 -i</Code>
										</Paragraph>
									</ListItem>
								</ProcedureList>
							</TD>
						</TR>
					</TBODY>
				</TABLE>
			</Step>
		</Steps>
	</ProcedureSection>
	<Note><SectionTitle>
                              Note
                           </SectionTitle>
		<Paragraph class="Default">For more information on shared memory, refer to <DocRef>Infor Enterprise Server 8.5 - Technical Manual (U8172 US)</DocRef>.</Paragraph>
	</Note>
</ManualTopic>
