UPSI - Control of the User Program Switch Indicator

This Natural profile parameter adjusts the setting of the User Program Switch Indicator (UPSI) specified in the JCL. The UPSI profile parameter is mainly used for debugging and tracing in Natural under z/VSE to avoid undesired results if a UPSI setting in a JCL statement is interpreted differently by a non-Natural program.

Possible settings 1 - 8 characters Any combination of the characters 0, 1 and X.

The syntax of the character string is the same as for the UPSI string in the JCL control statement.

Default setting XXXXXXXX The UPSI string in the JCL is not adjusted to the Natural parameter setting: see Rules for UPSI Adjustments.
Dynamic specification yes  
Specification within session no  

Rules for UPSI Adjustments:

The UPSI profile parameter adjusts the UPSI specification in the JCL control statement according to the following rules:

UPSI Parameter Setting UPSI Specification in the JCL
0 The corresponding bit in the UPSI string is set to 0.
1 The corresponding bit in the UPSI string is set to 1.
X The corresponding bit in the UPSI string remains unchanged.
Unspecified rightmost positions The corresponding bits in the UPSI string remain unchanged.

Examples of UPSI Adjustments:

  1. UPSI in the JCL:

    11X0X001

    UPSI parameter setting:

    X0101

    Resulting setting used by Natural:

    10101001
  2. UPSI in the JCL:

    11X0X

    UPSI parameter setting:

    X0101111

    Resulting setting used by Natural:

    10101111

Related Topics:

  • Debugging Facilities for Natural under z/VSE in the Operations documentation

  • Using the UPSI Parameter in Natural CICS Interface Debugging Facilities in the TP Monitor Interfaces documentation