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: Create 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> </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 <IMG SRC="art/tip2.gif" WIDTH=12 HEIGHT=10 BORDER=0 ALT="">Create<BR> 67 <a href="#name"><EM>Name</EM></a><BR> 68 <a href="#option"><EM>Option</EM></a><BR> 69 <a href="#order"><EM>Up/Down</EM></a><BR> 70 <a href="#del"><EM>Delete</EM></A><BR> 71 <A HREF="dhcp_macro_dup.html">Duplicate</A><BR> 72 <A HREF="dhcp_macro_mod.html">Modify</A><BR> 73 <A HREF="dhcp_macro_del.html">Delete</A><P> 74 75 <A HREF="dhcp_option_ref.html"><STRONG>Options</STRONG></A><P> 76 77 <A HREF="dhcp_main_how.html"><STRONG>How To..</STRONG></A><P> 78 <A HREF="dhcp_main_menus.html"><STRONG>Menus</STRONG></A><P> 79 <A HREF="dhcp_main_idx.html"><STRONG>Index</STRONG></A> 80 81 82 </td> 83 84 85 86 <!-- End contents block --> 87 88 <!-- Start column rule --> 89 90 <td colspan=1 width=5 bgcolor="#CCCCCC"> </td> 91 92 <!-- End column spacer --> 93 94 <!-- Start column spacer --> 95 96 <td colspan=1 width=10 bgcolor="#FFFFFF"> </td> 97 98 <!-- End column spacer --> 99 100 101 102 <!-- Start topic block --> 103 104 105 <td colspan=1 valign="top" bgcolor="#ffffff"> 106 <P> </P> 107 108 109 <h1>Create Macro</h1> 110 111 The Create Macro dialog box lets you to define a new macro in the <tt>dhcptab</tt> on the selected DHCP server. <p> 112 See <a href="dhcp_macros_about.html#using">Using Macros and Options 113 </a> for more information about defining DHCP macros.<P> 114 115 116 The settings available in the Create Macro dialog box are described below.<p> 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">Specify the name of the new macro. Remember, the name you choose determines the <A HREF="dhcp_macros_about.html#macrocat">macro category</a>. Macro names can be 125 a maximum of 128 alphanumeric characters.<P> 126 127 The important thing to remember when naming your macro is to give 128 it the same name as the resource or device in the category you want 129 to control. For example, to create a Client Class macro for 130 configuring an Ultra-5<small><sup>TM</sup></small> (which has the client class name 131 <tt>SUNW,Ultra5_10</tt>), name your macro <tt>SUNW.Ultra5_10</tt>. 132 </td> 133 </tr> 134 135 <tr> 136 <td width=105 valign="top"><A NAME="option"><STRONG>Option</STRONG></A></td> 137 <td valign="top">Specify the names of options and/or macros to include in the macro. The options or macros must 138 already exist in the <tt>dhcptab</tt>. If the option does not exist, you 139 can create it using the <A HREF="dhcp_option_create.html">Create Option</A> dialog box. 140 To browse a list of defined options, right-click in the 141 Options column. Options are displayed by category and type. 142 To view the list of standard options, see <A HREF="dhcp_option_tags.html">Standard Options</A>.<P> 143 144 To include a nested macro, enter Include in the Option column 145 and then enter the name of the macro in the Value column.<P> 146 To specify an option, enter the name of the option in the Option 147 column, and the value of the option in the Value column. <P></TD> 148 </tr> 149 150 <tr> 151 <td width=125 valign="top"><A NAME="order"><STRONG>Move Up/Move Down</STRONG></A></td> 152 <td valign="top">Click Move Up or Move Down to change the processing order of 153 options and nested macros. The processing order is significant, as options and 154 macros processed last supersede conflicting values in those that are 155 processed first. </td> 156 </tr> 157 158 <tr> 159 <td width=125 valign="top"><A NAME="del"><STRONG>Delete</STRONG></A></td> 160 <td valign="top">Select an option and click Delete to remove it from the macro. </td> 161 </tr> 162 163 164 </table> 165 166 167 168 <p> 169 <strong>Notify DHCP Server of Change:</STRONG> Check the box if 170 you want the DHCP server to reload the <tt>dhcptab</tt> after 171 the changed macro information is written. Normally, you will want 172 the server to reload the <tt>dhcptab</tt> so that clients will 173 start receiving the new configuration data immediately. 174 However, in some cases, you may wish to delay this reload. 175 For example, you may need to modify several macros in order for 176 configurations to be correct. <P> 177 178 <A HREF="#top"><small>return to top</small></A> 179 180 181 <p> </p> 182 183 <!-- Don't go past this line! --> 184 185 </td> 186 187 <!-- End topic block --> 188 189 </tr> 190 191 </table> 192 193 <!-- End topic table --> 194 195 </body> 196 </html>