new_nis_map

Use the new_nis_map command to create a new NIS map for the current zone and set the new NIS map as the currently selected NIS map in memory. The new NIS map has no map entries.

The new_nis_map does not save the new NIS map to Active Directory. To save the new map, you must use save_nis_map. If you don’t save a new NIS map, it will disappear when you select a new NIS map or when the ADEdit session ends.

Zone type

Not applicable

Syntax

new_nis_map [-automount] map

Abbreviation

newnm

Options

This command takes the following option:

Option Description

Option	Description
-automount	Specifies that the new NIS map is an `automount` map. For most NIS maps, the map name defines the type of map you are creating. For example, if you create a new NIS map with the name `netgroup`, it must be a NIS `netgroup` map and contain valid `netgroup` entries. However, you can specify any name for NIS `automount` maps. Use this option to identify `automount` maps that have a name other than `automount`.

-automount

Specifies that the new NIS map is an automount map.

For most NIS maps, the map name defines the type of map you are creating. For example, if you create a new NIS map with the name netgroup, it must be a NIS netgroup map and contain valid netgroup entries. However, you can specify any name for NIS automount maps. Use this option to identify automount maps that have a name other than automount.

Arguments

This command takes the following argument:

Argument Type Description

Argument	Type	Description
map	string	Required. Specifies the name of the new NIS map. For most NIS maps, the map name defines the type of map you are creating. For example, if you create a new NIS map with the name `netgroup`, it must be a NIS `netgroup` map and contain valid `netgroup` entries. For information about the type of NIS maps you can create, see theNetwork Information Service Administrator’s Guide.

map

string

Required. Specifies the name of the new NIS map.

For most NIS maps, the map name defines the type of map you are creating. For example, if you create a new NIS map with the name netgroup, it must be a NIS netgroup map and contain valid netgroup entries. For information about the type of NIS maps you can create, see theNetwork Information Service Administrator’s Guide.

Return value

This command returns nothing if it runs successfully.

Examples

The following command creates the NIS map “Printers” in the current zone.

new_nis_map Printers

Related commands

Before you use this command, you must have a currently selected zone stored in memory. The following commands enable you to view and select NIS maps:

get_nis_maps returns a Tcl list of NIS maps in the current zone.
list_nis_maps lists to stdout the NIS maps in the current zone.
select_nis_map retrieves a NIS map from Active Directory and stores it in memory.

After you have a NIS map stored in memory, you can use the following commands to work with that map:

add_map_entry or add_map_entry_with_comment adds an entry to the current NIS map stored in memory.
delete_map_entry removes an entry from the current NIS map.
delete_nis_map deletes the selected NIS map from Active Directory and from memory.
get_nis_map or get_nis_map_with_comment returns a Tcl list of the map entries in the current NIS map.
get_nis_map_field reads a field value from the current NIS map.
list_nis_map or list_nis_map_with_comment lists to stdout the map entries in the current NIS map.
save_nis_map saves the selected NIS map with its current entries to Active Directory.