<?xml version="1.0" encoding="utf-8"?>
<ManualTopic ID="/baanerp/tt/onlinemanual/mle_to_migrate_data_languages" xml:lang="en" UserLevel="Expert">
	<Header>
		<Title xmlns:HTML="http://www.w3.org/TR/REC-html40">To migrate data languages</Title>
		<Keyword ContextSensitive="No"><Level1>Multilanguage Application Data</Level1>
			<Level2>migration</Level2>
		</Keyword>
		<Keyword ContextSensitive="No"><Level1>Data Language</Level1>
			<Level2>migration</Level2>
		</Keyword>
	</Header>
	<GeneralSection><Paragraph class="Default">In Infor Enterprise Server 8.4.1 and higher, the coding of data languages is based on the ISO 639-1/ISO 3166-1 standard. In earlier versions, the coding was based on the ISO 639-2 standard. For details, refer to <Link href="/baanerp/tt/onlinemanual/mle_multi_language_application_data" role="manual">Multilanguage Application Data</Link>.</Paragraph>
		<Paragraph class="Default">
                              Infor Enterprise Server 8.5 still works with the old ISO 639-2 data languages. However, to use the new data language coding standards, a migration of the existing data languages might be required.</Paragraph>
	</GeneralSection>
	<GeneralSection><Paragraph class="Default">To find out whether a migration is required, start the <Link href="/baanerp/tt/aad/ttaad1111m000" role="session">Data Languages (ttaad1111m000)</Link> session and view the data language properties. A migration is required if ISO 639-2 data languages with status "Available" or "Base Language" are present. Migrate these languages according to the procedure described in the following section.</Paragraph>
		<Note><SectionTitle>
                                 Note
                              </SectionTitle>
			<Paragraph class="Default">If no ISO 639-2 data languages with status "Available" or "Base Language" are present, a migration is not required. However, you must remove all data languages with status "Pending for Addition" and/or "Pending for Deletion", because otherwise you cannot convert new data languages to runtime.</Paragraph>
		</Note>
	</GeneralSection>
	<ProcedureSection><SectionTitle>To migrate data languages</SectionTitle>
		<Steps><StepsIntro>To migrate data languages to the new coding standard, complete the following steps:</StepsIntro>
			<Step><StepTitle>Define new ISO 639-1/ISO 3166 data languages</StepTitle>
				<ProcedureList><ListIntro>Complete the following steps:</ListIntro>
					<ListItem>Start the <Link href="/baanerp/tt/aad/ttaad1512m000" role="session">ISO 639 Languages (ttaad1512m000)</Link> session and check whether the ISO 639-1-based languages codes are present; if not, on the <GUIRef href="" role="menu">Specific</GUIRef> menu, click <GUIRef href="" role="manual">Import</GUIRef> to import the missing languages.</ListItem>
					<ListItem>Start the <Link href="/baanerp/tt/aad/ttaad1513m000" role="session">ISO 3166-1 Countries (ttaad1513m000)</Link> session and check whether the ISO 3166-based country codes are present; if not, on the <GUIRef href="" role="menu">Specific</GUIRef> menu, click <GUIRef href="" role="manual">Import</GUIRef> to import the missing countries.</ListItem>
					<ListItem>Start the <Link href="/baanerp/tt/aad/ttaad1111m000" role="session">Data Languages (ttaad1111m000)</Link> session. For each ISO 639-2 data language with status "Available" or "Base Language", define a new data language based on the new ISO 639-1/ISO 3166 standard. The new data languages have status "Pending for Addition".</ListItem>
				</ProcedureList>
			</Step>
			<Step><StepTitle>Define data language mapping</StepTitle>
				<ProcedureList><ListIntro>To define a mapping between the old ISO 639-2-based language codes and the new ISO 639-1/ISO 3166-based language codes, complete the following steps:</ListIntro>
					<ListItem>Start the <Link href="/baanerp/tt/aad/ttaad1211m000" role="session">ISO Data Language Migration (ttaad1211m000)</Link> session.</ListItem>
					<ListItem>Click <GUIRef href="/baanerp/tt/aad/ttaad1211m000#ttaad1114m000" role="command" Update="No">Mapping</GUIRef>. The <Link href="/baanerp/tt/aad/ttaad1114m000" role="session">ISO Data Language Mapping (migration) (ttaad1114m000)</Link> session starts. The session displays the old ISO 639-2 data languages with status "Available" or "Base Language" in the <GUIRef href="/baanerp/tt/aad/ttaad1411m000#dlan.f" role="manual" Update="No">Data Language (from)</GUIRef> field.</ListItem>
					<ListItem>Define the mapping between the old and new data languages: for each old data language displayed, specify the corresponding new ISO 639-1/ISO 3166 data language in the <GUIRef href="/baanerp/tt/aad/ttaad1411m000#dlan.t" role="manual" Update="No">Data Language (to)</GUIRef> field. For an example, refer to the session help. Note: all old data languages with status "Available" or "Base Language" MUST be mapped.</ListItem>
					<ListItem>To store the mapping and return to the <GUIRef href="/baanerp/tt/aad/ttaad1211m000" role="session">ISO Data Language Migration (ttaad1211m000)</GUIRef> session, click <GUIRef href="" role="manual">Save and Close</GUIRef>.</ListItem>
				</ProcedureList>
			</Step>
			<Step><StepTitle>Migrate data languages</StepTitle>
				<ProcedureList><ListIntro>To migrate the data languages, complete the following steps:</ListIntro>
					<ListItem>In the <GUIRef href="/baanerp/tt/aad/ttaad1211m000#d.file" role="manual">Basic name for dump file</GUIRef> field in the <GUIRef href="/baanerp/tt/aad/ttaad1211m000" role="session">ISO Data Language Migration (ttaad1211m000)</GUIRef> session, enter the basic name, including the path, of the sequential dump files the session will generate. For example: <Code>/home/ISOdump</Code>. <List><ListItem>The session generates a separate dump file for each package combination. The package combination code is automatically added as a prefix to the basic filename.</ListItem>
							<ListItem>The sequential dump files contain the records and data dictionary of all tables with enabled registered multilanguage fields.</ListItem>
						</List>
					</ListItem>
					<ListItem>In the <GUIRef href="/baanerp/tt/aad/ttaad1211m000#d.file.err" role="manual">Basic name for error file</GUIRef> field, enter the basic name, including the path, of the error files the session will generate. For example: <Code>/home/ISOerr</Code>. <List><ListItem>The session generates a separate error file for each package combination. The package combination code is automatically added as a prefix to the basic error filename.</ListItem>
							<ListItem>The error files contain error messages and statistics.</ListItem>
						</List>
					</ListItem>
					<ListItem>To start the migration process, click <GUIRef href="/baanerp/tt/aad/ttaad1211m000#exec.cont.process" role="command">Migrate</GUIRef>.</ListItem>
				</ProcedureList>
				<List><ListTitle>
                                       Important! Do not interrupt this process.</ListTitle>
					<ListIntro>During the migration process, the following steps are automatically executed and indicated by a progress bar:</ListIntro>
					<ListItem>The sequential dump(s), mentioned above, are generated.</ListItem>
					<ListItem>From the sequential dumps the data is imported again, using the data language mapping scheme as defined in step 2. This step links the existing translations to the new data language.</ListItem>
					<ListItem><Paragraph class="Default">Based on the data language mapping scheme, users and software languages linked to old ISO 639-2 data languages are linked to the corresponding new data languages.</Paragraph>
						<Paragraph class="Default">If the user who executes the migration is not linked to a data language, the migration process links this user to the base language. You can change this manually after the migration.</Paragraph>
					</ListItem>
					<ListItem>If the process executed successfully, the following message is displayed: <Code>Migration data languages completed successfully</Code>.</ListItem>
					<ListItem>If the process did NOT execute successfully, the following error message is displayed: <Code>Migration data languages NOT completed successfully</Code>. Check the logfile "log.mle_conv" in the $BSE/log folder for the possible cause, solve the issue(s) and restart the migration process.</ListItem>
					<ListItem>The original ISO 639-2 data languages get the status "Migrated". The new ISO 639-1/ISO 3166-1 data languages get the status "Available", and the mapped base language gets the status "Base Language".</ListItem>
				</List>
				<Figure space-and-orientation="indented-estimated"><FigIntro>For example, after a successful migration, the following data languages are present.</FigIntro>
					<HTML:IMG height="330" width="696" SRC="../images/nt_screen_mle_to_migrate_data_languages1.gif" path="/enterpriseserver/tools/tt/onlinemanual" btb-count="1" btb-count2="1" btb-image-name="nt_screen_mle_to_migrate_data_languages1.gif" btb-source-path="C:\SVN\docnl\Technology\EnterpriseServer~8.5\EnterpriseServer" btb-image-path="/enterpriseserver/tools/tt/images/nt_screen_mle_to_migrate_data_languages1.gif" ID="IDAQ1WBC" alt="[...]" xmlns:HTML="http://www.w3.org/TR/REC-html40"/></Figure>
				<Paragraph class="Default">In the example above, the $BSE/lib/data_langs file has the following content:</Paragraph>
				<CodeBlock space-and-orientation="indented-estimated">en_US:b
fr_BE:a
nl_NL:a
</CodeBlock>
			</Step>
			<Step><StepTitle>Finalize migration</StepTitle>
				<ProcedureList><ListIntro>To finalize the migration, complete the following steps:</ListIntro>
					<ListItem>Log off and log on again.</ListItem>
					<ListItem>Start the <GUIRef href="/baanerp/tt/ams/ttams2200m000" role="session">Convert Changes to Runtime DD (ttams2200m000)</GUIRef> session and convert all user data to runtime.</ListItem>
				</ProcedureList>
				<List><ListTitle>
                                       Important!
                                    </ListTitle>
					<ListItem>After a successful migration, do not remove the specified data language mapping; this mapping is used by the Audit Management facility.</ListItem>
					<ListItem>After a successful migration, you can add new data languages based on the new ISO 639-1/ISO 3166 standard. For details, refer to <Link href="/baanerp/tt/onlinemanual/mle_multi_language_application_data" role="manual">Multilanguage Application Data</Link>.</ListItem>
				</List>
			</Step>
		</Steps>
	</ProcedureSection>
</ManualTopic>
