Use the Command Flow Editor to edit
the command flow collector options for your currently connected user
ID. The collector must be in the Stopped state.
To open the Command Flow Editor, double-click
your user ID, or select the Edit collector options icon, from the IA Operations view.
The command flow editor
If the collector is 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 8 characters in length.
- Traced Terminal ID: can be up to 4 characters in length, or you can use an asterisk (*) to match
any terminal ID.
- Traced user ID: can be up to 8 characters in length.
- Records Before Stopping: the number of CICS IA journal records collected before it stopped. A
value of 0 indicates that no limit is applied.
- Tasks Before Stopping: the number of CICS tasks that are processed before it stopped. A value of
0 indicates that no limit is applied.
- Transaction Exclude List: can be up to 8 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 8 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 - 9999.
- Transaction List
- Transaction List: can be up to 4 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 8 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 that 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 to 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 that 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.