OA56588: DOC APAR FOR Z/OS UNIX REASON CODE SLIP AT Z/OS 2.2 AND 2.3

APAR status

• Closed as documentation error.

Error description

• The z/OS UNIX reason code SLIP is documented in z/OS UNIX
  Messages and Codes, section "Obtaining dumps on specific reason
  codes".  The SLIP is incorrect for both z/OS 2.2 and 2.3,
  particularly with the DATA= parm:
  .
  DATA=(13R!!+1B0,EQ,xxxxxxxx)
  .
  Note that the reference to R13 is only using the low half of the
  register.  When running with z/OS UNIX stacks above the bar -
  KERNELSTACKS(ABOVE) in BPXPRMxx - this results in the R13
  address being truncated (high half of register not used).  The
  DATA= parm should be changed as follows:
  .
  DATA=(13G!!+1B0,EQ,xxxxxxxx)
  .
    The complete z/OS UNIX reason code SLIP should be as follows:
  .
  SLIP SET,IF,A=SYNCSVCD,RANGE=(10?+8C?+F0?+1F4?),
  DATA=(13G!!+1B0,EQ,xxxxxxxx),JL=(OMVS),AL=(H,P,S),
  DSPNAME=('OMVS'.B*,'OMVS'.S*),
  SDATA=(ALLNUC,PSA,CSA,LPA,TRT,SQA,RGN,SUM),J=jobname,END
  .
  

Local fix

• N/A
  

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * All users of z/OS UNIX System Services for HBB77A0 and       *
  * HBB77B0                                                      *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * In V2R2, the documented SLIP used  to collect a dump when a  *
  * specific                                                     *
  * reason code is issued is incorrect when parmlib option       *
  * KERNELSTACKS is set to ABOVE and register 13 has a 64 bit    *
  * address.                                                     *
  * Also, in some cases, not all the necessary storage is in the *
  * dump.                                                        *
  *                                                              *
  * The SLIP trap is documented as:                              *
  *                                                              *
  * SLIP SET,IF,A=SYNCSVCD,RANGE=(10?+8C?+F0?+1F4?),             *
  * DATA=(13R!!+1b0,EQ,xxxxxxxx),joblist=(OMVS),DSPNAME=('OMVS'. *
  * *),                                                          *
  * SDATA=(ALLNUC,PSA,CSA,LPA,TRT,SQA,RGN,SUM),                  *
  * j=jobname,END                                                *
  *                                                              *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  

Problem conclusion

• The SLIP trap should be updated as follows:
  
  - The DATA parameter should specify 13G!!  to reference above
  the bar address correctly
  - The ASIDLIST should include HOME, PRIMARY, and SECONDARY
  - The DSPNAME parameter should explicitly include just  the OMVS
  dspnames while filtering out the HFS dataspaces (HFSDSPxx) that
  take up space in the dump, but are not normally needed for
  debug.
  
  
   SET,IF,A=SYNCSVCD,RANGE=(10?+8C?+F0?+1F4?),
  DATA=(13G!!+1B0,EQ,xxxxxxxx),JL=(OMVS),AL=(H,P,S),
  DSPNAME=('OMVS'.B*,'OMVS'.S*),
  SDATA=(ALLNUC,PSA,CSA,LPA,TRT,SQA,RGN,SUM),J=jobname,END
  

Temporary fix

Comments

APAR Information

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

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

Fix information

Applicable component levels