You use the MODIFY-MAIL-SERVICE-PARAMETER command to change different parameters of the ASTI service task. In particular, you can change the file that contains the configuration for the mail sender backend. You can also specify separate parameters for logging settings and assign values that differ from the contents of the configuration file. In this way, it is possible to change the logging files or the set of logging events dynamically without the need to change the configuration file.
Since the command works with the service task, the completion of the execution of the command may be delayed when the service task is lagging behind due to previous orders that have to be processed.
Domain
SYSTEM-MANAGEMENT
Privileges
TSOS
MODIFY-MAIL-SERVICE-PARAMETER |
CONFIGURATION-FILE = *UNCHANGED / <filename 1..54 without-gen> ,MAIL-LOG-FILE = *UNCHANGED / <filename 1..54 without-gen> ,TRACE-FILE = *UNCHANGED / <filename 1..54 without-gen> ,ASTI-TRACE-LEVEL = *UNCHANGED / *NONE / *ALERT / *CRITICAL / *ERROR / *WARNING / *NOTICE / *INFO / *DEBUG ,SMTP-TRACE-LEVEL = *UNCHANGED / *NONE / *ALERT / *CRITICAL / *ERROR / *WARNING / *NOTICE / *INFO / *DEBUG ,TLS-TRACE-LEVEL = *UNCHANGED / *NONE / *ALERT / *CRITICAL / *ERROR / *WARNING / *NOTICE / *INFO / *DEBUG ,SMIME-TRACE-LEVEL = *UNCHANGED / *NONE / *ALERT / *CRITICAL / *ERROR / *WARNING / *NOTICE / *INFO / *DEBUG ,OTHER-TRACE-LEVEL = *UNCHANGED / *NONE / *ALERT / *CRITICAL / *ERROR / *WARNING / *NOTICE / *INFO / *DEBUG |
Operand description
CONFIGURATION-FILE = *UNCHANGED / <filename 1..54 without-gen>
Specifies the file that contains the configuration options for the service task. You will find the contents of the file in the section “Configuration file for the mail sender backend”.
CONFIGURATION-FILE = *UNCHANGED
The name of the configuration file remains unchanged.
CONFIGURATION-FILE = <filename 1..54 without-gen>
Specifies the file that contains the configuration options for the service task. If the name of the configuration currently being used is specified, this file is read in again and any changes made to the file become effective.
MAIL-LOG-FILE = *UNCHANGED / <filename 1..54 without-gen>
Specifies the name of the file in which the mail send result is to be logged (see the mailLogFile option on "mailLogFile"). It is not possible to access the file when the mail service is running. To open the file, the assignment must therefore be made (temporarily) to another file.
MAIL-LOG-FILE = *UNCHANGED
The name of the mail logging file remains unchanged.
MAIL-LOG-FILE = <filename 1..54 without-gen>
Specifies the name of the file in which the mail send result is to be logged.
TRACE-FILE = *UNCHANGED / <filename 1..54 without-gen>
Specifies the name of the file in which diagnostic messages are to be logged (see the logFile option on "logFile"). It is not possible to access the file when the mail service is running. To open the file, the assignment must therefore be made (temporarily) to another file.
TRACE-FILE = *UNCHANGED
The name of the logging file remains unchanged.
TRACE-FILE = <filename 1..54 without-gen>
Specifies the name of the file in which diagnostic messages are to be logged.
ASTI-TRACE-LEVEL = *UNCHANGED / *NONE / *ALERT / *CRITICAL / *ERROR / *WARNING / *NOTICE / *INFO / *DEBUG
Specifies the filter level for the logging of diagnostic messages relating to ASTI actions (see the logLevel option on "logLevel").
SMTP-TRACE-LEVEL = *UNCHANGED / *NONE / *ALERT / *CRITICAL / *ERROR / *WARNING / *NOTICE / *INFO / *DEBUG
Specifies the filter level for the logging of diagnostic messages relating to the SMTP protocol (see the logLevel option on "logLevel").
TLS-TRACE-LEVEL = *UNCHANGED / *NONE / *ALERT / *CRITICAL / *ERROR / *WARNING / *NOTICE / *INFO / *DEBUG
Specifies the filter level for the logging of diagnostic messages relating to the TLS protocol (see the logLevel option on "logLevel").
SMIME-TRACE-LEVEL = *UNCHANGED / *NONE / *ALERT / *CRITICAL / *ERROR / *WARNING / *NOTICE / *INFO / *DEBUG
Specifies the filter level for the logging of diagnostic messages relating to S/MIME actions (see the logLevel option on "logLevel").
OTHER-TRACE-LEVEL = *UNCHANGED / *NONE / *ALERT / *CRITICAL / *ERROR / *WARNING / *NOTICE / *INFO / *DEBUG
Specifies the filter level for the logging of diagnostic messages relating to other actions (see the logLevel option on "logLevel").
Return codes
(SC2) | Maincode | Meaning |
0 | CMD0001 | No error |
1 | CMD0202 | Syntax error |
64 | CMD0216 | The user has no authorization for the command |
32 | CMD0220 | Internal error |
64 | YML0120 | The ASTI subsystem is not available |
64 | YML0130 | The configuration file cannot be read or does not exist |
64 | YML0131 | Error accessing file |
64 | YML0140 | The mail service is not running |
64 | YML0148 | The maximum order limit has been reached |
32 | YML0176 | Unexpected ASTI error |