Functionality
To create policy groups while PCs are not managed by CS during the installation or before the connection, this command is used to upload multiple PCs to register in advance.
Record format
dtppcmst.exe | /s|/d /f File Name /e Error File Name |
Option
Specify upload (register, update), upload (delete) of PC list.
/s: upload (register, update)
/d: upload (delete)
Specify the file name of PC list to be uploaded, registered, updated or deleted.
When the path contains space, enclose the whole path in quotes. In addition, apart from the quotes, the maximum string of 128 fullwidth characters or 256 halfwidth characters can be specified.
For the PC list file, refer to "2.5.1 PC List File".
Specify the name of error file that outputs the error information. This option cannot be omitted.
The name of error file with extension ".dtl" cannot be specified as the file name.
Specify the error file with absolute path. When the path contains space, enclose the whole path in quotes. In addition, apart from the quotes, the maximum string of 128 fullwidth characters or 256 halfwidth characters can be specified.
Return value
0: ended normally
Other than 0: ended abnormally
Command saving location
The following folder in CS:
CS Installation Directory \bnserv\bin |
Authority required for execution/executing environment
Administrator authority is required.
This command must be executed on CS.
Cautions
If the output file has existed, overwrite it or delete it when an exception occurred. If the file created previously is required, modify the file name or move this file to another location before executing this command.
If exception occurs while uploading, the exceptional contents will become the error details file, and the error file with extension ".dtl" specified in /e option can be created.
Command execution example
When uploading the registered PC list:
"C:\Program Files\Fujitsu\Systemwalker Desktop Patrol\bnserv\bin\dtppcmst.exe" /s /fC:\mast\pcmst.csv /eC:\mast\err.csv |
Execution result/output format
The format of error file is in the same that of PC list file. By referring to the error details file (error file's extension is ".dtl"), and managing and modifying the corresponding position of the error file, for the Master data that failed to be registered, updated or deleted, the error file can be used for file uploading next time.
The error details file is shown in the following example:
Comment Line Comment Line 3, PC Name, Invalid Data 4, PC Name, Length of item is wrong |
File format
No. | Item | Description |
|---|---|---|
1 | Line Number | Line number of error file |
2 | Item | Item name of exceptional causes |
3 | Contents | Exceptional contents |
Error contents
Exceptional Contents | Cause | Resolution |
|---|---|---|
Integrity of double quotation marks | Double quotes are not used correctly to enclose the items. | Enclose each item with double quotes correctly. |
Invalid Data |
|
|
Length of item is wrong | The item length is not correct. Or though it is required item, the item record is still blank. | Confirm the item length and items, and modify it as correct ones. |
No Key Data | The user ID, section code or building code are not specified. | Confirm whether the item is correct and record the required items. |
No Corresponding Data | The item of update object and deletion object do not exist. | Confirm whether the items as deletion objects are correct. If it is no longer required, delete the corresponding line in the error file. |
Database Error | An exception may occur in the database. | Confirm whether an exception occurred in the database, and exclude the causes of exception. |
Repeat error | When the PC name and user ID specified in PC list file are the same as those collected in Inventory and as this PC has been managed, the PC cannot be registered. | Confirm whether PC name and user ID are incorrect, and if it is not required, delete the corresponding line in the error file. |
When the processing failed, a message indicating failure will be output. Refer to "3.3.5 Messages Output in PC Registration Command" for details.
