Functionality
This command can perform upload and download in [Environment Setup] - [User Management] and [Section Management] of main menu.
Record format
dtpmast.exe | /s|/d|/g /m Type /f File Name [/e Error File Nameļ¼½ |
Option
Specify upload (register, update), upload (delete) or download of Master data.
/s: upload (register/update)
/d: upload (delete)
/g: download
Specify the type of Master data.
e: user management information
g: section management information
b: building management information
Specify the name of the file to be uploaded during uploading (/s, /d), and specify the name of the file to be output during downloading (/g).
Please specify the output file with absolute path, and 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.
Specify the name of error file that outputs the error information.
The name of error file with extension ".dtl" cannot be specified as a file name.
When uploading (/s, /d), this option cannot be omitted. In addition, when downloading (/g), this option is not required and invalid when specifying.
Please specify the error file with absolute path and when the path contains space, please enclose the whole path in quotes. In addition, apart from 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
Please execute by using user with Administrator authority.
Please execute on PC with CS installed.
Cautions
If the output file has existed, overwrite it or delete it when an exception occurs. When the file created previously is required, please modify the file name or move this file to another location before executing this command.
If an exception occurs while uploading, the exceptional contents become a error details file and the error file with extension ".dtl" is created by specifying the /e option.
The output order of error files when uploading the section management information may be different from the input order of the Master data file.
Command execution example
When downloading user management information to C:\mast\emp.csv
”C:\Program Files\Fujitsu\Systemwalker Desktop Patrol\bnserv\bin\dtpmast.exe” /g /me /fC:\mast\emp.csv |
Execution result/output format
The format of error file is in the same format of Master data 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 example of error details file is shown as follows:
Comment line Comment line 3, User Name, Error Data 4, E-mail Address, Incorrect Item Length |
File format
No. | Item | Decription |
|---|---|---|
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 |
|---|---|---|
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. |
Incorrect scope | The section level is over 100. | Including management targets, please modify section level to be less than 100. |
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. |
Excluded from the object | Specify the section code of a object that is registered or updated in the upstream section. | Please confirm the upstream section code and modify it as the correct one. |
Section level circulation error | The section level is specified as a circle. | Please confirm the upstream section code and modify it as the correct one. |
PC error | The PC Inventory has existed on PC of user management to be deleted, so it cannot be deleted. | Please confirm the users to be deleted and then modify them as correct users. Normally, please delete Inventory of PC as required. |
Current License error | The License has existed on PC of user management to be deleted, so it cannot be deleted. | Please confirm the users to be deleted and then modify them as correct users. Normally, please delete Inventory of PC when it is required to delete License first. |
Outside of the bottom | Prepare to delete the section outside of the bottom. | The subordinate sections of the deletion object should also be added to the deletion target list. |
Unable to delete | Prepare to delete system account user, or there is no authority for deleting the object section. | Unable to delete a system account user who manages user information. Please delete it after modifying the account as a section management account or a user account. In addition, please confirm whether the section of deletion object is 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. |
Unable to update | Prepare to update or delete a user ID that is logging on. | Please try again after the user logs off or wait a while. |
When the processing failed, a message indicating failure will be output. Please refer to “3.3.1 Messages Output in Master Data Construction Command” for details.
