This section describes how to configure the Application Performance Analyzer Listener started task to suit your installation.
The Application Performance Analyzer Listener started task obtains the configuration settings from a file allocated to DDname CONFIG. The file is a SYSIN-type member that you edit in order to change the settings. The member CAZCNFGL in hlq.SCAZSAMP contains the initial settings. A group of configuration settings is specified by a CONFIG statement. Settings are organized into categories or classes. Each CONFIG statement defines settings for a particular class. The general syntax for a CONFIG statement is illustrated here:
CONFIG class
keyword1=value1
keyword2=value2 // this is a comment
...
keywordn=valuen
; // end with semicolon
You must code a single keyword/value pair expression within a single line. It cannot span two lines. Separate keyword/value pair expressions from each other using one or more blanks. A CONFIG statement, including all its keyword/value pair expressions, must be terminated by a semicolon.
A CONFIG statement might be coded anywhere within columns 1 to 71 inclusive. An asterisk in column 1 denotes a comment line. A double slash (//) anywhere in the line indicates the remaining text in the line is a comment.
The following CONFIG BASIC statement, which is supplied in the predefined CAZCNFGL member, illustrates the CONFIG syntax.
CONFIG BASIC // Basic settings:
ListenerID=CAZL // . ID
HLQ=#yourhlq // . DSN HLQ for diagnostic
// trace datasets
PORT=8001 // . Listener's port#
UNIT=SYSALLDA // . unit name for new data set
SECURITY=DISABLED // . no security checking
MsgLevel=I // message level
SessionTimeOut=0000 // Session time out (never)
KeepConnected=0000 // ping interval (never)
BASIC settings allow you specify values for basic characteristics of the Application Performance Analyzer Listener installation. The following settings can be specified:
Currently HLQ is used to allocate trace data sets used for diagnostic purposes.
Default: None.
Avoid using ‘Well-Known' (privileged) port numbers as well as registered port numbers. Refer to the Internet Assigned Numbers Authority (IANA) at: www.iana.org for more information on assigned port numbers.
When the ListenTo setting is not specified, the Application Performance Analyzer Listener will listen on this port for every active TCP/IP stack that is defined on the z/OS image.
Default: None.
The syntax is ListenTo=(STACK=(procname,port) ... STACK=(procname,port))
STACK=(procname,port) is a unique TCP/IP stack and port number combination that may be repeated up to 9 times where:
Avoid using ‘Well-known' (privileged) port numbers as well as registered port numbers. Refer to the Internet Assigned Numbers Authority (IANA) at: http://www.iana.org for more information on assigned port numbers.
Example:
PORT=8000
ListenTo=(STACK=TCPIP STACK=(TCPIP1,8001) STACK=(TCPIP2,8002) STACK=(TCPIP3,8003))
In this example, because the first STACK entry TCPIP has no port specified, the Application Performance Analyzer Listener will listen on port 8000, as specified on the PORT setting. TCPIP1 will listen on port 8001, TCPIP2 will listen on port 8002, and TCPIP3 will listen on port 8003.
Default: SYSDA
Unit can be either a device type such as 3390, or esoteric such as SYSDA. A mount status of STORAGE or PUBLIC is non-specific and does not require a VOLSER. Application Performance Analyzer Listener does not allow a VOLSER to be specified.
On a non-SMS-managed system, you must ensure that the UNIT name you specified contains one or more volumes mounted as either STORAGE or PUBLIC. If there are no such volumes mounted, then Application Performance Analyzer Listener is unable to allocate critical files and terminates.
On an SMS-managed system, SMS ignores the unit parameter. To ensure SMS control over all data sets allocated by Application Performance Analyzer Listener, specify an HLQ value that is recognized and managed by SMS.
Default: ENABLED
Default: I
Specifies the length of time a workstation session is allowed to remain connected to the Application Performance Analyzer Listener until it is disconnected. In order for the session to remain connected, the workstation user must cause Application Performance Analyzer GUI to initiate activity with the Application Performance Analyzer Listener within the SESSIONTIMEOUT interval. This is to prevent the Application Performance Analyzer GUI users from monopolizing Application Performance Analyzer Listener sessions.
It must be specified as a four digit number. The value is in the form of: HHMM. Where HH is the number hours in the range of 00-99, and MM is the number of minutes in the range of 00-59. The maximum allowed connection time is 9959 or 4 days 3 hours and 59 minutes. The minimum allowed value is 5 minutes, except for a value of 0000 which indicates that session timeout will not be applied.
Default: 0000
Specifies an interval in minutes. This a heart beat or pulse interval used by the Application Performance Analyzer GUI to ping the Application Performance Analyzer Listener once per interval. The purpose of this value is to keep the connection active. It is common when you are behind a NAT proxy or a firewall to be disconnected due to inactivity.
The maximum interval is 99 minutes. The minimum allowed value is 4 minutes, except for a value of 00 which indicates that no pings will be sent.
Default: 00
Specifies the high-level qualifier used for data sets created by GUI requests to export observation files. The value that you specify for DataHLQ must comply with the JCL rule for specifying a data set name. It can be no more than 17 characters long.
Default: None.Logging records activity within the Application Performance Analyzer Listener started task. Log data is always written to SYSOUT, but you have the option of also writing this data to log data sets. LOGFILE settings allow you manage these data sets. The following settings might be specified:
Default: NO.
If this parameter is not specified, the value that you specify for HLQ on the CONFIG BASIC statement is used.
Default: None.
Default: 15.
Default: NO.
Default: T.
This statement defines configurable parameters for the Application Performance Analyzer Workstation Front-End application (GUI). The following parameter can be specified:
Default: YES
Default: 5.
These settings pertain to operational parameters and should not be changed by the user. These should only be changed on the advice of IBM®. Application Performance Analyzer ships with only one parameter specified, which is DiagLevel=1.
[ Top of Page | Previous Page | Next Page | Contents | Index ]