EWA information

EWA heading information

Common name: EWA - Error Recovery Procedure Work Area
Macro ID: EWAMAP
DSECT name: EWA
Owning component: IOS (SC1C3)
Eye-catcher ID:
EWA
Offset:  228
Length:  4
Storage attributes:
Main Storage:  YES
Virtual Storage:  n/a
Auxiliary Storage:  n/a
Subpool:   226 (below 16MB block), 245 (above 16MB block)
Key:       0
Residency: Above or below the 16MB line
Size:
248 bytes
Created by:
IOS IRB analysis or IOS Post Status modules.
Pointed to by:
IOSERP
Serialization:
None
Function:
Procedure work area common section:
- the common section consists of
indicators, counters and sense information
- the ERP dependent sections are available
for ERP use as needed

EWA mapping

Table 1. Structure EWA
Offset Offset  
Dec Hex Type Len Name(Dim) Description
0 (0) STRUCTURE 248 EWA  
0 (0) ADDRESS 4  EWAHDR EWA HEADER
0 (0) ADDRESS 4   EWAEXT ADDRESS OF WA EXTENTION THIS FIELD MUST BE ZERO OR POINT TO A BLOCK OBTAINED FROM THE IOS STORAGE MANAGER
4 (4) CHARACTER 4  EWAFLAGS FOUR BYTES OF FLAGS
4 (4) BITSTRING 1   EWAFLG1 FLAG BYTE 1
      1... ....    EWASLIS IF ON, INDICATES SKIP SENSE PROCESSING ACTIVE
      .1.. ....    EWAAPR IF ON, ALTERNATE PATH RETRY NEEDED
      ..1. ....    EWAREPET REPEAT USAGE OF THIS EWA FOR A REQUEST. (ZERO ONLY ON FIRST ENTRY
      ...1 ....    EWAXTRCD ERROR RECORDED BY EXIT ROUTINE. CAN BE USED TO COMMUNICATE BETWEEN A DEVICE DEPENDENT EXIT ROUTINE WHICH IS RECORDING AN ERROR AND THE ERP, SO THE ERP DOES NOT RECORD THE SAME ERROR. SET TO 0 BY IOS ONLY WHEN THE EWA IS OBTAINED. IT IS THE RESPONSIBILITY OF THE ERP OR DEVICE DEPENDENT EXIT TO RESET THIS FIELD ONCE IT HAS BEEN SET ON.
      .... 11..    EWASCCD START SUBCHANNEL DEFERRED CONDITION CODE ON SENSE OPERATION IF THIS IS A UNIT CHECK. (ONLY 0,1 AND 3 ARE VALID)
      .... 11..     EWASCC3 DEFERRED CONDITION CODE 3
      .... 1...      * RESERVED
      .... .1..      EWASCC1 DEFERRED CONDITION CODE 1 SEE END OF EWA FOR CC 0
      .... ..1.    EWADDMSG ERP DEPENDENT DATA TO BE INCLUDED IN I/O ERROR MESSAGE
      .... ...1    EWABDSNS IF ON, INDICATES SENSE DATA INVALID
5 (5) BITSTRING 1   EWAFLG2 FLAG BYTE 2
      1... ....    EWAMDR IF ON, MDR REQUEST. IF OFF, OBR REQUEST.
      .1.. ....    EWAWTEMP ON - TEMPORARY WRITE ERR COUNTER TO BE UPDATE IF DATA CHECK CONDITION. OFF - TEMPORARY READ ERR COUNTER TO BE UPDATED.
      ..1. ....    EWACOVF COUNTER OVERFLOW INDICATOR FOR STATISTICS UPDATE
      ...1 ....    EWAERPRT ON, THE ERP REQUESTS THAT IOSB COMPLETION CODES X'41' TO X'5F' BE RETURNED TO ERP WITH THE IOSERR BIT SET IN THE IOSB
      .... 1...    EWARCBLT OBR RECORD BUILT BY CALLER
      .... .1..    EWALBUSY IF ON, LONG BUSY UNIT CHECK
      .... ..1.    EWAFSAVF Failing storage address in EWAFSA is valid
      .... ...1    * RESERVED
6 (6) BITSTRING 1   EWAFLG3 FOR DEVICE DEPENDENT ERP USAGE
      1... ....    EWAJAM 3800 PAPER JAM
      .111 1111    * RESERVED
7 (7) BITSTRING 1   EWASNSCT LOOP COUNT FOR SENSE FAILURE
8 (8) BITSTRING 2  EWASSTAT CSW STATUS ON SENSE OPERATION IF THIS IS A UNIT CHECK
10 (A) CHARACTER 4  EWACNTRS COUNTERS FOR ERP USE
10 (A) ADDRESS 1   EWACNTR1 COUNTER 1
11 (B) ADDRESS 1   EWACNTR2 COUNTER 2
12 (C) ADDRESS 1   EWACNTR3 COUNTER 3
13 (D) ADDRESS 1   EWACNTR4 COUNTER 4
14 (E) CHARACTER 2  EWASTUP STATISTICS INFORMATION FOR UPDATING STATISTICS
16 (10) CHARACTER 8  EWAERPIB ERPIB BUILT BY SLH FOR CHANNEL ERRORS. INFORMATION FOR ERP USE. VALID WHENEVER THERE IS A CCC, CDC, ICC, OR MEASUREMENT-BLOCK CHECK (L BIT =1 IN IOSB). Note: For the following other conditions, the LPUM field will be valid and all other fields of the ERPIB will be zero: - Unit Check - Intercept - Channel program check - Channel protection check In all other cases, the ERPIB will be zero.
16 (10) BITSTRING 1   EWACFSTB FIRST BYTE OF THE EXTENDED STATUS WORD. (SEE IHAESW)
      1... ....    * RESERVED
      .111 1111    EWACECF ERROR CHECK FLAGS
      .1.. ....     EWACKEY IF ON, INDICATES CBC ERROR ON KEY VS STORAGE. MEANINGFUL FOR CDC, MEASUREMENT- BLOCK DATA CHECK, OR CCC WITH CCW OR IDAW CHECK.
      ..1. ....     EWACMBPG IF ON, MEASUREMENT-BLOCK PROGRAM CHECK. MEASUREMENT- BLOCK ENTRY HAS AN INVALID ABSOLUTE ADDRESS.
      ...1 ....     EWACMBDC IF ON, MEASUREMENT- BLOCK DATA CHECK. THE MEASUREMENT-BLOCK PARAMETERS OR THE ASSOCIATED KEY HAVE AN INVALID CBC.
      .... 1...     EWACMBPT IF ON, MEASUREMENT- BLOCK PROTECTION CHECK. KEY USED BY CHANNEL DOESN'T MATCH MEASUREMENT-BLOCK (STORAGE) KEY.
      .... .1..     EWACCCWC IF ON, CBC ERROR WHILE FETCHING A CCW. CHANNEL CONTROL CHECK WILL ALSO BE ON.
      .... ..1.     EWACIDAW IF ON, CBC ERROR WHILE FETCHING AN IDAW. CHANNEL CONTROL CHECK WILL ALSO BE ON.
      .... ...1     EWACALC IF ON, ADDRESS LIMIT FAILURE WHILE EXECUTING THE LAST CHANNEL PROGRAM. CHANNEL CONTROL CHECK WILL ALSO BE ON.
17 (11) BITSTRING 1   EWAERWF ERW FLAGS
      1... ....    EWA2CCWV SECONDARY CCW ADDRESS VALID
      .111 1111    * RESERVED
18 (12) BITSTRING 1   EWAERW2 Byte 2 of the Extended Report Word (ERW)
      1... ....    EWAOBE Extended exception status is associated with the operation block
      .1.. ....    EWARBS Extra exception status has been stored.
      ..11 1111    * RESERVED
19 (13) CHARACTER 1   * RESERVED
20 (14) BITSTRING 1   EWARGFG1 FLAG BYTE
      1... ....    EWACSIO ALWAYS 0. INDICATES STATUS WAS NOT STORED AFTER A START SUBCHANNEL COMMAND.
      .1.. ....    EWACINT ALWAYS 1. INDICATES STATUS STORED FOLLOWING AN I/O INTERRUPT FOR START SUBCHANNEL.
      ..1. ....    EWACTIO ALWAYS 0. INDICATES STATUS WAS NOT STORED AFTER A TEST SUBCHANNEL COMMAND.
      ...1 ....    EWACHIO ALWAYS 0. INDICATES STATUS WAS NOT STORED AFTER A HALT SUBCHANNEL COMMAND.
      .... 1...    EWAITO INTERFACE TIMEOUT DETECTED
      .... .1..    EWACSNS SENSE DATA WAS STORED
      .... ..1.    EWACCNT CSW COUNT IS VALID
      .... ...1    EWANORTY IF ON, OPERATION CANNOT BE RETRIED.
21 (15) BITSTRING 1   EWALPUM LAST PATH USED MASK (LPUM). THIS FIELD IS COPIED FROM THE EXTENDED STATUS WORD IF THE LPUM SETTING IS CONSISTENT WITH THE OTHER LOGOUT INDICATIONS.
22 (16) BITSTRING 1   EWAXCSW1 VALIDITY INDICATORS
      1... ....    * RESERVED
      .111 11..    EWACFVF FIELD VALIDITY FLAGS
      .1.. ....     EWACLPUV LAST PATH USED MASK FIELD IS CONSISTENT WITH THE OTHER LOGOUT INDICATIONS
      ..1. ....     EWACTCV TERMINATION CODE IS VALID
      ...1 ....     EWACSQV SEQUENCE CODE IS VALID
      .... 1...     EWACUNS DEVICE STATUS IS VALID
      .... .1..     EWACCMD CCW/TCW address is valid
      .... ..1.    EWACCHV ALWAYS 1. INDICATES THE DEVICE NUMBER IS VALID.
      .... ...1    EWACDAV ALWAYS 1. INDICATES THE DEVICE NUMBER IS VALID.
23 (17) BITSTRING 1   EWAXCSW2 TERMINATION AND SEQUENCE CODES
      11.. ....    EWACTEC TERMINATION CODE - SEE BELOW FOR VALUES
      ..1. ....    EWAD DEVICE STATUS CHECK
      ...1 ....    EWAE SECONDARY ERROR INDICATION
      .... 1...    EWACDIN I/O ERROR ALERT
      .... .111    EWACSEQ SEQUENCE CODES - SEE BELOW FOR VALUES
24 (18) CHARACTER 2  EWACHA DEVICE NUMBER ON WHICH I/O WAS STARTED
26 (1A) BITSTRING 1  EWAFLGA FLAGS FOR IOS INTERNAL USE
      1111 ....   * RESERVED
      .... 1111   EWADDE BITS RESERVED FOR DEVICE DEPENDENT EXITS
27 (1B) BITSTRING 1  EWAPATHS PATHS TO BE USED FOR RETRY I/O. ONLY USED IF EWAAPR IS ON.
28 (1C) ADDRESS 4  EWADRCW ADDR OF RECORD CONTROL TABLE (VALID ONLY IF EWARCBLT=1)
28 (1C) CHARACTER 1   EWADCNT NUMBER OF BYTES OF OBR INFO
29 (1D) ADDRESS 3   EWADDISP ADDR OF OBR DEVICE DEPENDENT INFORMATION (EWARCBLT=0)
32 (20) CHARACTER 184  EWAIERP AREA FOR INDIVIDUAL ERPS
216 (D8) CHARACTER 8  EWAFSA When EWAFSAVF is one, contains the failing storage (real) address. This is valid for channel control checks, channel data checks, channel program checks (FCX), and protection checks (FCX).
216 (D8) ADDRESS 4   EWAFSAH High order word of FSA
216 (D8) ADDRESS 4    EWASMADR No longer used
220 (DC) ADDRESS 4   EWAFSAL Low order word of FSA
220 (DC) BITSTRING 4    EWASMFLG No longer used
224 (E0) SIGNED 2  EWARSVD1 Reserved
224 (E0) SIGNED 2   EWASMRC No longer used
226 (E2) BITSTRING 1  EWAPFCMD Failing command code within the prefix area, otherwise zero
227 (E3) BITSTRING 1  EWAVPATH PATH MASK OF CHANNEL PATHS TO BE VARIED OFFLINE
228 (E4) CHARACTER 4  EWAID EBCDIC ACRONYM FOR EWA
232 (E8) CHARACTER 4  EWAESW EXTENDED STATUS WORD
236 (EC) BITSTRING 2  EWAQTIME IOS TIME VALUE WHEN I/O REQUEST WAS PLACED ON IOQ QUEUE (CONVERTED FROM IOQIOTCT)
238 (EE) UNSIGNED 1  EWASNSRD Lesser of the number of sense bytes actually read from the device and the number of sense bytes expected. The UCBSNSCT field contains the number of bytes that IOS expected the device to return and is set by the UIM. This field is not valid if EWABDSNS is set.
239 (EF) UNSIGNED 1  EWASSID Subchannel Set ID
240 (F0) ADDRESS 4  EWASLH POINTER TO SLH STORAGE
244 (F4) ADDRESS 4  EWAERPCR ERP CLEANUP ROUTINE ADDRESS
Table 2. Structure EWADDIOS
Offset Offset  
Dec Hex Type Len Name(Dim) Description
32 (20) STRUCTURE 80 EWADDIOS  
32 (20) CHARACTER 64  EWASNS SENSE DATA START
96 (60) CHARACTER 12  * RESERVED
108 (6C) CHARACTER 4  EWA2CSW 2nd CCW translation address
112 (70) CHARACTER 0  EWAEND END OF EWA
Table 3. Constants for EWA
Len Type        Value Name Description 
CONSTANTS FOR EWASCCD
1 HEX 00 EWASCC0 DEFERRED CONDITION CODE 0 
CONSTANTS FOR EWASNSCT
1 HEX FF EWASCTMX MAXIMUM NUMBER OF SENSES TRIED. 
CONSTANTS FOR EWACTEC
0 BIT 00 EWATER0 INTERFACE DISCONNECT
0 BIT 01 EWATER1 STOP, STACK, OR NORMAL TERM
0 BIT 10 EWATER2 SELECTIVE RESET 
CONSTANTS FOR EWACSEQ
0 BIT 000 EWACSEQ0 RESERVED
0 BIT 001 EWACSEQ1 COMMAND SENT BUT STATUS NOT ANALYZED
0 BIT 010 EWACSEQ2 COMMAND ACCEPTED BY DEVICE BUT NO DATA HAS BEEN TRANSFERRED
0 BIT 011 EWACSEQ3 AT LEAST ONE BYTE OF DATA HAS BEEN TRANSFERRED
0 BIT 100 EWACSEQ4 COMMAND NOT SENT OR SENT BUT NOT YET ACCEPTED
0 BIT 101 EWACSEQ5 COMMAND HAS BEEN ACCEPTED BUT DATA TRANSFER UNPREDICTABLE
0 BIT 110 EWACSEQ6 RESERVED
0 BIT 111 EWACSEQ7 RESERVED 
CONSTANTS FOR CONTROL BLOCK IDENTIFIER
4 CHARACTER EWA EWACID CONTROL BLOCK IDENTIFIER
Table 4. Cross Reference for EWA
Name Offset Hex Tag
EWA 0
EWAAPR 4 40
EWABDSNS 4 01
EWACALC 10 01
EWACCCWC 10 04
EWACCHV 16 02
EWACCMD 16 04
EWACCNT 14 02
EWACDAV 16 01
EWACDIN 17 08
EWACECF 10 7F
EWACFSTB 10
EWACFVF 16 7C
EWACHA 18
EWACHIO 14 10
EWACIDAW 10 02
EWACINT 14 40
EWACKEY 10 40
EWACLPUV 16 40
EWACMBDC 10 10
EWACMBPG 10 20
EWACMBPT 10 08
EWACNTRS A
EWACNTR1 A
EWACNTR2 B
EWACNTR3 C
EWACNTR4 D
EWACOVF 5 20
EWACSEQ 17 07
EWACSIO 14 80
EWACSNS 14 04
EWACSQV 16 10
EWACTCV 16 20
EWACTEC 17 C0
EWACTIO 14 20
EWACUNS 16 08
EWAD 17 20
EWADCNT 1C
EWADDE 1A 0F
EWADDIOS 20
EWADDISP 1D
EWADDMSG 4 02
EWADRCW 1C
EWAE 17 10
EWAEND 70
EWAERPCR F4
EWAERPIB 10
EWAERPRT 5 10
EWAERWF 11
EWAERW2 12
EWAESW E8
EWAEXT 0
EWAFLAGS 4
EWAFLGA 1A
EWAFLG1 4
EWAFLG2 5
EWAFLG3 6
EWAFSA D8
EWAFSAH D8
EWAFSAL DC
EWAFSAVF 5 02
EWAHDR 0
EWAID E4
EWAIERP 20
EWAITO 14 08
EWAJAM 6 80
EWALBUSY 5 04
EWALPUM 15
EWAMDR 5 80
EWANORTY 14 01
EWAOBE 12 80
EWAPATHS 1B
EWAPFCMD E2
EWAQTIME EC
EWARBS 12 40
EWARCBLT 5 08
EWAREPET 4 20
EWARGFG1 14
EWARSVD1 E0
EWASCCD 4 0C
EWASCC1 4 04
EWASCC3 4 0C
EWASLH F0
EWASLIS 4 80
EWASMADR D8
EWASMFLG DC
EWASMRC E0
EWASNS 20
EWASNSCT 7
EWASNSRD EE
EWASSID EF
EWASSTAT 8
EWASTUP E
EWAVPATH E3
EWAWTEMP 5 40
EWAXCSW1 16
EWAXCSW2 17
EWAXTRCD 4 10
EWA2CCWV 11 80
EWA2CSW 6C