Assign distribution return codes

The Assign return codes dialog box is used to send status back to the core server based on whether or not a distribution task was successful.

Users have the option to add all possible return codes indicating success or failure or only add additional return codes that indicate success. In the instance that only success codes are added, any return codes not referenced in the template are automatically mapped as failures.

To use the Return code template manager
  1. Click Tools > Distribution > Distribution packages.
  2. On the Distribution packages toolbar, click the Return code template manager button.
  3. In the Return code template manager dialog, click Add, Modify, Delete, Import, or Export.
  4. Click Save.
To add a new return code mapping template
  1. Click Tools > Distribution > Distribution packages.
  2. On the Distribution packages toolbar, click the Return code template manager button.
  3. In the Return code template manager dialog, click Add.
  4. Enter a Template name and Template description.
  5. Select a Template filter type.
  6. Click OK.
  7. In the Package return code mappings dialog box, if you want to change the default message for success or failure, select a State and enter a corresponding Message for that state.
  8. Add a new mapping by clicking Add.
  9. At the bottom of the dialog box, enter the numeric return code or return code range.
  10. Enter a Message and select a State.
  11. Repeat steps 8-10 as necessary.
  12. Click OK. Your new template appears in the list.
To apply the return code mapping to a distribution package
  1. Click Tools > Distribution > Distribution packages.
  2. Double-click the package you want to modify.
  3. In the package properties tree, click Assign return codes.
  4. Click the return code template you want to apply.
  5. Click Assign.
  6. Click Save.