Information Sources tab
Use the Information Sources tab to define where emitted business information is obtained by this capture specification.
This tab consists of a table of the business information items that you defined previously in the Event Binding tab. You must enter information sources for each item of emitted business information.
Use this tab to map the business information items that are associated with the event specification to available data items for this capture point.

The fields in the Information Sources table are a summary of the options you can edit in the Edit Information Source panel.
Edit Information Source panel for an application capture point
To open the Edit Information Source panel for an information source, either select an information source in the table and click Edit, or double-click the information source.
Available Date pane fields
- Context
- The context fields are used for capturing data about the application context. Valid context choices include:
- Event Options
- The event options are used to capture the values of options on a CICS command. The event options vary depending on the capture point specified.
- Application Data
- The predicates in the capture specification are used for filtering on application data specified in a CICS command. The application data varies depending on the capture point specified. Copybook import and formatting options on the right side of the Edit Information Source panel are only available when an item of application data is selected in the Available Data pane.
Click Select from imported language structure if you want to import a language structure. You can then select the field you want to capture from the language structure. If you use this method the Type, Offset, and Length fields are automatically completed. Alternatively, you can specify the Type, Offset, and Length values.
- Type
- Specifies the data type for the application data predicate. The
following data types are available:
- Binary Floating Point
- Character
- Character terminated by null
- Decimal Floating Point
- Hexadecimal
- Hexadecimal terminated by null
- Hexadecimal Floating Point
- Packed Decimal
- Signed Halfword
- Signed Fullword
- Unsigned Halfword
- Unsigned Fullword
- Zoned Decimal
- Offset
- Specifies the distance from the beginning, where the data starts. Offset 0 is the start of the field.
- Length
- Specifies the length of the field to be captured. Specify a length
of 0 to capture up to the end of the data area or container. Specifying
a length of 0 has the following effects:
- For API commands where the length of the data area is specified (or defaulted by the translator) in a separate argument on the API command, all the contents of the data area or container are captured regardless of its length. For example, where COMMAREA and LENGTH are specified on a LINK command, all the data is captured.
- For API commands where the data area being captured does not have a length argument, no data is captured. For example, where RIDFLD is specified on a READ command, or INTO is specified on a RECEIVE MAP command, there is no associated length argument, so 0 bytes of data are captured.
- Precision
- Select the precision for numeric and scientific business information items. This field is disabled for other business information items.
- Codepage
- Select a code page. This field is disabled for some business information items, such as application data coming from another source.
Edit Information Source window for a system capture point
To open the Edit Information Source panel for an information source, either select an information source in the table and click Edit, or double-click the information source. CICS knows the format for all the information sources.
- Context
- The context fields are used for capturing data about the system
context. Valid context choices include:
- TRANSID
- USERID
- System Event Data
- The System Event Data fields are used to capture data about the system event that occurred. The system event data varies depending on the capture point specified.
- Static data
- You can define static values of up to 255 characters, including
spaces. The valid character set is as follows:
A-Z, a-z, 0-9, `¬¦!"£$%^&*()_+-={}:@~;'#<>?,./|
Based on the options you select in the System Capture Point pane of the Capture Point tab, the following options are available in the Edit Information Source panel:
Information sources for DB2 CONNECTION STATUS
Option | Description |
---|---|
DB2ID | If you are not using group attach, this option returns the name of the DB2 subsystem that the CICS DB2 attachment is connected to, or if the CICS DB2 attachment is not connected, the name of the DB2 subsystem that you have specified for CICS to connect to. For more information, see DB2ID in INQUIRE DB2CONN. |
DB2GROUPID | If you are using group attach, this option returns the name of a data-sharing group, or subgroup, of DB2 subsystems that you have specified. For more information, see DB2GROUPID in INQUIRE DB2CONN. |
DB2RELEASE | Returns a 4-character value indicating the version and release level of the DB2 subsystem to which CICS is connected. For more information, see DB2RELEASE in INQUIRE DB2CONN. |
FROM_CONNECTST | A character string which represents the status
of the CICS DB2 connection. Possible values include:
For more information, see CONNECTST in INQUIRE DB2CONN. |
TO_CONNECTST | A character string that represents the status
of the CICS DB2 connection. Possible values include:
For more information, see CONNECTST in INQUIRE DB2CONN. |
Information sources for FILE ENABLE STATUS
Option | Description |
---|---|
FILE | Specifies the 8-character name of the file about which you are inquiring. For more information, see FILE in INQUIRE FILE. |
DSNAME | Returns the 44-character name of the BDAM data set or VSAM object associated with the FILE definition. For more information, see DSNAME in INQUIRE FILE. |
FROM_ENABLESTATUS | A character string identifying whether application
programs can access the file. Possible values include:
For more information, see ENABLESTATUS in INQUIRE FILE. |
TO_ENABLESTATUS | A character string identifying whether application
programs can access the file. Possible values include:
For more information, see ENABLESTATUS in INQUIRE FILE. |
OPENSTATUS | A character string identifying whether the
file is open, closed, or in a transitional state. The possible values
include:
For more information, see OPENSTATUS in INQUIRE FILE. |
Information sources for FILE OPEN STATUS
Option | Description |
---|---|
FILE | Specifies the 8-character name of the file about which you are inquiring. For more information, see FILE in INQUIRE FILE. |
DSNAME | Returns the 44-character name of the BDAM data set or VSAM object associated with the FILE definition. For more information, see DSNAME in INQUIRE FILE. |
FROM_OPENSTATUS | A character string identifying whether the
file is open, closed, or in a transitional state. The possible values
include:
For more information, see OPENSTATUS in INQUIRE FILE. |
TO_OPENSTATUS | A character string identifying whether the
file is open, closed, or in a transitional state. The possible values
include:
For more information, see OPENSTATUS in INQUIRE FILE. |
ENABLESTATUS | A character string identifying whether application
programs can access the file. Possible values include:
For more information, see ENABLESTATUS in INQUIRE FILE. |
Information sources for MESSAGE
Option | Description |
---|---|
MESSAGE_ID | Specifies the 9-character message number of the message about which you are inquiring. |
INSERTnn | Specifies the value of the INSERTnn for the message about which you are inquiring. Where nn is an insert identifier from 1 to 22. |
Information sources for TASK THRESHOLD
Option | Description |
---|---|
FROM_TASKS | Specifies the number of attached tasks before an event. |
TO_TASKS | Specifies the number of attached tasks after an event. |
MAXTASKS | Returns the maximum number of tasks that are eligible for dispatch at any one time in this CICS. For more information, see MAXTASKS in INQUIRE SYSTEM. |
PERCENT_MAXTASKS | Specifies the threshold that has been crossed as a percentage of maximum tasks. |
Information sources for TRANCLASS TASK THRESHOLD
Option | Description |
---|---|
TRANCLASS | Specifies the 8-character name of the transaction class about which you are inquiring. If the class is one of the numbered classes used in earlier releases of CICS, its name is DFHTCLnn, where nn is the 2-digit class number. For more information, see TRANCLASS in INQUIRE TRANCLASS. |
FROM_ACTIVE | Returns the number of active tasks in the transaction class before an even |
TO_ACTIVE | Returns the number of active tasks in the transaction class after an event. |
MAXACTIVE | Returns the maximum number of tasks that are allowed to run concurrently in the transaction class. For more information, see MAXACTIVE in INQUIRE TRANCLASS. |
PERCENT_MAXACTIVE | Specifies the threshold that has been crossed as a percentage of maximum active tasks. |
Information sources for UNHANDLED TRANSACTION ABEND
Option | Description |
---|---|
TRANSACTION | Specifies the transaction ID that issued the unhandled transaction abend. |
ABCODE | Specifies the 4-character transaction dump abend code. |
For more information, see Adding a capture specification.