This command includes three functions.

• WSUS synchronization
  This command function copies to a specified downstream WSUS server the WSUS computer group configuration and update approval status from the highest level WSUS server to which JP1/Software Distribution is connected. However, this command function does not register clients into a WSUS computer group.
  When synchronization is executed, updates that have been downloaded to the top-level WSUS server are transferred to the specified downstream WSUS server.
  
• Registering clients into a WSUS computer group
  On a downstream WSUS server, this command function registers clients into the WSUS computer group that has the same name as the specified host group. Of the clients included in the specified host group, only clients that are managed by the WSUS server on which the command was executed are registered into the WSUS computer group.
  If this command function is executed for the top-level WSUS server, a WSUS computer group with the same name as the specified host group is created. Any clients managed by the top-level WSUS server that are included in the specified host group are registered into the WSUS computer group that is created.
  
• Output of a list of clients registered in a WSUS computer group
  This command function outputs to a specified file a list of the clients that are registered in a specified WSUS computer group.
  

Performing WSUS synchronization

dcmwsus.exe SYNCHRONIZE /w URL-of-WSUS-server
                        /o full-path-of-execution-result-output-file
                        [/u user-name][/p password]
                        [/LC {ON|OFF}]

Registering clients into a WSUS computer group

dcmwsus.exe GROUP_CREATE /w URL-of-WSUS-server
                         /g name-of-host-group
                         /o full-path-of-execution-result-output-file
                         [/u user-name][/p password]
                         [/LC {ON|OFF}]

Output of a list of clients registered in a WSUS computer group

dcmwsus.exe CLIENT_LIST   /w URL-of-WSUS-server
                          /g name-of-WSUS-computer-group
                          /o full-path-of-execution-result-output-file
                          [/u user-name][/p password]
                          [/LC {ON|OFF}]

• /w
  Specify the URL of the WSUS server targeted by the command, as no more than 127 characters. The following shows the format for specification of a URL:
  http://name-of-WSUS-server[:port-number]/name-of-virtual-directory
  
• /o
  Specify the full path to the file to which the command's execution result is to be output.
  
• /u
  Specify a user name if authentication is required for connection to the WSUS server.
  
• /p
  Specify a password if authentication is required for connection to the WSUS server.
  
• /g
  For registering clients into a WSUS computer group, specify the host group name that matches the name of the target WSUS computer group.
  For output of a list of clients, specify the name of the target WSUS computer group.
  Note that when you register clients into a WSUS computer group, you cannot specify All Computers or Unassigned Computers, because these are the default WSUS computer groups.
  
• /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.
  

• If you are connected to the WSUS server that is specified in the /w option and you are performing operations in the Create WSUS Computer Group dialog box or the Update Program Authentication Settings dialog box, you cannot use the dcmwsus command to perform synchronization or client registration for that WSUS server.
• You cannot use the dcmwsus command to perform synchronization or client registration for a WSUS server on which the dcmwsus command is currently executing.
• Before you execute the dcmwsus command with GROUP_CREATE specified for a downstream WSUS server, you should first execute the dcmwsus command with SYNCHRONIZE specified to synchronize that downstream WSUS server with the top-level WSUS server.
• If the WSUS computer group is not created for the downstream WSUS server even after you have performed synchronization, an error may have occurred at the top-level WSUS or in the network. If this happens, check the following and take the appropriate corrective action:
  
  • The startup status of the top-level WSUS server
  • Whether an error has occurred at the top-level WSUS server
  • The upstream WSUS server that is specified at the downstream WSUS server
  • The status of the network between the WSUS servers
• You should perform WSUS synchronization on a regular basis, so that untransferred updates do not accumulate at the top-level WSUS server.
  As the number of updates not downloaded from the upstream WSUS server increases, the larger becomes the number of updates that must be downloaded when synchronization is executed and the longer it will take for the command to execute.
  
• Although the command will terminate normally if synchronization is re-executed while it is already executing, depending on the exact time the synchronizations are executed, the WSUS computer group configuration or update approval status may not be copied.

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

Code	Meaning	Action
0	The command terminated normally.	None.
2	Invalid value in command argument.	Check the values specified in the command arguments.
3	A connection to the specified WSUS server (WSUS Linkage) could not be established.	Check for the following to determine if there is a problem with the WSUS server or WSUS Linkage: Invalid URL for the WSUS server Problem with the startup status of the WSUS server Error at the WSUS server WSUS Linkage not installed Incorrect Microsoft .Net Frameworks configuration Incorrect Microsoft .Net Frameworks version Abnormality in the network between WSUS servers
4	Unable to open the result output file.	Check the result output file specification.
5	A communication error at a WSUS server (WSUS Linkage) occurred while processing was underway.	Check for the following to determine if there is a problem with a WSUS server: Problem with the startup status of a WSUS server Error at a WSUS server Abnormality in the network between WSUS servers
6	The specified group does not exist, an invalid character was specified, or too many characters were specified.	Check the group name specified in the arguments.
7	No computer group was created.	Check if a WSUS computer group was created for the top-level WSUS server. If one was created, perform synchronization. If one was not created, create a WSUS computer group for the top-level WSUS, and then execute synchronization. Wait a while, then re-execute the command.
8	An error occurred at a WSUS server.	Check the result output file.
12	Some other error occurred.	Check the event log.
13	The user name or password is invalid.	Check the specification of the user name and password.
15	Another process is currently performing processing targeting the WSUS server.	Wait a while, and then re-execute the command.

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

The following are examples of performing WSUS synchronization, of registering clients into a WSUS computer group, and of output of a list of clients registered in a WSUS computer group.

To perform WSUS synchronization:

dcmwsus.exe SYNCHRONIZE /w http://wssrv001:80/netmWS /o C:\temp\wsussync.txt

To register clients into a WSUS computer group:

dcmwsus.exe GROUP_CREATE /w http://wssrv001:80/netmWS /g Group1 /o C:\temp\wsuscreate.txt

To output a list of clients registered in a WSUS computer group:

dcmwsus.exe CLIENT_LIST /w http://wssrv001:80/netmWS /o C:\temp\wsuscltlist.txt