This command connects to the managing server (JP1/Software Distribution Manager) on the local computer and assigns the registered hosts to host groups in a single operation, according to the created policies.

dcmgpmnt.exe [processing-key] [/LC {ON|OFF}]

• processing-key
  This key specifies the type of policy to apply to the host groups. Specify one or more of the following processing keys after the command name. The default is NETM_ALLGROUP.
  
  • NETM_ALLGROUP
    Applies all the policies to the host group.
    
  • NETM_IPSCOPE
    Applies the policy Group by IP address to the host groups.
    
  • NETM_OSTYPE
    Applies the policy Group by OS type to the host groups.
    
  • NETM_USERINV
    Applies the policy Group by user inventory items to the host groups.
    
  You can specify NETM_IPSCOPE, NETM_OSTYPE, and NETM_USERINV in any combination. Use spaces to delimit each processing key. The default is NETM_ALLGROUP.
  Note that an error occurs and return code 2 is returned if any of the following specifications is given:
  
  • You specify NETM_ALLGROUP in combination with another processing key.
  • You repeat the same processing key.
• /LC
  Specify ON or OFF to indicate whether the command's processing is to continue after logging off from Windows when Task Scheduler or JP1/AJS is used to execute commands in the background.
  
  • ON
    Continues command processing even after logging off from Windows.
    
  • OFF
    Forcibly terminates command processing once Windows is logged off.
    
  This argument is effective when the command is executed from a service under any of the following OSs:
  
  • Windows 2000
  • Windows XP
  • Windows Server 2003 (excluding Windows Server 2003 (IPF))
  Do not specify /LC ON when you execute the command from the command prompt, because in this case the command is executed as a foreground program.
  You can use a registry setting to specify whether command processing is to continue after Windows is logged off. For details about the registry setting, see 4.6 Registry settings (JP1/Software Distribution Manager) in the manual Setup Guide.
  Note that operation may differ depending on the combination of the /LC specification and the registry setting. For details, see 4.28 Command operation at logoff that depends on a registry setting and logoff option.
  

The following explains the return codes that the dcmgpmnt command may return:

Code	Meaning	Action
0	Normal termination or no applicable hosts.	None.
2	Invalid value in command argument.	Check the values in the command argument.
3	Error during connection to managing server.	Check the version of the managing server.
12	Other errors occurred.	Check the event log.
15	Another process is updating the database.	Wait a while and then re-execute the command, or check the process that is updating the database.

If JP1/Base is linked to manage JP1/Software Distribution users, see 1.3.3 Setting for executing commands.

The following is an example of applying the policies Group by IP address and Group by user inventory items to the host groups.

dcmgpmnt.exe NETM_IPSCOPE NETM_USERINV