Defining Lifecycle Processes › Define a Notify Process

Define a Notify Process

Note: The instances of Linux in this section refer to both the Linux and zLinux operating environments.

The Notify Properties dialog lets you define the process and specify defaults for various execution options. When the user invokes the process execution dialog, the user can override the default values.

The notify process uses standard MAPI or SMTP mail services to let you send a message to any combination of users and user groups. You can add this process to a state or link it to other processes so designated users are notified automatically during the execution of the parent process.

Linked processes execute before and after the initial notify process completes successfully.

Follow these steps:

1. Click the Lifecycles tab of the Administrator application, and expand the state in which you want to define the process.

   The Processes folder is listed in the workspace.

2. Right-click the Processes folder, and select New, Notify Process from the shortcut menu.

   The Notify Properties dialog appears.

3. Name the process and complete the dialog fields:

   Mail Utility

   Specifies a mail program and any arguments you want to supply when the program is invoked. On Windows clients, the server computer executes the mail program and must be in the path of the user who started the server.

   Default: mail

   Subject

   Specifies a default subject. This subject appears on the subject line of the email message when it is sent. Users can modify the content of this field when it is not set up as a linked process. For AIX and Linux operating systems, the Subject field cannot contain double quotes.

   Note: If you are using hsmtp.exe and define a subject separately in the hsmtp.arg file, do not include a value in this field.

   Mail Message

   Specifies a default mail message for the process. You can enter up to 2,000 characters. For example, if this process is going to be used to notify a manager that a package has been promoted, you can specify the appropriate message in this field. If the notify process is being linked to another process, you can use system variables in the messages to represent various parameters.

   Output

   Specifies a default action to be taken with any general or error outputs generated by the notify process. The choices are Display or Discard. All output is automatically appended to the output when the Display choice is selected.

   Users to Notify

   Specifies the users to receive the notification. You can add a user to the list by clicking Add, selecting the user, and clicking OK. You can delete a user from the list by selecting the user, and clicking Delete.

   User Groups to Notify

   Specifies the user groups to receive the notification. To be notified, users in the group must have use access to the project unless they are listed in the Users to Notify list. You can add a user group to the list by clicking Add, selecting the user group, and clicking OK. You can delete a user group from the list by selecting the user group, and clicking Delete.

   The process is defined.

4. Click Apply.

   Saves the process definition, but does not close the dialog.

5. Click the Access tab and set access for the process. Click OK.

   The notify process is added to the state and the process name appears in the Processes menu and in the title bar of the process execution dialog.

More information:

How to Set Up hsmtp