IBM Support

PM91735: RDZ INTERNAL V9010 DEFECTS/ENHANCEMENTS (NON-RSE)

Subscribe

You can track all active APARs for this component.

APAR status

  • Closed as program error.

Error description

  • RDZ INTERNAL V9010 DEFECTS/ENHANCEMENTS (NON-RSE)
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: 01.Users of the IBM z/OS Automated Unit      *
    *                    Testing Framework (zUnit) who include     *
    *                    NLS characters in text passed to test     *
    *                    runner APIs AZUASTFM, AZUTCADD, or        *
    *                    AZUTCINI.                                 *
    *                 02.RDz users who access the Endevor          *
    *                    repository using the IBM supplied RDz     *
    *                    Endevor RAM and whose site requires the   *
    *                    CCID and COMMENT parameters for certain   *
    *                    actions.                                  *
    *                 03.Users of the IBM Rational Developer for   *
    *                    System z (RDz) Enterprise Service Tools   *
    *                    (EST) WSDL2PLI (IMS PL/I top-down)        *
    *                    support.                                  *
    *                 04.Users of the IBM Rational Developer for   *
    *                    System z (RDz) Enterprise Service Tools   *
    *                    (EST) IRZPWSIO segmentation APIs (e.g,    *
    *                    DFSXGETS, DFSXSETS, DFSQGETS, DFSQSETS)   *
    *                    in the WSDL2PLI (IMS PL/I top-down)       *
    *                    scenario.                                 *
    *                 05.RDz users who access the Endevor          *
    *                    repository using the IBM supplied RDz     *
    *                    Endevor RAM and set up separate jobcards  *
    *                    templates that are to be used with the    *
    *                    JCL templates when performing Element     *
    *                    actions in batch mode.                    *
    *                 06.RDz users who access the Endevor          *
    *                    repository using the IBM supplied RDz     *
    *                    Endevor RAM and edit the elements using   *
    *                    the Enhanced Edit feature.                *
    *                 07.RDz users who access the Endevor          *
    *                    repository using the IBM supplied RDz     *
    *                    Endevor RAM and make use of the Enhanced  *
    *                    Edit capabilities but whose site does     *
    *                    not allow the CA Endevor Transfer         *
    *                    Element function.                         *
    *                 08.system admin installing RDz               *
    *                 09.RDz users who access the Endevor          *
    *                    repository using the IBM supplied RDz     *
    *                    Endevor RAM and make use of the Enhanced  *
    *                    Edit capabilities and also need the copy  *
    *                    members to be accessible during the edit  *
    *                    session.                                  *
    *                 10.All CARMA users if CLIST startup method   *
    *                    is used and CLIST uses 8-argument         *
    *                    startup string                            *
    *                 11.system administrator                      *
    *                 12.CARMA administrators and CARMA RAM        *
    *                    developers.                               *
    *                 13.RDz system administrator                  *
    *                 14.RDz users who access the Endevor          *
    *                    repository using the IBM supplied RDz     *
    *                    Endevor RAM and make use of the Enhanced  *
    *                    Edit capabilities but whose site does     *
    *                    not allow the CA Endevor Transfer         *
    *                    Element function.                         *
    *                 15.CARMA users accessing files that          *
    *                    contains a x'00' byte                     *
    ****************************************************************
    * PROBLEM DESCRIPTION: 01.When the user-supplied reason text   *
    *                         for an assertion exception           *
    *                         (AZU1003S) contains NLS characters,  *
    *                         these characters may be corrupted    *
    *                         when included in the test runner     *
    *                         result XML.                          *
    *                      02.RDz client users whose site require  *
    *                         the CCID and COMMENT parameters      *
    *                         must be notified when they do not    *
    *                         specify a value for those required   *
    *                         fields.                              *
    *                      03.Beginning with RDz version 9.0.1,    *
    *                         the IRZPWSIO segmentation APIs will  *
    *                         no longer be provided with RDz, but  *
    *                         will be shipped with IMS and         *
    *                         renamed to DFSPWSIO to reflect the   *
    *                         IMS 'DFS' prefix. Certain Enteprise  *
    *                         Services Tools (EST) runtime         *
    *                         messages reference IRZWPSIO          *
    *                         segmentation APIs by name.           *
    *                      04.Since the IRZPWSIO segmentation      *
    *                         APIs define and implement an         *
    *                         interface to multi-operation IMS     *
    *                         Web service provider MPPs (a type    *
    *                         of IMS application), the APIs are    *
    *                         being made part of IMS to ensure     *
    *                         their availability in the future.    *
    *                      05.When a default jobcard is specified  *
    *                         in the CRABCFG DD dataset member,    *
    *                         the last line of the jobcard is      *
    *                         suppressed when the JCL is           *
    *                         generated.                           *
    *                      06.When using CARMA Fast Edit, the      *
    *                         user does not have the option to     *
    *                         invoke the Generate Processor for    *
    *                         the element. This may result in the  *
    *                         dependencies not be being resolved.  *
    *                      07.When using CARMA Enhanced Edit the   *
    *                         user does not have the option to     *
    *                         invoke the Generate Processor for    *
    *                         the element. his may result in the   *
    *                         dependencies not be being resolved.  *
    *                         If the user browses the element at   *
    *                         the original high level the extract  *
    *                         dependencies works. Local fix : The  *
    *                         workaround is to have the element    *
    *                         footprint rebuilt, i.e to generate   *
    *                         the element to have the              *
    *                         dependencies resolved.               *
    *                      08.SMP/E workarea in sample xxx1SMPE    *
    *                         job is too small                     *
    *                      09.Endevor copybook not found most of   *
    *                         the time when opening a file using   *
    *                         the Edit with action. Local fix:     *
    *                         The copybook is found using the      *
    *                         Extract to remote project and        *
    *                         editing there.                       *
    *                      10.CARMA startup fails when using       *
    *                         CLIST startup method with the new    *
    *                         (8 parameters) format                *
    *                      11.updated host configuration utility   *
    *                      12.Enhancement to pass client version   *
    *                         and user exit invocation             *
    *                         information to CARMA startup and     *
    *                         CARMA RAM.                           *
    *                      13.enhancement to allow execution       *
    *                         of a user exit during CARMA server   *
    *                         startup                              *
    *                      14.RDz client users whose site does     *
    *                         not allow the CA Endevor Transfer    *
    *                         Element function to be used are not  *
    *                         able to use the Enhanced Edit        *
    *                         capabilities to edit the elements.   *
    *                         The datasets returned for the list   *
    *                         of dependencies also include other   *
    *                         datasets that are not needed for     *
    *                         resolving the copy books             *
    *                      15.When a file that contains a x'00'    *
    *                         byte is edited from the CARMA        *
    *                         repositories view, the complete      *
    *                         file contents are not displayed      *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    01.If the codepage/CCSID of the NLS characters is not
       compatible with the default C/C++ locale on the z/OS system,
       the NLS characters may be damaged when converted to UTF-8.
    02.Some sites require that the CCID and COMMENT fields be
       specified for certain actions.  In order for the RDz client
       to determine when to require those fields, the Endevor RAM
       must provide this information when a list of systems is
       requested.
    03.Beginning with RDz version 9.0.1, the IRZPWSIO segmentation
       APIs will no longer be provided with RDz, but will be
       shipped with IMS and renamed to DFSPWSIO to reflect the IMS
       'DFS' prefix. Certain Enteprise Service Tools (EST) runtime
       messages reference IRZWPSIO segmentation APIs by name.
    04.Since the IRZPWSIO segmentation APIs define and implement an
       interface to multi-operation IMS Web service provider MPPs
       (a type of IMS application), the APIs are being made part of
       IMS to ensure their availability in the future.
    05.The RDz client is not picking up the last line of the
       jobcard that is sent by the Endevor RAM. Inserting a JCL
       comment line at the end of the Jobcard is a workaround. Or,
       the user can modify the Jobcard in the preview dialog.
    06.The RDz Endevor RAM did not specify in the RAM
       configurations the "Bypass Generate Processor" as one of the
       parameters to add to the dialog prompts.
    07.The RDz Endevor RAM did not provide the users with the
       ability to specify whether they want to invoke the Gneerate
       Processor during the Enhanced Edit. The element footprint
       may not be updated since the element is not generated when
       brought to the entry stage of the target environment.
    08.SMP/E workarea in sample xxx1SMPE job is too small, causing
       B37 space abend when installing service
    09.The data being sent to the RDz client sometimes has some bad
       characters due to the fact that the storage area that
       contains the list of dependencies is not initialized.
    10.CARMA startup fails when using CLIST startup method with the
       new (8 parameters) format. fekfivpc.log and rsecomm.log show
       the following trace message
    
       INFO com.ibm.carma.rse.server.transport.CARMASocketServer$1:
       REXX output:FEK.#CUST.CNTL(CRASUBMT)' is using the old format
       stderr head: //'FEK.#CUST.CNTL\(CRASUBMT\)': EDC5047I An
       invalid file name was specified as a function parameter.
       (errno2=0xC00B028E)
    
       Due to this faulty processing, CARMA always expects the CLIST
       to use the old format and does not provide all arguments the
       CLIST expects. The next lines in the log show that the
       startup fails because of this.
    
       ERROR: RC 560 for EXEC ' FEK.#CUST.CNTL(CRASUBMT)' '2731 '
       ENTER POSITIONAL PARAMETER CRAPRM2 -
       MISSING POSITIONAL PARAMETER CRAPRM2
       PROC 8 CRAPRM1 CRAPRM2 CRAPRM3 CRAPRM4 CRAPRM5 CRAPRM6
       CRAPRM7 CRAPRM8
       /usr/lpp/rdz/bin/carma.startup.rex ending with RC 15
    
       workaround: Correct REXX /usr/lpp/rdz/bin/carma.startup.rex
       by removing the Escape( and ) on line 225:
       call bpxwunix 'head -l1 "//'Escape(Clist)'"',,stdout.,stderr.
       becomes
       call bpxwunix 'head -l1 "//'Clist'"',,stdout.,stderr.
    11.updated host configuration utility to work with v9010
       configuration files
    12.Enhancement to pass client version and user exit invocation
       information to CARMA startup and CARMA RAM. CARMA startup
       and configuration files are enhanced to accept up to 8
       arguments, of which currently 4 are used (port, timeout,
       user exit and client version). CARMA startup also places
       this data in a new DD, CRAPARM, to allow a RAM to access the
       data.
    13.enhancement to allow execution of a user exit during
       CARMA server startup. CRASRV.properties has a new directive
       to specify the exit: #user.exit = 'FEK.SFEKSAMP(CRAEXIT)'
    
       #user.exit
       Defines the user-exit invoked by the CRAALLOC / CRANDVRA
       allocation execs. A sample user-exit is provided as
       FEK.SFEKSAMP(CRAEXIT). Uncomment and specify the name of the
       user-exit. When not enclosed in quotes, the client userid
       will be used as high level qualifier prefix.
    14.In order to bring the element being edited to the entry
       stage of the target environment, the RDz Endevor RAM makes
       use of the CA Endevor Transfer Element API.  For sites that
       do not allow the CA Endevor Transfer Element function, this
       means that their RDz users are not able to make use of the
       RDz Enhanced Edit capabilities when retrieving elements from
       the CA Endevor repository. When the Endevor RAM requests the
       list of components from the CA Endevor API, this list also
       includes datasets that are used during the linkedit step.
       When those datasets are sent to the RDz client, their record
       format is not compatible with the record format used by the
       copybook datasets.  This causes message "Record format not
       allowed" to be shown in the log.
    15.When CARMA users access a file that contains a x'00' byte,
       the record that contains the byte is truncated and the
       complete file is not displayed
    

Problem conclusion

  • 01.A new test runner parameter has been added to allow
       specification of a C/C++ compiled locale to use when
       converting native character data to/from UTF-8.
    02.The RDz Endevor RAM is being enhanced to provide information
       about whether the CCID and COMMENT are required when a list
       of systems is requested.
    03.Enteprise Services Tools (EST) runtime messages that
       reference renamed IRZPWSIO APIs will be updated to reflect
       the IMS 'DFS' prefix. EST runtime messages IRZ0500S and
       IRZ0501S have been updated to the following text:
    04.Beginning with RDz version 9.0.1, the IRZPWSIO segmentation
       APIs will no longer be provided with RDz. The IRZPWSIO APIs
       will be renamed to DFSPWSIO to reflect the IMS 'DFS' prefix
       and will be shipped with IMS. Artifacts generated for the
       WSDL2PLI (IMS PL/I top-down) scenario using RDz version
       9.0.1 will reference the renamed DFSPWSIO APIs only (e.g,
       DFSXGETS, DFSXSETS, DFSQGETS, DFSQSETS). Important: A
       temporary, non-functional IRZWPSIO stub module will be
       shipped with RDz version 9.0.1. This stub will issue one of
       the following fatal IRZ9999S messages if an attempt is made
       to use it at execution time:
       o IRZ9999S API IRZXGETS IS NO LONGER SUPPORTED. IT IS
         REPLACED BY IMS API DFSXGETS.
       o IRZ9999S API IRZXSETS IS NO LONGER SUPPORTED. IT IS
         REPLACED BY IMS API DFSXSETS.
       o IRZ9999S API IRZQGETS IS NO LONGER SUPPORTED. IT IS
         REPLACED BY IMS API DFSQGETS.
       o IRZ9999S API IRZQSETS IS NO LONGER SUPPORTED. IT IS
         REPLACED BY IMS API DFSQSETS.
       o IRZ9999S API IRZB64E IS NO LONGER SUPPORTED. IT IS
         REPLACED BY IMS API DFSB64E.
       o IRZ9999S API IRZB64D IS NO LONGER SUPPORTED. IT IS
         REPLACED BY IMS API DFSB64D.
       o IRZ9999S API IRZLOCXE IS NO LONGER SUPPORTED. IT IS
         REPLACED BY IMS API DFSLOCXE.
    05.The RDz Endevor RAM is being changed to insert a JCL comment
       line at the end of the jobcard so that if the RDz client
       drops the last line, the original default Jobcard that is
       presented in the preview dialog is what is expected.
    06.The RDz Endevor RAM configurations file is being changed to
       add the "Bypass Generate Processor" as one of the parameters
       of the dialog prompt for Enhanced Edit.
    07.The RDz Endevor RAM did not provide the users with the
       ability to specify whether they want to invoke the Gneerate
       Processor during the Enhanced Edit.
    08.enlarged workarea definitions global, target, dlib SYSUT1:
       CYL,(20,200) target, dlib SMPWRK6: CYL,(20,200)
    09.The RDz Endevor RAM passes the exact size of the storage
       that contains the list of dependencies. If that size is
       smaller than that of the target field, the residual content
       of the target field may contain some bad characters.
    10.carma.startup.rex is corrected
    11.updated host configuration utility to work with v9010
       configuration files
    12.Enhancement to pass client version and user exit invocation
       information to CARMA startup and CARMA RAM. CARMA startup
       and configuration files are enhanced to accept up to 8
       arguments, of which currently 4 are used (port, timeout,
       user exit and client version). CARMA startup also places
       this data in a new DD, CRAPARM, to allow a RAM to access the
       data.
    13.enhancement to allow execution of a user exit during
       CARMA server startup. CRASRV.properties has a new directive
       to specify the exit: #user.exit = 'FEK.SFEKSAMP(CRAEXIT)'
    14.The RDz Endevor RAM is being enhanced to allow the systems
       administrator to indicate whether to use an alternative
       method for getting the element from the source location into
       the entry stage of the target location.
    15.The CARMA Server code was truncating file records that
       contained a x'00' byte. The server code has been modified so
       that it no longer truncates the file records and the x'00'
       byte is sent to the client along with the rest of the data
       in the file.
    

Temporary fix

Comments

APAR Information

  • APAR number

    PM91735

  • Reported component name

    RD/Z HOST

  • Reported component ID

    5724T0723

  • Reported release

    900

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2013-06-24

  • Closed date

    2013-11-29

  • Last modified date

    2013-12-12

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

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

Modules/Macros

  • AZUFZUNI AZUTSTRN AZUZUNIT BWBVER   CRAALLOC
    CRACFG   CRAEXIT  CRAMAJAR CRANDVRA CRAREXX  CRARNDVR CRASCFCA
    CRASCONF CRASERV  CRASRV   CRASTART CRASUBCA CRASUBMT CRA0VCAD
    ELAXFGO  FEKCARB1 FEKCARB2 FEKCOPY  FEKCRASR FEKCRCNE FEKCRCNF
    FEKCSET  FEKFCMOD FEKFCMPR FEKFCOPY FEKFIVPJ FEKFIVP0 FEKFRSES
    FEKINIT  FEKLOGR  FEKLOGS  FEKMAIN  FEKRACF  FEKRSEDE FEKSETUP
    FEKZUNIT FEK1SMPE IRZMENG  IRZMUEN  IRZPWSH  IRZPWSIO
    

Fix information

  • Fixed component name

    RD/Z HOST

  • Fixed component ID

    5724T0723

Applicable component levels

  • R900 PSY UI13095

       UP13/12/12 I 1000

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.



Document information

More support for: Rational Developer for System z

Software version: 9.0

Reference #: PM91735

Modified date: 12 December 2013