UDZAP - DASD Modification Utility (Control User)

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:


Command Format

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 
    

Selecting a Volume

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.

UCB/PUB Lookup Display

Note that this display does not permit the changing or entering of data. Its only function is to allow you to view UCB information.

z/OS Display

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

z/VSE Display

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:
a. Press PF1.
b. Enter the characters "PF1".
PF2 Causes the display of the preceding CUU. Either:
a. Press PF2.
b. Enter characters "PF2".
PF3 Causes the UCB/PUB of the designated volume to be displayed. Either:
a. Enter the volume identification of desired volume and press PF3.
b. Enter the characters "PF3=vvvvvv", where vvvvvv is the desired volume identification.
PF4 Causes the function selection menu to be displayed. Either:
a. Press PF4.
b. Enter the characters "PF4".
PF5 Causes the UCB of the designated CUU to be displayed. Either:
a. Enter the CUU of the desired UCB and press PF5.
b. Enter the characters "PF5=cuu", where cuu is the desired CUU value.

Zap Volume Display

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 ENTER 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:
a. Press PF1.
b. Enter the characters "PF1".
PF2 Causes the function selection menu to be displayed. Either:
a. Press PF2.
b. Enter the characters "PF2".

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