z/TPF - Group home

Multiple module copy enhancements (PJ46055)

  

Multiple module copy enhancements provide a 500% increase in the number of simultaneous module copy operations. With this capability, you can recover from errors faster and migrate to new DASD hardware faster.

Before APAR PJ46055, a maximum of 20 module copy operations could be processed at the same time in the z/TPF complex. In addition, other limitations could further reduce the number of simultaneous module copies:

  • A maximum of 10 module copies on a processor was allowed.
  • A maximum of 5 module copies on a logical control unit (LCU) was allowed. 

With APAR PJ46055, you can set the maximum number of simultaneous module copies as high as 100. Use the ZMCPY SET command to set the maximum number of module copies that can run concurrently in a processor complex, on a control unit, or on a processor. 

Here is an example of the updated ZMCPY STATUS command output: 

CSMP0097I 11.43.10 CPU-C SS-WP   SSU-WP1  IS-01
MCPY0283I 11.43.10 MODULE COPY STATUS - TOTAL NUMBER OF COPIES IS  14
SLOT TYPE     STATUS              FROM SDA  MOD  TO SDA  MOD  CURRENT CCHH
1  COPY UP  ACTIVE   ON PROC B       7130 001F    7030 001E  1726 0002
2  COPY UP  ACTIVE   ON PROC B       7131 0020    7031 0021  15D6 000E
3  COPY UP  ACTIVE   ON PROC B       7132 0023    7032 0022  16F4 000C
4  COPY UP  ACTIVE   ON PROC B       7033 0025    7133 0024  10F5 000B
5  COPY UP  ACTIVE   ON PROC B       7034 0026    7134 0027  168E 000E
6  COPY UP  ACTIVE   ON PROC B       7035 0029    7135 0028  12DE 000A
7  COPY UP  ACTIVE   ON PROC B       7136 002B    7036 002A  12E9 0007
8  COPY UP  ACTIVE   ON PROC B       7137 002C    7037 002D  10F3 000E
9  COPY UP  ACTIVE   ON PROC B       7039 0031    7139 0030  0D96 0005
10  COPY UP  ACTIVE   ON PROC B       703A 0032    713A 0033  12AD 000C
11  COPY UP  ACTIVE   ON PROC B       703B 0035    713B 0034  0E20 000D
12  COPY UP  ACTIVE   ON PROC B       713C 0037    703C 0036  12D5 000D
13  COPY UP  ACTIVE   ON PROC B       713D 0038    703D 0039  10C6 0004
14  COPY UP  ACTIVE   ON PROC B       703F 003D    713F 003C  0CED 000E
END OF DISPLAY+ 


For loosely coupled environments, support was added for as many as 14 locks in MPLF partition 2. This support provides as many as 14 simultaneous module copies to a logical control unit (LCU) in a loosely coupled environment. Some ZBUFC commands were updated to change the LOCKS parameter to the LOCKS1 parameter and to add a LOCKS2 parameter. The LOCKS1 and LOCKS2 parameters are to be used to manage the sizes of MPLF partition 1 and 2 respectively. If there is a decision to increase the CU limit with ZMCPY SET, resize MPLF partition 2 accordingly before starting module copy operations.

Here is an example of the ZBUFC ALLOCATE DISPLAY RCS command output: 

CSMP0097I 15.07.41 CPU-C SS-BSS  SSU-HPN  IS-01
BUFC0002I 15.07.41 RCS CONTROL UNIT CACHE ALLOCATIONS

CURRENT   RCS381-25,RCS1055-25,RCS4096-25,RCSBUF-25,LOCKS1-255,LOCKS2-  0
TARGET    RCS381-25,RCS1055-25,RCS4096-25,RCSBUF-25,LOCKS1-255,LOCKS2-  0


The LOCKS2 parameter is set to an initial value of 0. A value of 0 is treated as a value of 5 to be compatible with processing before APAR PJ46055. Unlike the LOCKS1 parameter, the value for the LOCKS2 parameter is the actual number of locks that will be requested for the MPLF partition.

Here is an example of a piece of the ZBUFC STATUS command output:

CSMP0097I 15.05.33 CPU-C SS-BSS  SSU-HPN  IS-01
BUFC0004I 15.05.33 STATUS FOR DEVICE-7400 RCS SSID-2040

DEVICE COUNT -  64     STATISTICS COUNT/DEVICE -   4
CONFIGURED SS STORAGE   - FFFFFFFF
AVAILABLE SS STORAGE    - 4E3FD000
PINNED SS STORAGE       - 00000000 _
OFFLINE SS STORAGE      - 00000000
CONFIGURED NVS STORAGE  - 00000000
PINNED NVS STORAGE      - 00000000

CACHE ALLOCATION:  (RECORD SLOT SIZES 1-3)
SIZE    - TRACK     381    1055     4096
RATIO   -    25      25      25       25
LOCKS1  -   255
  LOCKS2  -    14



Additionally, the following enhancements were made to help you diagnose significantly long DASD interrupt times and provide information about the I/O time for all devices, including DASD, tape, and console: 

  • The I/O first-level interrupt handler was updated to save the extended measurement word into the LDEV trace table entry. The extended measurement word is a 32-byte area at the end of the interrupt response block that includes the components of the response time for the I/O, such as device connect time, function pending time, device busy time, and so on.
  • Dump processing and the ZIOTR DISPLAY TRACE command were updated to include the extended measurement word in the formatted output for an I/O interruption.

Here is an example of the updated output for ZIOTR DISPLAY TRACE:

CSMP0097I 13.54.26 CPU-C SS-BSS  SSU-HPN  IS-01
IOTR0010I 13.54.26 TRACE ENTRIES, SUBCHANNEL 00011B78, LDEV 00000000014B8400
*Event  *TOD Clock        *ISN  *CC  *SCSW / Return Address     *DORPRM
       *Macro Parameters            *Extended-Status Word _
                                     *Extended-Measurement Word
                                    *Extended-Measurement Word (continued)
ISDAC   D900E457 4D9AB072  01    00  000189E0
       DDB-0000003BAA788E80
INT     D900E456 169F3B44  01        10104007 04723F80 0C000100 114D6600
       SLIH-00205776                00100001 00000000 00000000 00000000
                                     00000062 00000070 00000000 00000000
                                    00000000 00000000 00000056 00000000
SIOSC   D900E456 169888D0  02    00  0020A418                   114D6600
       TCW CPA-04723F80 KEY-1  LPM-F0 _
INT     D900E456 155A0D22  02        10104007 04723F80 0C000100 112C6000
       SLIH-00205776                00400000 00000000 00000000 00000000
                                     00000082 00000058 00000000 00000000
                                    00000000 00000000 0000003E 00000000
SIOSC   D900E456 15531162  01    00  0020A418                   112C6000
       TCW CPA-04723F80 KEY-1  LPM-F0
INT     D900E456 14EDA394  02        10104007 04723F80 0C000100 11249200
       SLIH-00205776                00200001 00000000 00000000 00000000
                                     0000009A 00000062 00000000 00000000
                                    00000000 00000000 00000048 00000000
SIOSC   D900E456 14E593D2  01    00  0020A418                   11249200
       TCW CPA-04723F80 KEY-1  LPM-F0
INT     D900E456 14E5540A  01        10104007 04723F80 0C000100 115E4000
       SLIH-00205776                00400000 00000000 00000000 00000000
                                     00000062 0000005B 00000000 00000000
                                    00000000 00000000 00000040 00000000



Here is an example of the updated LDEV trace output in a main storage dump: 

*LDEV TRACE ENTRIES *
*Event  *SDA  *ALS  *SIW   *I/O-Old PSW / Macro Parameters       *TOD Clock          *ISN   *DORPRM    *SLIH
                          *SCSW/ESW / Macro Return Address
                           *EMW
SIOSC   7129  ----  25A1   TCW CPA-04324380 CC-0 KEY-1 LPM-C0    D8B6A580 1A5E0E10   0002   10FAF200
                          00209418          00062B6A 10104007

(Int)   7129  ----  25A1   0704C001 80000000 00000000 00062B6A   D8B6A580 1A5DE4E8   0002   10CF1400   00204766
                          10C04007 043240A0 0C000000 00400006 00000000 00000000 00000000 00000000
                           00000668 00000754 00000000 00000000 00000000 00000000 00000100 00000000

SIOSC   7129  ----  25A1   CCW CPA-04324030 CC-0 KEY-1 LPM-C0    D8B6A580 19DD5E06   0003   10CF1400
                          00209418          00062B6A 10104007

(Int)   7129  ----  25A1   0704C001 80000000 00000000 00062B6A   D8B6A580 19DD4182   0003   10CAC800   00204766
                          10104007 04324380 0C000100 00800001 00000000 00000000 00000000 00000000
                           000000F6 000000EB 00000000 00000000 00000000 00000000 00000084 00000000

SIOSC   7129  ----  25A1   TCW CPA-04324380 CC-0 KEY-1 LPM-C0    D8B6A580 19CDCD86   0001   10CAC800
                          00209418          00062B6A 10104007

(Int)   7129  ----  25A1   0704C001 80000000 00000000 00062054   D8B6A580 19CDBB54   0001   10F27800   00204766
                          10C04007 043240A0 0C000000 0040000A 00000000 00000000 00000000 00000000
                           00000A58 00000823 00000000 00000000 00000000 00000000 00000100 00000000

SIOSC   7129  ----  25A1   CCW CPA-04324030 CC-0 KEY-1 LPM-C0    D8B6A580 192C78CE   0003   10F27800
                          00209418          9E45520A 10C04007

(Int)   7129  ----  25A1   0704C001 80000000 00000000 00062B6A   D8B6A580 192C533C   0003   10C54000   00204766
                          10C04007 043240C0 0C000000 00800006 00000000 00000000 00000000 00000000
                           000005DE 000002AC 00000000 00000000 00000000 00000000 00000100 00000000

SIOSC   7129  ----  25A1   CCW CPA-04324030 CC-0 KEY-1 LPM-C0    D8B6A580 18E2ECD6   0002   10C54000
                          00209418          00062B6A 10104007

(Int)   7129  ----  25A1   0704C001 80000000 00000000 00062B6A   D8B6A580 18E2D2AA   0002   10D04C00   00204766
                          10104007 04324380 0C000100 00400001 00000000 00000000 00000000 00000000
                           000000CE 000008DE 00000000 00000000 00000000 00000000 00000120 00000000

SIOSC   7129  ----  25A1   TCW CPA-04324380 CC-0 KEY-1 LPM-C0    D8B6A580 18954998   0002   10D04C00
                          00209418          00195F28 10C04007


The DASD interrupt handler was updated to save the extended measurement word into the I/O control block (IOB). The extended measurement word is saved for both successful and unsuccessful operations, except when the interruption is asynchronous. An asynchronous interrupt does not have an associated IOB to save data in. 

Migration note: To make appropriate space in the IOB, the MIOSHDW field was removed from the IOB. If you have utilities that use this field, those utilities must be updated to use another field.  

For systems that run in a z/VM® environment, if there are no VPARS disks present (roll-called), High Performance FICON® transport control word (TCW) translation will now occur for I/O operations when possible.  

For more information about APAR PJ46055, see the APEDIT and IBM Knowledge Center.