The UDZAP utility, designed for use with 3270-type terminals, enables you to perform specific CCHHR zaps to a specified DASD volume. A UCB routine locates the specified volume by either:
CUU address;
Volume identification name.
Note:
z/VSE installations must have, for each disk device accessed by UDZAP,
a logical unit assignment (VSE LUB) in the z/VSE partition in which Com-plete
resides.
This document covers the following topics:
UDZAP is entered by issuing the request:
*UDZAP
This call displays the following menu:
CHOOSE FUNCTION UCB LOOKUP -- PF1
ZAP DISK -- PF2
|
Once this menu is displayed, you can perform additional functions. Optionally, the additional functions can be invoked as part of the UDZAP call.
The initial menu display explicitly specifies that one of two major functions can be performed:
| UCB LOOKUP | Performs a UCB/PUB lookup to obtain information about a specific volume and displays its UCB/PUB. |
| ZAP DISK | Displays a menu used to enter specific CCHHR/PBN information and data to be verified and replaced at the CCHHR/PBN. |
The function to be performed can be selected in one of three ways:
Press the appropriate PF key as illustrated in the menu.
Enter the characters that describe the function, as follows:
UCB/PUB ZAP
Specify the function when calling UDZAP as follows:
*UDZAP UCB/PUB *UDZAP ZAP
The volume on which the chosen function is to be performed can be identified by CUU or volume identification name. The choice is initially indicated in the display obtained after a specific UCB/PUB or ZAP function is selected, as shown in the following figure.
ENTER CUU ___ OR VOL ID______ |
To choose which CUU or volume to reference, enter the desired CUU value or volume identification in the appropriate input field.
The following pages illustrate and describe typical displays.
Note that this display does not permit the changing or entering of data. Its only function is to allow you to view UCB information.
UCB ADDR 1A3C UCB 0048FF8C 046A0020 013A0300 00F4F6C1 3050200D ......
F1401049 1DFC0100 00000000 00000000 00000001 ...... VOL ID SAG01
DEV ADDR--46A
UCB TYPE--MODEL CODE 0 OPT FEAT 50 DEV CLASS 20 .....
PF1= +1 CUU PF2= -1 CUU PF3= NEW PACKID ENTERED .....
CUU ENTERED |
PUB ADDR 015E PUB 0048FF8C 046A0020 013A0300 00F4F6C1 3050200D ...... F1401049 1DFC0100 00000000 00000000 00000001 ...... VOL ID DOSVSE DEV ADDR--15F PUB TYPE--PUB OPT 00 CHN FLAG FF JCL FLAGSFC UNIT TYPE 65 PF1= +1 CUU PF2= -1 CUU PF3= NEW PACKID ENTERED ..... CUU ENTERED |
The PF key definitions listed in the display enable you to either continue the UCB lookup function or to switch to the ZAP function. Specific PF key meanings and usage are:
| PF1 | Causes the display of the next sequential CUU. Either: | |||
|
||||
| PF2 | Causes the display of the preceding CUU. Either: | |||
|
||||
| PF3 | Causes the UCB/PUB of the designated volume to be displayed. Either: | |||
|
||||
| PF4 | Causes the function selection menu to be displayed. Either: | |||
|
||||
| PF5 | Causes the UCB of the designated CUU to be displayed. Either: | |||
|
The following figure illustrates a typical zap volume display.
FOR CUU 150 VOL ID DISK01
ENTER CYL/PBN___HEAD___REC___LGH-KRR VER DATA________ ________
REP DATA________ ________
ASSUME DECIMAL EXCEPT VER AND REP DATA (PRECEDE HEX ... ) |
You can enter data in the appropriate input fields. As indicated in the last line of the zap display, VER and REP data is assumed to be hexadecimal. Other data entered is assumed to be decimal. If hexadecimal is desired, the entry must be preceded by an "X". Note that it is not necessary to zero-fill any fields.
When zap information is entered and is pressed, the above screen is redisplayed either showing the accepted zap, or, in the case of an error, giving notification of the verify/rejection and permitting another attempt at the zap entry.
The following display illustrates a typical response received for a successful verify/replacement. The CCHHR value illustrated is for cylinder 1, head 1, record 1, offset 0.
FOR CUU 356 VOL ID DISK01 ENTER CYL/PBN__HEAD 1__REC __OFFSET 0__ LGH-KRR
002A28 VER DATA 90ECD00C 185D05F0
REP DATA 90EFD00C 185D05F0
ASSUME DECIMAL EXCEPT VER AND REP DATA (PRECEDE HEX ...
DONE. NEW DATA+ENTER=ZAP. PF1=NEW CUU. PF2=NEW FUNCTION. |
The functions described at the bottom of the preceding display are:
| NEW DATA | Tab the cursor to the input fields in the display and reenter additional CCHHR and verify/replace data. | |||
| PF1 | Causes the CUU/VOLUME selection menu to be displayed. Either: | |||
|
||||
| PF2 | Causes the function selection menu to be displayed. Either: | |||
|
When a zap is verified, the replacement zap is performed and a message summarizing the activity is sent to the default Com-plete logging terminal. The following figure shows a typical response received at a hard copy terminal.
MSG ID: 30, SENT 2/11/87 AT 1227, FROM TID 1 ZAP VOL DISK01 AT 0001000101 +0 ___
VER 90ECD00C 185D05F0
REP 90EFD00C 185D05F0
If the verify/replacement is unsuccessful, the entry screen is redisplayed indicating an error condition. To correct the error, tab to the input fields and reenter the correct information.
The following figure illustrates the display obtained from an unsuccessful attempt to modify data.
FOR CUU 356 VOL ID DISK01
ENTER CYL 1__HEAD 1__SEC 1__OFFSET 0__
LGH-KRR 002A28 VER DATA 90ECD00C 185D05F0
REP DATA 90EFD00C 185D05F0
ASSUME DECIMAL EXCEPT VER AND REP DATA (PRECEDE HEX ...
VER DATA DOESN'T MATCH RECORD: REENTER |