NonStopTM Server for JavaTM Tools Reference Pages Abstract This document consists of this title page, a table of contents, and the Compaq NonStopTM Server for JavaTM Tools Reference Pages. Product Version NonStopTM Server for JavaTM 2.0 Part Number Published 426948-001 January 2001 Document History Part Number Product Version Published 425258-001 NSJ 1.6 December 1999 422745-001 NSJ 1.6 November 1999 422726-001 NSJ 1.5 March 1999 (on TIM) None NSJ 1.5 June 1998 (on product CD) None NSJ 1.
particular purpose. Compaq does not warrant, guarantee, or make any representations regarding the use or the results of the use of any examples or sample programs in any documentation. You should verify the applicability of any example or sample program before placing the software into productive use. U.S. Government Customers FOR U.S. GOVERNMENT CUSTOMERS REGARDING THIS DOCUMENTATION AND THE ASSOCIATED SOFTWARE These notices shall be marked on any reproduction of this data, in whole or in part.
Microsoft, MS-DOS, Outlook, PowerPoint, Visual Basic, Visual C++, Win32, Win32s, Win64, Windows, Windows logo, Windows NT, Windows Start logo, and XENIX are either registered trademarks or trademarks of Microsoft Corporation. Intel, Pentium, and Intel Inside are registered trademarks of Intel Corporation. Motif, OSF/1, UNIX, and X/Open are registered trademarks of, and The Open Group, the "X" device, and IT DialTone are trademarks of, The Open Group. 3Com is a registered trademark of 3Com Corporation.
IPX/SPX is a trademark of Novell, Inc. used by Compaq under license from Novell. Netware is a trademark of Novell, Inc. used by Compaq under license from Novell.
SMP, SMP+, and CMW+ are trademarks of SecureWare, Inc. DIR-X and MX300i are trademarks of Siemens Nixdorf Informationssysteme AG. Wireless Location Services is a trademark of SignalSoft Corp.
The information in this publication is subject to change without notice and is provided "AS IS" WITHOUT WARRANTY OF ANY KIND. THE ENTIRE RISK ARISING OUT OF THE USE OF THIS INFORMATION REMAINS WITH RECIPIENT.
NonStopTM Server for JavaTM Tools Reference Pages Command ddl2java * Tool Name Java Data Description Tool Function Generates and (optionally) compiles a Java source file for each data description in an input file. JAR Conflict Detection Tool Detects version conflicts between a target extcheck Java Archive (JAR) file and currently installed extension JAR files. Java Archive Tool Combines multiple files into a single JAR jar file and retrieves files from a JAR file.
rmiregistry Java Remote Object Registry serialver Serial Version Command Naming Service Access tnameserv * Compaq extension to standard Java Starts a remote object registry on the specified port on the current host. Returns the serialVersionUID of one or more classes. Provides access to the Naming Service. NonStopTM Server for JavaTM Tools Reference Pages (426948-001) Copyright © 2001, Compaq Computer Corporation. All rights reserved.
NSJ Tools Home Page ddl2java: JavaTM Data Description Tool ddl2java generates and (optionally) compiles a JavaTM source file for each data description in an input file. For more information, see Description. Synopsis ddl2java [-c] [-d source-path ] -e coding [-h] [-l [C | COBOL]] [-v] -dpath dictionary-path -p package-name -i filename Options -c Causes ddl2java to compile any generated .java source file for the specified DDL record or definition.
item-type item-name,class-type[,language],char-string-type Note: item-type must be the first entry on its line and item-name must appear next. The other options can be in any order. Do not put spaces between item-name, class-type, language, and char-string-type. where: item-type Specifies the DDL type of the data item--DEF[INITION] or REC[ORD]. item-name Specifies the name of the DDL record or definition. class-type Specifies the type of class to be generated--RQ (request), RP (reply), or BOTH.
● Java class names ● Instance variable names ● Instance variable data types ● set and clear methods ● get methods ● Calls to conversion methods ● Constructors for Reply IPCs Generated Java Class Names For a class generated for a request IPC, ddl2java forms the Java class name by upshifting the first character of the DDL description name and adding the prefix RQ.
ddl2java generates the following instance variable names: protected protected protected protected protected protected protected protected protected String String String String String String String String String request_code; employee_old_info_empnum; employee_old_info_empname_firstname; employee_old_info_empname_lastname; employee_old_info_empname_middle; employee_new_info_empnum; employee_new_info_empname_firstname; employee_new_info_empname_lastname; employee_new_info_empname_middle; Generated Instance
dependent_info[] = { new Dependent_info_class(), new Dependent_info_class(), new Dependent_info_class() }; class Dependent_info_class { protected String name; protected String age; } If a DDL field is defined as occurs depending on, ddl2java generates an array whose size is the maximum number of occurrances for the field. For example, for a field defined as: 02 num-of-deps binary 16. 02 dependent-info occurs 0 to 5 times depending on num-of-deps. 03 name pic x(20). 03 age pic 99.
private String c; private String d; For classes generated for request IPCs, execute the set method for the variable you want to use. If you use multiple set methods for variables that redefine each other, results are unpredictable. For predictable results, either use only the set method for the variable you want or use the clear method for each unwanted redefinition of the variable.
the generated class are unique. For classes associated with reply IPCs, ddl2java generates get methods that you can use to retrieve the data returned from the TsmpServerReply(). For the following DDL data description: def getEmployeeReply. 02 reply_code pic 99. 02 employee-info. 04 empnum pic 9(4). 04 empname. 06 firstname pic x(20). 06 lastname pic x(30). 06 middle pic x. end ddl2java generates the following get methods: public String getReply_code() { ... } public String getEmployee_info_empnum() { ...
Generated Constructors for Reply IPCs For a reply IPC only, ddl2java generates a constructor that accepts a TsmpGenericServerReply object as an argument. This constructor is used to move the contents of the reply buffer from a TsmpGenericServerReply to the reply IPC. For example: TsmpGenericServerReply greply = new TsmpGenericServerReply(); ...
NSJ Tools Home Page extcheck: JAR Conflict Detection Tool The extcheck tool detects version conflicts between a target Java Archive (JAR) file and currently installed extension JAR files. For a complete description of the tool and its use, see the Sun Microsystems documentation for extcheck. Synopsis extcheck [ -verbose ] targetfile.jar See Also: jar NSJ Tools Home Page NonStopTM Server for JavaTM Tools Reference Pages (426948-001) Copyright © 2001, Compaq Computer Corporation. All rights reserved.
NSJ Tools Home Page jar: JavaTM Archive Tool The jar tool combines multiple files into a single JavaTM Archive (JAR) file or retrieves files from a JAR file. For a complete description of the tool and its use, see the Sun Microsystems documentation for jar. Synopsis jar [ options ] [ jar-file ] [ manifest-file ] [ file | directory ] ... NSJ Tools Home Page NonStopTM Server for JavaTM Tools Reference Pages (426948-001) Copyright © 2001, Compaq Computer Corporation. All rights reserved.
NSJ Tools Home Page jarsigner: JAR Signing and Verification Tool The jarsigner tool generates signatures for JavaTM Archive (JAR) files and verifies the signatures of signed JAR files. For a complete description of the tool and its use, see the Sun Microsystems documentation for jarsigner.
NSJ Tools Home Page java: JavaTM Interpreter The java tool interprets (executes) JavaTM bytecode. For a complete description of the tool and its use, see the Sun Microsystems documentation for java. NonStopTM Server for Java also supports oldjava, a limited-feature launcher tool that supports programming techniques that are incompatible with some 1.2 features of Java. That tool is also described in the Sun Microsystems documentation for java.
NonStopTM Server for JavaTM Tools Reference Pages (426948-001) Copyright © 2001, Compaq Computer Corporation. All rights reserved.
NSJ Tools Home Page javac: JavaTM Compiler The javac tool compiles JavaTM source code into bytecode. For a complete description of the tool and its use, see the Sun Microsystems documentation for javac. Synopsis javac [ options ] filename.java ... See Also: ● rmic ● java ● jdb ● javah ● javap ● javadoc NSJ Tools Home Page NonStopTM Server for JavaTM Tools Reference Pages (426948-001) Copyright © 2001, Compaq Computer Corporation. All rights reserved.
NSJ Tools Home Page javadoc: JavaTM API Documentation Generator The javadoc tool generates API documentation in HTML or MIF format from JavaTM source code. For a complete description of the tool and its use, see the Sun Microsystems documentation for javadoc. Synopsis javadoc [ options ] { package | class.java } ...
NSJ Tools Home Page javah: C Header and Stub File Generator The javah tool generates C header files and stub C source files from a Java class. These files provide the connections that allow your JavaTM and C code to interact. For a complete description of the tool and its use, see the Sun Microsystems documentation for javah. Synopsis javah [ options ] classname ...
-nsjversion Prints the Compaq build version. See Also: ● javac ● rmic ● java ● jdb ● javap ● javadoc NSJ Tools Home Page NonStopTM Server for JavaTM Tools Reference Pages (426948-001) Copyright © 2001, Compaq Computer Corporation. All rights reserved.
NSJ Tools Home Page javap: JavaTM Class File Disassembler The javap tool disassembles compiled JavaTM files. For a complete description of the tool and its use, see the Sun Microsystems documentation for javap. Synopsis javap [ options ] class ... See Also: ● javac ● rmic ● java ● jdb ● javah ● javadoc NSJ Tools Home Page NonStopTM Server for JavaTM Tools Reference Pages (426948-001) Copyright © 2001, Compaq Computer Corporation. All rights reserved.
NSJ Tools Home Page jdb: JavaTM Debugger The jdb tool helps you find and fix bugs in JavaTM programs. For a complete description of the tool and its use, see the Sun Microsystems documentation for jdb. Synopsis jdb [ options ] Compaq Specifics The Compaq implementation of the Java Debugger, jdb, differs slightly from the Sun Microsystems implementation. One difference is in the way you start a jdb session. There are also some additional jdb commands, described under Compaq Command Extensions.
Reads commands from a file. out filename Sets the standard output device to the specified file. sleep milliseconds Puts the debugger to sleep. source [line-number|method] Prints source code (very similar to the list command). t [threadID|all] With no argument, dumps the stack of the current thread. With all, dumps the stack of each thread in the current thread group. With threadID, dumps the stack of the specified thread (very similar to the where command).
NSJ Tools Home Page keytool: Key and Certificate Management Tool The keytool tool manages a keystore (database) of private keys and their associated X.509 certificate chains authenticating the corresponding public keys. For a complete description of the tool and its use, see the Sun Microsystems documentation for keytool.
NSJ Tools Home Page native2ascii: Native-to-ASCII Converter The native2ascii tool converts a file that has native-encoded characters (characters that are not Latin-1 and not Unicode) to a file with Unicode-encoded characters. For a complete description of the tool and its use, see the Sun Microsystems documentation for native2ascii.
NSJ Tools Home Page rmic: JavaTM RMI Stub Compiler The rmic tool generates stubs and skeletons for remote objects. For a complete description of the tool and its use, see the Sun Microsystems documentation for rmic. Synopsis rmic [ options ] classname ... See Also: ● javac ● rmiregistry NSJ Tools Home Page NonStopTM Server for JavaTM Tools Reference Pages (426948-001) Copyright © 2001, Compaq Computer Corporation. All rights reserved.
NSJ Tools Home Page rmid: JavaTM RMI Activation System Daemon The rmid tool starts the activation system daemon that allows objects to be registered and activated in a JavaTM virtual machine (JVM). For a complete description of the tool and its use, see the Sun Microsystems documentation for rmid. Synopsis rmid [ options ] See Also: ● java ● rmic NSJ Tools Home Page NonStopTM Server for JavaTM Tools Reference Pages (426948-001) Copyright © 2001, Compaq Computer Corporation. All rights reserved.
NSJ Tools Home Page rmiregistry: JavaTM Remote Object Registry The rmiregistry tool starts a remote object registry on the specified port on the current host. For a complete description of the tool and its use, see the Sun Microsystems documentation for rmiregistry. Synopsis rmiregistry [ port ] See Also: ● rmic NSJ Tools Home Page NonStopTM Server for JavaTM Tools Reference Pages (426948-001) Copyright © 2001, Compaq Computer Corporation. All rights reserved.
NSJ Tools Home Page serialver: Serial Version Command The serialver tool returns the serialVersionUID of one or more classes. For a complete description of the tool and its use, see the Sun Microsystems documentation for serialver. Synopsis serialver [ option ] [ classname ... ] NSJ Tools Home Page NonStopTM Server for JavaTM Tools Reference Pages (426948-001) Copyright © 2001, Compaq Computer Corporation. All rights reserved.
NSJ Tools Home Page tnameserv: Naming Service Access The tnameserv tool starts the JavaTM Interface Definition Language (IDL) name server to provide access to the CORBA Common Object Services (COS) Naming Service. For a complete description of the tool and its use, see the Sun Microsystems documentation for Naming Service. Synopsis tnameserv [ -ORBInitialPort n ] NSJ Tools Home Page NonStopTM Server for JavaTM Tools Reference Pages (426948-001) Copyright © 2001, Compaq Computer Corporation.
