SETTINGS (EAS)

Syntax

EAS SETTINGS

Read syntax diagramSkip visual syntax diagramMODIFY procname ,SETTINGS TASK=( ,taskid )

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=IHSAACDS statement 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=ALERTA

Response

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=TRAPALRT

Response

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=GLOBAL

Response

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)