The CHANGEVOLUME TSO subcommand updates details for a volume defined to DFSMSrmm. This diagram shows the syntax of the MEDIATYPE operand, the RECORDINGFORMAT operand, the KEYLABEL1/NOKEYLABEL1 and KEYENCODE1 operands, and the KEYLABEL2/NOKEYLABEL2 and KEYENCODE2 operands for the CHANGEVOLUME TSO subcommand.

>>-+------------------------------+----------------------------->
   |            .-*-----------.   |   
   '-MEDIATYPE(-+-CST---------+-)-'   
                +-ECCST-------+       
                +-EHPCT-------+       
                +-HPCT--------+       
                +-+-MEDIA5-+--+       
                | '-ETC----'  |       
                +-+-MEDIA6-+--+       
                | '-EWTC---'  |       
                +-+-MEDIA7-+--+       
                | '-EETC---'  |       
                +-+-MEDIA8-+--+       
                | '-EEWTC--'  |       
                +-+-MEDIA9-+--+       
                | '-EXTC---'  |       
                '-+-MEDIA10-+-'       
                  '-EXWTC---'         

>--+-------------------------------------+---------------------->
   '-RECORDINGFORMAT--(--+-*--------+--)-'   
                         +-18TRACK--+        
                         +-36TRACK--+        
                         +-128TRACK-+        
                         +-256TRACK-+        
                         +-384TRACK-+        
                         +-EFMT1----+        
                         +-EFMT2----+        
                         '-EEFMT2---'        

>--+--------------------------------------------------------------+-->
   |                                                   .-L-.      |   
   '-+-KEYLABEL1--(--keylabel1_name--)--KEYENCODE1--(--+-H-+--)-+-'   
     '-NOKEYLABEL1----------------------------------------------'     

>--+--------------------------------------------------------------+-><
   |                                                   .-L-.      |   
   '-+-KEYLABEL2--(--keylabel2_name--)--KEYENCODE2--(--+-H-+--)-+-'   
     '-NOKEYLABEL2----------------------------------------------'     

KEYLABEL1(keylabel1_name)

Specifies the key encryption key label number 1 for a non-scratch volume that is encrypted. A key label is 1-to-64 characters with blanks padding the field on the right. A key label contains alphanumeric, national, or special characters with some additional characters also allowed. Enclose it in single quotation marks if it contains any blanks or special characters.

When a volume is rewritten in a non-encryption format, DFSMSrmm does not clear the encryption key label related fields. Instead, the fields continue to be displayed until the volume is reused from scratch, or a release action causes them to be cleared.

When you specify this optional operand, you can also specify a value for the key encoding mechanism using the KEYENCODE1 operand.

KEYLABEL1 is mutually exclusive with NOKEYLABEL1.

KEYLABEL2(keylabel2_name)

Specifies the key encryption key label number 2 for a non-scratch volume that is encrypted. A key label is 1-to-64 characters with blanks padding the field on the right. A key label contains alphanumeric, national, or special characters with some additional characters also allowed. Enclose it in single quotation marks if it contains any blanks or special characters.

When a volume is rewritten in a non-encryption format, DFSMSrmm does not clear the encryption key label related fields. Instead, the fields continue to be displayed until the volume is reused from scratch, or a release action causes them to be cleared.

When you specify this optional operand, you can also specify a value for the key encoding mechanism using the KEYENCODE2 operand.

KEYLABEL2 is mutually exclusive with NOKEYLABEL2.

KEYENCODE1

Specifies the encoding mechanism used for KEYLABEL1.

L

Label

H

Public key hash

The default value is L.

KEYENCODE2

Specifies the encoding mechanism used for KEYLABEL2.

L

Label

H

Public key hash

The default value is L.

NOKEYLABEL1

Specify the NOKEYLABEL1 operand to clear an existing key encryption key label number 1 and encoding mechanism.

NOKEYLABEL1 is mutually exclusive with KEYLABEL1.

NOKEYLABEL2

Specify the NOKEYLABEL2 operand to clear an existing key encryption key label number 2 and encoding mechanism.

NOKEYLABEL2 is mutually exclusive with KEYLABEL2.

To use the EFMT2 and the EEFMT2 recording technology, you must specify the MEDIATYPE(MEDIA5/ETC, MEDIA6/EWTC, MEDIA7/EETC, MEDIA8/EEWTC, MEDIA9/EXTC, or MEDIA10/EXWTC) operand of the CHANGEVOLUME TSO subcommand.