CONFIG BASIC statement

BASIC settings allow you specify values for basic characteristics of the Application Performance Analyzer Listener installation. The following settings can be specified:
LISTENERID
Required. This is the Application Performance Analyzer Listener ID, a four-character value that uniquely identifies the Application Performance Analyzer Listener started task.
HLQ
Required. Specifies the high-level qualifier for data sets created by the Application Performance Analyzer Listener started task as part of its normal operation. The value that you specify for HLQ must comply with the JCL rule for specifying a data set name. It can be no more than 17 characters long.

Currently HLQ is used to allocate trace data sets used for diagnostic purposes.

Default: None.

PORT
Required. Specifies the 1 to 5 digit TCP/IP port number on which the Application Performance Analyzer Listener listens for client connections. The port number can be between 1 and 65,535 and must be unique to a single instance of the Application Performance Analyzer Listener. No other product is allowed to use the same port number. Application Performance Analyzer supports both secure and unsecure ports. Secure ports are required to enforce SSL communication in the Application Performance Analyzer GUI.

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.

ListenTo
Optional. Specifies 1 to 9 specific TCP/IP stacks and port numbers on which the Application Performance Analyzer Listener listens for client connections. When not specified, the Application Performance Analyzer Listener will listen on the port specified in the PORT setting, of every active TCP/IP stack defined on the z/OS image. Application Performance Analyzer supports both secure and unsecure ports. Secure ports are required to enforce SSL communication in the Application Performance Analyzer GUI.

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:

  • procname is required and specifies the name of a member in a procedure library that is used to start a TCP/IP started task (stack).
  • port is optional and specifies the 1-5 digit TCP/IP port number on which the Application Performance Analyzer Listener listens for client connections. The default is the port number specified on the PORT setting. The port number can be between 1 and 65,535 and must be unique to a single instance of the Application Performance Analyzer Listener. No other product is allowed to use the same port number. Application Performance Analyzer supports both secure and unsecure ports. Secure ports are required to enforce SSL communication in the Application Performance Analyzer GUI.

    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.

UNIT
Optional. Specifies the unit name to be used when allocating all new trace data sets.

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.

SECURITY
Optional. Specifies whether workstation users will have their user ID and password verified by the external security system, for example, RACF®. ENABLED and DISABLED are the only two valid choices.

Default: ENABLED

MSGLEVEL
Optional. Specifies the severity level of messages to be written to the log data sets. MsgLevel=I writes all messages.

Default: I

SESSIONTIMEOUT
Optional.

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.
Note: This value is not affected by the KEEPCONNECTED value if it also set.
Default: 0000
KEEPCONNECTED
Optional.

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.
Note: This value does not affect the SESSIONTIMEOUT value if it is also set.
Default: 00
DataHLQ
Optional.

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.