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 111The Create Macro dialog box lets you to define a new macro in the <tt>dhcptab</tt> on the selected DHCP server. <p> 112See <a href="dhcp_macros_about.html#using">Using Macros and Options 113</a> for more information about defining DHCP macros.<P> 114 115 116The 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 138already exist in the <tt>dhcptab</tt>. If the option does not exist, you 139can create it using the <A HREF="dhcp_option_create.html">Create Option</A> dialog box. 140To browse a list of defined options, right-click in the 141Options column. Options are displayed by category and type. 142To view the list of standard options, see <A HREF="dhcp_option_tags.html">Standard Options</A>.<P> 143 144To include a nested macro, enter Include in the Option column 145and then enter the name of the macro in the Value column.<P> 146To specify an option, enter the name of the option in the Option 147column, 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 170you want the DHCP server to reload the <tt>dhcptab</tt> after 171the changed macro information is written. Normally, you will want 172the server to reload the <tt>dhcptab</tt> so that clients will 173start receiving the new configuration data immediately. 174However, in some cases, you may wish to delay this reload. 175For example, you may need to modify several macros in order for 176configurations 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> 197
