Installation instructions for fix UO03550 for Explorer for z/OS v3.4, service level 3.4.2 (FMID HALG340)

The fix is shipped as file IBM.HALG340.UO03550

The fix has rework (build) date 2025160 (9 Jun 2025)

The following fixes are prerequisites for this fix:

The following fixes are corequisites for this fix:

The following fixes are superseded by this fix:

AH65293 AH66886 UO02100

Overview of the installation steps

Steps required to install the fix:

  1. Allocate host data sets for the fix.
  2. Upload the fix from your workstation to z/OS.
  3. SMP/E hold information for the fix.
  4. Perform SMP/E ACCEPT for the prerequisites.
  5. Perform SMP/E RECEIVE and APPLY for the fix.
  6. Restart started tasks to activate changes.

Allocate host data sets for the fix

A sequential data set must be allocated on the z/OS system to receive the fix that you will upload from your workstation. You can do this by submitting the job below. Add a job card and modify the parameters to meet your site's requirements before submitting.

//         SET HLQ=#hlq
//*
//ALLOC    EXEC PGM=IEFBR14
//UO03550    DD DSN=&HLQ..IBM.HALG340.UO03550,
//            DISP=(NEW,CATLG,DELETE),
//            DSORG=PS,
//            RECFM=FB,
//            LRECL=80,
//            UNIT=SYSALLDA,
//*            VOL=SER=volser,
//*            BLKSIZE=6160,
//            SPACE=(TRK,(197,30))
//*

Upload the fix from your workstation to z/OS

Upload the file in binary format from your workstation to the z/OS data set. On a Windows system, you can use FTP from a command prompt to upload the file. In the sample dialog shown below, commands or other information entered by the user are in bold, and the following values are assumed:

User enters: Values
mvsaddr TCP/IP address of the z/OS system
tsouid Your TSO user ID
tsopw Your TSO password
d: Your drive containing the fix files
hlq High-level qualifier that you used for the data set that you allocated in the job above
C:\>ftp mvsaddr
Connected to mvsaddr.
220-FTPD1 IBM FTP CS %version% at mvsaddr, %time% on %date%.
220 Connection will close if idle for more than 60 minutes.

User (mvsaddr:(none)): tsouid
331 Send password please.

Password: tsopw
230 tsouid is logged on.  Working directory is "tsouid.".

ftp> cd ..
250 "" is the working directory name prefix.

ftp> cd hlq
250 "hlq." is the working directory name prefix.

ftp> binary
200 Representation type is Image

ftp> put d:\IBM.HALG340.UO03550
200 Port request OK.
125 Storing data set hlq.IBM.HALG340.UO03550
250 Transfer completed successfully
10843680 bytes sent in 0.28 seconds

ftp> quit
221 Quit command received. Goodbye.

SMP/E hold information for the fix

++HOLD(UO03550) SYSTEM FMID(HALG340) REASON(ACTION) DATE(25159)                 
  COMMENT(                                                                      
  ****************************************************************              
  * Affected function: RSE                                       *              
  ****************************************************************              
  * Description: new environment variables                       *              
  ****************************************************************              
  * Timing: pre-APPLY                                            *              
  ****************************************************************              
  * Part: /usr/lpp/IBM/zexpl/samples/rse.env                     *              
  *       Ý/etc/zexpl/rse.env¨                                   *              
  ****************************************************************              
  This fix updates the sample rse.env by adding the                             
  following optional directives:                                                
                                                                                
  _RSE_MVS_TEMP_QUALIFIER                                                       
    Customize the second qualifier of temporary data set names                  
    used in load module copy. Uncomment and provide a valid data                
    set name qualifier if the default values do not match your                  
    data set naming convention.                                                 
                                                                                
  ****************************************************************              
  * Affected function: RSE                                       *              
  ****************************************************************              
  * Description: new environment variables                       *              
  ****************************************************************              
  * Timing: post-APPLY                                           *              
  ****************************************************************              
  * Part: /usr/lpp/IBM/zexpl/samples/rse.env                     *              
  *       Ý/etc/zexpl/rse.env¨                                   *              
  ****************************************************************              
  This fix updated sample file rse.env.                                         
  Redo your customizations, if any, after applying this                         
  maintenance.                                                                  
                                                                                
  ****************************************************************              
  * Affected function: RSE                                       *              
  ****************************************************************              
  * Description: new environment variables                       *              
  ****************************************************************              
  * Timing: pre-APPLY                                            *              
  ****************************************************************              
  * Part: /usr/lpp/IBM/zexpl/samples/rse.env                     *              
  *       Ý/etc/zexpl/rse.env¨                                   *              
  ****************************************************************              
  This fix updates the sample rse.env by adding the                             
  following optional directives:                                                
                                                                                
  RSE_CLIENT_CERT_AUTH_ONLY                                                     
    Specifies which authentication methods are accepted for a new               
    connection. The default is false, which allows either client                
    certificate authentication, or user ID plus password,                       
    passphrase, OTP (one time password), or MFA (multi factor                   
    authetication). Uncomment and specify true to only accept                   
    client certificate authentication.                                          
                                                                                
  ****************************************************************              
  * Affected function: RSE                                       *              
  ****************************************************************              
  * Description: new environment variables                       *              
  ****************************************************************              
  * Timing: post-APPLY                                           *              
  ****************************************************************              
  * Part: /usr/lpp/IBM/zexpl/samples/rse.env                     *              
  *       Ý/etc/zexpl/rse.env¨                                   *              
  ****************************************************************              
  This fix updated sample file rse.env.                                         
  Redo your customizations, if any, after applying this                         
  maintenance.                                                                  
                                                                                
  ****************************************************************              
  * Affected function: RSE                                       *              
  ****************************************************************              
  * Description: new environment variables                       *              
  ****************************************************************              
  * Timing: pre-APPLY                                            *              
  ****************************************************************              
  * Part: /usr/lpp/IBM/zexpl/samples/rse.env                     *              
  *       Ý/etc/zexpl/rse.env¨                                   *              
  ****************************************************************              
  This fix updates the sample rse.env by adding the                             
  following optional directives:                                                
                                                                                
  MINIMUM_CLIENT_VERSIONS                                                       
    Report clients that do not meet the specified minimum service               
    level. Uncomment and specify the minimum version for IBM                    
    Explorer for z/OS clients (product ID 5655EX1) and IBM                      
    Developer for z/OS (IDz) clients (product ID 5724T07).                      
    The product ID and the version are separated by a comma (,).                
    The information of different products is separated by a colon               
    (:). E.g. "5655EX1,3.4.2.0:5724T07,17.0.2".                                 
                                                                                
  MINIMUM_CLIENT_VERSIONS_VALIDATION_LEVEL                                      
    Specify the log level used to report clients that do not meet               
    the minimum client level specified in MINIMUM_CLIENT_VERSIONS.              
    The default is INFO (debugLevel 2). Uncomment and specify the               
    desired severity level;                                                     
    INFO (debugLevel 2)                                                         
    WARN (debugLevel 1)                                                         
    ERROR (debugLevel 0)                                                        
                                                                                
  ****************************************************************              
  * Affected function: RSE                                       *              
  ****************************************************************              
  * Description: new environment variables                       *              
  ****************************************************************              
  * Timing: post-APPLY                                           *              
  ****************************************************************              
  * Part: /usr/lpp/IBM/zexpl/samples/rse.env                     *              
  *       Ý/etc/zexpl/rse.env¨                                   *              
  ****************************************************************              
  This fix updated sample file rse.env.                                         
  Redo your customizations, if any, after applying this                         
  maintenance.                                                                  
                                                                                
  ****************************************************************              
  * Affected function: RSE                                       *              
  ****************************************************************              
  * Description: changed default for environment variable        *              
  ****************************************************************              
  * Timing: pre-APPLY                                            *              
  ****************************************************************              
  * Part: /usr/lpp/IBM/zexpl/samples/rse.env                     *              
  *       Ý/etc/zexpl/rse.env¨                                   *              
  ****************************************************************              
  This fix updates the sample rse.env by changing the                           
  following optional directive:                                                 
                                                                                
  GSK_V3_CIPHER_SPECS_EXPANDED                                                  
    The default changed from 130113021303 to                                    
    130113021303C02CC02BC030C02F (which covers TLS 1.3 and TLS 1.2              
    ciphers).                                                                   
                                                                                
  ****************************************************************              
  * Affected function: RSE                                       *              
  ****************************************************************              
  * Description: new environment variables                       *              
  ****************************************************************              
  * Timing: post-APPLY                                           *              
  ****************************************************************              
  * Part: /usr/lpp/IBM/zexpl/samples/rse.env                     *              
  *       Ý/etc/zexpl/rse.env¨                                   *              
  ****************************************************************              
  This fix updated sample file rse.env.                                         
  Redo your customizations, if any, after applying this                         
  maintenance.                                                                  
                                                                                
  ****************************************************************              
  * Affected function: RSE                                       *              
  ****************************************************************              
  * Description: changed default for environment variable        *              
  ****************************************************************              
  * Timing: pre-APPLY                                            *              
  ****************************************************************              
  * Part: /usr/lpp/IBM/zexpl/samples/rse.env                     *              
  *       Ý/etc/zexpl/rse.env¨                                   *              
  ****************************************************************              
  This fix updates the sample rse.env by changing the                           
  following optional directive:                                                 
                                                                                
  JAVA_HOME                                                                     
    The default value changes from Java 8 31-bit to Java 8 64-bit.              
    Uncomment and update the variable if RSED must continue to use              
    the 31-bit version.                                                         
  ).                                                                            
  

Perform SMP/E ACCEPT for the prerequisites

SMP/E ACCEPT the prerequisites to facilitate an easy backout of the fix, if required. Note that once accepted, you cannot backout the accepted prerequisites.

This step can be skipped if there are no prerequisites, or if there is a reason to not make a prerequisite permanent.

You can accept the prerequisites by submitting the job below. Add a job card and modify the parameters to meet your site's requirements before submitting.

//*
//* Change #globalcsi to the data set name of your global CSI.
//* Change #dzone to your CSI distribution zone name.
//*
//ACCEPT   EXEC PGM=GIMSMP,REGION=0M
//SMPCSI   DD DISP=OLD,DSN=#globalcsi
//SMPCNTL  DD *
   SET BOUNDARY(#dzone) .
   ACCEPT SELECT(
   ) REDO COMPRESS(ALL) BYPASS(HOLDSYS,HOLDERROR).
//*

Perform SMP/E RECEIVE and APPLY for the fix

SMP/E RECEIVE and APPLY the fix.

You can do this by submitting the job below. Add a job card and modify the parameters to meet your site's requirements before submitting.

//*
//* Change #hlq to the high level qualifier used to upload the fix.
//* Change (2x) #globalcsi to the data set name of your global CSI.
//* Change #tzone to your CSI target zone name.
//*
//         SET HLQ=#hlq
//*
//RECEIVE  EXEC PGM=GIMSMP,REGION=0M
//SMPCSI   DD DISP=OLD,DSN=#globalcsi
//SMPPTFIN DD DISP=SHR,DSN=&HLQ..IBM.HALG340.UO03550
//SMPCNTL  DD *
   SET BOUNDARY(GLOBAL) .
   RECEIVE SELECT(
     UO03550
   ) SYSMODS LIST .
//*
//APPLY    EXEC PGM=GIMSMP,REGION=0M
//SMPCSI   DD DISP=OLD,DSN=#globalcsi
//SMPCNTL  DD *
   SET BOUNDARY(#tzone) .
   APPLY SELECT(
     UO03550
   ) REDO COMPRESS(ALL) BYPASS(HOLDSYS,HOLDERROR).
//*

Restart started tasks to activate changes

Restart started tasks to activate changes.