cscrepctl (Importing/ Exporting)

Format

cscrepctl [-h]
-user login-user-ID
-pass login-password
{-import file-name [-overwrite]
[{-check|-compo [{-name service-ID
|-namelist file-name-specifying-HCSC-components}] [-nouoc]}]
|-export file-name
|-autoexport
|-delete {-name service-ID
|-namelist file-name-specifying-HCSC-components}}

Function

Outputs the information from the repository to a ZIP file, and expands the information stored in the ZIP format to the repository. This command also enables you to delete the repository components.

By setting up default values for mandatory options, such as the login user ID, in the HCSC-Manager command definition file, you can omit the specification of these values in this command.

For details on how to use this command, see the following locations in the Service Platform System Setup and Operation Guide according to the purpose of use:

Arguments

-h

Displays the usage of commands. When you specify this option, all other options are ignored even if specified.

-user login-user-ID ~ <one-byte alphanumeric characters and underscores (_)> ((1 to 16 characters))

Specifies the user ID that is used to log in to HCSC-Manager.

-pass login-password ~ <one-byte alphanumeric characters and underscores (_)> ((1 to 16 characters))

Specifies the password that is used to log in to HCSC-Manager.

-import file-name ~ ((1 to 200 bytes))

Specifies the absolute or relative path for the ZIP file to be expanded.

-overwrite

Expands the HCSC components in the operating environment repository when the components are imported. This option is enabled when the -import option is specified.

-check

Checks whether the HCSC server configuration information is the same in the repository information for the current operating environment and the repository information to be imported. An error occurs if the HCSC server configuration information is different. This option is enabled when the -import option is specified. Do not specify this option for a standard import.

-compo

Imports the information for components.

-name service-ID ~ <one-byte alphanumeric characters and underscores (_)> ((1 to 8 characters))

Imports or deletes a business process or a service adapter with the specified service ID.

If you omit this option when specifying the -compo option, all the components will be imported.

-namelist file-name-specifying-HCSC-components ~ ((1 to 200 bytes))

Specifies the HCSC components you intend to import or delete in the HCSC component-specification file.

Specifies the file in an absolute or relative path. If the file does not exist, the command terminates abnormally. For details on the HCSC component-specification file, see HCSC component-specification file.

Note that the order of executing the specified HCSC components is not fixed.

-nouoc

Specify this option if you do not want to update UOC when each component is imported. UOC is the source, class, and library created independently by the user as a part of the HCSCTE project in the development environment.

You can specify this option only when you specify the -compo option.

-export file-name ~ ((1 to 200 bytes))

Specifies the name of the ZIP file to be output, expressed as an absolute or relative path. If the directory up to the specified file does not exist, the command terminates abnormally. If the specified file already exists, the file is overwritten. If the extension of the specified file is not .zip, then .zip is added.

-autoexport

Specify this option to output the ZIP file with the default file name. This option assigns the default file name in the following format:

aaabbbcccddd_YYYYMMDDhhmmss.zip

aaabbbcccddd:
Indicates the IP address of the machine that executed the command.
YYYYMMDDhhmmss:
Indicates the time of backup.
YYYY: Year, MM: Month, DD: Date, hh: Hour, mm: Minutes, ss: Seconds

You can specify the output destination in cscmng.properties (HCSC-Manager definition file). If the output destination is not specified, the ZIP file is output to the current directory.

-delete

Deletes the components with the specified service ID from the operating environment repository. After this option, specify the service ID you intend to delete in the options -name or -namelist.

If you delete a service by specifying this option, the services invoked from the other business processes are also deleted. Therefore, carefully select the service you intend to delete.

Examples of input

(1) To expand the contents of repository.zip to a repository

cscrepctl -user admin -pass admin -import repository.zip

(2) To output repository.zip containing the repository information to the current directory

cscrepctl -user admin -pass admin -export repository.zip

(3) To output with the default file name

cscrepctl -user admin -pass admin -autoexport

(4) To import the contents of repository.zip for each component

cscrepctl -user admin -pass admin -import repository.zip -compo

(5) To import all the HCSC components specified in the HCSC component-specification file hcsccomponent.txt, from among the repository.zip contents

cscrepctl -user admin -pass admin -import repository.zip -compo -namelist hcsccomponent.txt

(6) To delete the component with the service ID 1

cscrepctl -user admin -pass admin -delete -name 1

(7) To delete all the HCSC components specified in the HCSC component-specification file hcsccomponent.txt

cscrepctl -user admin -pass admin -delete -namelist hcsccomponent.txt

Return values

Return valueMeaning
0The command terminated normally.
1The command terminated abnormally.
3An exclusion error occurred.
9An error occurred when checking the execution permission.

Notes