PK23258: CICS SFR COPYBOOKS AMENDED SUCH THAT EXEC CICS STATEMENTS ARE NO LONGER PRE-TRANSLATED

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• D-type APAR raised to cover change to CICS SFR copybooks in whic
  h EXEC CICS statrements are no longer pre-translated.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS SFR users.                          *
  ****************************************************************
  * PROBLEM DESCRIPTION: This PTF changes the way that EXEC      *
  *                      CICS statements are handled in CICS SFR *
  *                      source copybooks.                       *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  All CICS Service Flow Runtime source copybooks which contain
  EXEC CICS statements are now supplied in non-translated form.
  

Problem conclusion

• Translated strings for EXEC CICS statements have now been
  removed from all CICS Service Flow Runtime source copybooks,
  meaning customers will now have to use the integrated compiler
  when processing CICS Service Flow Runtime modules.
  ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
  The CICS Service Flow Runtime Version 3 Release 1 User's Guide
  (SC34589906) will be updated as follows:
  
  In Chapter 10, "Problem Determination", on page 216 immediately
  following the end of the section entitled "CICS Service Flow
  Runtime additional error messages" (which started on page 212),
  insert the following section:
  
  ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
  Applying APARs
  
  When you need to apply maintenance or fixes to the runtime
  environment, use the following process.
  
  Maintenance is applied using the JCL batch job called
  DFHMAINA. The JCL is very similar to the DFHMAINJ post-
  installation job, in that it contains a subset of the
  parameters from DFHMAINJ. DFHMAINA invokes a REXX program
  called DFHMAINX, which looks in member DFHMAINZ for a list of
  the changed and new members that require maintenance as part of
  an APAR. DFHMAINZ is cumulative and will contain members which
  have been altered by previous APARs as well as those which are
  affected by this APAR.
  
  1. Edit the DFHMAINA JCL, supplying the same parameter values
     as you would for DFHMAINJ. The parameters that you need to
     edit are:
  
     JOB1
        Together with JOB2 and JOB3, JOB1 is used to create the
        JCL statements for the required jobs in the .SCIZSAMP
        library. Do not alter the number of + symbols at the
        beginning of the statement as it is used to substitute
        the jobname when DFHMAINJ runs.
  
     JOB2
        JCL JOB statement continued.
  
     JOB3
        JCL JOB statement continued.
  
     SHLQ your.smpe.install.hlq
        A 1-35 character length value that is the data set name
        high level qualifier of the CICS SFR SMP/E installation
        libraries. This value must match what you specified in the
        previous step for syshlq.
  
     QUAL your.runtime.library.hlq
        A 1-35 character length value that is the data set name
        high level qualifier of the runtime libraries. This value
        must match what you specified in the previous step for
        hlqual.
  
      MQ YES|NO
         Indicates if you require support for WebSphere MQSeries
         (WMQ). If you specify MQ YES, then you must also define
         a value for the HLQMQ parameter. You must specify this
         parameter if you want to use the Simulator program to
         verify your installation.
  
       HLQCICS your.cics.hlq
          A 1-35 character length value that is the high level
       qualifier of the CICS. libraries.
  
       HLQCOBOL your.cobol.hlq
          A 1-35 character length value that is the high level
          qualifier of the COBOL runtime libraries.
  
  
       HLQCEE your.language.environment.hlq
          A 1-35 character length value that is the high level
          qualifier of the Language Environment  runtime
          libraries.
  
       PREFIX your.prefix
          The JCL jobname is created as a combination of this
          and the name of the member that is customized.
          For example, if you specify  PREFIX CSFR, this would
          rename jobs in the runtime libraries with CSFR as the
          first four characters e.g. DFHMASET would become
          CSFRASET. If you do not specify a value for this
          parameter, the sample jobs will have the same names as
          the member names.
  
       HLQMQ your.mq.hlq
          A 1-35 character length value that is the high level
          qualifier of the WMQ runtime libraries.
  
          Note: This parameter is required if you specified MQ YES
  
       THE_QMGR qmgrname
          A 1-4 character length value that is the name of the WMQ
          manager that resources are defined to.
  
          Note: This parameter is required if you specified MQ YES
  
  2. Submit DFHMAINA. DFHMAINA invokes the REXX program DFHMAINX.
     This replaces the SCIZMAC and SCIZLOAD runtime libraries,
     copies the members listed in DFHMAINZ from the SMP/E SCIZSAMP
     library to the runtime SCIZSAMP library and customizes the
     members using the parameter values that you supplied in
     DFHMAINA.
  
  3. Check the output for a return code of 0. Each member that is
     in DFHMAINZ should have a "Customizing member" message
     associated with it in the output.
  
     You should also see the following messages in the //SYSTSPRT
     of the DFHMAINA job output:
  
     CICS SFR SCIZSAMP customization beginning
     CICS SFR SCIZSAMP customization completed successfully.
  
     If you get a return code other than 0, you should investigate
     the cause of the error and correct it before rerunning
     DFHMAINA.
  
  4. Perform any additional steps if outlined in the APAR
     documentation.
  

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:

Modules/Macros

•    DFHMADPL DFHMADPP DFHMAD02 DFHMAD03 DFHMAERQ
  DFHMAERR DFHMAF02 DFHMAF04 DFHMAG03 DFHMAINA DFHMAINX DFHMAINZ
  DFHMALFC DFHMALFD DFHMALFS DFHMALIN DFHMALNM DFHMALPT DFHMALSC
  DFHMALTS DFHMAL02 DFHMAL04 DFHMAL22 DFHMAL24 DFHMAMGR DFHMAN03
  DFHMAN05 DFHMAQ03 DFHMASTM DFHMASTP DFHMAVCL DFHMAVCP DFHMAXAA
  DFHMAXAC DFHMAXAI DFHMAXAJ DFHMAXAO DFHMAXCA DFHMAXCC DFHMAXCI
  DFHMAXCO DFHMAXCP DFHMAXCS DFHMAXEC DFHMAXEP DFHMAXFC DFHMAXFI
  DFHMAXFO DFHMAXIC DFHMAXIO DFHMAXJC DFHMAXLB DFHMAXLC DFHMAXLI
  DFHMAXLO DFHMAXNA DFHMAXNN DFHMAXNS DFHMAXOC DFHMAXPI DFHMAXSC
  DFHMAXTC DFHMAX5P
  

Fix information

• Fixed component name

  SERVICE FLOW FE

• Fixed component ID

  5655M1502

Applicable component levels

• R200 PSY UK17061

     UP06/08/15 P F608

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.