Installation instructions for fix UO03545 for Remote System Explorer API v1.2, service level 1.2.2 (FMID HAMA120)

The fix is shipped as file IBM.HAMA120.UO03545

The fix has rework (build) date 2025163 (12 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:

AH65340 AH66324 AH66330 UO02150 UO02987

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
//UO03545    DD DSN=&HLQ..IBM.HAMA120.UO03545,
//            DISP=(NEW,CATLG,DELETE),
//            DSORG=PS,
//            RECFM=FB,
//            LRECL=80,
//            UNIT=SYSALLDA,
//*            VOL=SER=volser,
//*            BLKSIZE=6160,
//            SPACE=(TRK,(1162,230))
//*

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.HAMA120.UO03545
200 Port request OK.
125 Storing data set hlq.IBM.HAMA120.UO03545
250 Transfer completed successfully
64115280 bytes sent in 0.28 seconds

ftp> quit
221 Quit command received. Goodbye.

SMP/E hold information for the fix

++HOLD(UO03545) SYSTEM FMID(HAMA120) REASON(ACTION) DATE(25159)                 
  COMMENT(                                                                      
  ****************************************************************              
  * Affected function: RSEAPI                                    *              
  ****************************************************************              
  * Description: started task JCL update                         *              
  ****************************************************************              
  * Timing: post-APPLY                                           *              
  ****************************************************************              
  * Part: HUH.SHUHSAMP(HUHSTC)                                   *              
  *       İHUH.#CUST.PROCLIB(RSEAPI)¨                            *              
  ****************************************************************              
  This fix updates the RSEAPI started task JCL procedure. Instead               
  of BPXBATCH, now BPXBATSL is used to start the server.                        
  Without this change, the console listener is spawned in a child               
  address space, RSEAPI1, so to stop the server you must issue                  
  operator command STOP RSEAPI1 for RSEAPI to see the request.                  
  With this change, the console listener is active in the RSEAPI                
  address space, so you can issue STOP RSEAPI, as expected.                     
                                                                                
  ****************************************************************              
  * Affected function: configuration                             *              
  ****************************************************************              
  * Description: new environment variable                        *              
  ****************************************************************              
  * Timing: post-APPLY                                           *              
  ****************************************************************              
  * Part: tomcat.base/samples/rseapi.env                         *              
  *       {/etc/zexpl/rseapi.env}                                *              
  ****************************************************************              
  This fix updates the sample rseapi.env by adding the                          
  following optional directives:                                                
                                                                                
  #RSE_LOGGER_PAUSE_ENABLE=true                                                 
    Pause writing non-critical user log messages during times of                
    high log management overhead due to out-of-space conditions.                
    The default is false. Set it to true to enable the feature.                 
                                                                                
  Redo your customizations, if any, after applying this                         
  maintenance.                                                                  
                                                                                
  ****************************************************************              
  * Affected function: configuration                             *              
  ****************************************************************              
  * Description: deploy configuration file                       *              
  ****************************************************************              
  * Timing: post-APPLY                                           *              
  ****************************************************************              
  * Part: tomcat.base/samples/mvsMappings.json                   *              
  *       {/etc/zexpl/mvsMappings.json}                          *              
  ****************************************************************              
  mvsMappings.json is an existing configuration file to instruct                
  RSEAPI on how to work with data set members. A sample was                     
  provided only in the documentation, and at startup, RSEAPI would              
  attempt to create the file (as specified in rseapi.env variable               
  RSEAPI_MVS_MAPPING_FILE) if the file does not exist.                          
  With this update, a sample mvsMappings.json file is shipped in                
  the tomcat.base/samples directory, and copied to your                         
  configuration directory when executing SHUHSAMP(HUHSETUP).                    
  ).                                                                            
  

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.HAMA120.UO03545
//SMPCNTL  DD *
   SET BOUNDARY(GLOBAL) .
   RECEIVE SELECT(
     UO03545
   ) SYSMODS LIST .
//*
//APPLY    EXEC PGM=GIMSMP,REGION=0M
//SMPCSI   DD DISP=OLD,DSN=#globalcsi
//SMPCNTL  DD *
   SET BOUNDARY(#tzone) .
   APPLY SELECT(
     UO03545
   ) REDO COMPRESS(ALL) BYPASS(HOLDSYS,HOLDERROR).
//*

Restart started tasks to activate changes

Restart started tasks to activate changes.