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. To map the item, double-click the item, and the Edit Information Source window opens.

An image of the 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.

Edit Information Source panel for an application capture point

When you highlight an information source in the table and click Edit, the Edit Information Source panel opens.
Figure 1. This image shows the Information Source panel that you might see if REWRITE is selected for an application capture point.
An image of the edit information source panel for an application capture point.
The Available Data pane of the Edit Information Source panel 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 on the right side of the edit information sources panel are only available when an item of Application Data is selected in the Available data pane.
Based on the options you select in the Available Data pane of the Edit Information Source panel, the following fields are available in the remaining pane of the Edit Information Source panel:
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 the An image of the select from imported language structure button. button 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
The length of the field to be captured. A length of 0 means capture up to the end of the data area or container. This value is useful when emitting, for example, the contents of a container regardless of its length.
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

When you highlight an information source in the table and click Edit, the Edit Information Source panel opens. CICS knows the format for all the information sources.
Figure 2. This image shows the Information Source panel that you might see if FILE ENABLE is selected for a system capture point.
An image of the edit information source panel for a system capture point.
The Available Data pane of the Edit Information Source panel 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.

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

Table 1.
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 which 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.
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.
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 TASK THRESHOLD

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

Table 5.
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 two-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 6.
Option Description
TRANSACTION

Specifies the transaction ID that issued the unhandled transaction abend.

ABCODE

Specifies the four character transaction dump abend code.

For more information, see Adding a capture specification.