Configuring SMTP Mail - Intergraph Batch Services - Help

Intergraph Batch Services Help

Language
English
Product
Intergraph Batch Services
Search by Category
Help

You can configure Batch Services to notify you (or anyone you choose) about the status of your Batch jobs. SMTP mail is one method Batch Services can use to send job notification information. To use SMTP mail notification, your mail system must be able to handle SMTP mail. In some systems a program called an SMTP gateway provides this functionality. The gateway allows mail to be sent between users running various mail packages. Contact your mail administrator to see if your installation will support SMTP mail notification.

SMTP mail is the most convenient notification method supported by Batch Services, since it sends notification directly to you. The other notification method requires you to periodically check the event log for the information. To use the SMTP mail method, you must configure Batch Services to recognize the SMTP address to which you want to send notification mail.

There are two methods used to provide this information. The method you choose will depend on whether or not a direct SMTP address is available for the person to whom you want to send mail. For example, if your address is "jsmith@mymachine.b101.mycomp.com," you can use the direct method. If you want to use the address "jsmith@mycomp.com," an alias for the previous address, you must use the indirect method. Contact your mail administrator to determine which of these cases describes your mail situation.

Microsoft has enhanced security that changed the default behavior of controlled access to the Outlook automation code. The default is now to Prompt User that causes a dialog to appear on the server. Using the PDS Batch Mail Utility now displays the dialog prompting the user to confirm or cancel the email request. You must click Yes on the dialog prompt before the email will send. No remaining batch jobs will process until the acknowledgement is made.

Direct SMTP Mail Support

If you or the user(s) to which you want to send job notification have a direct SMTP address, no further configuration is necessary. Batch Services sends mail directly to those addresses.

Indirect SMTP Mail Support

If you or the user(s) to which you want to send job notification do not have a direct SMTP address, you must give Batch Services the location of your SMTP host (a computer that is running SMTP). This computer will be used to route the mail to the requested user for you. Ask your mail administrator for the name of your SMTP host computer and for the address of the person to whom you want to send job notification mail.

To notify the batch server of the name of your SMTP host, add the following information to the HKEY_LOCAL_MACHINE\SOFTWARE\Intergraph\Batch Service entry in the system registry:

Value Name:

SMTPhost

Type:

REG_SZ

String:

Any computer running SMTP

Stop and restart the Intergraph Batch Server service for this change to take effect. The SMTPhost computer will send any SMTP mail from the batch service.

Administrator privileges are required to configure the SMTPhost in the system registry.

Using Batch Manager:

  1. When submitting a job, select the Notification tab from the Job Submit dialog box.

  2. Key in the email address in the Address box.

  3. Click Add to add the address to the List box.

    SHARED Tip You can specify more than one email address.

  4. Complete the Job Submit dialog as appropriate for the job.

  5. Click OK.

Using the command line:

Use the qsub -M or -mu options when submitting the job.

Using the Batch API:

Edit the BATCH_JOB_INFO_2 structure and place the mail address(es) in element mailaddress.

Submit the job with the QueueBatchJob function.

See SMTP Mail in the Troubleshooting section for additional information.