Event Configuration Options (CA 7 Server for iDash)
These statements are available for Event Configuration options in the CA 7 Server for iDash address space.
ca712
These statements are available for Event Configuration options in the CA 7 Server for iDash address space.
The IDASHEV member defines CA 7 Server for iDash event configuration options that are used in the CA 7 Server for iDash address space for the CA 7 Web Services when processing events.
All these options are applicable to all CA 7 instances being monitored and are defined in the CAJFPARM(IDASHMN) member.
- CAPTURE(Optional) Indicates whether a capture table is used for CA 7 Web Services events. All CA 7 instances that are selected for processing process all events that are captured. For more information, see the MONITOR Statement.The keyword value must contain the number of entries to hold in the capture table. The value must be numeric and between a value of 100 and 10000.A value of zero indicates that an events capture table is not used.Default:1000Example: CAPTURE statementCAPTURE(1000)
- DURABLE(Required) Determines whether to allow durable subscriptions. Durable subscriptions are subscriptions that are saved on a disk in a USS file directory. CA 7 Server for iDash loads them into memory each time it is started. This setting should not be changed from the YES value. If it is changed, CA 7 Server for iDash does not accept subscriptions from CA Workload Automation iDash.
- YESIndicates that durable subscriptions are allowed. This keyword also requires that options PATHNAME and SUBSCRIBE(YES) are set. Refer to these keywords for more information.Example: DURABLE statementDURABLE(YES)
- GUARANTEED(Required) Indicates whether CA 7 Server for iDash attempts to ensure the delivery of events to a client that is subscribed to a durable subscription. This setting should not be changed from the YES value. If it is, CA 7 Server for iDash does not accept subscriptions from CA Workload Automation iDash.This guarantee means that:
- The package of captured events is successfully sent to the client using TCP/IP.
- A zero return code from the function was received.
- An HTTP response of 200 was received from the send operation.
- YESIndicates that CA 7 Server for iDash attempts to ensure the delivery of events to a client that is subscribed to a durable subscription. This keyword requires that the DURABLE(YES) keyword option is also selected. For more information, see the DURABLE and SUBSCRIBE keyword descriptions.
Example: GUARANTEED statementGUARANTEED(YES)
- MAXEVENTS(Optional) Indicates the amount of memory that each subscription uses. This value is the maximum number of events that any one subscription can monitor.The MAXEVENTS value must be numeric and between a value of 100 and 1000000.Default:1000Example: MAXEVENTS statementMAXEVENTS(1000)
- MAXSUBS(Optional) Indicates the number of subscriptions allowed.The MAXSUBS value must be numeric and between a value of 0 and 1000. If SUBSCRIBE(YES) was specified, the value of MAXSUBS must be greater than zero.Default:100Example: MAXSUBS statementMAXSUBS(100)
- MAXUPDATES(Optional) Specifies the maximum number of update events that are allowed per notification to iDash based on how many CA 7 database definition retrievals iDash requests.The MAXUPDATES value must be numeric and between a value of 1 and 1000.Default:100Example: MAXUPDATES statementMAXUPDATES(100)
- PATHNAME(Required) Specifies the absolute USS path name where durable subscriptions are stored. This keyword is required when DURABLE(YES) is specified.The USS path name must be predefined. If this option is used, the path name that is specified must contain 1-63 characters in length and can be specified in mixed-case.CA 7 Server for iDash saves each durable subscription in this directory when requested by a web service client when a durable subscription is processed. Each durable subscription is saved in this directory and is suffixed with “.xml”.When CA 7 Server for iDash is started, all durable subscriptions are read from this directory and are stored in memory.This directory is for the exclusive use of CA 7 Server for iDash for the sole purpose of storing and retrieving durable subscriptions. Do not store other files in this directory.Example: PATHNAME statementPATHNAME(/u/users/JobflowMonitorDurableSubscriptions/)
- SUBSCRIBE(Required) Indicates whether to allow subscriptions. Do not change this setting from the ‘YES’ value. If it is changed, CA 7 Server for iDash cannot accept subscriptions.
- YESIndicates that subscriptions are allowed. This option enables the use of options MAXEVENTS, MAXSUBS, and DURABLE. For more information, see these keyword descriptions.
Example: SUBSCRIBE statementSUBSCRIBE(YES)