The fix is shipped as file IBM.HHOP760.UK81273
The fix has rework (build) date 2012236 (23 Aug 2012)
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.HHOP760.<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 //* //UK81273 DD DSN=hlq.IBM.HHOP760.UK81273, // DISP=(NEW,CATLG,DELETE), // DSORG=PS, // RECFM=FB, // LRECL=80, // UNIT=SYSALLDA, //* VOL=SER=volser, //* BLKSIZE=6160, // SPACE=(TRK,(79,10)) //*
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.HHOP760.UK81273 200 Port request OK. 125 Storing data set hlq.IBM.HHOP760.UK81273 250 Transfer completed successfully 4365520 bytes sent in 0.28 seconds ftp> quit 221 Quit command received. Goodbye.
++HOLD(UK81273) SYS FMID(HHOP760) REASON(DOC) DATE(12236)
COMMENT
(****************************************************************
* Affected function: console messages *
****************************************************************
* Description: new message, FEK212E *
****************************************************************
* Timing: post-APPLY *
****************************************************************
* Part: n/a *
****************************************************************
This maintenance defines a new console message
FEK212E = Invalid {0} command option: {1}
The message can be shown after issueing a faulty formatted
operator command.).
++HOLD(UK81273) SYS FMID(HHOP760) REASON(ACTION) DATE(12236)
COMMENT
(****************************************************************
* 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).
SEARCHALL
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: 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).
LIMIT_CONSOLE
Defines how much authority is granted to the console used to
execute supported JES commands (Hold, Release, Cancel, and
Purge). The default (LIMIT_CONSOLE=LIMITED) limits authority
to commands protected by a security profile in the OPERCMDS
class. Uncomment this directive and specify NOLIMIT to allow
execution of supported JES commands that are not protected by
a security profile.
Note that when a security profile exists for a command, the
user must have sufficient permission to execute the command,
regardless of the LIMIT_CONSOLE setting. The only valid
settings are LIMITED and NOLIMIT.
Add this directive to your active FEJJCNFG (by default located
in FEK.#CUST.PARMLIB) if you want to use it.
****************************************************************
* Affected function: configuration problem analysis *
****************************************************************
* Description: updated debug information gathering tool *
****************************************************************
* Timing: pre-APPLY *
****************************************************************
* Part: FEK.SFEKSAMP(FEKLOGS) *
****************************************************************
This maintenance updates the debug information gathering tool,
FEKLOGS.
- added support to collect data for multiple userids
If you have customized this file, it is advised to back it
up before proceeding with SMP/E Apply.
****************************************************************
* Affected function: configuration problem analysis *
****************************************************************
* Description: updated debug information gathering tool *
****************************************************************
* Timing: post-APPLY *
****************************************************************
* Part: FEK.SFEKSAMP(FEKLOGS) *
* [FEK.#CUST.JCL(FEKLOGS)] *
****************************************************************
This maintenance updates the debug information gathering tool,
FEKLOGS.
- added support to collect data for multiple userids
Redo your customizations, if any, after applying this
maintenance.
****************************************************************
* 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
****************************************************************
* Affected function: RSED operator commands *
****************************************************************
* Description: changed operator command ouptut: D PROCESS,CPU *
****************************************************************
* Timing: post-APPLY *
****************************************************************
* Part: not applicable *
****************************************************************
This service changes the output of operator command for the RSED
started task.
MODIFY RSED,APPL=DISPLAY PROCESS,CPU
If the output size exceeds the maximum number of lines for a
console message, the output will be split over multiple BPXM023I
messages. These additional messages will have the same header as
the first message, but with the CONTINUATION keyword added to
the first line.
ProcessId(421) ASId(007D) JobName(RSED8) Order(1) CONTINUATION
USERID THREAD-ID TCB@ ACC_TIME TAG
****************************************************************
* 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).
SMP/E ACCEPT the prerequisites to facilitate an easy backout of the fix, if required.
SMP/E RECEIVE and APPLY the fix.