IBM Support

OA66475: NEW FUNCTION - CBRUXSAE Extended Parameter List (OAM Subsystem name and DB2ID)

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as new function.

Error description

  • NEW FUNCTION
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: OAM Object users at 3.1 release and higher.  *
    ****************************************************************
    * PROBLEM DESCRIPTION: New function adds two new parameters    *
    *                      to CBRUXSAE security exit parameter     *
    *                      list.                                   *
    *                                                              *
    *                      OAM Subsystem Name                      *
    *                      Db2 Subsystem ID                        *
    ****************************************************************
    

Problem conclusion

  • New function provided.
    
    Documentation updates:
    
    DFSMS Object Access Method Planning, Installation and Storage
    Administration Guide for Object Support
    (SC23-6866-60)
    
    Chapter 3 ->
    
    SL=x
    specifies whether Dynamic load for security exit CBRUXSAE is
    enabled and whether the CBRUXSAE
    extended parameter list is enabled.
    SL=N specifies that LOAD macro is in use to load the exit on
    every OSREQ invocation. The
    dynamic load into common storage for the security exit is not
    enabled. This is the default.
    SL=Y specifies that dynamic load into common storage for the
    security exit is enabled.
    SL=E enables the CBRUXSAE extended parameter list (Released in
     APAR OA66475) and is
    combined with SL=N.
    SL=B enables the CBRUXSAE extended parameter list and enables
    the dynamic load into
    common storage for the security exit. This option is treated as
    if SL=Y and SL=E are both
    specified at the same time (Released in APAR OA66475).
    Note This keyword is only processed for the first OAM subsystem
    to initialize and that value is used
    for all OAM subsystems. If it is specified on any OAM subsystem
    other than the first one to initialize, it
    is ignored.
    
    
    Chapter 5 ->
    
    SL=x
    specifies whether Dynamic load for security exit CBRUXSAE is
    enabled and whether the CBRUXSAE
    extended parameter list is enabled.
    SL=N specifies that LOAD macro is in use to load the exit on
    every OSREQ invocation. The
    dynamic load into common storage for the security exit is not
    enabled. This is the default.
    SL=Y specifies that dynamic load into common storage for the
    security exit is enabled.
    SL=E enables the CBRUXSAE extended parameter list (Released in
    APAR OA66475) and is
    combined with SL=N.
    SL=B enables the CBRUXSAE extended parameter list and enables
    the dynamic load into
    common storage for the security exit. This option is treated as
    if SL=Y and SL=E are both
    specified at the same time (Released in APAR OA66475).
    
    Existing CBR1157I (part of CBR1100I) message insert will be
    updated to now display E or B as appropriate.
    (SL= portion in message below bolded for reference).
    CBR message manual will not necessitate an update as we dont
    explicitly describe SL= behavior, however I
    do plan to include a ++HOLD(AO) to indicate new message inserts
    will be available.
    OAM PROCNAME: procname OAM TASKID: taskid
    OPT. TOT USE TOT USE AVL TOT USE AVL TOT USE AVL SCR REQ
    LIB LIB DRV DRV DRV LDR LDR LDR SDR SDR SDR VOL CT
    aaa bbb ccc ddd eee fff ggg hhh iii jjj kkk lll mmm
    TAPE TOT ONL TOT TOT TOT TOT TOT ONL AVL TOTAL
    LIB LIB AL VL VCL ML DRV DRV DRV SCRTCH
    nnn ooo ppp qqq rrr sss ttttt uuuuu vvvvv wwwwwwww
    Category count scratch transition {ENABLED|OPERATOR DISABLED}
    exit-name processing {ENABLED|DISABLED|BYPASSED|
    OPERATOR DISABLED}.
    CBRUXSAE processing {ENABLED|BYPASSED|BYPASSED_RS}for STORE.
    CBRUXSAE processing {ENABLED|BYPASSED} for RETRIEVE.Existing
    CBR1157I (part of CBR1100I) message insert will be updated to
    now display E or B as appropriate.
    (SL= portion in message below bolded for reference).
    CBR message manual will not necessitate an update as we dont
    explicitly describe SL= behavior, however I
    do plan to include a ++HOLD(AO) to indicate new message inserts
    will be available.
    
    OAM PROCNAME: procname OAM TASKID: taskid
    OPT. TOT USE TOT USE AVL TOT USE AVL TOT USE AVL SCR REQ
         LIB LIB DRV DRV DRV LDR LDR LDR SDR SDR SDR VOL CT
         aaa bbb ccc ddd eee fff ggg hhh iii jjj kkk lll mmm
    TAPE TOT ONL TOT TOT TOT TOT TOT ONL AVL TOTAL
         LIB LIB AL VL VCL ML DRV DRV DRV SCRTCH
         nnn ooo ppp qqq rrr sss ttttt uuuuu vvvvv wwwwwwww
    Category count scratch transition {ENABLED|OPERATOR DISABLED}
    exit-name processing {ENABLED|DISABLED|BYPASSED|
    OPERATOR DISABLED}.
    CBRUXSAE processing {ENABLED|BYPASSED|BYPASSED_RS}for STORE.
    CBRUXSAE processing {ENABLED|BYPASSED} for RETRIEVE.
    CBRUXSAE processing {ENABLED|BYPASSED} for QUERY.
    CBRUXSAE processing {ENABLED|BYPASSED} for CHANGE.
    CBRUXSAE processing {ENABLED|BYPASSED} for DELETE.
    Access Backup {ACTIVE|INACTIVE}for reason, using {1st|2nd|no}
    backup copy.
    Diagnostic messages {ACTIVE|INACTIVE} for error-type.
    Limit=nnnn.
    Db2 ID: db2-id
    XCF GROUP NAME: group-name
    XCF MEMBER NAME: member-name
    CBROAM: cbroam-parmlib-suffix
    OAMx Parms: TIME=xxx MSG=xx OTIS=x SL=x
    UPD=x QB=x MOS=xxxx LOB=x DP=x LR=x
    
    z/OS MVS System Messages, Vol 4 (CBD-DMO)
    (SA38-0671-60)
    
    CBR8562I Security exit CBRUXSAE dynamic load stays enabled.
    Re-IPL is needed to disable dynamic load.
    
    Explanation
    
    This message will be issued under the circumstance that
    CBRUXSAE dynamic load is enabled (SL=Y or
    SL=B) and all subsystems have been deleted and has become an
    empty configuration, a new subsystem is
    being added to the configuration with parameter SL=N or SL=E. A
    dynamic change of SL=Y (or SL=B) to
    SL=N (or SL=E) is not supported and SL=Y (or SL=B) will remain
    in effect for the duration of this IPL.
    
    System action
    Processing continues.
    
    Operator response
    Inform your system programmer.
    
    System programmer response
    To switch from SL=Y (or SL=B) to SL=N (or SL=E), update
    subsystem definition in IEFSSNxx PARMLIB
    member and re-IPL. See z/OS DFSMS OAM Planning, Installation,
    and Storage Administration Guide for
    Object Support for more information.
    
    Source
    Object Access Method (OAM)
    
    Routing code
    2
    
    Descriptor code
    5
    

Temporary fix

Comments

APAR Information

  • APAR number

    OA66475

  • Reported component name

    OBJECT ACCESS M

  • Reported component ID

    5695DF180

  • Reported release

    310

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    YesSpecatt / New Function / Xsystem

  • Submitted date

    2024-05-01

  • Closed date

    2024-11-12

  • Last modified date

    2025-01-02

  • APAR is sysrouted FROM one or more of the following:

  • APAR is sysrouted TO one or more of the following:

    UJ96314

Modules/Macros

  • CBRFDO   CBRICMMN CBRIFLPC CBRINIT0 CBRPOSMA CBRSMGM1 CBRSMGU1
    CBRUXSAE
    

Publications Referenced
SC23686660SA38067160   

Fix information

  • Fixed component name

    OBJECT ACCESS M

  • Fixed component ID

    5695DF180

Applicable component levels

  • R310 PSY UJ96314

       UP24/12/04 P F412  

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":"BU011","label":"Systems - zSystems software"},"Product":{"code":"SG19M"},"Platform":[{"code":"PF054","label":"z Systems"}],"Version":"310"}]

Document Information

Modified date:
02 January 2025