Changing the order of tasks in a configuration profile (moveTask)

Use the moveTask command to change the position of a task in a configuration profile. The position of the tasks determines the order in which the tasks are run.

Command description

When you run the generateConfig command, the tasks are added to the myprofile.cfgp file in the default order. The moveTask command changes the position of the task in the myprofile.cfgp file that is located in your profile directory. The position of a task in the task list is important only when you run all of the tasks in the configuration profile.

To see the current order of tasks, use the listTask command. For more information, see Listing the tasks in a configuration profile (listTasks command).

moveTask command syntax

To run the moveTask command, use the following syntax:
configmgr_cl moveTask -task task_type | -taskfile task_file_name
 -position new_position 
 -profile myprofile 
[-silent] [-force] 
[-help]
Important:
  • Before you run the command, change to the configure subdirectory of the IBM® Content Navigator installation directory. The default location is:
    • AIX, Linux, and Linux for System z: /opt/IBM/ECMClient/configure
    • Windows: C:\Program Files\IBM\ECMClient\configure
  • Enter the command and parameters on a single line, without any line breaks.
  • The command name is not case-sensitive.
  • The parameter names and parameter values are case-sensitive.

Examples of use cases

The following examples show how you might use the moveTask command.

Change the position of the configureldap.3.xml file in a profile with more than one configureldap task.
The following command moves the configureldap.3.xml file in the myprofile profile directory to position 1:
configmgr_cl moveTask -taskfile configureldap.xml -position 1
-profile myprofile
Move the importltpakey task in the task list
The following command moves the importltpakey task from the default position of task 4 to task 1 in the myprofile profile. By moving this task to position 1 you configure LTPA security before running the rest of the tasks in the profile.
configmgr_cl moveTask -task configureloginmodules 
-position 5 
-profile myprofile

Command parameters

Specify the following parameters to run the moveTask command:
-task
Required: No. You can omit the -task parameter if you specify the -taskfile parameter.

Description: Specifies the type of task to move.

Valid values: To see a list of the tasks in your profile, use the listTasks command: 
configmgr_cl listTasks -profile myprofile
-taskfile
Required: Required if you have multiple configuration XML files for the specified task.

Description: Specifies which configuration XML file to move for the specified task. For example, if you have multiple LDAP configuration XML files in a profile, you can change the order in which the configuration files are run.

By default, the file name increments for each new file that is generated. For example, a second LDAP configuration file is named configureldap.2.xml.

-position
Required: Yes
Description: Specifies the new position of the task in the myprofile.cfgp file, which determines the order in which the tasks are run.
Tip: Use The listTasks command to see the current task order in the myprofile.cfgp file.

Valid values: An integer from 1 to n (where n is a number equal or greater than 2).

-profile
Required: Yes

Description: The fully qualified directory where the configuration XML files are located. When you specify the -profile parameter, the default location of the configuration XML files is ..\Program Files\IBM\ECMClient\configure\profiles or /opt/IBM/ECMClient/configure/profiles. If the profile directory is at this location, you only need to specify the name of the profile directory.

-silent
Required: No

Description: Runs the command silently, without any user interaction, which means that no prompts or informational messages are displayed on the console. Instead, the errors are written to the log files. Failure messages and validation error messages are displayed as needed, such as messages about missing passwords.

-force
Required: If the -silent parameter is used.

Description: Overrides the checks that the command runs. The task is forced to run without pausing to prompt you for required input or responses to validation error messages. The force parameter should always be used with caution; otherwise, it might result in the loss of data.

-help
Required: No

Description: Use the help parameter to get information about the command syntax, valid parameters, and values.