PI54037: SUPPORT RACF SPECIAL CHARACTERS.

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• RACF now supports an extended set of special characters which
  IMS does not currently support..
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All IMS V13 users with RACF special          *
  *                 characters active.                           *
  ****************************************************************
  * PROBLEM DESCRIPTION: RACF special characters don't work      *
  *                      with IMS.                               *
  ****************************************************************
  * RECOMMENDATION: INSTALL CORRECTIVE SERVICE FOR APAR/PTF      *
  ****************************************************************
  IMS doesn't support all of the special characters supported by
  RACF
  

Problem conclusion

Temporary fix

Comments

• Module DFSICL30 has been modified to support special characters
  within brackets.  Passwords are between brackets.  This is used
  for IMS commands like /LOCK, /UNLOCK  ...
  
  Modules DFSICLZ0, DFSNCL40, DFSNCS10 and DFSNCS30 have been
  modified to pass special characters to RACF,  This will only be
  done if RACF special characters is active.
  
  NOTE: Only IMS V14 and V13 supports RACF special characters, so
  it is necessary to migrate all IMS systems to V14 or V13
  before turning on RACF special characters.
  To support RACF special characters for IMS connect
  APAR PI54038 or PI48112 needs to be installed.
  
  KEYWORD:  IBM.Function.RACF.PasswordCharacters
  
  Documentation changes:
  
  GC19365800  Release Planning
  
  Add to chapter:  IMS SYSTEM ENHANCEMENTS
  
  IMS 13 supports RACF passwords that contain special characters
  after APAR PI54037 is installed.
  
  
  SC19364800  Commands, Volume 1: IMS Commands A-M
  
  At chapter: Multisegment command input
  
  Add after the table that lists the multisgement commands:
  
  When support for special characters is enabled in RACF, and the
  last parm of
  the /OPNDST command is a password a blank should be added before
  the period.
  
  At the /LOCK command where the password is explained add at the
  end:
  
  A period in the password brackets will not be treated as
  delimiter.
  
  
  SC19364900  Commands, Volume 2: IMS Commands N-V
  
  Add to the /SIGN command to the general description:
  
  A period is normally used as the delimiter at the end of IMS
  commands.
  When support for special characters is enabled in RACF, a period
  becomes a valid character in the RACF password.
  Because the password can be specified at the end of the
  /SIGN command,
  a period intended to be the end-of-command delimiter could be
  interpreted as part of the password field.
  Therefore, when a password is specified at the end of the /SIGN
  command,
  a space should be inserted prior to the end-of-command period.
  
  At the /SIGN command, at the userpw parameter, add following:
  
  If Special Character support is enabled in RACF, IMS supports
  RACF passwords that contain special characters.
  
  At the end of the /SIGN command add:
  
  With RACF special characters active, a period within a password
  will not mark the end of the IMS command.
  
  At the /SET, /UNSET, UNLOCK command where the password is
  explained add at the
  end:
  
  A period in the password brackets will not be treated as
  delimiter.
  
  Add to the /OPNDST command to the general description:
  
  A period is normally used as the delimiter at the end of IMS
  commands.
  With RACF special characters enabled, a period becomes a valid
  character in the RACF password.
  Because the password can be specified at the end of the /OPNDST
  command,
  a period intended to be the end-of-command delimiter could be
  interpreted as part of the password field.
  Therefore, when a password is specified at the end of the
  /OPNDST command,
  a space should be inserted prior to the end-of-command period.
  
  If a period is needed to end the command and the last parameter
  is a password, a space
  should be entered before the period to signify the end of
  command.
  

APAR Information

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

  PI48111

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

  UI36544 UI36545

Modules/Macros

• DFSICLZ0 DFSICL30 DFSNCL30 DFSNCS10 DFSNCS40
  

Fix information

• Fixed component name

  IMS V13

• Fixed component ID

  5635A0400

Applicable component levels

• R300 PSY UI36544

     UP16/03/31 P F603

• R302 PSY UI36545

     UP16/03/31 P F603

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.