The IA Operations view shows a list of collectors that
are defined for an IA Collector connection. You must have at least
one IA Collector connection configured to work with collectors. Contact
your system administrator for details of the collector connections
to use.
- You can view collectors that are available from any current IA
Collector connection.
- You can change the state of collectors that are available from
any current IA Collector connection, for example, started, paused
or stopped.
- You can edit options for the command flow collector.
IA Collector connections are displayed in a tree structure, where
each top level represents a separate configured IA Collector connection.
For more information about creating a configuration and connecting,
see Configuring a CICS IA Collector connection.
For an IA Collector connection that is configured but is not currently
connected, only the name of the connection is listed.
For each currently connected IA Collector connection, the regions
and users are listed:
- The regions section shows all the regions that can be controlled
by the collector through that connection.
- The users section shows all users that are currently connected
to that connection.
You can have more than one current IA Collector connection, which
means that you can work with connections on multiple regions without
needing to change connections.
The state of the collector for the listed regions and users is
indicated by the color of the small round icon on each user and region
icon, as follows:
- Green: The collector for the region or user is running.
- Yellow: The collector for the region is paused.
- Red: The collector for the region or user is stopped.
- Gray: The state of the collector cannot be determined (for example,
the collector connection is not available, or the collector connection
is active but there is no such region defined).
When you select a region or a user, information about the selected
collector is displayed in the Properties view. If you are connected
to a CICS IA Version
3.2 or later database, the properties for the resource include the
Archive Date and Collection ID. If you are connected to a CICS IA 3.1 database, these properties
are not displayed.
Properties for a program or transaction are divided by collection
ID, for example a transaction in a collection. If you do not set a
search scope, all entries are displayed in the Properties view. When
you set a collection ID as a search scope, the properties display
this collection ID only. If there is no entry for this collection
ID in the properties table, no data is displayed.
Controlling the command flow collector
You
can use the icons in the toolbar to control the command flow collector
as follows:
- Start Collector. Start the collector if it is currently stopped.
- Stop Collector. Stop the collector if it is currently running.
- Pause Collector. Pause the collector if it is currently running.
This option is available for a region, but not for a user.
- Continue Collector. Start the collector running again if it is
currently paused. This option is available for a region, but not for
a user.
- Edit collector options. If the collector is currently stopped,
view or edit the command flow collector options for the currently
selected region, or your user ID. You cannot edit the command flow
options for another user.
- Refresh. Refresh the view.
To
stop or start the command flow collector for your user ID, right-click
your user ID and click Start Collector or Stop
Collector, respectively.
To view or edit the command flow
collector options for your user ID, ensure that the collector is stopped,
then use one of the following methods to open the command flow editor:
- Double-click your user ID.
- Right-click your user ID and click Edit collector options.
- Select your user ID, then click the Edit collector
options icon in the toolbar.
The command flow editor
If
the collector is currently stopped, you can use the command flow editor
to view or edit the command flow collector options.

You can use
the command flow editor to edit the following options for the command
flow for your user ID:
- Command Flow Options
- Command Flow ID: can be up to 16 characters in length.
- Traced Terminal ID: can be up to four characters in length, or
you can use an asterisk (*) to match any terminal ID.
- Traced user ID: can be up to eight characters in length.
- Records Before Stopping: the number of CICS IA journal records
collected before stopping. A value of 0 indicates that no limit is
applied.
- Tasks Before Stopping: the number of CICS tasks processed before
stopping. A value of 0 indicates that no limit is applied.
- Transaction Exclude List: can be up to eight characters (only
alphanumeric characters or the @, #, or $ characters). The name of
the list of transaction name prefixes to exclude. Data is not collected
for any transaction with a name that begins with a prefix in this
list.
- Program Exclude List: can be up to eight characters (only alphanumeric
characters or the @, #, or $ characters). The name of the list of
program name prefixes to exclude. Data is not collected for any program
with a name that begins with a prefix in this list.
- Journal
- Journal Copy Criteria: you can select LAST, USER,
or CFID (command flow ID).
- Application
- Application Filter: can be one of the following values:
- All Applications: the collector collects
data for all applications. This option disables the rest of the Application
fields.
- Specific Application: the collector saves
data for the specified application only. You can specify an application
name and its version.
- None: the collector ignores the application
filter. This option disables the Application fields.
- Application Name: can be up to 64 characters long. The name cannot
start with a space.
- Major/Minor/Micro versions: used to define the exact version of
application specified. The values must be in the range 0000 to 9999.
- Transaction List
- Transaction List: can be up to four characters in length.
- You can enter up to five separate transaction IDs.
- Misc
- Dynamic Call: you can select Y or N.
- User Exit Name: can be up to eight characters in length.
- Region Applid List
- These APPLIDs specify the regions where the command flow is started.
- You can enter up to 15 CICS APPLIDs.
Any text you enter is changed to uppercase characters. The values
are not checked for content, they are only checked for the number
of characters.
If you change a query but do not
save it, when you try and start your user ID, a warning is displayed
so that you can avoid the data loss. When the editor closes, a warning
is displayed and you can choose whether to restore the editor with
the unsaved changes, or ignore the warning and lose the changes.
You
cannot open the command flow editor when the collector is running;
the corresponding button is disabled automatically when it starts.
If the command flow editor is open and you can open the IA Operations
view and click start, a warning is displayed and you can choose whether
to stop the collector and save the command flow changes. You can use
the editor to change some values, but you cannot save the changes
until you stop the collector. If you attempt to save the changes while
the collector is still running, a warning message is displayed. Click Yes on
the warning message to stop the collector, or click No to
return to the editor.
The application filter
You
can select applications in the CICS IA plug-in as
you can on the host system with the CINT and CINC transactions. In
the command flow editor, set the Application Filter to Specific
Application and click the Application Filter button
. A window opens where you can select the applications you
require.
You can select an application from the list, or enter
a partial name in the Filter by Application Name field.
To further
refine your selection, you can also enter your requirements in the
optional fields Major version, Minor
version, and Micro version. The
matching applications are listed in the table. Select the appropriate
row and click OK.