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>&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 <IMG SRC="art/tip2.gif" WIDTH=12 HEIGHT=10 BORDER=0 ALT="">Create<BR>
  67         &nbsp;&nbsp;&nbsp;&nbsp;<a href="#name"><EM>Name</EM></a><BR>
  68         &nbsp;&nbsp;&nbsp;&nbsp;<a href="#option"><EM>Option</EM></a><BR>
  69         &nbsp;&nbsp;&nbsp;&nbsp;<a href="#order"><EM>Up/Down</EM></a><BR>
  70         &nbsp;&nbsp;&nbsp;&nbsp;<a href="#del"><EM>Delete</EM></A><BR>
  71         &nbsp;&nbsp;<A HREF="dhcp_macro_dup.html">Duplicate</A><BR>
  72         &nbsp;&nbsp;<A HREF="dhcp_macro_mod.html">Modify</A><BR>
  73         &nbsp;&nbsp;<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">&nbsp;</td>
  91 
  92 <!-- End column spacer -->
  93 
  94 <!-- Start column spacer -->
  95 
  96         <td colspan=1 width=10 bgcolor="#FFFFFF">&nbsp;</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>&nbsp;</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 &nbsp;&nbsp;&nbsp;<A HREF="#top"><small>return to top</small></A>
 179 
 180 
 181 <p>&nbsp;</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>