The fix is shipped as file IBM.HHOP910.UI23762
The fix has rework (build) date 2014344 (10 Dec 2014)
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.HHOP910.<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 //* //UI23762 DD DSN=hlq.IBM.HHOP910.UI23762, // DISP=(NEW,CATLG,DELETE), // DSORG=PS, // RECFM=FB, // LRECL=80, // UNIT=SYSALLDA, //* VOL=SER=volser, //* BLKSIZE=6160, // SPACE=(TRK,(667,130)) //*
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.HHOP910.UI23762 200 Port request OK. 125 Storing data set hlq.IBM.HHOP910.UI23762 250 Transfer completed successfully 37239760 bytes sent in 0.28 seconds ftp> quit 221 Quit command received. Goodbye.
++HOLD(UI23762) SYS FMID(HHOP910) REASON(ACTION) DATE(14344)
COMMENT
(****************************************************************
* Affected function: Integrated Debugger *
****************************************************************
* Description: changed CICS CSD definitions *
****************************************************************
* Timing: post-APPLY *
****************************************************************
* Part: FEK.SFEKSAMP(AQECSD) *
* [FEK.#CUST.JCL(AQECSD)] *
****************************************************************
This fix updates the sample job that defines Integrated Debugger
in the CSD of a CICS region.
* TD queues are renamed
* new programs are defined
****************************************************************
* Affected function: Integrated Debugger *
****************************************************************
* Description: security updates *
****************************************************************
* Timing: post-APPLY *
****************************************************************
* Part: FEK.SFEKSAMP(AQERACF, FEKRACF) *
* [FEK.#CUST.JCL(AQERACF, FEKRACF)] *
****************************************************************
This fix updates how Integrated Debugger validates debug
requests.
Integrated Debugger now requires that users are permitted to one
of the following FACILITY class security profiles:
* READ access to profile AQE.AUTHDEBUG.STDPGM allows users to
debug problem state programs
* READ access to profile AQE.AUTHDEBUG.AUTHPGM allows users to
debug problem state and authorized programs
The following sample RACF commands can be used to define the
new permits.
RDEFINE FACILITY AQE.AUTHDEBUG.STDPGM UACC(NONE) -
DATA('RATIONAL DEVELOPER FOR SYSTEM Z')
RDEFINE FACILITY AQE.AUTHDEBUG.AUTHPGM UACC(NONE) -
DATA('RATIONAL DEVELOPER FOR SYSTEM Z')
# allow everyone to debug problem state programs
PERMIT AQE.AUTHDEBUG.STDPGM CLASS(FACILITY) ACCESS(READ) ID(*)
SETROPTS RACLIST(FACILITY) REFRESH
# show results
RLIST FACILITY AQE.** ALL
****************************************************************
* Affected function: Integrated Debugger *
****************************************************************
* Description: started task updates *
****************************************************************
* Timing: post-APPLY *
****************************************************************
* Part: FEK.SFEKSAMP(AQEJCL) *
* [FEK.#CUST.PROCLIB(DBGMGR) / SYS1.PROCLIB(DBGMGR)] *
****************************************************************
This Integrated Debugger fix requires an update to the Debug
Manager started task, DBGMGR.
//*
//* RDz Debug Manager
//*
//DBGMGR PROC PRM=, * PRM=DEBUG TO START TRACING
// LEPRM='RPTOPTS(ON)',
// TZ='EST5EDT',
// CLIENT=5335,
// HOST=5336,
// SVC=251,
// HLQ=FEK
//*
//DBGMGR EXEC PGM=AQEZPCM,REGION=0M,TIME=NOLIMIT,
// PARM=('&LEPRM ENVAR("TZ=&TZ")/&HOST &CLIENT &SVC &PRM')
//STEPLIB DD DISP=SHR,DSN=&HLQ..SFEKAUTH
// DD DISP=SHR,DSN=&HLQ..SFEKLPA * NEW V911
//SYSPRINT DD SYSOUT=*
//SYSOUT DD SYSOUT=*
// PEND
//*
****************************************************************
* Affected function: Integrated Debugger *
****************************************************************
* Description: new mandatory SVC *
****************************************************************
* Timing: post-APPLY *
****************************************************************
* Part: FEK.SFEKLPA(AQESVC03) *
****************************************************************
This fix introduces a new SVC, AQESVC03, which is required when
using the Integrated Debugger.
SYS1.PARMLIB(IEASVCxx) update:
SVCPARM 251,REPLACE,TYPE(3),EPNAME(AQESVC03)
The previous SVC, AQESVC01, is no longer used and can be removed
To activate the SVC you can IPL (assuming SFEKLPA is part of
LPALSTxx), or rely on the Debug Manager started task, DBGMGR,
to dynamically define the SVC.
****************************************************************
* Affected function: CA Endevor SCM(R) interface *
****************************************************************
* Description: new option *
****************************************************************
* Timing: post-APPLY *
****************************************************************
* Part: FEK.#CUST.PARMLIB(CRACFG) *
* [FEK.SFEKSAMP(CRACFG)] *
****************************************************************
This fix updates configuration file CRACFG, which is used by
Edit support for CA Endevor SCM(R).
# ALTERNATIVE-ALLOC
Uncomment to use an alternative allocation mechanism for those
situations where the data sets that are being created for use
by the client are locked exclusively by the CARMA server.
****************************************************************
* Affected function: CA Endevor SCM(R) interface *
****************************************************************
* Description: new option *
****************************************************************
* Timing: post-APPLY *
****************************************************************
* Part: FEK.#CUST.PARMLIB(CRABCFG) *
* [FEK.SFEKSAMP(CRABCFG)] *
****************************************************************
This fix updates configuration file CRABCFG, which is used by
Batch Actions for CA Endevor SCM(R).
TRANSFER-ELEMENT = <jcl member name>
****************************************************************
* Affected function: CA Endevor SCM(R) interface *
****************************************************************
* Description: batch actions *
****************************************************************
* Timing: post-APPLY *
****************************************************************
* Part: FEK.#CUST.CNTL(CRASUBCA) *
* [FEK.SFEKSAMP(CRASUBCA)] *
* Part: /etc/rdz/crastart.endevor.conf *
* [/usr/lpp/rdz/samples/crastart.endevor.conf] *
****************************************************************
This fix updates sample members CRASUBCA and
crastart.endevor.conf, to specify DD APIHJC.
This DD is used by the CA Endevor(R) SCM Package Ship feature.
****************************************************************
* Affected function: CARMA *
****************************************************************
* Description: CA Endevor(R) SCM VSAM update *
****************************************************************
* Timing: post-APPLY *
****************************************************************
* Part: SFEKVSM2(CRA0VCAD) *
* Part: SFEKVSM2(CRA0VCAS) *
****************************************************************
This maintenance updates the CRADEF and CRASTRS VSAM data sets
used by the Developer for System z interface to CA Endevor(R).
To apply these changes to your active VSAM data sets, resubmit
the customized SFEKSAMP(CRA$VCAD) and SFEKSAMP(CRA$VCAS).
****************************************************************
* Affected function: code generation *
****************************************************************
* Description: define programs to CICS CSD *
****************************************************************
* Timing: post-APPLY *
****************************************************************
* Part: FEK.SFEKSAMP(IRZCSD) *
* [FEK.#CUST.JCL(IRZCSD)] *
****************************************************************
This maintenance adds a new sample JCL, SFEKSAMP(IRZCSD),
which can be used to update the CSD of a CICS region.
The job defines IRZX* programs used by code generated by
Developper for System z.
****************************************************************
* Affected function: build procedures *
****************************************************************
* Description: updated build procedure *
****************************************************************
* Timing: pre-APPLY *
****************************************************************
* Part: FEK.SFEKSAMP(ELAXFLNK) *
* [FEK.#CUST.PROCLIB(ELAXFLNK) / SYS1.PROCLIB(ELAXFLNK)] *
****************************************************************
This maintenance updates sample JCL procedure ELAXFLNK,
which is used to bind/linkedit compiled code into a load module.
It adds SFEKLOAD to STEPLIB to assist unit testing via zUnit.
****************************************************************
* Affected function: build procedures *
****************************************************************
* Description: updated build procedure *
****************************************************************
* Timing: post-APPLY *
****************************************************************
* Part: FEK.SFEKSAMP(ELAXFLNK) *
* [FEK.#CUST.PROCLIB(ELAXFLNK) / SYS1.PROCLIB(ELAXFLNK)] *
****************************************************************
This fix updated sample member ELAXFLNK.
Redo your customizations, if any, after applying this
maintenance.
****************************************************************
* Affected function: console messages *
****************************************************************
* Description: changed messages *
****************************************************************
* Timing: post-APPLY *
****************************************************************
* Part: n/a *
****************************************************************
This maintenance changes and adds a console message:
FEK220I = LOGS Command has been started to write onto {0} for
the requester, {1}
The message is issued when host logs are requested, either via
operator command or client action.
FEK800S = client_userid abend_message
The message is issued when a client action causes an abend.
****************************************************************
* 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.
#_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: 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"
#_RSE_JAVAOPTS="$_RSE_JAVAOPTS -Denable.saf.check=true"
#_RSE_JAVAOPTS="$_RSE_JAVAOPTS -DRSE_DSICALL=TSO"
****************************************************************
* 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: 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: 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).
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).
//*
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.HHOP910.UI23762 //SMPCNTL DD * SET BOUNDARY(GLOBAL) . RECEIVE SELECT(UI23762) SYSMODS LIST . //* //APPLY EXEC PGM=GIMSMP,REGION=0M //SMPCSI DD DISP=OLD,DSN=#globalcsi //SMPCNTL DD * SET BOUNDARY(#tzone) . APPLY SELECT(UI23762) REDO COMPRESS(ALL) BYPASS(HOLDSYS,HOLDERROR). //*
Restart started tasks to activate changes.