Help Center


Knowledge Base


[DOC:Netmail Documentation]

Documentation for Netmail Archive 5.4.
Documentation for [Netmail Archive 5.3] and [earlier versions of Netmail] is also available.

Skip to end of metadata
Go to start of metadata


 On this page:

Describing a Job

Under Description, describe the job you are configuring. This may be helpful if you have multiple jobs of the same type (e.g., multiple archiving jobs).

Choosing a Policy

Under Policy, use the dropdown list to choose a policy that you created earlier from the list of available policies. If no policies appear in the list, you must create a policy as described in Policy Planning, Configuration, and Management. Click View if you want to review the criteria previously specified in the policy.

Note: If you are creating an Index Job, you do not need to select a policy. For more information, see Inheriting an Archive Job.

Selecting Job Priority

The Job Priority option allows you to assign a priority level to a job – high, normal (default setting), or low. With this setting, the JobManager process, which is responsible for allocating queued job threads to available thread slots on the archive nodes, selects from the queue according to the priority setting. As such, if a normal priority job is already running and using up all available job threads, setting your job to high priority and executing it will result in any freed threads being used for the new urgent job.The priority setting is useful only in scenarios where you need to have multiple jobs running concurrently and want to control which job takes priority with respect to thread allocation.

Scheduling a Job

The Schedule option allows you to specify when your job should be executed. You can schedule your jobs to execute automatically, either once only or on a regular basis, or you can execute your jobs manually, on demand.

  • Daily: To schedule a job to run automatically at a fixed time every day, set the time in hours and minutes (HH:MM) when you want your job to start, and then select the Daily option.
  • Weekly: To schedule a job to run automatically at a fixed time, but only on certain days of the week, set the time in hours and minutes (HH:MM) when you want your job to start, and then select the Weekly option. Select the day(s) of the week on which to run your job.
  • Specify Date: To schedule a job to run automatically at a specific time on a specific date, select the Specify Date option. Set the time in hours and minutes (HH:MM) when you want your job to start, and then click the calendar icon to choose the date (MM/DD/YYYY).
  • Disable: If you have not scheduled a job to run automatically, the Disable option is selected by default. This allows you to save the job while disabling any scheduled automatic executions.
  • Run Now: To manually trigger a job to run immediately, select the Run Now option, and click OK in the dialog box to confirm that you want to run the job now.

When you select the Run Now option for an Archive job, the dialog box also contains a Process only accounts which have failed on the last run option. If you select this option, any accounts that failed to be archived successfully during the Archive Job will be automatically re-processed within the same Archive Job. You will not need to rerun the entire Archive Job to process the failed accounts. Once the failed accounts have been processed, the Process only accounts which have failed on the last run option will be automatically unchecked (otherwise the Archive Job will continue to process only failed accounts during its subsequent runs).

Selecting Users

After you have scheduled a job to run at a specific time, you need to configure a list of user accounts that you wish to process as part of this job. The list of currently selected accounts is shown in the Users list on the job’s Job Settings tab.

Selecting Exchange Accounts for Archive and Utility Jobs:

For information on selecting Exchange accounts for Export, ILM, and Index Agent Jobs, see Selecting Exchange Accounts for Export, ILM, Index, and Migration Agent Jobs.

For Archive Agent Jobs and most Utility Agent Jobs, the accounts which are relevant to the job are the mail system accounts (i.e., Exchange accounts). The User List dialog box provides you with the ability to select Exchange accounts as follows:

1. Under Users, click Select.

2. In the User List dialog box that appears, click List Users to choose from a list of all of your Exchange mailboxes.

3. You can also use the available filters to customize the list of mailboxes that you will choose from. These filters are designed to simplify the process of selecting users. The following filters are available:

  • Domain: Choose the domain from which you want to select mailboxes, or use the default of ALL domains.
  • Mail Store: If you chose a specific domain, you can further narrow down your selection list by choosing the CAS server from which you want to select users, or use the default of ALL mail stores.
  • User ID Filter: Enter a user ID to locate a particular account or set of accounts. This option supports the use of wildcards (e.g., m* will list all accounts starting with the letter “m”).
  • Type: Choose All to view all accounts (i.e., users, resources, and distribution lists), or choose to view Users Only or Groups Only to narrow down the list. Journal only is an option used when Netmail Archive is deployed in a Exchange environment.

4. When you are satisfied with your filter specifications, click List Users.

Important: If no users appear in the User List when you click List Users, and you are creating a job using the Archive or Utility Agent, you need to update your Address Book cache. To update your Address Book cache refer to Updating the Address Book Cache.

5. Upon clicking List Users, a list of accounts based on your filter selections now appears in the left-hand pane of the User List dialog box. Click on a user ID to highlight the user, then click Add to add the user to your list of selected users. Your selected users will appear in the right-hand pane of the User List dialog box.

Note: You can select multiple users by holding down the CTRL key and clicking on multiple user IDs. You can also highlight the first user and while holding down the SHIFT key, highlight the last user in the range to select an entire range Alternatively, if you want to select all of the users in the left-hand pane, click All.

6. To remove a user from your list of selected users, highlight the user, then click Remove.

7. When you are satisfied with your list of selected users, click OK.

8. A list of selected users now appears under Users on the Job Settings tab. Review the list of users. If you want to exclude any users from the list, highlight the user name in the list, and click Remove.

9. When you are satisfied with your user selection, click Save at the bottom of the Job Settings tab.

Tip: It is possible to save your job without selecting users. You can create your job, save it, and then select users at a later time.

Selecting Archive Accounts for Export, ILM, Index, and Migration Agent Jobs

Export, ILM, and Index Agent jobs operate on data in the archive locations, not on accounts in your mail system. As such, the user selection for those jobs differ in that you are selecting archive folders to add to the job.

In this case, before selecting users you must first tell the job the storage location in which it should search for accounts (a job can only process accounts from one location). The selection of the source location is done on the Criteria tab of the job as described in the relevant sections of Netmail Archive Job Agents for Exchange.

Once you have selected the appropriate source location, those users whose have already been archived to that location will be available to you in the User List. If your user list does not accurately reflect your recently archived accounts, confirm that you have selected the correct location on the Criteria tab.

To select users:

1. Under Users, click Select.

2. In the User Selection dialog box that appears, click Load to choose from a list of all of the archive accounts in the specified source location.

Alternatively, you can use one of the three following options to select users:

  • Select Filter to customize the list of users that you will choose from. This filter is designed to simplify the process of selecting users. Enter a user ID to locate a particular user. The Filter option supports the use of wildcards.
  • Select DL to load users from a particular distribution list, and then choose a distribution list from the dropdown list. Distribution list based selection selects only those accounts which belong to the distribution list AND have archive data in the source location.
  • Select SSV file path if you want to specify a SSV file from which you want to pull users.

3. A list of archive accounts now appears in the left-hand pane of the User Selection dialog box. Click on a user ID to highlight the user, then click Add to add the user to your list of selected users. Your selected users will appear in the right-hand pane of the User Selection dialog box.

Note: You can select multiple users by holding down the CTRL key and clicking on multiple user IDs. You can also highlight the first user and while holding down the SHIFT key, highlight the last user in the range to select an entire range. Alternatively, if you want to select all of the users in the left-hand pane, click All.

4. To remove a user from your list of selected users, highlight the user, then click Remove.

5. When you are satisfied with your list of selected users, click OK.

6. A list of selected users now appears under Users on the Job Settings tab. Review the list of users. If you want to exclude any users from the list, highlight the user name in the list, and click Remove.

7. When you are satisfied with your user selection, click Save at the bottom of the Job Settings tab.

  • No labels
Write a comment…