installjava

Syntax

installjava
	-f file_name
	[ -new | -update ]
	[ -a display_charset ]
	[ -D database_name ]
	[ -I interfaces_file ]
	[ -J client_charset ]
	[ -j jar_name ]
	[ -P password ]
	[ -S server_name ]
	[ -t timeout ]
	[ -U user_name ]
	[ -v]
	[ -z language ]

installjava -v

Parameters

• -a display_charset – allows you to use installjava from a machine where the character set differs that of the server. Use -a in conjunction with -J to specify the character set translation file (.xlt file) required for the conversion. Use -a without -J only if the client character set is the same as the default character set.
• -D database_name – is the name of the database in which to install the JAR. If you omit the -D flag, or if you specify the -D flag with no parameter, the user’s default database is used.
• -f file_name – is the name of the source file containing the classes to be installed in the database.
• -I interfaces_file – is the name and location of the interfaces file to search when connecting to the SAP ASE server. If you omit the -I flag and parameter, or if you specify the -I flag with no parameter, the interfaces file in the directory designated by your SYBASE environment variable is used.
• -J client_charset – specifies the character set to use on the client. installjava uses a filter to convert input between client_charset and the SAP ASE character set.

  -J client_charset requests that the SAP ASE server convert to and from client_charset, the character set used on the client.

  -J with no argument disables character set conversion. Use this if the client and server use the same character set.

  Omitting -J sets the character set to a default for the platform, which may not necessarily be the character set that the client is using. See the System Administration Guide for more information about character sets and associated flags.

• -j jar_name – is the name of the JAR containing the classes to be installed in the database. Indicates that the JAR file should be saved in the database and associated with the classes it contains.
• -new | -update – specifies whether the classes in the file already exist in the database. If you specify:

  • -new – you cannot install a class with the same name as an existing class

  • -update – install a class with the same name as an existing class, and the newly installed class replaces the existing class

• -P password – is an SAP ASE password. If you omit the -P flag and parameter, installjava prompts for a password. If you specify the -P flag with no password, the null password is used.
• -S server_name – is the name of the server.
• -t timeout – specifies the number of seconds before a SQL command times out. If you do not specify a timeout, the command runs indefinitely. This affects commands issued from within installjava, not the connection time. The default timeout for logging into installjava is 60 seconds.
• -U user_name – is an SAP ASE login name. If you omit the -U flag and parameter, or if you specify the -U flag with no parameter, the SAP ASE server uses the current user’s operating system login name.
• -v – prints the version number and copyright message for installjava and then exits.
• -z language – is the name of an alternate language for displaying installjava prompts and messages. Without the -z flag, installjava uses the server’s default language. Add languages to an SAP ASE during installation or afterward, using the langinstall utility or the sp_addlanguage stored procedure.

Examples

• Install – Installs addr.jar and its classes, but does not retain the association between the JAR and classes:

  installjava -f '/home/usera/jars/addr.jar' -new

  In Windows:

  instjava -f '\home\usera\jars\addr.jar' -new

• Reinstall – Reinstalls addr.jar and associates its classes with the employees JAR name:

  installjava -f '/home/usera/jars/addr.jar' -update -j employees

  In Windows:

  instjava -f '\home\usera\jars\addr.jar' -update -j employees

Permissions

You need to be a system administrator or database owner to use installjava.

Tables used

sysjars, sysxtypes