nmapmgr(1)


          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
          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 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
               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

          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.