PK49606: ICMD CALLS NOT PROPERLY LOGGED IN THE CCF COMBINED MESSAGE LOG.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• CCF has been updated to set the proper maximum command length.
  
  ========================================
  DOC changes:
  ========================================
  
      Please add to "Chapter 11. Batch processing."
      -  Please add a new "Topic" - probably immediately after the
         sample JCL.
  
  |
  |   . "Command Control Facility specific DD statements" on page
  ??
  |
  |   Command Control Facility specific DD statements
  |
  |   There are four DD statements used by Command Control
  Facility.
  |   Two are required for successful operation of Command Control
  |   Facility, and one can be optionally specified and the other
  |   is typically dynamically allocated.
  |
  |   Required DD statements:
  |
  |   Command Control Facility requires two DD statements to
  |   process successfully.  The default names, CCFSYSIN and
  CCFLIST,
  |   can be overriden in the global options using the Command
  |   Control Facility ISPF dialog.
  |
  |   CCFSYSIN -
  |     An input physical-sequential data set with an LRECL
  ranging
  |     from 80 to 121 bytes.  This DD statement references the
  dataset
  |     containing the list of commands Command Control Facility
  is
  |     to process.
  |
  |   CCFLIST -
  |     An output physical-sequential data set where Command
  Control
  |     Facility writes the command results and responses.  This
  |     dataset must be the same LRECL as CCFSYSIN.  This DD
  statment
  |     is typically coded as:
  |        //CCFLIST  DD  SYSOUT=*
  |
  |   Optional DD statment:
  |
  |   CCFOPTS -
  |      An input physical-sequence dataset used to provide
  runtime
  |      options for this particular batch job.  The options
  specified
  |      here override those specified in the Command Control
  Facility
  |      options data set.  This dataset must be defined as
  LRECL=80.
  |
  |   Dynamically allocated DD statement:
  |
  |   CCFJOPRT -
  |      An output print dataset that is dynamically allocated.
  This
  |      dataset listd the options that are in effect for the
  |      execution of this job.  Code the following DD statement
  |      if this report is not desired:
  |         //CCFJOPRT  DD  DUMMY
  |
  
      Please change "Chapter 14. Callable API."
      -  Replace the description of AOIDATA in Table 4 with:
  
  |
  |   If the AOITYPE call type is CMD, then this field should be
  |   initialized by the caller to the IMS command padded to 256
  bytes
  |   with spaces.  The actual command cannot be longer than 252
  bytes.
  |   CCF requires the last four bytes to contain spaces.
  |
  |   Upon return from the CMD call, this field will either be
  spaces
  |   or contain a message from CCFCAPI0 of up to 256 bytes
  (padded
  |   with spaces).
  |
  |   If AOITYPE call type is GCMD, then this field will contain
  up
  |   to 256 bytes (padded with spaces) if the return code in
  AOIRETCD
  |   is zeros.  Otherwise the contents of this field should be
  ignored.
  |
  
  New messages:
  
  |
  |   CCF0220E - INPUT COMMAND LONGER THAN 252 BYTES
  |
  |   Explanation:  An application program called the Command
  |      Control Facility AOI with an input command (AOIDATA)
  |      longer than 252 bytes.  Command Control Facility
  |      requires the command be 252 bytes, or less, with the
  |      last four bytes of AOIDATA containing spaces.
  |
  |   System Action:  A return code 12 is returned to the calling
  |      program, and the command is ignored.
  |
  |   User response:  Correct the command, and run the job again.
  |
  

Local fix

• No Work Around
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All Command Control Facility V2.1 users.     *
  ****************************************************************
  * PROBLEM DESCRIPTION: ICMD calls not properly logged in the   *
  *                      CCF combined message log.               *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  ICMD calls not properly logged in the CCF combined message log.
  

Problem conclusion

• CCF has been updated to set the proper maximum command length.
  

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:

  UK31013

Modules/Macros

•    CCFCAPI0 CCFEXEC  CCFEXEC0
  

Fix information

• Fixed component name

  IMS COMMAND CTL

• Fixed component ID

  5655F4000

Applicable component levels

• R210 PSY UK31013

     UP07/11/09 P F711

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.