The fix is shipped as file IBM.HHOP850.UI24911
The fix has rework (build) date 2015034 (3 Feb 2015)
The following fixes are prerequisites for this fix:
These prerequisites can be downloaded from the Developer for System z Recommended Fixes page, if not included as file IBM.HHOP850.<prereq>.
Steps required to install 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.
//ALLOC EXEC PGM=IEFBR14 //* //UI24911 DD DSN=hlq.IBM.HHOP850.UI24911, // DISP=(NEW,CATLG,DELETE), // DSORG=PS, // RECFM=FB, // LRECL=80, // UNIT=SYSALLDA, //* VOL=SER=volser, //* BLKSIZE=6160, // SPACE=(TRK,(105,20)) //*
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 | TC P/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.HHOP850.UI24911 200 Port request OK. 125 Storing data set hlq.IBM.HHOP850.UI24911 250 Transfer completed successfully 5857680 bytes sent in 0.28 seconds ftp> quit 221 Quit command received. Goodbye.
++HOLD(UI24911) SYS FMID(HHOP850) REASON(ACTION) DATE(15034)
COMMENT
(****************************************************************
* Affected function: APPC *
****************************************************************
* Description: changed environment variables *
****************************************************************
* Timing: pre-APPLY *
****************************************************************
* Part: /usr/lpp/rdz/samples/rsed.envvars *
* [/etc/rdz/rsed.envvars] *
****************************************************************
This fix updates the sample rsed.envvars by making the
following optional directives mandatory if APPC is used to
connect to the TSO Commands service. Note that the default
connection method is the ISPF Client Gateway.
#_FEKFSCMD_PARTNER_LU_=
Specify the APPC partner LU. Specifying the APPC base LU as
partner LU is acceptable. This is a required directive for
APPC usage.
****************************************************************
* Affected function: APPC *
****************************************************************
* Description: new environment variables *
****************************************************************
* Timing: post-APPLY *
****************************************************************
* Part: /usr/lpp/rdz/samples/rsed.envvars *
* [/etc/rdz/rsed.envvars] *
****************************************************************
This fix updated sample file rsed.envvars.
Redo your customizations, if any, after applying this
maintenance.
****************************************************************
* Affected function: APPC *
****************************************************************
* Description: new security setup *
****************************************************************
* Timing: pre-APPLY *
****************************************************************
* Part: none *
****************************************************************
This fix updates how RSE authenticates with APPC, when APPC is
used to connect to the TSO Commands service. Note that the
default connection method is the ISPF Client Gateway.
RSE will now generate a passticket to do the authentication.
To do so, RSE requires additional permits, as APPC requires that
the partner-LU is used as APPLID.
The following sample RACF commands can be used to define the
additional permits. Except for the APPLID value, these commands
are identical to the passticket-related commands that allow RSE
to create passtickets for APPLID FEKAPPL.
- replace luname with the partner-LU name, as specified in
rsed.envvars variable _FEKFSCMD_PARTNER_LU_
- change "key16 " to a secret, user-provided,
16 character string with only these characters:
0123456789ABCDEF
- replace stcrse with the userid of the RSED started task
RDEFINE PTKTDATA luname UACC(NONE) -
DATA('RATIONAL DEVELOPER FOR SYSTEM Z') -
APPLDATA('NO REPLAY PROTECTION - DO NOT CHANGE') -
SSIGNON(KEYMASKED(key16 ))
RDEFINE PTKTDATA IRRPTAUTH.luname.* UACC(NONE) -
DATA('RATIONAL DEVELOPER FOR SYSTEM Z')
PERMIT IRRPTAUTH.luname.* CLASS(PTKTDATA) ACCESS(UPDATE) -
ID(stcrse)
SETROPTS RACLIST(PTKTDATA) REFRESH
# show results
RLIST PTKTDATA luname ALL SSIGNON
RLIST PTKTDATA IRRPTAUTH.luname.* ALL
****************************************************************
* Affected function: RSE *
****************************************************************
* Description: new environment variables *
****************************************************************
* Timing: pre-APPLY *
****************************************************************
* Part: /usr/lpp/rdz/samples/rsed.envvars *
* [/etc/rdz/rsed.envvars] *
****************************************************************
This fix updates the sample rsed.envvars by adding the
following optional directives:
#_RSE_JAVAOPTS="$_RSE_JAVAOPTS
-Dsearch.server.limit.errcount=true"
Limit the resource usage of non-indexed file and text
searches. The default is false (no limit). Uncomment and
specify true to stop a search before it exceeds a non-zero
Language Environment (LE) ERRCOUNT value.
****************************************************************
* Affected function: RSE *
****************************************************************
* Description: removed environment variables *
****************************************************************
* Timing: pre-APPLY *
****************************************************************
* Part: /usr/lpp/rdz/samples/rsed.envvars *
* [/etc/rdz/rsed.envvars] *
****************************************************************
This fix updates the sample rsed.envvars by REMOVING the
following optional directives:
#_RSE_JAVAOPTS="$_RSE_JAVAOPTS -Denable.saf.check=true"
****************************************************************
* Affected function: RSE *
****************************************************************
* Description: new environment variables *
****************************************************************
* Timing: post-APPLY *
****************************************************************
* Part: /usr/lpp/rdz/samples/rsed.envvars *
* [/etc/rdz/rsed.envvars] *
****************************************************************
This fix updated sample file rsed.envvars.
Redo your customizations, if any, after applying this
maintenance.
****************************************************************
* Affected function: system usage *
****************************************************************
* Description: new LPA load module. *
****************************************************************
* Timing: pre-APPLY *
****************************************************************
* Part: n/a *
****************************************************************
This service will move loadmodule FEKDSI from FEK.SFEKLOAD to
FEK.SFEKLPA. FEK.SFEKLPA modules are assumed to be in LPA, which
can be done dynamically with operator command
SETPROG LPA,ADD,DSN=FEK.SFEKLPA
Note that FEKDSI expects the REXX runtime library,
REXX.*.SEAGLPA, to be accessible. This runtime is part of the
REXX compiler, and also of the (free) Alternate Library for REXX
product package. The default alternate library name is
REXX.*.SEAGALT.
****************************************************************
* Affected function: RSE *
****************************************************************
* Description: removed environment variables *
****************************************************************
* Timing: pre-APPLY *
****************************************************************
* Part: /usr/lpp/rdz/samples/rsed.envvars *
* [/etc/rdz/rsed.envvars] *
****************************************************************
This fix updates the sample rsed.envvars by REMOVING the
following optional directives:
#_RSE_JAVAOPTS="$_RSE_JAVAOPTS -DRSE_DSICALL=TSO"
****************************************************************
* Affected function: RSE *
****************************************************************
* Description: new environment variables *
****************************************************************
* Timing: post-APPLY *
****************************************************************
* Part: /usr/lpp/rdz/samples/rsed.envvars *
* [/etc/rdz/rsed.envvars] *
****************************************************************
This fix updated sample file rsed.envvars.
Redo your customizations, if any, after applying this
maintenance.
****************************************************************
* Affected function: RSE *
****************************************************************
* Description: removed environment variables *
****************************************************************
* Timing: pre-APPLY *
****************************************************************
* Part: /usr/lpp/rdz/samples/rsed.envvars *
* [/etc/rdz/rsed.envvars] *
****************************************************************
This fix updates the sample rsed.envvars by REMOVING the
following optional directives:
#_RSE_JAVAOPTS="$_RSE_JAVAOPTS -Dsearch.server.limit.datasets=0"
****************************************************************
* Affected function: RSE *
****************************************************************
* Description: new environment variables *
****************************************************************
* Timing: pre-APPLY *
****************************************************************
* Part: /usr/lpp/rdz/samples/rsed.envvars *
* [/etc/rdz/rsed.envvars] *
****************************************************************
This fix updates the sample rsed.envvars by adding the
following optional directives:
#_RSE_JAVAOPTS="$_RSE_JAVAOPTS
-Dsearch.server.limit.scanned_objects=0"
Limit the resource usage of non-indexed file and text
searches. The default is 0 (no limit). Uncomment and customize
this directive to stop a search after the specified number of
objects (data set or PDS(E) member) has been scanned.
****************************************************************
* Affected function: RSE *
****************************************************************
* Description: new environment variables *
****************************************************************
* Timing: post-APPLY *
****************************************************************
* Part: /usr/lpp/rdz/samples/rsed.envvars *
* [/etc/rdz/rsed.envvars] *
****************************************************************
This fix updated sample file rsed.envvars.
Redo your customizations, if any, after applying this
maintenance.
****************************************************************
* Affected function: RSE *
****************************************************************
* Description: new environment variables *
****************************************************************
* Timing: pre-APPLY *
****************************************************************
* Part: /usr/lpp/rdz/samples/rsed.envvars *
* [/etc/rdz/rsed.envvars] *
****************************************************************
This fix updates the sample rsed.envvars by adding the
following optional directives:
#_RSE_JAVAOPTS="$_RSE_JAVAOPTS -DDSTORE_SSL_ALGORITHM=TLSv1.2"
Use Use the specified algorithm for encrypted communication
with the client. The default depends on your Java default, but
is often TLS v1.0. To start using TLS v1.2 for Developer for
System z client-host communication, uncomment and specify
TLSv1.2. This option works only with z/OS 2.1 and later, Java
version 7.0 and later and clients version 9.0 and later. All
clients and RSE daemon must also be adjusted to use the
specified algorithm. All clients must specify
-DDSTORE_SSL_ALGORITHM=TLSv1.2 in eclipse.ini to enable TLS
v1.2 encrypted communication. RSE daemon requires that
GSK_PROTOCOL_TLSV1_2=ON is defined in rsed.envvars.
****************************************************************
* Affected function: RSE *
****************************************************************
* Description: new environment variables *
****************************************************************
* Timing: post-APPLY *
****************************************************************
* Part: /usr/lpp/rdz/samples/rsed.envvars *
* [/etc/rdz/rsed.envvars] *
****************************************************************
This fix updated sample file rsed.envvars.
Redo your customizations, if any, after applying this
maintenance.
****************************************************************
* Affected function: console messages *
****************************************************************
* Description: changed message, FEK800S *
****************************************************************
* Timing: post-APPLY *
****************************************************************
* Part: n/a *
****************************************************************
This maintenance adds a new console message:
FEK800S = client_userid abend_message
The message is issued when a client action causes an abend.).
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(
UK98515
UK92638
UK83670
UI18898
) REDO COMPRESS(ALL) BYPASS(HOLDSYS,HOLDERROR).
//*
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. //* //RECEIVE EXEC PGM=GIMSMP,REGION=0M //SMPCSI DD DISP=OLD,DSN=#globalcsi //SMPPTFIN DD DISP=SHR,DSN=hlq.IBM.HHOP850.UI24911 //SMPCNTL DD * SET BOUNDARY(GLOBAL) . RECEIVE SELECT(UI24911) SYSMODS LIST . //* //APPLY EXEC PGM=GIMSMP,REGION=0M //SMPCSI DD DISP=OLD,DSN=#globalcsi //SMPCNTL DD * SET BOUNDARY(#tzone) . APPLY SELECT(UI24911) REDO COMPRESS(ALL) BYPASS(HOLDSYS,HOLDERROR). //*
Restart started tasks to activate changes.