–cq “parameter=value; . . . ” Specify connection parameters for the stable queue. This option applies to Adaptive Server Enterprise only. If not supplied, the values default to the -cvalues.

–dlDisplay messages in the Message Agent window or at the command prompt and also in the log file if specified.

Specify encryption key (–ek)This option allows you to specify the encryption key for strongly encrypted databases directly at the command prompt. If you have a strongly encrypted database, you must provide the encryption key to use the database or transaction log in any way, including offline transaction logs. For strongly encrypted databases, you must specify either -ekor -ep, but not both. The command will fail if you do not specify a key for a strongly encrypted database.

Prompt for encryption key (–ep)This option allows you to specify that you want to be prompted for the encryption key. This option causes a dialog box to appear, in which you enter the encryption key. It provides an extra measure of security by never allowing the encryption key to be seen in clear text. For strongly encrypted databases, you must specify either -ekor -ep, but not both. The command will fail if you do not specify a key for a strongly encrypted database.

–elocale-stringThis option applies to Adaptive Server Enterprise only. Specify Adaptive Server Enterprise locale information. The locale string has the following format:

"language_name,charset_name[,sort_order]"

By default, the Message Agent uses the default locale, which is defined in the file sybase\locales\locales.dat.

If language_name and charset_name are not supplied, the Message Agent obtains them from Adaptive Server Enterprise. If sort_order is not supplied, the Message Agent uses a binary sort order (sort by byte value).

–fqThis option is for use only with Adaptive Server Enterprise. It permits a full scan of the stable queue when sending messages, starting from the oldest confirm_sent value in the sr_remoteuser table.

This feature is intended for occasional use to clean out a large stable queue. If, for example, a single user has not confirmed receipt of a message from a long time ago, the stable queue may be very large. However, by running -fqyou can delete entries from more up-to-date users that have been confirmed, even though they are more recent than the cutoff value at which entries are deleted by default.

–gnInstructs the Message Agent to group transactions containing less

296

Page 314
Image 314
Sybase DC38133-01-0902-01 manual Languagename,charsetname,sortorder