NMAPMGR(1M)

NAME
nmapmgr - NQS Machine Id manager program

SYNOPSIS
nmapmgr

DESCRIPTION
Nmapmgr is a program used by the NQS System Administrator or System Operator to control the Machine ID configuration at the local machine.

  Definitions
A MID is a Machine IDentifier, or a number used to identify a certain system in the NQS network. This is a 32 bit unsigned integer. NQS proceses the MID internally and maps to the ascii name through the MID database. Nmapmgr manages the database which provides the association of the Machine Names and Machine IDs. A Principal Name is the machine's primary name. This is usually its unqualified host name. An Alias is another name by which the system is known. This can be the fully qualified domain name of the host or another name for the host.

  MID Assignment Strategies
There are two strategies for assigning MIDs within a network. The first is to explicitly assign MIDs using a manual scheme and the second is to implicitly assign MIDs based on the IP numbers of the systems.

The first method requires that there be some coordination of MID assignment, usually by having a central administration that assigns MIDs as NQS is installed on various systems. MIDs are usually assigned starting at 1, and each new machine gets the next number. Alternatively, blocks of MIDs could be given to various groups. This method uses the Nmapmgr commands "Add Mid" to associate a Principal Name with a machine, and then "Add Name" to add an alias to a MID.

In the second method, the IP address of the host is used as the Machine ID. This method uses the Nmapmgr commands "Add Host" to add a Principal Name and MID to the database and "Add Alias" to add an alias to the MID. Since IP addresses are already assigned, there is no additional administration of Machine IDs required.

The two methods are not incompatable, as MIDs can be assigned by both methods. MID collisions are unlikely if manually assigned MIDS are small integers. If there are no outstanding reasons, such as for compatability with other versions of NQS, then for new installations it is probably easier to use the second method and assign MIDs based on IP numbers. One can convert from one method to another, but care must be taken to make sure that all references to the old MID (such as pipe queue destinations) are converted to the new.

  Commands
The following paragraphs describe the syntax of each Nmapmgr(1m) command. All command keywords are recognized regardless of upper or lower case usage. Keyword characters shown in uppercase indicate the smallest possible abbreviation of the keyword for the particular command being described.

Add Uid from_mid  from_uid to_uid
    Creates the mapping of the remote uid (from_uid) from the remote system (from_mid) to the local uid (to_uid). UID mapping is currently unimplemented in NQS.

Add Gid from_mid  from_gid to_gid
    Create the mapping of the remote gid (from_gid) from the remote system (from_mid) to the local gid (to_gid). GID mapping is currently unimplemented in NQS.

Add Alias name  principal-name
    Add an alias to the MID for the IP address of the principal name.

Add Host principal-name
    Create a MID for the principal name which is determined by its IP address.

Add Name name to_mid
    Add an alias to the MID indicated by the to_mid parameter. The to_mid is an integer. This command is used when Machine IDs are explicitly assigned.

Add Mid mid principal-name
    Explicitly associate a Machine ID with a system name. The mid is an integer. This command is used when Machine IDs are explicitly assigned.

Change Name mid new-name
    Replaces the principal name for the given Machine ID with the new name. However, this new name is not considered the principal name, but an alias. This is very risky to do.

Create
    Create the necessary files in NQS_NMAP so that Machine IDs can be added. Normally the empty database is created automatically the first time nmapmgr is invoked.

Delete Uid from_mid from_uid
    Delete the mapping of the remote uid (from_uid) from the remote system (from_mid). UID mapping is currently unimplemented in NQS.

Delete Gid from_mid from_gid
    Delete the mapping of the remote gid (from_gid) from the remote system (from_mid). GID mapping is currently unimplemented in NQS.

Delete DEFUid from_mid
    Delete the mapping for the default UID for requests from the given Machine. UID mapping is currently unimplemented in NQS.

Delete DEFGid from_mid
    Delete the mapping for the default GID for requests from the given Machine. GID mapping is currently unimplemented in NQS.

Delete Alias name
    Delete the indicated alias for its Machine ID. This command may be used no matter how MIDs were assigned.

Delete Host principal-name
    Delete the mapping for the indicated Machine ID. All information on that Machine ID is removed from the database.

Delete Name name
    Delete the indicated Principal Name or alias. If the Principal Name is deleted while aliases remain, a listing will indicate that the Principal Name is not in the machines file.

Delete Mid mid
    Delete the mapping for the indicated Machine ID. All information on that Machine ID is removed from the database.

Exit
    Exit from the NQS Nmap manager subsystem.

Get Uid from_mid from_uid
    Print the local UID associated with the remote Machine ID and UID pair. UID mapping is currently unimplemented in NQS.

Get Gid from_mid from_gid
    Print the local GID associated with the remote Machine Id and GID pair. GID mapping is currently unimplemented in NQS.

Get Mid name
    Display the Machine ID corresponding to the indicated name.

Get Name mid
    Print the Principal Name for the indicated Machine ID.

Help
    List a one-line summary of each of the Nmapmgr commands.

List
    Display all known systems in Machine ID order, giving the MID, Principal name, and any aliases.

Quit
    Synonym for exit.

Set Nfds #-of-file-descrs
    Adjust the number of file descriptors Nmapmgr uses. This command has never been used to my knowledge.

Set DEFUid from_mid defuid
    Set the mapping for the default UID for requests from the given Machine. UID mapping is currently unimplemented in NQS.

Set DEFGid from_mid defgid
    Set the mapping for the default GID for requests from the given Machine. GID mapping is currently unimplemented in NQS.

Show
    Synonym for list.

Version
    Display the current Nmapmgr version.

SEE ALSO
qmgr(1)
in the NPSN UNIX User Reference Manual.

NPSN HISTORY
Origin: Sterling Software Incorporated

August 1994 - John Roman, Monsanto Company
Release 3.36.