Step 30B: Set up the JCL Procedure and Configuration File

Set up the configuration file

Set up the configuration file based on the sample file, which is needed to start the Policy Services Provider.

1. Copy the sample environment configuration file from the directory /usr/lpp/ing/policyservices/config/ing.policyservices.environment to your custom directory/etc/ing/policyservices/config/ing.policyservices.environment
2. You can keep the configuration file name as it is or rename it if you like. When you set up the JCL procedure in a later step, the configuration file should match the name you choose.
3. Customize the parameters in this environment configuration file as instructed by the descriptions within that sample file.

   Parameter	Description	Required for HTTP Connection?	Required for HTTPS Connection?
   port=18000	The port specified when establishing the connection between Policy Services Provider and Customization Dialog.	Yes	Yes
   javahome=/usr/lpp/java/J8.0_64	Java 8 64-bit home directory.	Yes	Yes
   psphome=/usr/lpp/ing/policyservices	The location of the Policy Services Provider jar file.	Yes	Yes
   userhome=<config-dir>	Customized directory of your z/OS UNIX System Services project.	Yes	Yes
   https=false	Specify whether HTTPS connection is enabled.	Yes. Leave it as default false.	Yes. Specify to true.
   keystore_path=keystorepathvalue	Specify the absolute full path to the keystore file, for example, /psp_userhome/config/pspcert.jks.	No	Yes
   alias=aliasvalue	Alias that identifies the key in the keystore.	No	Yes
   keypass=keypassvalue	Password to access the key in the keystore.	No	Yes
   storepass=storepassvalue	Password to access the keystore.	No	Yes
   ing.input.encoding=	Specify encoding for reading ISPF tables. Blank means system default encoding, IBM-1047.	Yes. Leave it as default blank unless you're using a different encoding.	Yes. Leave it as default blank unless you're using a different encoding.
   ing.output.encoding=	Specify encoding for JSON report files. Blank means system default encoding, UTF-8.	Yes. Leave it as default blank unless you're using a different encoding.	Yes. Leave it as default blank unless you're using a different encoding.

Set up the JCL procedure

The sample procedure ING.SINGSAMP(INGEPSP) starts the Java™ application of Policy Services Provider.

1. Copy the sample procedure ING.SINGSAMP(INGEPSP) to your PROCLIB.
2. Customize the following data set variables:
   • Change ING to the high-level qualifier of your System Automation target libraries.
   • Change ISP to the high-level qualifier of your site-specific ISPF data sets.
   • Change <config-dir> to the USS directory where the site-specific Policy Services Provider configuration is specified.
   • Change the configuration file name in the CONFIG parameter.
   • For the JAVAOUT and JAVAERR path, Policy Services Provider log information is written in java.out and java.err in this path. These two files are created automatically, so you don't need to create them manually.

   For more information, refer to ING.SINGSAMP(INGEPSP) sample procedure.

Next Step

Authenticate and authorize the communication between the Policy Services Provider and Customization Dialog. See Step 30C: Secure the Policy Services Provider.