Specifying environment variables

The Policy Agent requires access to one or more DLLs at run time. The LIBPATH environment variable needs to be set to include the /usr/lib directory, which normally includes all the required DLLs.

For policy time specifications to be properly acted upon, the TZ environment variable needs to be set to local time. You can set the LIBPATH and TZ environment variables as follows:

• When starting from the z/OS® shell:

  Export the LIBPATH and TZ environment variables before starting the Policy Agent. This is best accomplished in /etc/profile or in .profile in the HOME directory. For example, if you are in the Eastern time zone in the United States:

  export LIBPATH=/usr/lib
  export TZ=EST5EDT

• When starting as a started task, use either of the following methods:
  • Specify LIBPATH and TZ using the ENVAR parameter on the PARM statement in the started procedure. For example:

    // PARM=('ENVAR("LIBPATH=/usr/lib","TZ=EST5EDT")/')

  • Export the LIBPATH and TZ environment variables in a file specified with the STDENV DD statement. For example:

    // PARM='ENVAR("_CEE_ENVFILE=DD:STDENV")/'
    //STDENV DD PATH='/etc/pagent.env',PATHOPTS=(ORDONLY)

    In the /etc/pagent.env file:

    LIBPATH=/usr/lib
    TZ=EST5EDT

    The use of the STDENV DD statement works well when you want to specify more than one environment variable; there is a JCL limit of 100 characters on the PARM parameter. Language Environment® recommends a variable record format for the STDENV file.

You can also set the TZ environment variable for all applications in the CEEPRMxx PARMLIB member. You should define the TZ environment variable for all three LE option sets (CEEDOPT, CEECOPT, and CELQDOPT). For example:

CEECOPT(ALL31(ON), ENVAR('TZ=EST5EDT') )
CEEDOPT(ALL31(ON), ENVAR('TZ=EST5EDT') )
CELQDOPT(ALL31(ON), ENVAR('TZ=EST5EDT') )

For more information on specifying run-time options, see z/OS Language Environment Programming Guide. For details on setting the LIBPATH and TZ environment variables, see z/OS UNIX System Services Command Reference.