5.2.1 Organization Operation Commands

Command Name: fscsm_org

Format

fscsm_org create -file input-file

fscsm_org modify -file input-file

fscsm_org delete -orgId organizationID

fscsm_org export [-orgId organizationID] -file output-file

fscsm_org import [-check result-file] -file input-file

fscsm_org list

Description

Performs addition, modification, deletion, batch addition, batch modification, and output of organization information.

This command also checks the organization information of files to be added.

Subcommands

create -file input-file

Adds organization information.

In input-file, enter the name of the file containing the organization information to be added. For details on the format of the file, refer to "5.3.1 Organization Information".

modify -file input-file

Modifies organization information. Only the information of a single organization can be modified at one time.

In input-file, enter the name of the file containing the organization information to be modified. For details on the format of the file, refer to "5.3.1 Organization Information".

delete -orgId organizationID

Deletes organization information.

In organizationID, specify the ID of the organization to be deleted.

export [-orgId organizationID] -file output-file

Outputs organization information as an XML file.

-orgId organizationID can be omitted. If specified, only the information for that organization will be output. If not specified, the information for all organizations will be output.

In output-file, specify the file name using a character string containing alphanumeric characters, hyphens ("-"), underscores ("_"), and periods ("."). For details on the format of the file, refer to "5.3.1 Organization Information".

When the specified file already exists, an error occurs.

import [-check result-file] -file input-file

Performs batch addition and modification of organization information.

If -check result-file is specified, only the check of XML format, description format, and organization hierarchy information of the organization information to be added or modified is performed. To perform batch addition or modification, omit this parameter. If -check is omitted, when a failure of addition or modification is detected, the subsequent processes are not performed.

In result-file, enter the name of the file to which the check results will be output. If specified, the results of the check of input-file are output to the specified file. Specify an absolute path or a relative path.

In input-file, enter the name of the XML file containing the organization information to be added or modified as a batch. For details on the format of the XML file, refer to "5.3.1 Organization Information". If the specified organization information has not been added in Cloud Services Management, the information will be added. If the specified organization information has been added already, the information will be modified to the specified content.

If -check result-file is specified, the results of the check will be output in the following format:

"orgId, Result(Create/Modify/NotExist/Error)"

Create: New addition
Modify: Modification
NotExist: The information is not in the input file but has been added in Cloud Services Management.
Error:message: When there are errors in the input content, the error details are displayed using messages beginning with fscsm. For details and corrective actions, refer to "FUJITSU Software Cloud Services Management Messages".

If -check result-file is not specified, batch addition and modification will be performed. Execution results are output as files with the following names in the log folder:

fscsm_org_import_mmddhhmmss.log 
(mmddhhmmss: The month, date, hour, minute, and second when the command was executed)

Execution results of batch addition and modification are output in the following format:

"orgId, Result(Create/Modify/NotExist/Error)"

Create: New addition
Modify: Modification
NotExist: The information is not in the input file but has been added in Cloud Services Management.
Error:message: When there are errors in the input content, the error details are displayed using messages beginning with fscsm. For details and corrective actions, refer to "FUJITSU Software Cloud Services Management Messages".

list

Displays all added organization information in a prompt window.

The following items are displayed:

Organization Name
Organization ID
Organization Short Name
Description
Parent organization ID
When the displayed organization has no parent organization, this item will be blank.

Example

When adding organization information

>fscsm_org create -file addorg.xml<RETURN>

When modifying organization information

>fscsm_org modify -file updorg.xml<RETURN>

When deleting the organization information with organization ID 101
```
>fscsm_org delete -orgId 101<RETURN>
```
When outputting the organization information of A Unit (Organization ID 101) as a file
```
>fscsm_org export -orgId 101 -file orgdata_A.xml<RETURN>
```
When outputting all organization information as a file
```
>fscsm_org export -file orgdata_ALL.xml<RETURN>
```

When checking the target organization information for batch addition

>fscsm_org import -check resultAdata.txt -file orgdata_ABC.xml<RETURN>

When performing batch addition and modification

>fscsm_org import -file orgdata_ABC.xml<RETURN>

When outputting organization information to the screen

>fscsm_org list<RETURN>
orgName     orgId  orgAbbreviation   comment                    parentOrgId
-------------------------------------------------------------------------------------
A Unit      101    A Unit            Comments for A Unit        !root
B Unit      201    B Unit            Comments for B Unit        !root
C Unit      301    C Unit            Comments for C Unit        !root
D Division  10101  A)D Division      Comments for D Division    101