AUTOMATE statement
The AUTOMATE statement enables and disables alert automation within BMC AMI Datastream.
Enabling AUTOMATE creates an Extended Multiple Console Support (EMCS) console, which can issue commands and return responses to the caller. Refer to the IBM Knowledge Center for more information about EMCS consoles.
The AUTOMATE statement is in the $$$AUTO member.
Using AUTOMATE
You can define only one AUTOMATE statement. The following are examples of how you configure the AUTOMATE statement:
Sample from $$$AUTO
PORT(49252) + ; Dynamic Port Number
TCPIPSTACK(TCPIP) + ; TCP/IP Stack Name
TLS(OPTIONAL) + ; TLS(REQUIRED | OPTIONAL)
THREADS(10) + ; Number of REXX threads 1-50
TIMEOUT(10) + ; Number of seconds until timeout
ENABLE + ; Enable AUTOMATE
; DISABLE + ; Disable AUTOMATE
DESCRIPTION('Alert Automation')
Statement parameters
AUTOMATE uses the following parameters:
Parameter | Description |
|---|---|
PORT(assignedListenerPort) | Port number of the alert notfication receiver The port used by BMC AMI Command Center for Security to notify BMC AMI Datastream of identified alerts. |
TCPIPSTACK(tcpipStack) | TCP/IP stack name Name of the TCP/IP stack used for network TCP/IP communications. Check with your z/OS administrator for this name. |
TLS(REQUIRED|OPTIONAL) | Binary option to require or not AT-TLS support
If you omit TLS, the default value OPTIONAL is used. |
THREADS(REXXExecThreads) | Number of REXX exec threads to create For use with XAPIID(LOCAL) only. Indicate the number of REXX exec threads (1–50) for BMC AMI Datastream to create. Each thread runs one automation alert. For systems that require more concurrent automation alerts, increase this value. If you omit THREADS, the default value 10 is used. If you specify a value of 0 for THREADS, the default value 1 is used. |
TIMEOUT(numberOfSeconds) | Number of seconds to wait For use with XAPIID(LOCAL) only . Indicate the number of seconds, from 1 to 999,999, to wait for the alert to be scheduled by BMC AMI Datastream. If you never want an alert to time out, enter 0 (zero). This option is useful if you have a low number of THREADS or a spike in automated alerts. If you omit TIMEOUT, the default value 10 is used. |
ENABLE|DISABLE | Enable or disable alert automation If you omit this parameter, the default value ENABLE is used. |
DESCRIPTION(‘automateTaskDesc’) | A 1–40 character string You must enclose the string in single quotation marks ( ’ ). It can be any meaningful description of the automation task. For example, you might want to use a description that distinguishes test automation from production alert automation. |