| changeset 9573 | c02ff5a7c67b |
| parent 5865 | 47da38a8c0f0 |
| child 21743 | 3d979da7bdf0 |
| 9572:6f64c69a7574 | 9573:c02ff5a7c67b |
|---|---|
1 ." Copyright (c) 1999, 2010, Oracle and/or its affiliates. All rights reserved. |
1 ." Copyright (c) 1999, 2011, Oracle and/or its affiliates. All rights reserved. |
2 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. |
2 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. |
3 ." |
3 ." |
4 ." This code is free software; you can redistribute it and/or modify it |
4 ." This code is free software; you can redistribute it and/or modify it |
5 ." under the terms of the GNU General Public License version 2 only, as |
5 ." under the terms of the GNU General Public License version 2 only, as |
6 ." published by the Free Software Foundation. |
6 ." published by the Free Software Foundation. |
17 ." |
17 ." |
18 ." Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA |
18 ." Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA |
19 ." or visit www.oracle.com if you need additional information or have any |
19 ." or visit www.oracle.com if you need additional information or have any |
20 ." questions. |
20 ." questions. |
21 ." |
21 ." |
22 .TH tnameserv 1 "02 Jun 2010" |
22 .TH tnameserv 1 "10 May 2011" |
23 |
23 |
24 .LP |
24 .LP |
25 .SH "Name" |
25 .SH "Name" |
26 Java IDL: Transient Naming Service \- \f2tnameserv\fP |
26 Java IDL: Transient Naming Service \- \f2tnameserv\fP |
27 .LP |
27 .LP |
28 .LP |
28 .LP |
29 This document discusses using the Java IDL Transient Naming Service, \f2tnameserv\fP. Java IDL also includes the Object Request Broker Daemon (ORBD). ORBD is a daemon process containing a Bootstrap Service, a Transient Naming Service, a \f3Persistent\fP Naming Service, and a Server Manager. The Java IDL tutorials all use ORBD, however, you can substitute \f2tnameserv\fP for \f2orbd\fP in any of the examples that use a Transient Naming Service. For documentation on the \f2orbd\fP tool, link to its orbd(1) or the |
29 This document discusses using the Java IDL Transient Naming Service, \f2tnameserv\fP. Java IDL also includes the Object Request Broker Daemon (ORBD). ORBD is a daemon process containing a Bootstrap Service, a Transient Naming Service, a \f3Persistent\fP Naming Service, and a Server Manager. The Java IDL tutorials all use ORBD, however, you can substitute \f2tnameserv\fP for \f2orbd\fP in any of the examples that use a Transient Naming Service. For documentation on the \f2orbd\fP tool, link to its orbd(1) or the |
30 .na |
30 .na |
31 \f2Java IDL Naming Service Included with ORBD\fP @ |
31 \f2Java IDL Naming Service Included with ORBD\fP @ |
32 .fi |
32 .fi |
33 http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlNaming.html topic. |
33 http://download.oracle.com/javase/7/docs/technotes/guides/idl/jidlNaming.html topic. |
34 .LP |
34 .LP |
35 .LP |
35 .LP |
36 Topics in this section include: |
36 Topics in this section include: |
37 .LP |
37 .LP |
38 .RS 3 |
38 .RS 3 |
118 .LP |
118 .LP |
119 For the client and server to find the Naming Service, they must be made aware of the port number and host on which the naming service is running. Do this by setting the \f2org.omg.CORBA.ORBInitialPort\fP and \f2org.omg.CORBA.ORBInitialHost\fP properties in the client and server files to the machine name and port number on which the Naming Service is running. An example of this is shown in |
119 For the client and server to find the Naming Service, they must be made aware of the port number and host on which the naming service is running. Do this by setting the \f2org.omg.CORBA.ORBInitialPort\fP and \f2org.omg.CORBA.ORBInitialHost\fP properties in the client and server files to the machine name and port number on which the Naming Service is running. An example of this is shown in |
120 .na |
120 .na |
121 \f2The Hello World Example Using RMI\-IIOP\fP @ |
121 \f2The Hello World Example Using RMI\-IIOP\fP @ |
122 .fi |
122 .fi |
123 http://java.sun.com/javase/6/docs/technotes/guides/rmi\-iiop/rmiiiopexample.html. You could also use the command line options \f2\-ORBInitialPort\fP \f2nameserverport#\fP and \f2\-ORBInitialHost\fP \f2nameserverhostname\fP to tell the client and server where to find the Naming Service. |
123 http://download.oracle.com/javase/7/docs/technotes/guides/rmi\-iiop/rmiiiopexample.html. You could also use the command line options \f2\-ORBInitialPort\fP \f2nameserverport#\fP and \f2\-ORBInitialHost\fP \f2nameserverhostname\fP to tell the client and server where to find the Naming Service. |
124 .na |
124 .na |
125 \f2Java IDL: Running the Hello World Example on TWO Machines\fP @ |
125 \f2Java IDL: Running the Hello World Example on TWO Machines\fP @ |
126 .fi |
126 .fi |
127 http://java.sun.com/javase/6/docs/technotes/guides/idl/tutorial/jidl2machines.html shows one way of doing this using the command line option. |
127 http://download.oracle.com/javase/7/docs/technotes/guides/idl/tutorial/jidl2machines.html shows one way of doing this using the command line option. |
128 .LP |
128 .LP |
129 .LP |
129 .LP |
130 For example, suppose the Transient Naming Service, \f2tnameserv\fP is running on port 1050 on host \f2nameserverhost\fP. The client is running on host \f2clienthost\fP and the server is running on host \f2serverhost\fP. |
130 For example, suppose the Transient Naming Service, \f2tnameserv\fP is running on port 1050 on host \f2nameserverhost\fP. The client is running on host \f2clienthost\fP and the server is running on host \f2serverhost\fP. |
131 .LP |
131 .LP |
132 .RS 3 |
132 .RS 3 |
167 .LP |
167 .LP |
168 .SS |
168 .SS |
169 The \-J option |
169 The \-J option |
170 .LP |
170 .LP |
171 This command\-line option is available for use with \f2tnameserve\fP: |
171 This command\-line option is available for use with \f2tnameserve\fP: |
172 .RS 3 |
|
173 |
|
174 .LP |
|
175 .RS 3 |
172 .RS 3 |
176 .TP 3 |
173 .TP 3 |
177 \-Joption |
174 \-Joption |
178 Pass \f2option\fP to the Java virtual machine, where \f2option\fP is one of the options described on the reference page for java(1). For example, \f3\-J\-Xms48m\fP sets the startup memory to 48 megabytes. It is a common convention for \f3\-J\fP to pass options to the underlying virtual machine. |
175 Pass \f2option\fP to the Java virtual machine, where \f2option\fP is one of the options described on the reference page for java(1). For example, \f3\-J\-Xms48m\fP sets the startup memory to 48 megabytes. It is a common convention for \f3\-J\fP to pass options to the underlying virtual machine. |
179 .RE |
176 .RE |
180 |
177 |
181 .LP |
178 .LP |
182 .RE |
|
183 .SH "Stopping the Java\ IDL Transient Naming Service" |
179 .SH "Stopping the Java\ IDL Transient Naming Service" |
184 .LP |
180 .LP |
185 .LP |
181 .LP |
186 To stop the Java\ IDL naming service, use the relevant operating system command, such as \f2kill\fP for a Unix process, or \f2Ctrl\-C\fP for a Windows process. The naming service will continue to wait for invocations until it is explicitly shutdown. Note that names registered with the Java\ IDL naming service disappear when the service is terminated. |
182 To stop the Java\ IDL naming service, use the relevant operating system command, such as \f2kill\fP for a Unix process, or \f2Ctrl\-C\fP for a Windows process. The naming service will continue to wait for invocations until it is explicitly shutdown. Note that names registered with the Java\ IDL naming service disappear when the service is terminated. |
187 .LP |
183 .LP |
188 .SH "Sample Client: Adding Objects to the Namespace" |
184 .SH "Sample Client: Adding Objects to the Namespace" |
189 .LP |
185 .LP |
190 .LP |
186 .LP |
191 The following sample program illustrates how to add names to the namespace. It is a self\-contained Transient Naming Service client that creates the following simple tree. |
187 The following sample program illustrates how to add names to the namespace. It is a self\-contained Transient Naming Service client that creates the following simple tree. |
192 .LP |
188 .LP |
193 .nf |
189 .RS 3 |
194 \f3 |
190 .TP 2 |
195 .fl |
191 o |
196 \fP\f3 |
192 \f4Initial Naming Context\fP |
197 .fl |
193 .RS 3 |
198 \fP\f4Initial\fP\f3 |
194 .TP 2 |
199 .fl |
195 * |
200 \fP\f4Naming Context\fP\f3 |
196 \f3plans\fP |
201 .fl |
197 .TP 2 |
202 / \\ |
198 * |
203 .fl |
199 \f4Personal\fP |
204 / \\ |
200 .RS 3 |
205 .fl |
201 .TP 2 |
206 plans \fP\f4Personal\fP\f3 |
202 - |
207 .fl |
203 \f3calendar\fP |
208 / \\ |
204 .TP 2 |
209 .fl |
205 - |
210 / \\ |
206 \f3schedule\fP |
211 .fl |
207 .RE |
212 calendar schedule\fP |
208 .RE |
213 .fl |
209 .RE |
214 .fi |
|
215 |
210 |
216 .LP |
211 .LP |
217 .LP |
212 .LP |
218 In this example, \f3plans\fP is an object reference and \f3Personal\fP is a naming context that contains two object references: \f3calendar\fP and \f3schedule\fP. |
213 In this example, \f3plans\fP is an object reference and \f3Personal\fP is a naming context that contains two object references: \f3calendar\fP and \f3schedule\fP. |
219 .LP |
214 .LP |