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.