ADD-CONNECTION-SET Add connection set for RESPONSETIME monitoring

This statement is used to define a connection set which is to be added to the
RESPONSETIME monitoring program definition. A connection set consists of one or more (as many as five) connection groups. The connection set can be either positively defined (i.e. all groups specified in this connection set are monitored) or negatively defined (i.e. all groups except those specified in the connection set are monitored).

For each connection set, a freely selectable name must be assigned; the name is the one under which this set can be addressed in the REMOVE-CONNECTION-SET statement and also addressed by SM2R1 for analysis purposes.

If a connection set is defined, it is also possible to specify whether remote, local or both types of connections are to be taken into account for the set. SM2 then passes the correct parameter value to BCAM-SM2. This value then applies to this connection set only.

This statement cannot be entered until after the SET-RESPONSETIME-PARAMETERS statement has been entered. The SET-RESPONSETIME-PARAMETERS statement automatically defines a connection set with the name *GLOBAL in which all connections are monitored (*CONNECTION (*ALL)). The value CONNECTION-TYPE=*REMOTE applies for this connection set and cannot be changed.

A total of 16 connection sets (*GLOBAL inclusions) may be defined with a total of
16 different connection groups ((*ALL) inclusion). If this number is exceeded, the statement will be rejected and a message to this effect issued. If an attempt is made to declare more than one set under one set name, the statement will be rejected and a message will be issued.

Format

ADD-CONNECTION-SET                                                                                                                             

SET-NAME = <alphanum-name 1..16>
,SET-DEFINITION = *BY-CONNECTION / *EXCEPT-CONNECTION
,CONNECTION-SET = list-poss(5): *CONNECTION(...)
	*CONNECTION(...)
		|	APPLICATION = *ALL / <alphanum-name 1..8 with-wild>
,CONNECTION-TYPE = *REMOTE / *LOCAL / *BOTH

Operands

SET-NAME = <alphanum-name 1..16>
Defines a name for the selected connection set.

SET-DEFINITION =
Defines the connection set to be monitored.

SET-DEFINITION = *BY-CONNECTION
All connection groups defined in the connection set are monitored.

SET-DEFINITION = *EXCEPT-CONNECTION
All connection groups except those defined in the connection set are monitored.

CONNECTION-SET = list-poss(5): *CONNECTION(...)
Defines a selection of up to five connection groups.

APPLICATION = *ALL / <alphanum-name 1..8 with-wild>
*ALL: No special application is selected.
<alphanum-name 1..8>: Specifies the name of the selected application. An asterisk * is also permitted as the last character in a wildcard specification.

CONNECTION-TYPE =
Specifies the type of connection to be taken into consideration for the connection set.

CONNECTION-TYPE = *REMOTE
Only remote connections are taken into consideration.

CONNECTION-TYPE = *LOCAL
Only local connections are taken into consideration.

CONNECTION-TYPE = *BOTH
Both local and remote connections are taken into consideration.

No application name is defined for applications that use the SOCKETS(BS2000) or ICMX(BS2000) interface. Connections of these applications cannot be selected in SM2 using the ADD-CONNECTION-SET statement. They are contained in the *GLOBAL connection set.

The BCAM-CONNECTION supports the selection of the partner computer, the local application and the partner application.