REST API Reference > ParamSetCli utility > Using the ParamSetCli utility
  

Using the ParamSetCli utility

To use the ParamSetCli utility, type the runParamSetCli command followed by the arguments.
Use paramsetcli.bat runParamSetCli for Windows. Use paramsetcli.sh runParamSetCli for Unix-like operating systems.
For each action that you want to perform, you must specify the action type.

ParamSetCli utility arguments

You can use the following arguments in a ParamSetCli command:
Parameter
Argument
Description
username
-u
Required. The user name to log in to Informatica Intelligent Cloud Services.
password
-p
Required. The password or encrypted password string to log in to Informatica Intelligent Cloud Services.
baseUrl
-bu
Required. Informatica Intelligent Cloud Services MA service URL. Default is https://dm-us.informaticacloud.com/ma.
paramsetbaseUrl
-psbu
Base URL of Informatica Cloud Data Integration suffixed with active-bpel.
For example, https://na1.dm-us.informaticacloud.com/active-bpel
You can provide the paramset base URL in the restenv.properties file or you can pass it through the CLI using the -psbu argument. If it is available in both locations, the -psbu value in the action command takes precedence.
debug
-d
Optional. Displays debugging information.
insecure
-k
Optional. Enables the insecure mode.
action
-a
Required. Defines the action to be performed on the parameter set. You can specify one of the following actions:
upload- Upload a parameter set to the cloud-hosted repository by using the unique name. Optionally, you can specify the -f force argument to override the existing parameter set.
download- Download a parameter set from the cloud-hosted repository by using the unique name of an uploaded parameter set. If the specified file already exists on your local machine, the CLI does not download the parameter set. To forcefully download and overwrite the existing file, you can use the -f force argument.
list- List the parameter sets with basic information such as created by, creation date, parameter set name, parameter file name, and parameter directory available in the cloud-hosted repository.
delete- Permanently delete the specified parameter set from the cloud-hosted repository.
Force
-f
Optional. Enables you to force upload or download the parameter set.
Parameter Set Unique Name
-un
Required. A name used to identify a parameter set when performing different operations such as upload, download, or delete a parameter set, or use it in a taskflow. The name must be unique within the IICS organization.
Parameter directory
-pd
Specifies the directory where the parameter files are located.
Parameter file name
-pf
Parameter file name.
Parameter Set List Page
-page
Optional. Page number. Specifies the page number that you want to list.
Page size
-ps
Optional. Specifies the number of entries per page. The default and the maximum number of entries that you can list is 50 per page.

Running the ParamSetCli commands

You can use the following command to run an action using the action name.
paramsetcli.bat runParamSetCli -a <actionName>
You can perform different actions such as upload, download, and delete a parameter set and list all of the uploaded parameter sets. For each action, you must provide the -a argument and appropriate arguments specific to the action as shown below:
Upload a parameter set
You can use the upload action to upload a parameter set to the cloud-hosted repository. You can upload a file with a size up to 5 MB.
To upload a parameter set, use the following syntax:
paramsetcli.bat runParamSetCli -un <unique_param_set_name> -pf <parameter_file_name> -pd <parameter_directory> -a <action>
For example:
paramsetcli.bat runParamSetCli -un Paramset.params -pf Paramsetfile.params -pd C:\files -a upload
Here, -un, -pf, and -pd are mandatory arguments. If a parameter set already exists in the cloud-hosted repository, you cannot upload a parameter set with the same name. However, if you want to force an update of the content in the existing parameter set, you can use the -f force argument.
If you update the parameter set after uploading it to the cloud-hosted repository, you must reupload the parameter set for the changes to take effect.
After you run this command, the parameter set is uploaded to the cloud-hosted repository. The unique name of the parameter set is used in a taskflow to read the inputs.
Download a parameter set
You can use the unique name of an uploaded parameter set to download it from the cloud-hosted repository.
To download a parameter set, use the following syntax:
paramsetcli.bat runParamSetCli -un <unique_param_set_name> -pf <parameter_file_name> -pd <parameter_directory> -a <action>
For example:
paramsetcli.bat runParamSetCli -un Paramset.params -pf Paramsetfile.paramsDownload -pd C:\files -a download
Here, -un, -pf, and -pd are mandatory arguments. -pf specifies the file name with which you want to download the parameter set, and -pd specifies the directory where the parameter set is to be downloaded. If the specified file already exists on the local machine, the ParamSetCli utility does not download the parameter set. To forcefully download and overwrite the existing file, you can use the -f force argument.
After you run this command, the parameter set is downloaded to the specified directory.
Delete a parameter set
You can use the unique name of the parameter set to delete it from the cloud-hosted repository.
To delete a parameter set, use the following syntax:
paramsetcli.bat runParamSetCli -un <unique_param_set_name> -a <action>
For example:
paramsetcli.bat runParamSetCli -un Paramset.params -a delete
Here, -un is a mandatory argument.
After you run this command, the parameter set is permanently deleted from the cloud-hosted repository.
List the parameter sets
You can list the parameter sets that you have uploaded to the cloud-hosted repository.
To list the parameter sets, use the following syntax:
paramsetcli.bat runParamSetCli -a list
When you run the above command, the first page with 50 entries is listed. It displays basic information such as created by, creation date, parameter set name, parameter file name, and parameter directory for the parameter sets available in the cloud-hosted repository.
The default and the maximum number of entries that you can list is 50 per page. If you want a customized list, you can specify the page number and page size as per the requirement.
To customize the parameter set list, use the following syntax:
paramsetcli.bat runParamSetCli -a list -page <page_number> -ps <page_size>
For example: paramsetcli.bat runParamSetCli -a list -page <5> -ps <10>
Here, -page is the page number that you want to list and -ps is the number of entries you want to display on that page.
After you run this command, the fifth page with 10 entries are listed.