The SELECT parameter USERS

Function

You use this parameter to specify the timesharing and application users to be evaluated.

Please note that you can restrict logging to individual users by means of the USER-SELECT parameter of the SET-TUNING-TRACE administration statement (see "SET-TUNING-TRACE"). Only from these users can you make a selection for evaluation in SESCOSP by means of the USERS parameter.

USERS

= *ALL / *BY-SELECT(...)
	*BY-SELECT(...)
		|	HOST-NAME = *NONE / <text 1..8>
		|	,APPLICATION-NAME = *NONE / *TSN (TSN=<alphanum-name 4..4>) / <text 1..8>
		|	,CUSTOMER-NAME = *NONE / <text 1..8>
		|	,CONVERSATION-ID = *NONE / <x-string 1..8> / <alphanum-name 1..8>
		|	,TAC = *NONE / <alphanum-name 1..8>

Operands

USERS = *ALL

All timesharing and application users are evaluated.

USERS = *BY-SELECT(...)
Only specific timesharing and application users are evaluated. You must specify a value other than *NONE for at least one operand.

HOST-NAME =
The data to be evaluated is selected by specifying a host system.

HOST-NAME = *NONE
The information to be output is not limited to that on a specific host system.

HOST-NAME = <text 1..8>
Only the data of the specified host system is evaluated. The host system is identified by its symbolic host name. In non-distributed processing, HOMEPROC always identifies the local system.

The wildcard * (asterisk) enables you to select a subset

The hosts whose names begin with the specified string (up to the first *) are selected.

For example HOST-NAME=D016* selects all hosts whose name begins with D016. HOST-NAME=* selects all hosts.

APPLICATION-NAME =

The data to be evaluated is selected by specifying an application.

APPLICATION-NAME = *NONE
The information to be output is not limited to that of a specific application.

APPLICATION-NAME = *TSN (TSN= <alphanum-name 4..4>)
In TIAM mode you select the application by specifying the task sequence number (TSN).

APPLICATION-NAME = <text 1..8>
In UTM mode you select the application by specifying the UTM application name, in DCAM mode by specifying the DCAM application name.

The wildcard * (asterisk) enables you to select a subset

The applications whose names begin with the specified string (up to the first *) are selected.

For example APPLICATION-NAME=TSN* selects all TIAM applications. APPLICATION-NAME=* selects all applications.

CUSTOMER-NAME =
The data to be evaluated is selected by specifying a user.

CUSTOMER-NAME = *NONE
The information to be output is not limited to that of a specific user.

CUSTOMER-NAME = <text 1..8>
In UTM mode the user is specified by means of the KDCSIGN name, in TIAM and DCAM modes by means of the program name.

The wildcard * (asterisk) enables you to select a subset

The users whose names begin with the specified string (up to the first *) are selected.

For example CUSTOMER-NAME=UPIC* selects all users whose name begins with UPIC. CUSTOMER-NAME=* selects all users.

CONVERSATION-ID =
The data to be evaluated is selected by specifying a UTM conversation.

CONVERSATION-ID = *NONE
The data to be evaluated is not limited to that of a specific UTM conversation.

CONVERSATION-ID = <x-string 1..8> / <alphanum-name1..8>
The UTM conversation is identified by the UTM conversation number.

TAC =

The data to be evaluated is selected by means of the UTM transaction code, the DCAM user name or the BS2000 user ID.

TAC = *NONE
No selection by means of the UTM transaction code, the DCAM user name or the BS2000 user ID

TAC = <alphanum-name 1..8>
In UTM mode, the transaction code is specified here, in DCAM mode the DCAM user name, and in TIAM mode the BS2000 user ID.