The fix is shipped as file IBM.HHOP801.UK76573
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.HHOP801.<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 //* //UK76573 DD DSN=hlq.IBM.HHOP801.UK76573, // DISP=(NEW,CATLG,DELETE), // DSORG=PS, // RECFM=FB, // LRECL=80, // UNIT=SYSALLDA, //* VOL=SER=volser, //* BLKSIZE=6160, // SPACE=(TRK,(225,40)) //*
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.HHOP801.UK76573 200 Port request OK. 125 Storing data set hlq.IBM.HHOP801.UK76573 250 Transfer completed successfully 12523920 bytes sent in 0.28 seconds ftp> quit 221 Quit command received. Goodbye.
++HOLD(UK76573) SYS FMID(HHOP801) REASON(ACTION) DATE(12058)
COMMENT
(****************************************************************
* 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).
* provide missing F00000-F00044 records
* remove package actions from element menus
To apply these changes to your active VSAM data sets, resubmit
the customized SFEKSAMP(CRA$VCAD) and SFEKSAMP(CRA$VCAS).
****************************************************************
* Affected function: restore deprecated CARMA function *
****************************************************************
* Description: CA Endevor(R) SCM VSAM update *
****************************************************************
* Timing: post-APPLY *
****************************************************************
* Part: SFEKVSM2(CRA0VPKD) *
* Part: SFEKVSM2(CRA0VPKS) *
****************************************************************
This maintenance removes the CA Endevor(R) SCM package actions
from the CA Endevor(R) SCM element menus, as they are now
avaialable through the CA Endevor(R) SCM package menus.
If desired, you can reverse this change by merging the new
SFEKVSM2(CRA0VPK*) data in the updated CARAMA VSAMs.
As described in another hold action, the CARMA VSAMs are updated
by resubmitting the customized SFEKSAMP(CRA$VCAD) and
SFEKSAMP(CRA$VCAS).
Once completed, customize and submit SFEKSAMP(CRA#UADD) to merge
the removed menu items back in. This action must be repeated
each time the CARMA VSAMs are rebuilt using the
SFEKSAMP(CRA$VCA*) jobs.
* merge SFEKVSM2(CRA0VPKD) into FEK.#CUST.CRADEF
* merge SFEKVSM2(CRA0VPKS) into FEK.#CUST.CRASTRS
****************************************************************
* Affected function: JES Job Monitor *
****************************************************************
* Description: new operator command: STORAGE *
****************************************************************
* Timing: post-APPLY *
****************************************************************
* Part: not applicable *
****************************************************************
This service introduces a new operator command for the JMON
started task.
MODIFY JMON,APPL=STORAGE
Show the storage usage below 2GB bar for this address space.
The output is written to DD SYSOUT.
>>>STORAGE TRACE (console request)<<<
LDAREGRQ 00000000000 00000000K 00000M requested region size
below 16M line
LDASIZA 00006266880 00006120K 00005M maximum region size
LDALIMIT 00006266880 00006120K 00005M limit
LDAVVRG 00006266880 00006120K 00005M getmain limit
LDALOAL 00000061440 00000060K 00000M in use
LDAHIAL 00000266240 00000260K 00000M LSQA/SWA/private subpoo
_GAP 00000000000 00000000K 00000M gaps in allocation
_AVAIL 00005939200 00005800K 00005M available including gap
_MAX 00006000640 00005860K 00005M current limit
above 16M line
LDAESIZA 01905262592 01860608K 01817M maximum region size
LDAELIM 01905262592 01860608K 01817M limit
LDAEVVRG 01905262592 01860608K 01817M getmain limit
LDAELOAL 00000933888 00000912K 00000M in use
LDAEHIAL 00012775424 00012476K 00012M ELSQA/ESWA/private subp
_EGAP 00000000000 00000000K 00000M gaps in allocation
_EAVAIL 01891553280 01847220K 01803M available including gap
_EMAX 01892487168 01848132K 01804M current limit
****************************************************************
* Affected function: JES Job Monitor *
****************************************************************
* Description: new configuration directives *
****************************************************************
* Timing: post-APPLY *
****************************************************************
* Part: FEK.#CUST.PARMLIB(FEJJCNFG) *
* [FEK.SFEKSAMP(FEJJCNFG)] *
****************************************************************
This service introduces new optional directives for the FEJJCNFG
configuration file (used by JMON).
SEACHALL
Collect APPC and z/OS UNIX output that matches the JES Job
Monitor filter, for example ouptut written to SYSOUT by a
Developer for System z CARMA server started using the
CRASTART method. The default is OFF. The only valid values
are ON and OFF.
Note that the collection of this output was introduced earlier
in a PTF, at which point is was enabled and not configurable.
TRACE_STORAGE
Enable storage tracing. Use only when directed by the IBM
support center. The default is OFF. The only valid values
are ON and OFF. When enabled, a storage report is written
to DD SYSOUT after each command.
Add these directives to your active FEJJCNFG (by default located
in FEK.#CUST.PARMLIB) if you want to use them.
****************************************************************
* Affected function: RSED operator commands *
****************************************************************
* Description: new operator command: D P,CPU *
****************************************************************
* Timing: post-APPLY *
****************************************************************
* Part: not applicable *
****************************************************************
This service introduces a new operator command for the RSED
started task.
MODIFY RSED,APPL={DISPLAY | D} {PROCESS | P},{CPU | C}[,PID=pid]
Show CPU usage per z/OS UNIX thread in the RSE thread pools.
Results are shown in a single BPXM023I console message per
RSE thread pool.
Add optional argument PID=pid (where pid is the process ID of
an RSE thread pool) to limit the scope of the command to a
single thread pool.
BPXM023I (STCRSE)
ProcessId(207 ) ASId(0069) JobName(RSED9) Order(2)
USERID THREAD-ID TCB@ ACC_TIME TAG
STCRSE 0ED8E20000000000 005E6B60 748 1/ThreadPoolProces
STCRSE 0ED8F30000000001 005E69C8 001
STCRSE 0ED9040000000002 005E6518 1870
STCRSE 0ED9150000000003 005E66B0 1767
STCRSE 0ED9260000000004 005E62F8 001
STCRSE 0ED9370000000005 005E60D8 001
STCRSE 0ED9480000000006 005C4D80 009 6/ThreadPoolMonito
STCRSE 0EDDCC0000000009 005C49C8 068
STCRSE 0EDE43000000000A 005C4088 002
IBMUSER 0EDDBB000000000D 005C4BE8 315 16/ServerReceiver
IBMUSER 0EDEA9000000000E 005C2BE0 146 12/ServerUpdateHan
IBMUSER 0EDEBA000000000F 005C29C0 558 11/ServerCommandHa
STCRSE 0EDE980000000012 005C2E00 004
STCRSE 0EDE870000000013 005C42A8 126
IBMUSER 0EDECB0000000014 005C27A0 027 22/UniversalFileSy
IBMUSER 0EDF200000000018 005C2140 002 23/EnvironmentMine
IBMUSER 0EDEFE0000000019 005C2580 002 27/CommandMiner
IBMUSER 0EDEED000000001A 005C2360 079 28/MVSFileSystemMi
IBMUSER 0EDF0F000000001B 005C1E88 002 29/MVSByteStreamHa
STCRSE 0EDF31000000001C 005C1CF0 001
IBMUSER 0EDF53000000001D 005C1AD0 066 30/JESMiner
IBMUSER 0EDF64000000001F 005C18B0 003 32/FAMiner
IBMUSER 0EDF750000000020 005C1690 001 33/LuceneMiner
IBMUSER 0EDF860000000021 005C1470 001 34/CDTParserMiner
IBMUSER 0EDF970000000022 005C1250 001 35/MVSLuceneMiner
IBMUSER 0EDFA80000000023 005C1030 001 36/CDTMVSParserMin
BPXM023I (STCRSE)
ProcessId(204 ) ASId(003B) JobName(RSED7) Order(1)
USERID THREAD-ID TCB@ ACC_TIME TAG
STCRSE 0ED1D80000000000 005E6B60 727 1/ThreadPoolProces
STCRSE 0ED21C0000000001 005E69C8 001
STCRSE 0ED22D0000000002 005E6518 425
STCRSE 0ED23E0000000003 005E66B0 1884
STCRSE 0ED2820000000004 005E62F8 001
STCRSE 0ED2930000000005 005E60D8 001
STCRSE 0ED4090000000006 005C4D80 007 6/ThreadPoolMonito
****************************************************************
* Affected function: RSED operator commands *
****************************************************************
* Description: new operator commands: DEBUG HEAPDUMP,PID= *
****************************************************************
* Timing: post-APPLY *
****************************************************************
* Part: not applicable *
****************************************************************
This service introduces a new operator command for the RSED
started task.
MODIFY RSED,APPL=DEBUG {HEAPDUMP | HD},PID=pid
Request a Java Heap dump for a specified thread pool (where
pid is the process ID of an RSE thread pool).
The dump is written to the directory specified by
_CEE_DUMPTARG in rsed.envvars (default value is /tmp).
Results are shown in a single BPXM023I console message.
BPXM023I (STCRSE)
JVMDUMP034I User requested Heap dump using '/tmp/heapdump.2012
0223.211430.16777590.0001.phd' through com.ibm.jvm.Dump.HeapDu
****************************************************************
* Affected function: RSED operator commands *
****************************************************************
* Description: new operator commands: DEBUG JAVACORE,PID= *
****************************************************************
* Timing: post-APPLY *
****************************************************************
* Part: not applicable *
****************************************************************
This service introduces a new operator command for the RSED
started task.
MODIFY RSED,APPL=DEBUG {JAVACORE | JC},PID=pid
Request a Java Core dump for a specified thread pool (where
pid is the process ID of an RSE thread pool).
The dump is written to the directory specified by
_CEE_DUMPTARG in rsed.envvars (default value is /tmp).
Results are shown in a single BPXM023I console message.
BPXM023I (STCRSE)
JVMDUMP034I User requested Java dump using '/tmp/javacore.2012
0225.234244.537.0001.txt' through com.ibm.jvm.Dump.JavaDump
****************************************************************
* Affected function: logon *
****************************************************************
* Description: new environment variable *
****************************************************************
* Timing: post-APPLY *
****************************************************************
* Part: /etc/rdz/rsed.envvars *
* [/usr/lpp/rdz/samples/rsed.envvars] *
****************************************************************
This fix updates the sample rsed.envvars by adding the
following optional directives:
#_RSE_JAVAOPTS="$_RSE_JAVAOPTS -Dlogon.action=<user exit>"
Name of a user exit which will be invoked when a user logs on.
There is no default value, but a sample exit is provided in
/usr/lpp/rdz/samples/process_logon.sh.
Uncomment and specify the full pathname of the user exit
program to enable post-processing of a logon.
#_RSE_JAVAOPTS="$_RSE_JAVAOPTS -Dlogon.action.id=<userid>"
User ID to be used for running the exit specified in the
logon.action variable. The default is the user ID assigned to
RSE daemon. Uncomment and specify a user ID to use the
specified ID for executing the audit post-processing exit.
Add these directives to your active rsed.envvars (by default
located in /etc/rdz) if you want to use them.
****************************************************************
* Affected function: RSED & LOCKD startup *
****************************************************************
* Description: changed TMPDIR usage during startup *
****************************************************************
* Timing: post-APPLY *
****************************************************************
* Part: #CUST.PROCLIB(RSED & LOCKD) *
* [SFEKSAMP(FEKRSED & FEKLOCKD)] *
****************************************************************
In previous releases, a new TMPDIR location could be specified
during startup in case /tmp was not available. However, in some
situations TMPDIR is needed before the provided variable is
interpreted.
This maintenance changes the usage of TMPDIR for the RSED and
LOCKD started tasks. During startup, the tasks will test whether
/tmp is available for TMPDIR assignment (directory must be
writeable). If not, the home directory of the user ID assigned
to the started task will be used as TMPDIR directory. If this
directory also lacks write permits, startup ends with an error
message. Note that TMPDIR can also be set in rsed.envvars. This
value will be used once startup arguments are interpreted. This
implies that only z/OS UNIX commands used during startup
argument interpretation use the initial TMPDIR directory.
This maintenance updates the sample RSED and LOCKD started task
JCL to remove the now obsolete TMPDIR definition.
****************************************************************
* Affected function: CARMA *
****************************************************************
* Description: CA Endevor(R) SCM VSAM update *
****************************************************************
* Timing: post-APPLY *
****************************************************************
* Part: SFEKVSM2(CRA0VCAD) *
****************************************************************
This maintenance updates the CRADEF VSAM data set used by the
Developer for System z interface to CA Endevor(R) SCM.
To apply these changes to your active VSAM data set, resubmit
the customized SFEKSAMP(CRA$VCAD) job.
****************************************************************
* Affected function: CA Endevor(R) SCM integration *
****************************************************************
* Description: new CRABCFG (batch action) directives *
****************************************************************
* Timing: post-APPLY *
****************************************************************
* Part: FEK.#CUST.PARMLIB(CRABCFG) *
* [FEK.SFEKSAMP(CRABCFG)] *
****************************************************************
This service introduces new batch action directives for the
CRABCFG configuration file (CA Endevor(R) SCM batch actions).
# batch action JCL members within SKELETON-DD
ADD-ELEMENT = CRABATCA # existing directive
GENERATE-ELEMENT = CRABATCA # existing directive
MOVE-ELEMENT = CRABATCA
DELETE-ELEMENT = CRABATCA
RETRIEVE-ELEMENT = CRABATCA
SIGNIN-ELEMENT = CRABATCA
PRINT-ELEMENT = CRABATCA
****************************************************************
* Affected function: CA Endevor(R) SCM integration *
****************************************************************
* Description: new CRASHOW (filter) directive *
****************************************************************
* Timing: post-APPLY *
****************************************************************
* Part: FEK.#CUST.PARMLIB(CRASHOW) *
* [FEK.SFEKSAMP(CRASHOW)] *
****************************************************************
This service introduces a new directive, FILTER-DEP for the
CRASHOW configuration file (CA Endevor(R) SCM filters).
#FILTER-DEP=YES
When enabled, FILTER-DEP excludes dependency scans for elements
with footprint references to other CA Endevor(R) SCM repository
locations. The directive is commented out by default, and the
only valid value is YES.
It is recommended that FILTER-DEP=YES is not specified unless
there are footprint references to other CA Endevor(R) SCM
repository locations for which scans need to be avoided.
****************************************************************
* Affected function: logon *
****************************************************************
* Description: new environment variable *
****************************************************************
* Timing: post-APPLY *
****************************************************************
* Part: /etc/rdz/rsed.envvars *
* [/usr/lpp/rdz/samples/rsed.envvars] *
****************************************************************
This fix updates the sample rsed.envvars by adding the
following optional directive:
#_RSE_JAVAOPTS="$_RSE_JAVAOPTS -Dreject.logon.threshold=1000000"
A thread pool opening a file larger than the specified size
will not accept new logon requests until the file is loaded.
The default file size is 1000000 (1 million) bytes. Uncomment
and customize to specify the file size at which a thread pool
is to ignore logon requests when such a file is opened. Note
that other thread pools will still be eligible to accept new
logon requests.
Add this directive to your active rsed.envvars (by default
located in /etc/rdz) if you want to use it.
****************************************************************
* Affected function: console messages *
****************************************************************
* Description: new message, FEK211W *
****************************************************************
* Timing: post-APPLY *
****************************************************************
* Part: n/a *
****************************************************************
This maintenance defines a new console message
FEK211W = User, {0}, not logged on).
SMP/E ACCEPT the prerequisites to facilitate an easy backout of the fix, if required.
SMP/E RECEIVE and APPLY the fix.