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


OCE Tape Installation Exits

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

The IFGTEP macro maps the tape log data. Table 1 describes the IFGTEP fields for mapping the installation exit main parameter list.
Table 1. IFGTEP fields for the installation exit main parameter list
Field name Length and type Description
TEPMRECTK 8 (integer) Recording technology of the mounted volume in binary. 8 - EEFMT2
TEPMMEDT 8 (integer) Media type of the mounted volume in binary.
The IFGTEP macro maps the tape log data. Table 2 describes the IFGTEP fields for mapping the installation exit file end on volume parameter list.
Table 2. IFGTEP fields for the installation exit file end on volume parameter list
Field name Length and type Description
TEPEKEK1 64 (character) KEK label 1
TEPEKEK2 64 (character) KEK label 2
TEPEKCD1 1 (character) Key encoding mechanism associated with KEK label 1: L - Label, H - Hash
TEPEKCD2 1 (character) Key encoding mechanism associated with KEK label 2: L - Label, H - Hash
Note:
  1. The version of the FILEE parameter list (TEPEVER) is also updated (to a 2) to accommodate the longer FILEE parameter list.
  2. For a given mount, the tape drive obtains (from the Encryption Key Manager) and stores the key management-related information for subsequent access. When returning this information to the drive, if the encoding mechanism for one or both of the EEDKs is a "hash", the Encryption Key Manager always tries to resolve the "hash" value in an EEDK to its corresponding key label value and returns only the hash value if the key label cannot be resolved.
  3. If the returned key label from the Encryption Key Manager is only available as a hash value, the control unit automatically converts the returned hash value to printable EBCDIC and returns this value as the 64-CHAR key label (padded on the right with blanks X'40'). The returned hash value can be up to 56 bytes in length. This value is then passed to the file end on volume exit along with the character string *HASH* appended to the end of the character string in bytes 59-64. For example:
    ABDCFAABF15698BCDE222156AB4589BEFCDE9009ACBECCA12345678A  *HASH*

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014