z/TPF - Group home

ZUDFM INIT Enhancements (PH43813)

By Daniel Jacobs posted Thu June 30, 2022 02:27 PM

  

 

ZUDFM INIT command enhancements (APAR PH43813)

 

z/TPFDF APAR PH43813 provides enhancements to output messages, subsystem user (SSU) processing, and timeout handling on the ZUDFM INIT command.

 

Output Messages

 

Before APAR PH43813, when you entered the initial ZUDFM INIT command, you were presented with a pair of output messages that contained text that did not adhere to IBM’s current message conventions.  For example, the message told you to make sure you knew what you were doing. 

 

With APAR PH43813, when you enter the initial ZUDFM INIT command, you will get a single output message that is more modern, concise, and relevant.  For example, an indication will be provided as to whether the initialization will be done with hold, nohold, or release:

zudfm init b411                                                    
CSMP0097I 17.21.30 CPU-B SS-BSS  SSU-HPN  IS-01                     
UDFM0384A 17.21.30 THE FOLLOWING FILE WILL BE INITIALIZED WITH HOLD.
                   ID-B411  FVN-00  FACET-#ACREDIT  SSU-COMMON     
                   BOR-0000000000   EOR-0000000879                 
                                                                    
                   TO CONFIRM THE INITIALIZATION, _                
                   REPEAT THE COMMAND WITHIN 2 MINUTES.+      


 

SSU Processing

 

Before APAR PH43813, to initialize a file on multiple SSUs, you had to enter the ZUDFM INIT command on each SSU.  In addition, if you specified the FILE parameter to save the fixed file prime blocks to a file or general tape, you had to manage multiple backup files or tapes. Furthermore, z/TPFDF did not provide a way to initialize a file on a dormant SSU.

 

With APAR PH43813, you can enter the ZUDFM INIT command with the SSU-ALL parameter specified to initialize the file on all SSUs. If you specify both the SSU-ALL and FILE parameters, the fixed file prime blocks for all subfiles on all SSUs are backed up to a single file or a single set of general tapes.  Furthermore, if any of the SSUs are dormant, they will still be initialized.  For example:

 

wp/zudfm init b075 ssu-all                                           
CSMP0097I 19.10.21 CPU-B SS-WP   SSU-WP1  IS-01                      
UDFM0386I 19.10.21 ZUDFM DATABASE INITIALIZATION COMPLETED ON SSU WP1
                   ID-B075  FVN-00  TOTAL ORDINALS-0000010026+       
CSMP0097I 19.10.21 CPU-B SS-WP   SSU-WP2  IS-01                      
UDFM0386I 19.10.21 ZUDFM DATABASE INITIALIZATION COMPLETED ON SSU WP2
                   ID-B075  FVN-00  TOTAL ORDINALS-0000010026+       
CSMP0097I 19.10.21 CPU-B SS-WP   SSU-WP3  IS-01                      
UDFM0386I 19.10.21 ZUDFM DATABASE INITIALIZATION COMPLETED ON SSU WP3
                   ID-B075  FVN-00  TOTAL ORDINALS-0000010026+       
CSMP0097I 19.10.21 CPU-B SS-WP   SSU-WP1  IS-01                       
UDFM0383I 19.10.21 ZUDFM DATABASE INITIALIZATION COMPLETED           
                   ID-B075  FVN-00  TOTAL ORDINALS-0000030078+       

 

You can also specify the SSU parameter with an SSU name to specify a single active or dormant SSU where the file will be initialized.  For example:

 

wp3/zudfm init b431 ssu-wp2                                        
CSMP0097I 19.22.44 CPU-B SS-WP   SSU-WP3  IS-01                    
UDFM0384A 19.22.44 THE FOLLOWING FILE WILL BE INITIALIZED WITH HOLD.
                   ID-B431  FVN-00  FACET-#AHOTEL  SSU-WP2         
                   BOR-0000000000   EOR-0000001589                 
                                                                    
                   TO CONFIRM THE INITIALIZATION, _                
                   REPEAT THE COMMAND WITHIN 2 MINUTES.       

   

 

Timeout Processing

 

Before APAR PH43813, if a second ZUDFM INIT command was not entered within 2 minutes of entering the initial ZUDFM INIT command, initialization processing timed out, but a notification was not sent to the console. The next request to initialize a file resulted in a potentially confusing error message because the control record for the previous initialization request was not cleaned up. Also, z/TPFDF did not provide a way to cancel a pending initialization.

 

With APAR PH43813, if a second ZUDFM INIT command is not entered within 2 minutes of entering the initial ZUDFM INIT command, initialization processing times out, and a notification is sent to the console. The control record is cleaned up, which ensures subsequent ZUDFM INIT commands can be entered without receiving an error message.  For example,

 

zudfm init b075
CSMP0097I 13.34.27 CPU-B SS-WP   SSU-WP1  IS-01
UDFM0384A 13.34.27 THE FOLLOWING FILE WILL BE INITIALIZED WITH HOLD.
                   ID-B075  FVN-00  FACET-#BTREE  SSU-WP1
                   BOR-0000000052   EOR-0000000077
 
                   TO CONFIRM THE INITIALIZATION,
                   REPEAT THE COMMAND WITHIN 2 MINUTES.

 

<Two minutes go by…>

 

CSMP0097I 13.36.27 CPU-B SS-WP   SSU-WP1  IS-01
UDFM0400E 13.36.27 THE PENDING INITIALIZATION FOR FILE ID B075 TIMED OUT.

 

Also, a CANCEL parameter is provided on the ZUDFM INIT command. For example, if you enter the initial ZUDFM INIT command and you realize you specified the wrong file ID or omitted a parameter, you can enter the ZUDFM INIT command with the CANCEL parameter to cancel the pending initialization.  For example,

 

zudfm init b425                                                            
CSMP0097I 17.25.21 CPU-B SS-BSS  SSU-HPN  IS-01                            
UDFM0384A 17.25.21 THE FOLLOWING FILE WILL BE INITIALIZED WITH HOLD.       
                   ID-B425  FVN-00  FACET-#APGRNUM  SSU-COMMON             
                   BOR-0000000000   EOR-0000000499                         
                                                                            
                   TO CONFIRM THE INITIALIZATION, _                        
                   REPEAT THE COMMAND WITHIN 2 MINUTES.+                   
zudfm init cancel                                                          
CSMP0097I 17.25.46 CPU-B SS-BSS  SSU-HPN  IS-01                            
UDFM0389I 17.25.46 THE PENDING INITIALIZATION FOR FILE ID B425 IS CANCELED.+

 

For more information on these enhancements, see the IBM z/TPFDF documentation or the APEDIT for APAR PH43813.

0 comments
2 views