Step 30C: Set Up the JCL Procedures for Policy Services Provider

The Policy Services Provider(PSP) runs in two separate address spaces when started:

SAPSP SA >Customization REST Server (handles REST API requests).
SAPSPISP >SA PSP ISPF Bridge (connects PSP to ISPF dialogs).
Both address spaces are mandatory for PSP to operate correctly.

Step 1: Copy the JCL Procedures to Your PROCLIB

Before using the sample procedures, copy the following members from the SA z/OS installation library into your computer PROCLIB:

INGEPSP: Starts the Java-based SA Customization REST Server
INGEPSPI: Starts the C-based SA PSP ISPF Bridge

This ensures the JCLs are available for system-level execution by using S START commands.

Step 2: Configure INGEPSP (SA Customization REST Server)

The INGEPSP procedure launches the Java Policy Services Provider that runs within UNIX System Services (USS). This JCL contains several parameters that must be customized before starting the server.

Key Parameters to Configure:

Parameter	Description
JAVAVER	Specifies the Java version to be used, for example, 17.
JAVADS	Dataset qualifier for the Java version for example XHO
DIRI	Installation directory of the Policy Services Provider in USS, for example, (/usr/lpp/ing/policyservices).
DIRC	Customization directory in USS where site-specific configuration resides, for example (/etc/ing/policyservices).
LOGLVL	Logging level for Policy Services Provider.
LEPARM	Optional Language Environment (LE) parameters for Java runtime.

Environment settings

In the STDENV section, additional configuration options are available:

Variable	Description
`JAVA_HOME`	Optional: Default Java home directory path.
`WORKING_DIR`	Working directory of the Policy Services Provider.
`SUBSTITUTE_SYSTEM_SYMBOLS`	Enables or disables system symbol substitution (true/false).
`KEYRING_PROVIDER`	Specifies keyring support: SAF, or ICSF.
`USER_JOPT`	User-defined Java options.

The JCL run the following startup script to initialize the runtime environment:

. &PSPHOME./bin/ing.policyservices.environment \
    --installdir "&PSPHOME." \
    --configdir "&PSPCFG." \
    --workingdir "$WORKING_DIR" \
    --javadir "$JAVA_HOME" \
    --keyring "$KEYRING_PROVIDER" \
    --systemsymbols "$SUBSTITUTE_SYSTEM_SYMBOLS"

Step 3: Configure INGEPSPI (SA PSP ISPF Bridge)

The INGEPSPI procedure starts the ISPF Bridge component, which connects the Policy Services Provider to ISPF dialogs.

This is a simpler JCL and requires fewer customizations.

Parameter	Description
HLQDSN	High-level qualifier of the SA target libraries, for example, ING.
ISPFHLQ	High-level qualifier of ISPF message and table libraries for example, ISP.
DIRC	Path to the UNIX System Services configuration directory used by Policy Services Providerfor example (/etc/ing/policyservices).

The CONFIG DD statement in this procedure points to the PSP configuration file:

PATH='&DIRC./ing.policyservices.properties'

Next Step

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