z/OS DFSMS Software Support for IBM System Storage TS1140, TS1130, and TS1120 Tape Drives (3592)
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Updates to the Dump Volume Output Notification Exit (Exit 26)

z/OS DFSMS Software Support for IBM System Storage TS1140, TS1130, and TS1120 Tape Drives (3592)
SC23-6854-00

If an application requests host-based encryption through the DFSMSdss application programming interface (API), and DFSMSdss overrides the encryption request, DFSMSdss uses the Volume Output Notification Exit (Exit 26) to notify the caller. To indicate that the output tape volume used hardware encryption, DFSMSdss sets the EI26TWHE bit to one in the ADREID0 mapping.

If applicable, review your Exit 26 routine for updates to use the EI26TWHE bit. Table 1 shows the ADREID0 mapping.
Table 1. ADREID0 mapping
Offsets Type Len Name (Dim) Description
Dec Hex
 
0 (0) STRUCTURE 128 EIREC26  
0 (0) BITSTRING 4 EI26TYPE EXIT TYPE
    1... ....   EI26VOL OUTPUT VOLUME NOTIFICATION
    .1.. ....   EI26TERM OUTPUT VOLUME TERMINATED
    ..1. ....   EI26R0CE BWO R0 COUNT ERROR
    ...1 ....   EI26VCLO OUTPUT VOLUME CLOSE - ONLY FOR DASD OUTPUTS DURING LOGICAL DUMP OPERATIONS
    .... 1...   EI26TWHE WHEN SET TO 1, THE OUTPUT TAPE VOLUME WILL USE HARDWARE ENCRYPTION.
    .... .xxx   * UNUSED
0 (0) BITSTRING 3 * RESERVED FOR EXPANSION
4 (4) CHARACTER 64 EI26DSN DSNAME IF EI26ROCE = '1'B
68 (44) UNSIGNED 1 EI26DSNL LENGTH OF DSNAME
69 (45) UNSIGNED 3 * RESERVED FOR ALIGNMENT
72 (48) CHARACTER 8 EI26DDN OUTPUT DDNAME IF EI26VOL, EI26TERM, OR EI26VCLO SET
80 (50) CHARACTER 6 EI26VSER VOLSER - PRESENT IF EI26VOL, EI26TERM, EI26VCLO SET
86 (56) CHARACTER 2 * RESERVED FOR ALIGNMENT
88 (58) UNSIGNED 4 EI26VTRC RETURN FOR VOLUME TERM AND VOLUME CLOSE
92 (5C) ADDRESS 36 * RESERVED FOR EXPANSION

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014