PK28900: CMD CALL FROM BMP RECEIVES STATUSCD BECAUSE THE 'USERID INDICATOR' BYTE PASSED TO DFSCCMD0 FROM DFSAOSC0 IS X'00'

APAR status

• Closed as program error.

Error description

• STATUSCD when issuing a CMD call from a BMP. Customer's
  DFSCCMD0 is expecting a non-zero value in the
  CCMD_UIDIDN (userid indicator) field passed to it from
  DFSAOSC0. IF AOI=YES, the value passed is hex '00' instead
  of the expected 'U'. If AOI=TRAN is used, the it works
  correctly. Also, AOI=YES for an MPP works correctly (userid
  indicator is not x'00'). Further description from customer:
  When the TRANSACT macro for the BMP has AOI=YES, the userid for
  the BMP (the person who submitted the BMP, me) is passed to
  DFSCCMD0 in the field pointed to by CCMD_UIDPTR (userid pointer)
  However, the CCMD_UIDIND byte contains X'00'. Our DFSCCMD0
  expected this byte to contain one of the documented values,
  C'U', C'L', C'P', C'O', C'T', or C'C'. This is why the command
  was not allowed to process. Had the userid indicator byte
  contained C'U', then security checking would have allowed
  the command to process.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All IMS 910 users using the DFSCCMD0         *
  *                 Command Authorization User Exit              *
  ****************************************************************
  * PROBLEM DESCRIPTION: CMD call from BMP receives STATUSCD     *
  *                      because the 'userid indicator' byte     *
  *                      passed to DFSCCMD0 from DFSAOSC0 is     *
  *                      X'00'.                                  *
  ****************************************************************
  * RECOMMENDATION: INSTALL CORRECTIVE SERVICE FOR APAR/PTF      *
  ****************************************************************
  In an environment where IMS is started with parameter AOI1=A,
  AOI1=C, AOIS=A or AOIS=C the Command Authorization User Exit,
  DFSCCMD0, is called to authorize commands issued from various
  sources.
  
  When the source of a command is a non-message driven BMP and
  the transaction is defined to pass a userid/program name for
  authorization ( TRANSACT macro with AOI=YES parameter ), the
  userid indicator parameter ( CCMD_UIDIND ) is not set to the
  expected value ( CCMD_UIDU = C'U' ) by the ICMD/CMD Security
  Authorization routine, DFSAOSC0, before calling the DFSCCMD0
  user exit. Instead, hex zeroes are passed in the CCMD_UIDIND
  field.
  

Problem conclusion

• AIDS: RIDS/DCS RIDS/CMD DCS CMD
    DEP: NONE
    GEN:
  
  *** END IMS KEYWORDS ***
  The DFSAOSC0 module has been updated to set the CCMD_UIDIND
  userid indicator parameter to the expected value.
  

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:

  UK20954 PK37455

Modules/Macros

• DFSAOSC0
  

Fix information

• Fixed component name

  IMS V9

• Fixed component ID

  5655J3800

Applicable component levels

• R900 PSY UK20954

     UP07/01/05 P F701