SETTINGS (EAS)
Syntax
IBM-Defined Synonyms
| Command or Operand | Synonym |
|---|---|
| MODIFY | F |
Purpose of Command
The SETTINGS command displays the current configuration settings for the requested Event/Automation Service task. The settings are displayed as console messages on the system console.
Operand Descriptions
- procname
- Specifies the Event/Automation Service job name.
- TASK=taskid
- Specifies the service task for which configuration settings are
to be displayed. The taskid can have the
following values:
- ALERTA
- The alert adapter service task.
- ALERTC
- The confirmed alert adapter service task.
- MESSAGEA
- The message adapter service task.
- MESSAGEC
- The confirmed message adapter service task.
- EVENTRCV
- The event receiver service task.
- TRAPALRT
- The trap to alert conversion task.
- ALRTTRAP
- The alert to trap conversion task.
- GLOBAL
- Display settings that are common for all services.
- ALL
- Display all settings.
Usage Notes
Consider the following when
using the SETTINGS command:
- The information returned for each service is dependent upon the
service itself. Nearly all of these settings are provided by default
if they are not explicitly provided through a startup parameter or
a configuration file statement. If the following immediately follows
the setting:
- (C)
- The setting was taken from a configuration file statement.
- (D)
- The setting was taken from the default.
- (P)
- The setting was taken from a startup parameter.
- The settings for each service are derived from the statements in the service configuration file. All of the service configuration file statements have default values, except for the ServerLocation statement.
- The configuration file used by each service can be specified either as a startup parameter or in the global configuration, or IHSAINIT, file.
- The global Event/Automation Service settings include the name of the global configuration file, the PPI value, and the OUTSIZE parameter value.
- Any settings that specify file names use the actual file name
instead of the exact value from the configuration file statement.
For example, if you have the
AdapterCdsFile=IHSAACDSstatement in the alert adapter configuration file, and data set NETVIEW.SCNMUXCL is provided on the IHSSMP3 data set definition statement in the Event/Automation Service startup procedure and contains member IHSAACDS, the actual value displayed by the SETTINGS command is as follows:NETVIEW.SCNMUXCL(IHSAACDS) (C) - The settings provided on the Filter and FilterCache statements are not followed by an indication of how the setting was provided. These settings can be provided only from an adapter service configuration file. If there are no Filter or FilterCache statements in this file, these settings are not displayed.
Restrictions
You can specify only one TASK operand. If you want to specify more than one service task, separate each task ID with a comma and enclose the string within parentheses.
Example: Showing the alert adapter settings
To
show the current alert adapter service settings, enter:
F IHSAEVNT,SETTINGS,TASK=ALERTAResponse
You
see a response similar to the following:
IHS0182I <==Current Alert Adapter Service Settings==>
IHS0183I CFG file : NETVIEW.SCNMUXCL(IHSAACDS) (D)
IHS0185I ServerLocation 1 = my.ip.hostname.com (C)
IHS0185I ServerPort 1 = 0 (D)
IHS0185I ConnectionMode = connection_oriented (D)
IHS0185I TestMode = no (D)
IHS0185I RetryInterval = 120 (D)
IHS0185I BufferEvents = yes (D)
IHS0185I BufferFlushRate = 0 (D)
IHS0185I BufEvtPath = /etc/Tivoli/tec/cache_nv390alt (C)
IHS0185I BufferEventsLimit = 0 (D)
IHS0185I BufEvtMaxSize = 64 (D)
IHS0185I BufEvtShrinkSize = 8 (D)
IHS0185I BufEvtRdblkLen = 64 (D)
IHS0185I EventMaxSize = 4096 (D)
IHS0185I AdapterCdsFile = NETVIEW.SCNMUXCL(IHSAACDS) (D)
IHS0185I FilterMode = out (D)
IHS0186I Filter 1 slots:
IHS0187I Class=SNA_Equipment_Malfunction;
IHS0187I source=filtersource;
IHS0187I severity=WARNING;
IHS0188I FilterCache 1 slots:
IHS0187I Class=SNA_Equipment_Malfunction;
IHS0187I source=filtersource;
IHS0187I severity=WARNING;The numeric value associated
with Filter or FilterCache settings is equivalent to the position
of the statement in the adapter configuration file, relative to the
other Filter or FilterCache statements in the file.Example: Showing the trap-to- alert service settings
To
show the current trap-to-alert service settings, enter:
F IHSAEVNT,SETTINGS,TASK=TRAPALRTResponse
You
see a response similar to the following:
IHS0182I <==Current Trap to Alert Conversion Service Settings==>
IHS0183I CFG file : NETVIEW.SCNMUXCL(IHSATCFG) (D)
IHS0185I NetViewAlertReceiver = NETVALRT (D)
IHS0185I PortNumber = 162 (C)
IHS0185I AdapterCdsFile = NETVIEW.SCNMUXCL(IHSATCDS) (D)Example: Showing the global Event/Automation Service settings
To
show the global Event/Automation Service settings,
enter:
F IHSAEVNT,SETTINGS,TASK=GLOBALResponse
You
see a response similar to the following:
IHS0182I <==Current E/AS Global Service Settings==>
IHS0183I CFG file : NETVIEW.SCNMUXCL(IHSAINIT) (D)
IHS0185I PPI = IHSATEC (D)
IHS0185I OUTSIZE = 0 (D)
IHS0185I ROUTECDE = 1 (D) 