langinstall

Description

Installs a new language in an Adaptive Server. Located in $SYBASE/ASE-12_5/bin.

NoteIn Windows NT, the utility is langinst.exe, located in %SYBASE%\ASE-12_5\bin.

Syntax

langinstall
	[-S server]
	[-U user]
	[-I interfaces_file]
	[-P password]
	[-R release_number]
	[-I path_to_interfaces_file]
	language
	character_set

Or

langinstall -v

Parameters

-S server

specifies the name of the Adaptive Server to which to connect. If you do not specify -S, langinstall uses the server specified by your DSQUERY environment variable. If DSQUERY is not set, langinstall attempts to connect to a server named SYBASE.

-U user

specifies a login name. Login names are case sensitive.

-I interfaces_file

specifies the name and location of the interfaces file (sql.ini file in Windows NT) that langinstall searches when connecting to Adaptive Server. If you do not specify -I, langinstall uses the interfaces file in the directory specified by the SYBASE environment variable. If SYBASE is not set, langinstall looks for the default SYBASE directory.

-P password

specifies the System Administrator’s (“sa” account) password. If you omit -P, langinstall prompts for the “sa” account password.

-R release_number

specifies the release number, in the format n.n.n, to use to upgrade messages in master..sysmessages. Use -R only in failure conditions, such as if langinstall (langinst in Windows NT) fails, in case of user error, or when you think that messages in sysmessages are out of date.

The -R parameter forces langinstall to collect messages from a release previous to the current one. langinstall compares the existing messages with the ones to be installed and replaces any that have changed.

For example, if the current version is 12.5, and the previous version was 12.0, and you think sysmessages may not be correct, include the messages from the earlier version in the syslanguages.upgrade column (12.0 in this case) by specifying -R 12.0. langinstall then installs all messages from Adaptive Server 12.0.

-I path_to_interfaces_file

specifies the path to the interfaces file.

language

is the official name of the language to be installed. You must specify a language.

character_set

is the name of Adaptive Server’s default character set. character_set indicates the directory name of the localization files for the language. The common.loc and server.loc localization files for an official language reside in the character set directory $SYBASE/locales/language/character_set in UNIX platforms, or %sybase%\locales\language\character_set in Windows NT. You must specify a character set.

-v

prints the version number and copyright message for langinstall and then exits.

Usage

Permissions

Only a System Administrator using the “sa” account can run langinstall.

Tables used

master.dbo.syslanguages, master.dbo.sysmessages

See also

System proceduressp_addlanguage, sp_addlogin, sp_configure, sp_defaultlanguage, sp_droplanguage, sp_helplanguage

Utilitiesdefncopy, srvbuild