1<!--
2  -- ident	"%W%	%E% SMI"
3  --
4    CDDL HEADER START
5
6    The contents of this file are subject to the terms of the
7    Common Development and Distribution License, Version 1.0 only
8    (the "License").  You may not use this file except in compliance
9    with the License.
10
11    You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
12    or http://www.opensolaris.org/os/licensing.
13    See the License for the specific language governing permissions
14    and limitations under the License.
15
16    When distributing Covered Code, include this CDDL HEADER in each
17    file and include the License file at usr/src/OPENSOLARIS.LICENSE.
18    If applicable, add the following below this CDDL HEADER, with the
19    fields enclosed by brackets "[]" replaced with your own identifying
20    information: Portions Copyright [yyyy] [name of copyright owner]
21
22    CDDL HEADER END
23
24 -- Copyright (c) 2000-2001 by Sun Microsystems, Inc.
25  -- All rights reserved.
26  -->
27<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
28<html>
29
30<head>
31<title>DHCP Manager Help: Modify Macro</title>
32<meta NAME="AUTHOR" CONTENT="smorgan">
33<meta NAME="KEYWORDS" CONTENT="DHCP">
34
35</head>
36
37<body bgcolor="#FFFFFF">
38
39<a name="top"></a>
40
41<table border=0 cellspacing=0 cellpadding=0 width=615>
42
43<!-- Start navigation banner -->
44
45<tr><td colspan=4  WIDTH="615" align="center" valign="top"><IMG SRC="art/bannersmc.gif" WIDTH=615 BORDER=0 ALT="DHCP Manager Help">
46
47	</td>
48	</tr>
49
50<!-- End navigation banner -->
51
52
53<tr>
54
55<!-- Start contents block -->
56
57	<td colspan=1 valign="top" width=105>
58	<P>&nbsp;</P>
59
60	<A HREF="dhcp_main_top.html"><STRONG>Overview</STRONG></A><P>
61	<A HREF="dhcp_relay_ref.html"><STRONG>Servers and Relays</STRONG></A><P>
62	<A HREF="dhcp_addr_ref.html"><STRONG>IP Addresses</STRONG></A><P>
63	
64		
65<A HREF="dhcp_macro_ref.html"><STRONG>Macros</STRONG></A><BR>
66	&nbsp;&nbsp;<A HREF="dhcp_macro_create.html">Create</A><BR>
67	&nbsp;&nbsp;<A HREF="dhcp_macro_dup.html">Duplicate</A><BR>
68
69<IMG SRC="art/tip2.gif" WIDTH=12 HEIGHT=10 BORDER=0 ALT="">Modify<BR>
70	&nbsp;&nbsp;&nbsp;&nbsp;<a href="#name"><EM>Name</EM></a><BR>
71	&nbsp;&nbsp;&nbsp;&nbsp;<a href="#option"><EM>Option</EM></a><BR>
72	&nbsp;&nbsp;&nbsp;&nbsp;<a href="#order"><EM>Up/Down</EM></a><BR>
73	&nbsp;&nbsp;&nbsp;&nbsp;<a href="#del"><EM>Delete</EM></A><BR>
74
75	&nbsp;&nbsp;<A HREF="dhcp_macro_del.html">Delete</A><P>
76
77<A HREF="dhcp_option_ref.html"><STRONG>Options</STRONG></A><P>
78		
79<A HREF="dhcp_main_how.html"><STRONG>How To..</STRONG></A><P>
80<A HREF="dhcp_main_menus.html"><STRONG>Menus</STRONG></A><P>
81<A HREF="dhcp_main_idx.html"><STRONG>Index</STRONG></A>
82	
83	
84		</td>
85
86
87
88<!-- End contents block -->
89
90<!-- Start column rule -->
91
92	<td colspan=1 width=5 bgcolor="#CCCCCC">&nbsp;</td>
93
94<!-- End column spacer -->
95
96<!-- Start column spacer -->
97
98	<td colspan=1 width=10 bgcolor="#FFFFFF">&nbsp;</td>
99
100<!-- End column spacer -->
101
102
103
104<!-- Start topic block -->
105
106
107	<td colspan=1 valign="top" bgcolor="#ffffff">
108	<P>&nbsp;</P>
109
110<h1>Modify Macro</h1>
111
112The Macro Properties dialog box displays the current settings for a macro, and lets you modify these settings in the <tt>dhcptab</tt> on the selected DHCP server. <p>
113<p>
114To modify an entry, double-click the entry, enter the new value, and then press Enter.
115To display a list of defined options, right-click in the Options or Values field. Options are listed by category and type.<P>
116The settings in the Macro Properties menu are described below.
117<P><HR NOSHADE><P>
118
119
120	<table border=0 cellspacing=4 cellpadding=3>
121
122	<tr>
123	<td width=105 valign="top"><a name="name"><STRONG>Name</STRONG></a></td>
124	<td valign="top">The macro name; specify a new name, if 
125	desired. Remember, the name you choose determines the <a 
126	href="dhcp_macros_about.html#using">macro category</a>. Macro names can be 
127	a maximum of 128 alphanumeric characters.<P>
128	The important thing to remember when naming your macro is to give 
129	it the same name as the resource or device in the category you want 
130	to control. For example, to create a Client Class macro for 
131	configuring a Ultra-5<small><sup>TM</sup></small> (which has the client class name 
132	<tt>SUNW,Ultra5_10</tt>), name your macro <tt>SUNW.Ultra5_10</tt>. 
133</td>
134	</tr>
135
136	<tr>
137	<td width=105 valign="top"><A NAME="option"><STRONG>Option</STRONG></A></td>
138	<td valign="top">The options and/or other macros included in the macro. You can add or delete options, and change the order of options in the list.<P>
139To browse a list of defined options, right-click in the
140Options column. Options are displayed by category and type.<P>
141To include a nested macro, enter Include in the Option column
142and then enter the name of the macro in the Value column.<P>
143To specify an option, enter the name of the option in the Option
144column, and the value of the option in the Value column. <P></td>
145	</tr>
146
147	<tr>
148	<td width=105 valign="top"><A NAME="order"><STRONG>Move Up/Move Down</STRONG></A></td>
149	<td valign="top">Click Move Up or Move Down to change the processing order of
150	options and nested macros. The processing order is significant, as options and 
151	macros processed last supersede conflicting values in those that are 
152	processed first. </td>
153	</tr>
154	
155	<tr>
156	<td width=105 valign="top"><A NAME="del"><STRONG>Delete</STRONG></A></td>
157	<td valign="top">Select an option and click Delete to remove it from the macro. </td>
158	</tr>
159
160
161	</table>
162
163<p>&nbsp;</p>
164<strong>Notify DHCP Server of Change:</STRONG> Check the box if 
165you want the DHCP server to reload the <tt>dhcptab</tt> after
166the changed macro information is written. Normally, you want 
167the server to reload the <tt>dhcptab</tt> so that clients
168start receiving the new configuration data immediately.  
169However, in some cases, you may want to delay this reload.
170For example, you may need to modify several macros in order for 
171configurations to be correct. <P>
172&nbsp;&nbsp;&nbsp;<A HREF="#top"><small>return to top</small></A>
173
174
175<p>&nbsp;</p>
176
177<!-- Don't go past this line! -->
178
179	</td>
180
181<!-- End topic block -->
182
183</tr>
184
185</table>
186
187<!-- End topic table -->
188</body>
189</html>
190