PK55757: DFHMAINR REXX MQ DFHMAINQ HLQMQ THE_QMGR CICS.INITQ

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• You are running the CICS SFF V3.1 installation customization
  job DFHMAINJ for the DFHMAINR REXX program with the input
  statement MQ NO and the job ends with RC16 and messages:
  .
  CIAI1002I SCIZSAMP customization beginning.
  CIAI1000I Validation of input parameters is taking place.
  CIAI1018E If MQ=YES is specified then you must specify HLQMQ
  CIAI1012I SCIZSAMP customization ended with errors.
  .
  If the job is run again after inserting a HLQMQ statement with
  no value and MQ NO, the following messages are received:
  .
  CIAI1002I SCIZSAMP customization beginning.
  CIAI1000I Validation of input parameters is taking place.
  CIAI1010I Customizing member: DFHMABAP
  CIAI1014S DFHMAINR has encountered an unrecoverable error.
            Novalue error at line 820 of DFHMAINR: TABLE.16.2
  .
  If the job is run with MQ NO but with HLQMQ and THE_QMGR but
  without a CICS.INITQ the following errors are received.
  .
  CIAI1002I SCIZSAMP customization beginning.
  CIAI1000I Validation of input parameters is taking place.
  CIAI1010I Customizing member: DFHMABAP
  CIAI1014S DFHMAINR has encountered an unrecoverable error.
            Novalue error at line 820 of DFHMAINR: TABLE.17.2
  .
  If MQ YES is specified, the CICS SFF 3.1 Users Guide indicates
  only the HLQMQ input statement in required, however the THE_QMGR
  and the CICS.INITQ optional parameters are also mandatory.
  .
  Additional Symptom(s) Search Keyword(s): TABLE 16.2 17.2 parse
  var validate
  

Local fix

• Run the DFHMAINJ job and the DFHMAINR REXX with the optional
  input paramters HLQMQ, THE_QMGR, and CICS.INITQ specified
  regardless of whether MQ NO|YES is specified.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS SFR 3.1 users.                      *
  ****************************************************************
  * PROBLEM DESCRIPTION: Message CIAI1014S running DFHMAINJ.     *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  The DFHMAINJ sample job creates the runtime libraries for CICS
  Service Flow Runtime.  It contains mandatory and optional
  parameters.  If the optional parameters are deleted then
  DFHMAINR (an exec called by DFHMAINJ) will issue error message:
                                                                 .
  CIAI1014S DFHMAINR has encountered an unrecoverable error.
            Novalue error at line 820 of DFHMAINR: TABLE.16.2
                                                                 .
  (NB: The line number and TABLE value may vary depending on which
  optional parameter has been deleted).
  

Problem conclusion

• The following comment has been added to DFHMAINJ (optional
  values section):
                                                                 .
  "If an optional value is not required then replace
   the example parameter value (eg: ivp_cics_sysid)
   with blanks.  DO NOT REMOVE THE LINE OR COMMENT IT
   OUT."
                                                                 .
  The following update will be made to the CICS Service Flow
  Runtime User's Guide (SC34-5899-07).  The section titled
  'Customizing the setup procedure DFHMAINJ' will have point
  2 amended so that it reads as follows:
  
  2. Provide values for the mandatory parameters and any optional
     parameters if required. The list of parameters is described
     in DFHMAINJ parameters.  If an optional value is not required
     then replace the example parameter value (eg: ivp_cics_sysid)
     with blanks.  DO NOT REMOVE THE LINE OR COMMENT IT OUT.
  

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:

  UK35532

Modules/Macros

•    DFHMAINJ
  

Fix information

• Fixed component name

  SERVICE FLOW FE

• Fixed component ID

  5655M1502

Applicable component levels

• R200 PSY UK35532

     UP08/04/15 P F804

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.