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, please enclose the whole path in quotes. In addition, apart from the quotes, the maximum string of 256 characters can be specified.
For the PC list file, please 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.
Please specify the error file with absolute path. When the path contains space, please enclose the whole path in quotes. In addition, apart from the quotes, the maximum string of 256 characters can be specified.
Return value
0: ended normally
Non-zero: 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.
Please execute on PC with CS installed.
Cautions
If the output file has existed, overwrite it or delete it when an exception occurred. If the file created previously is required, please 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, Incorrect Data 4, PC Name, Incorrect Item Length |
File format
No. | Item | Description |
|---|---|---|
1 | Line Nmber | Line number of error file |
2 | Item | Item name of exceptional causes |
3 | Contents | Exceptional contents |
Error contents
Exceptional Contents | Cause | Resolution |
|---|---|---|
Matching of double quotes | Double quotes are not used correctly to enclose the items. | Please enclose each item with double quotes correctly. |
Invalid data | The item number of data is insufficient. | Please confirm whether the item number is correct and record the required items. |
Incorrect item length | The item length is not correct. Or though it is required item, the item record is still blank. | Please confirm the item length and items, and modify it as correct ones. |
Incorrect data | Characters that are not allowed in items are contained. | Please confirm the items and modify to the characters that are allowed in items. |
Lack of key data | The user ID, section code or building code are not specified. | Please confirm whether the item is correct and record the required items. |
Lack of corresponding data | The item of update object and deletion object do not exist. | Please 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. | Please confirm whether an exception occurred in the database, and exclude the causes of exception. |
Repeated 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. | Please 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. Please refer to “3.3.5 Messages Output in PC Registration Command” for details.
