To define an Application Group:
This displays the Resource Definitions Menu, where you can choose to define either Resource Lists, Application Groups or Performance Alerts.
File Options Help -------------------------------------------------------------–--–--- Resource Definitions Menu Command ===> ______________________________________________________ Select an option then press Enter. 2 1. Resource Lists Define Resource Lists 2. Application Grouping Define Application Groups 3. Performance Alerts Define Performance Alerts HDB Register . . . 'CICSPA.HDB.REGISTER'_________________________ +
If you have not yet defined an HDB Register, you can do so from here. Specify the name of an existing HDB Register, or if you specify a new data set name, CICS PA prompts you to create a new register. For details, see HDB Register.
Otherwise, select option 2 Application Groups to display the Application Groups panel:
File Options Help -------------------------------------------------------------–--–-------------- Application Groups Row 1 to 1 of 1 Command ===> ________________________________________________ Scroll ===> PAGE Select to edit Application Group (APG). Enter NEW command to define a new APG. / Name Description Changed ID _ BUSFUNC Business functions 2008/05/06 12:46 GXH ******************************* Bottom of data ********************************
An Application Group name consists of 1-8 characters. The first character must be an alphabetic character (A-Z) or a national character (@, #, or $). The remaining characters can be alphabetic, national, or numeric (0-9) characters. Do not specify a name that matches a CMF field name or the leading characters of a CMF field name. For example, do not specify APP, because it matches the leading characters of the CMF field name APPLID, among others. However, APPG is valid.
Report or extracts for this Application Group will contain a column heading consisting of the Application Group name followed by the word "Group".
To edit an existing Application Group, enter line action S next to the Application Group.
File Edit Confirm Lists Options Help -------------------------------------------------------------–--–------------- EDIT Application Group - BUSFUNC Row 1 to 2 of 2 Command ===> ________________________________________________ Scroll ===> PAGE Description . . . Business functions__________________ Resource field . . TRAN____ + User field offset ___ Length ___ Specify the Application names and their resource values. ------------ Resources ------------- / Application Name Values List + _ Statistics collection $*______________ (2) ________ _ Accounting A*______________ ________ _ CICS-supplied transactions ________________ CICSTRAN _ Delivery D*______________ ________ _ Finance F*______________ ________ _ Unassigned transactions *_______________ ________ ******************************* Bottom of data ********************************
Before adding Applications to an Application Group, you must specify the resource field whose values will define the Applications. All Applications in an Application Group must refer to values of the same resource field, such as the CICS® transaction ID (TRAN).
The order of the Applications on this panel is significant. Reports or extracts associate input records with the first matching Application. In the following example, Application B never appears in a report, because input records always match Application A first:
Application Name Values
Application A AP*
Application B APB*
To enable matches with Application B, you would move Application B above Application A in the list. Report rows that do not match any Application contain *noapg* in the Application Group column. To specify a different label for these rows, insert an Application name at the end of the list, such as "No match" in the example above, with a single asterisk (*) as its value:
Application Name Values
Application B APB*
Application A AP*
No match *
This Application matches any records that have not already matched an Application in the list. If you do not want these rows to appear in a report, then, when requesting the report, specify selection criteria either to only include records that match the Applications or to exclude records that do not match any Application.
The Application Group details are:
To select from the list of predefined fields, press Prompt (F4). If you specify a user field name, you must also specify an offset and a length, indicating the part of the field you want to compare with the Application values.
If you specify a predefined CMF field in Resource field you cannot specify an offset or a length. The entire field value is always compared with the Application values.
or
The Values column shows only the first value of an Application. You can edit the first value directly in the Values column. If an Application has more than one value, the number of values appears in parentheses (n) next to the first value. To edit these other values, enter line action S. This displays the Value List panel, showing all of the values for the Application:
Command ===> ____________________________________________________________
Application Name: Statistics collection
Specify Resource Values.
$*______________ #*______________ ________________ ________________
________________ ________________ ________________ ________________
________________ ________________ ________________ ________________
________________ ________________ ________________ ________________
If more than 16 values are required, you must use a Resource List.
Press END (F3) to save the values, CANCEL (F12) to abort.
Masking characters % (exactly one character) and * (any number of characters) are allowed. For example, specify TR* to match all values starting with TR. To specify a null value, specify two single quotes ' ' or '' .
You can specify up to 16 individual values for an Application. If you need to specify more than 16 values for an Application, define and refer to a Resource List (see below).
To select a Resource List, press Prompt (F4).
To define a Resource List, select Lists in the action bar. After defining the Resource List, you return to this Application Group panel, so that you can refer to the newly defined Resource List. For more details, see Resource Lists.