IBM Support

PI87570: EXPLORER FOR ZOS MODIFY COMMAND REJECTED IF RSE DAEMON STARTED TASKNAME IS 8 CHARACTERS

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • IBM Explorer for z/OS v3.1.0
    
    MODIFY commands are rejected if the RSE Daemon started task
    name is 8 characters.
    
    The RSE Daemon started task name must be 7 characters or less
    to allow for the Unix child task suffix.
    
    
    Sample RSE Daemon started task JCL member FEKRSED in SFEKSAMP
    should be updated with a note in the comments describing the
    maximum of seven characters for the RSED STC name.
    
    Additional Symptom(s) Search Keyword(s): KIXREVWJB
    

Local fix

  • Use an STC name of 7 characters or less for the RSE Daemon.
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED: 01. All zOS Explorer and IDz users           *
    *                 02. All zOS Explorer and IDz users           *
    *                 03. All users who use RSE tables to sort     *
    *                     members.                                 *
    *                 04. All zOS Explorer and IDz users           *
    *                 05. All zOS Explorer and IDz users           *
    *                 06. All zOS Explorer and IDz users           *
    *                 07. z/OS Explorer support                    *
    *                 08. All zOS Explorer and IDz users           *
    *                 09. All zOS Explorer and IDz users           *
    *                 10. All zOS Explorer and IDz users           *
    *                 11. SYSPLEX users utilizing job completion   *
    *                     Notify.                                  *
    ****************************************************************
    * PROBLEM DESCRIPTION: 01. z/OS Explorer: MODIFY commands are  *
    *                          rejected if the RSE Daemon started  *
    *                          task name is 8 characters.          *
    *                      02. In some cases, incorrect processing *
    *                          may cause a carriage return in an   *
    *                          MVS text file to be converted to a  *
    *                          substitution character.             *
    *                      03. There are big performance problems  *
    *                          when using an RSE table to sort a   *
    *                          large number of members (i.e. 1k+). *
    *                          A big part of the problem is that   *
    *                          each member's attributes have to be *
    *                          separate queried.  This enhancement *
    *                          provides a new command allowing the *
    *                          client to query the attributes of a *
    *                          large number of members at once     *
    *                          which is significantly faster than  *
    *                          doing individual queries.           *
    *                      04. Remote System connections remain    *
    *                          active even after                   *
    *                          Multi-Factor Authentication (MFA)   *
    *                          sessions have expired.              *
    *                      05. When using the "Show Steps" feature *
    *                          on JES jobs within IBM Explorer for *
    *                          z/OS, all step dates after August   *
    *                          may display as Dec 31.              *
    *                      06. IBM z/OS Explorer Unused sockets    *
    *                          are kept in storage                 *
    *                      07. Enhance log gathering tool          *
    *                      08. Users who know exact dataset names  *
    *                          cannot access the data sets without *
    *                          having access to any catalog,       *
    *                          including the one where that        *
    *                          dataset is defined.                 *
    *                      09. When a user deletes .eclipse        *
    *                          directory with all his files in his *
    *                          uss home directory and connects to  *
    *                          RSE server, the syslog message      *
    *                          ICH408I on STATVFS may be shown.    *
    *                      10. IBM z/OS Explorer RSE user logs may *
    *                          be written to the user's home       *
    *                          directory rather than the location  *
    *                          specified by the user.log server    *
    *                          config property.                    *
    *                      11. Job completion Notify only works    *
    *                          for jobs running on the local       *
    *                          system.                             *
    ****************************************************************
    01. z/OS Explorer: MODIFY commands are rejected if the RSE
        Daemon started task name is 8 characters.
    02. When uploading an MVS text file, the flags indicating
        text/binary can be set in multiple messages sent from client
        to host. In some cases, incorrect processing may cause a
        carriage return in an MVS text file to be converted to a
        substitution character.
    03. There are big performance problems when using an RSE table
        to sort a large number of members (i.e. 1k+).  A big part of
        the problem is that each member's attributes have to be
        separate queried.  This enhancement provides a new command
        allowing the client to query the attributes of a large
        number of members at once which is significantly faster than
        doing individual queries.
    04. Remote System connections remain active even after
        Multi-Factor Authentication (MFA) sessions have expired.
    05. When using the "Show Steps" feature on JES jobs within IBM
        Explorer for z/OS, all step dates after August may display
        as Dec 31.  A counter overflow when calculating dates
        causing incorrect results for days after 255 in the year.
    06. RSE server does not check the result of close() when it
        closes a socket connected from a client. As a result, even
        if tcp connection are correctly moved to the closed state,
        socket descriptors for unsuccessful close() remain in zos.
    07. Enhancements and bug fixes for log gathering tool:
        InList avoid substr(list,0), bug show server log, skip
        validation if PTC or ISPF don't exist, always init
        UpdatedSince, verify file permits, verify HLQ.
    08. Users who know exact dataset names cannot access the
        datasets without having access to any catalog, including the
        one where that dataset is defined. Unlike ISPF, RDz always
        searches catalogs to process filters.
    09. When a user deletes .eclipse directory with all his files in
        his uss home directory and connects to RSE server, the
        syslog message as below may be shown.
    
    17199 17:03:17.60 S0082344 01000000  ICH408I USER(WDZT    )
    GROUP (STC1  ) NAME(RDZ                 )
       318 ..    /u/user1/.eclipse/RSE_TEST/user1/
       318 ..  CL(DIRSRCH ) .....
       318 ..  INSUFFICIENT AUTHORITY TO  STATVFS
       318 ..  ACCESS INTENT(--X)  ACCESS  ALLOWED(OTHER ---)
       318 ..  EFFECTIVE UID(1000000005)   EFFECTIVE GID(0000002000)
    
    10. IBM z/OS Explorer RSE user logs may be written to the user's
        home directory rather than the location specified by the
        user.log server config property.  Using the RSE server with
        some versions of Java 8 may write the logs into an incorrect
        location.
    11. Job completion Notify only works for jobs running on the
        local system, not jobs that run on other systems within the
        SYSPLEX.
    

Problem conclusion

  • 01. Sample RSE Daemon started task JCL member FEKRSED in
        SFEKSAMP has been updated with a note in the comments
        describing the maximum of seven characters for the RSED STC
        name.
    02. The host module is updated to look at the text/binary flag
        only in the first uploading message to detect the
        text/binary mode for the uploading file correctly.
    03. The host modules is updated to support the new enhancement.
    04. Updated host modules to close the RSE connection when MFA
        session expiry is detected.
    05. IBM Explorer for z/OS host modules have been updated.
    06. RSE server has been updated to retry calling close() for
        sockets when the previous call return errno=EAGAIN.
    07. Enhancements and bug fixes for log gathering tool.
    08. z/OS Explorer host code is updated to process filters by
        LOCATE macro if there is no wild card character in a filter
        string.
    09. The host module is updated to make the logging thread with
        the correct user authority be the only one that writes to
        rsecomm.log file.
    10. z/OS Explorer host code has been updated.
    11. JMON is updated to receive SYSPLEX signals as well. Requires
        matching ENF exit (v1.0.2).
    

Temporary fix

Comments

APAR Information

  • APAR number

    PI87570

  • Reported component name

    EXP FOR Z/OS HO

  • Reported component ID

    5655EXP23

  • Reported release

    310

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2017-09-19

  • Closed date

    2017-10-16

  • Last modified date

    2017-11-01

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

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

    UI51053

Modules/Macros

  • FEJENF70 FEJJCNFG FEJJJCL  FEJJMON  FEJTSO   FEK1SMPE FEK2RCVE
    FEK3ALOC FEK4ZFS  FEK5MKD  FEK6DDEF FEK7APLY FEK8ACPT FEK@CERR
    FEK@CONE FEK@CONF FEK@CUST FEK@DEB  FEK@DESC FEK@FLOW FEK@GEN
    FEK@GENW FEK@ISPF FEK@IVP  FEK@IVPD FEK@IVPW FEK@JCN1 FEK@JCNE
    FEK@JESJ FEK@MAIN FEK@MIGO FEK@OPTE FEK@OPTG FEK@OPTN FEK@PRIM
    FEK@RSE1 FEK@RSEO FEK@STRT FEK@TAB1 FEK@TAB2 FEK@TAB3 FEK@WRK1
    FEK@WRK2 FEK@WRK3 FEK@WRK4 FEK@WRK5 FEKAPPCC FEKAPPCL FEKAPPCX
    FEKDSI   FEKEESX0 FEKFASIZ FEKFBLD  FEKFCIPH FEKFCLIE FEKFCMOD
    FEKFCMPR FEKFCMSG FEKFCOMM FEKFCOPY FEKFCOR6 FEKFCORE FEKFDBGM
    FEKFDIR  FEKFDIR6 FEKFDIVP FEKFDST0 FEKFDST1 FEKFDST2 FEKFENVF
    FEKFENVI FEKFENVP FEKFENVR FEKFENVS FEKFEPL  FEKFICUL FEKFISPF
    FEKFIVP0 FEKFIVPA FEKFIVPD FEKFIVPI FEKFIVPJ FEKFIVPT FEKFJESM
    FEKFJESU FEKFJVM  FEKFLDSI FEKFLDSL FEKFLEOP FEKFLOGS FEKFLPTH
    FEKFMAI6 FEKFMAIN FEKFMINE FEKFMINS FEKFMNTL FEKFNTCE FEKFOMVS
    FEKFPATT FEKFPRDS FEKFPTC  FEKFRIVP FEKFRMSG FEKFRSES FEKFRSRV
    FEKFSCMD FEKFSEND FEKFSSL  FEKFSTUP FEKFT000 FEKFT001 FEKFTIVP
    FEKFTRKS FEKFTSO  FEKFUTIL FEKFVERS FEKFXITA FEKFXITL FEKFZME
    FEKFZMF  FEKFZOS  FEKHCONF FEKHCUST FEKHDEB  FEKHDESC FEKHFLOW
    FEKHGEN  FEKHISPF FEKHIVP  FEKHIVPD FEKHJESJ FEKHMAIN FEKHMIGO
    FEKHOPTE FEKHOPTN FEKHPRIM FEKHRSE1 FEKHRSEO FEKHSTRT FEKHTAB1
    FEKHTAB2 FEKINIT  FEKKEYS  FEKLOGR  FEKLOGS  FEKM00   FEKM01
    FEKM02   FEKMKDIR FEKMOUNT FEKMSGC  FEKMSGS  FEKRACF  FEKRSED
    FEKSAPF  FEKSAPPL FEKSBPX  FEKSCLAS FEKSCLOG FEKSCMD  FEKSCPYM
    FEKSCPYU FEKSDSN  FEKSENV  FEKSETUP FEKSISPF FEKSJCFG FEKSJCMD
    FEKSJMON FEKSLPA  FEKSPROG FEKSPTKT FEKSRSED FEKSSERV FEKSSTC
    FEKSSU   FEKSUSER FEKXCFGE FEKXCFGI FEKXCFGM FEKXCFGT FEKXMAIN
    FEKXML
    

Fix information

  • Fixed component name

    EXP FOR Z/OS HO

  • Fixed component ID

    5655EXP23

Applicable component levels

  • R310 PSY UI51053

       UP17/10/30 P F710

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.

[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSBDYH","label":"IBM Explorer for z\/OS"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"310","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}},{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"310","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
01 November 2017