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.

Information sources tab

The fields in the Information Sources table are a summary of the options you can edit in the Edit Information Source panel.

Information Source dialog for an application capture point

To open the Information Source dialog for an information source, either select an information source in the table and click Edit, or double-click the information source.

The following example shows the Information Source dialog if REWRITE is selected for an application capture point.

Figure 1. Information Source dialog for an application capture point
Information Source dialog for an application capture point.

Available Data fields

The Available Data section contains the following fields:
Context
The context fields are used for capturing data about the application context. Valid context choices include:
PROGRAM
TRANSID
USERID
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 are available in the dialog only when an item of application data is selected in the Available Data section.
Depending on the options you select in the Available Data section, the following fields are available in Information Source dialog:
Container
Specifies a CICS channel container. The container field can be selected only when the application data has a channel specified. In all other situations, the field is disabled.

Click Select from imported language structure to import a language structure. You can then select the field you want to capture from the language structure. If you use this option, 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. For more information about code pages, see Coded Character Set Reference Material.
Static data
To pass unchangeable data to the event consumer, you can specify static data to be associated with an event. You can define static values of up to 255 characters, including spaces. The valid character set is as follows:

0-9 A-Z a-z `¬¦!"£$%^&*()_+-={}:@~;'#<>?,./|

Information Source dialog for a system capture point

To open the Information Source dialog 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.

The following example shows the Information Source dialog if FILE ENABLE is selected for a system capture point.

Figure 2. Information Source dialog for a system capture point
Information Source dialog for a system capture point
The Available Data section contains the following fields:
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
To pass unchangeable data to the event consumer, you can specify static data to be associated with an event. You can define static values of up to 255 characters, including spaces. The valid character set is as follows:

0-9 A-Z a-z `¬¦!"£$%^&*()_+-={}:@~;'#<>?,./|

The following tables list the fields that are available in Information Source dialog, depending on the system capture point that you selected in the System Capture Point pane of the Capture Point tab.

Information sources for DB2 CONNECTION STATUS

Table 1. 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:
  • CONNECTED
  • NOTCONNECTED
  • CONNECTING
  • DISCONNING

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:
  • CONNECTED
  • NOTCONNECTED
  • CONNECTING
  • DISCONNING

For more information, see CONNECTST in INQUIRE DB2CONN.

Information sources for FILE ENABLE STATUS

Table 2. 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:
  • DISABLED
  • DISABLING
  • ENABLED
  • UNENABLED
  • UNENABLING

For more information, see ENABLESTATUS in INQUIRE FILE.

TO_ENABLESTATUS
A character string identifying whether application programs can access the file. Possible values include:
  • DISABLED
  • DISABLING
  • ENABLED
  • UNENABLED
  • UNENABLING

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:
  • CLOSED
  • CLOSEREQUEST
  • OPEN

For more information, see OPENSTATUS in INQUIRE FILE.

Information sources for FILE OPEN STATUS

Table 3. 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:
  • CLOSED
  • CLOSEREQUEST
  • OPEN

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:
  • CLOSED
  • CLOSEREQUEST
  • OPEN

For more information, see OPENSTATUS in INQUIRE FILE.

ENABLESTATUS
A character string identifying whether application programs can access the file. Possible values include:
  • DISABLED
  • DISABLING
  • ENABLED
  • UNENABLED
  • UNENABLING

For more information, see ENABLESTATUS in INQUIRE FILE.

Information sources for MESSAGE

Table 4. Information sources for MESSAGE
Option Description
INSERTnn Specifies the value of the INSERTnn for the message about which you are inquiring, where nn is an insert identifier from 1 to 30.
MESSAGE_ID Specifies the 9-character message number of the message about which you are inquiring.
MESSAGE_TEXT Specifies the whole text of a message as an output field in an event. Use this option if you want to capture an entire message. The maximum length of the message text captured is 1024 bytes. If the message is longer than 1024 bytes, it is truncated.
Note: All messages will be captured in the language defined by the NATLANG system initialization parameter except messages sent to the CICS console, which will be captured in English.

Information sources for TASK THRESHOLD

Table 5. 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 system.

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

Table 6. 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

Table 7. 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.