A fix is available
APAR status
Closed as new function.
Error description
Reinstate feature toggle: com.ibm.cics.spool.surrogate.check to allow disabling of RACF surrogate class checking for job submission to the internal reader; provide flexibility lost when migrating from a lower release to 6.2.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All CICS users * **************************************************************** * PROBLEM DESCRIPTION: Customers cannot use RACF surrogate * * class to authenticate batch job * * submission to the spool. * **************************************************************** Up to CICS TS 6.1, to enable RACF surrogate class checking when submitting batch jobs to the spool via internal reader required SIT parm XUSER=YES and feature toggle com.ibm.cics.spool.surrogate.check set to true. CICS TS 6.2 removed the feature toggle and required only XUSER=YES. This is preventing customers from upgrading due to the number of users that must be given READ access to the RACF profile and some customers cannot add the users to RACF as they use bespoke authentication methods under CICS.
Problem conclusion
CICS has been updated to reinstate the feature toggle from CICS 6.1: 'com.ibm.cics.spool.surrogate.check=true/false'. The default is 'true' which means CICS will continue to use RACF surrogate class checking for job submissions from CICS as per the SIT XUSER setting. Setting the feature toggle to 'false' will bypass the surrogate class check when XUSER=YES. The IBM Documentation for CICS TS 6.x will be updated to document this new feature toggle. .
Temporary fix
Comments
APAR Information
APAR number
PH65314
Reported component name
CICS TS Z/OS V6
Reported component ID
5655YA100
Reported release
500
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
YesSpecatt / New Function / Xsystem
Submitted date
2025-02-18
Closed date
2025-03-17
Last modified date
2025-04-02
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UO02473
Modules/Macros
DFHPSJP
Fix information
Fixed component name
CICS TS Z/OS V6
Fixed component ID
5655YA100
Applicable component levels
R500 PSY UO02473
UP25/03/18 P F503
Fix is available
Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.
[{"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSGMGV","label":"CICS Transaction Server"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"6.2","Line of Business":{"code":"LOB70","label":"Z TPS"}}]
Document Information
Modified date:
02 April 2025