Application Performance Analyzer for z/OS, Version 11.1, Customization Guide

Configure the Policy Agent (PAGENT) Started Task

Note:
If a Policy Agent started task is already configured on your system this task is bypassed.
Policy Agent started task
The Policy Agent (PAGENT) started task communicates with the TCP/IP started task. It provides TCP/IP with the AT-TLS rules. You can find a sample JCL procedure for the Policy Agent in: TCPIP.SEZAINST(PAGENT).

An example PAGENT JCL procedure is also provided here:

//PAGENT   PROC
//PAGENT   EXEC PGM=PAGENT,REGION=0K,TIME=NOLIMIT,
//       PARM='ENVAR("_CEE_ENVFILE=DD:STDENV")/'
//*
//STDENV   DD DSN=SYS1.TCPENV(PAGENV),DISP=SHR
//SYSPRINT DD SYSOUT=*
//SYSOUT   DD SYSOUT=*
//CEEDUMP  DD SYSOUT=*,DCB=(RECFM=FB,LRECL=132,BLKSIZE=132)

The Policy Agent started task runs as a USS process and requires input environment variables to define its environment. These environment variables may be passed via the EXEC PARM operand, an HFS file, or an MVS data set. Refer to the comments in the sample procedure TCPIP.SEZAINST(PAGENT) for more information. In the above example an MVS data set is used for the environment variables. The MVS data set must be defined as a variable blocked PDS, and called SYS1.TCPENV. Member PAGENV contains the environment variables.

Policy Agent Configuration Files
PAGENT Environment Variables
The example PAGENT JCL procedure above allocated SYS1.TCPENV(PAGENV) to DDName: STDENV. The member contains the following assignments:
  1. TZ=EST5EDT4
  2. PAGENT_CONFIG_FILE=//'SYS1.TCPPARMS(PAGENT)'
  3. PAGENT_LOG_FILE=SYSLOGD

Where:

  • Statement #1: TZ is the time zone variable
  • Statement #2: PAGENT_CONFIG_FILE specifies the HFS file or MVS data set containing the Policy Agent's configuration parameters.
  • Statement #3: PAGENT_LOG_FILE specifies the destination where the Policy Agent will log diagnostic information.
PAGENT Configuration Statements
The contents of the configuration data set:

‘SYS1.TCPPARMS(PAGENT)' are itemized below. Comment lines are denoted by a ‘#' in column 1.

  1. # TCPIP Policy Agent Configuration
  2. # LogLevel statement
  3. # ... SYSERR, OBJERR, PROTERR, and WARNING messages are logged.
  4. LogLevel 15
  5. TcpImage TCPIP FLUSH PURGE
  6. TTLSConfig //'SYS1.TCPPARMS(TCPPOLS)' FLUSH PURGE

Where:




Rate this page

[ Top of Page | Previous Page | Next Page | Contents | Index ]