Configuring Policy Agent as a started task in z/OS

Configuring Policy Agent as a started task in z/OS

Overview

Policy Agent (PAGENT) runs as a UNIX processor as a z/OS started task. In our example, we use the z/OS started task procedure to start Policy Agent.

STC procedure

Sample JCL for the Policy Agent started task can be found in member PAGENT in the BSA.SAMPLIB.

+-------------------------------------------------------------------------+
|//PAGENT PROC |
|//********************************************************************** |
|//* * |
|//* PAGENT STARTED PROCEDURE * |
|//* * |
|//* SAMPLE-PROCEDURE * |
|//* * |
|//* * |
|//********************************************************************** |
|//PAGENT EXEC PGM=PAGENT,REGION=0K,TIME=NOLIMIT, |
|// PARM='ENVAR("_CEE_ENVFILE=DD:STDENV")/' |
|//* |
|//* FOR INFORMATION ON THE ENVIRONMENT VARIABLES, REFER TO THE |
|//* IP CONFIGURATION GUIDE. |
|//* |
|//*** EXAMPLES FOR SPECIFYING ENVIRONMENT VARIABLES |
|//* |
|//* SAMPLE UNIX FILE CONTAINING ENVIRONMENT VARIABLES: |
|//* STDENV DD PATH='/etc/pagent.env',PATHOPTS=(ORDONLY) |
|//* |
|//* SAMPLE z/OS DATA SET CONTAINING ENVIRONMENT VARIABLES: |
|//* STDENV DD DSN=BETA.BSA.SAMPLIB(PAGNTENV),DISP=SHR |
|//* |
|//STDENV DD DSN=BETA.BSA.SAMPLIB(PAGNTENV),DISP=SHR |
|//* |
|//SYSPRINT DD SYSOUT=* |
|//SYSOUT DD SYSOUT=* |
|//* |
|//CEEDUMP DD SYSOUT=*,DCB=(RECFM=FB,LRECL=132,BLKSIZE=132) |
+-------------------------------------------------------------------------+

Configuration file

DD STDENV defines the name of the configuration file for Policy Agent. The configuration file can be a z/OS dataset or a Unix file.

In our example, we use a member in a z/OS dataset. A sample configuration file can be found in member PAGNTENV in the BSA.SAMPLIB.

LIBPATH=/lib:/usr/lib:usr/lpp/ldapclient/lib:.
PAGENT_CONFIG_FILE=//'BETA.BSA.IP.PARMLIB(PAGNTCFG)'
PAGENT_LOG_FILE=/tmp/pagent.log
PAGENT_LOG_FILE_CONTROL=300,3
_BPXK_SETIBMOPT_TRANSPORT=TCPIP

Important:

  • Parameter names and values are case-sensitive.
  • Line numbering must be turned off when editing this member.