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:
- TZ=EST5EDT4
- PAGENT_CONFIG_FILE=//’SYS1.TCPPARMS(PAGENT)'
- 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.
- # TCPIP Policy Agent Configuration
- # LogLevel statement
- # ... SYSERR, OBJERR, PROTERR, and WARNING messages are logged.
- LogLevel 15
- TcpImage TCPIP FLUSH PURGE
- TTLSConfig //'SYS1.TCPPARMS(TCPPOLS)' FLUSH PURGE
Where:
- Statement #4: Loglevel specifies the level of tracing
for the Policy Agent.
- Statement #5: TcpImage specifies the job name of the
TCP/IP stack that this Policy Agent will control.
- Statement #6: TTLSConfig specifies the location of the
HFS file or MVS data set containing the policy rules.