1 Z Functional Entry Support Requirement S00014 Libbye Sloan-Brooks Fall TPFUG 10/17/2000 Tucson, AZ.

1

Z Functional Entry Z Functional Entry SupportSupport

Requirement S00014Requirement S00014

Libbye Sloan-BrooksLibbye Sloan-BrooksFall TPFUGFall TPFUG

10/17/200010/17/2000Tucson, AZTucson, AZ

2

IntroductionIntroduction

The following ‘Z’ functions are used The following ‘Z’ functions are used today at Sabre and provide today at Sabre and provide improved System Monitoring improved System Monitoring functions resulting in better System functions resulting in better System Availability for our customers. Availability for our customers.

3

Display record hold table

– Display and Alter active items in the prime and overflow in-core Display and Alter active items in the prime and overflow in-core hold table. hold table.

– Display gives queue counts and address references for records Display gives queue counts and address references for records that are being held. Used to identify record queuing problems. that are being held. Used to identify record queuing problems.

– ZUCDH 002ZUCDH 002

– CSMP97I 12.40.00 CPU-A SSU-AA IS-01 CSMP97I 12.40.00 CPU-A SSU-AA IS-01

PRIME TABLE ADDRESS 3563D8 OVERFLOW TABLE ADDRESS PRIME TABLE ADDRESS 3563D8 OVERFLOW TABLE ADDRESS 357448 357448

CORE ADDR ECB ADDR TIME FILE ADDR WAIT QUEUE COUNT CORE ADDR ECB ADDR TIME FILE ADDR WAIT QUEUE COUNT

356B08 P 677060 0001 00DF03FF 507640 002 356B08 P 677060 0001 00DF03FF 507640 002

1B6678 O 21D380 xxxx 053E0007 1D3C68 003 1B6678 O 21D380 xxxx 053E0007 1D3C68 003

– where: P = Prime hold table where: P = Prime hold table

– O = Overflow hold table O = Overflow hold table

– xxxx = Time field invalid (no longer an ECB) xxxx = Time field invalid (no longer an ECB)

4

• Alters active item in the prime and overflow in-core hold Alters active item in the prime and overflow in-core hold table. Used to remove items from the hold table whose table. Used to remove items from the hold table whose I/O has been lost. I/O has been lost.

• ZUCAH xxxxxx yyyyyy zzzzzzzz ZUCAH xxxxxx yyyyyy zzzzzzzz

• where: xxxxxx = Core address of item in hold table where: xxxxxx = Core address of item in hold table

• yyyyyy = ECB address of item in hold table yyyyyy = ECB address of item in hold table

• zzzzzzzz = File address of item in hold table zzzzzzzz = File address of item in hold table

Alter the record hold table

5

Display the minute/second CRET tables

• ZUCSV D CRET S (or M for minute CRET Table)ZUCSV D CRET S (or M for minute CRET Table)

• CRET SEC PAID-TDIB 10.31.00 CRET SEC PAID-TDIB 10.31.00

LOCATION ENTER EXP USER PROG TIME PARM LOCATION ENTER EXP USER PROG TIME PARM

003654D0 10C0497F 04A3 AS JCD2 10.31.29 E2240C02 003654D0 10C0497F 04A3 AS JCD2 10.31.29 E2240C02

003654E4 10C0CC9F 04A3 AA CNQD 10.36.01 00000000 003654E4 10C0CC9F 04A3 AA CNQD 10.36.01 00000000

003654F8 10C0CC9F 0000 CP CYED 10.31.30 000000F0 003654F8 10C0CC9F 0000 CP CYED 10.31.30 000000F0

0036550C 10C02A0F 02A2 US CWCV 10.31.31 00000001 0036550C 10C02A0F 02A2 US CWCV 10.31.31 00000001

00365520 FF0F8461 0000 AA CYQJ 10.31.30 C3D9C5E3 00365520 FF0F8461 0000 AA CYQJ 10.31.30 C3D9C5E3

00365534 FF023101 2000 AA CNP1 10.31.30 005149B0 00365534 FF023101 2000 AA CNP1 10.31.30 005149B0

END OF CRET TABLEEND OF CRET TABLE

6

Compare contents of 2 records • ZUVRT COMP aaaaaaaa bbbbbbbb DSP yyy zzz ZUVRT COMP aaaaaaaa bbbbbbbb DSP yyy zzz

• where aaaaaaaa = File address to compare where aaaaaaaa = File address to compare

• bbbbbbbb = File address to compare to aaaaaaabbbbbbbb = File address to compare to aaaaaaa

• yyy = Starting displacement yyy = Starting displacement

• zzz = Ending displacement zzz = Ending displacement

• ZUVRT COMP 1402311F 24B3C06F ALL ZUVRT COMP 1402311F 24B3C06F ALL

7

Selective record copy

• ZUFSL id xxxxxxxx ZUFSL id xxxxxxxx

• ZUFSL id xxxxxxxx yyyyyyyy ZUFSL id xxxxxxxx yyyyyyyy

• ZUFSL DATA id xxxxxxxx*ddd TO yyyyyyyy*eee FOR nbrZUFSL DATA id xxxxxxxx*ddd TO yyyyyyyy*eee FOR nbr

– id - (1) & (2) - record ID of ‘from’ record id - (1) & (2) - record ID of ‘from’ record

– id - (3) - record ID of both the 'from' & 'to' recordid - (3) - record ID of both the 'from' & 'to' record

– xxxxxxxx - 'from' record address xxxxxxxx - 'from' record address

– ddd - 3 char hex displacement into 'from' record ddd - 3 char hex displacement into 'from' record

– yyyyyyyy - ‘to’ record address yyyyyyyy - ‘to’ record address

– eee - 3 char hex displacement into ‘to’ record eee - 3 char hex displacement into ‘to’ record

– nbr - 3 char decimal number of bytes to be moved nbr - 3 char decimal number of bytes to be moved

8

Display a module queue • ZUVRT MOD D ZUVRT MOD D

• ZUVRT MOD Q ZUVRT MOD Q

• ZUVRT MOD Q/S ZUVRT MOD Q/S

• ZUVRT MOD xxx ZUVRT MOD xxx

• ZUVRT MOD xxx/S ZUVRT MOD xxx/S

• where xxx = MOD number where xxx = MOD number

• The D option will display the highest module queue on a dupe The D option will display the highest module queue on a dupe mod. mod.

• The Q option will display the first 80 items on the highest The Q option will display the first 80 items on the highest module queue. module queue.

• The /S option will sort the list. The /S option will sort the list.

• You can also display the module queue for a particular module. You can also display the module queue for a particular module.

9

Display the Inter-Processor

Communications queue ZUVRT IPCZUVRT IPC

• Display the top 5 items from each outbound IPC Display the top 5 items from each outbound IPC (Interprocessor Communications) queue. (Interprocessor Communications) queue.

• The Q option will display up to 20 items from the largest The Q option will display up to 20 items from the largest queue. queue.

• The P option will display up to 20 items from a particular The P option will display up to 20 items from a particular processor's queue. processor's queue.

• Note there are no error responses. The default is ZUVRT Note there are no error responses. The default is ZUVRT IPC. IPC.

• ZUVRT IPC ZUVRT IPC

• ZUVRT IPC Q ZUVRT IPC Q

• ZUVRT IPC Px ZUVRT IPC Px

– where x = processor number where x = processor number

10

Compare a single record’s prime and

dupe

• ZUVRT P/DZUVRT P/D

• ZUVRT P/D xxxxxxxx ZUVRT P/D xxxxxxxx

– (where xxxxxxxx = FA Address (where xxxxxxxx = FA Address

11

Compare a module’s prime and dupe

records

• Compare prime/dupe records & write mismatches to tape. Compare prime/dupe records & write mismatches to tape.

• ZUVRT P/D mmmm iiii nnnn ZUVRT P/D mmmm iiii nnnn

• where: mmmm = Hex symbolic starting MOD where: mmmm = Hex symbolic starting MOD

• (prime or dupe) (prime or dupe)

• iiii = Hex max number of I/Os on primeiiii = Hex max number of I/Os on prime

• mod's queue before defer. mod's queue before defer.

• nnnn = Hex number of prime/dupe pairsnnnn = Hex number of prime/dupe pairs

• to be compared. Each pair has to be compared. Each pair has

• own CREX ECB. own CREX ECB.

12

Display the core location of CINFC tags

• ZUVRT CINFC tttttt dd.ll ZUVRT CINFC tttttt dd.ll – where tttttt = CINFC tag where tttttt = CINFC tag – dd = displacement from tagdd = displacement from tag– ll = length to displayll = length to display

• ZUVRT CINFC CMMOPEZUVRT CINFC CMMOPE

CSMP0097I 13.46.42 CPU-2 SS-PNR SSU-PR IS-01 CSMP0097I 13.46.42 CPU-2 SS-PNR SSU-PR IS-01

YVC30001I 13.46.42 CORE ADDR CINFC CMMOPE IS YVC30001I 13.46.42 CORE ADDR CINFC CMMOPE IS 00163098 00163098

• ZUVRT CINFC CMMOPE 0.30ZUVRT CINFC CMMOPE 0.30

CSMP0097I 13.46.42 CPU-2 SS-PNR SSU=PR IS-01CSMP0097I 13.46.42 CPU-2 SS-PNR SSU=PR IS-01

YVC30010I 13.46.42 BEGIN DISPLAYYVC30010I 13.46.42 BEGIN DISPLAY

00163098 - F000D000 F000D000 00000000 0000000000163098 - F000D000 F000D000 00000000 00000000

END OF DISPLAY - ZEROED LINES NOT DISPLAYEDEND OF DISPLAY - ZEROED LINES NOT DISPLAYED

13

Display the CSECT listing and displacement of a core address within

the control program

• ZUVRT CPLK cccccc ZUVRT CPLK cccccc

– where cccccc = Core address within the control where cccccc = Core address within the control program program

• ZUVRT CPLK 02DB00 ZUVRT CPLK 02DB00

02DB00 EQUALS L-100 IN SONA 02DB00 EQUALS L-100 IN SONA

14

Add a program to the minute or second

CRET table

• Activate a program at a specified time. Activate a program at a specified time.

• ZUVRT CRET PGM-pppp TBL-t PARM-xxxxxxxx TIME-yyyy ZUVRT CRET PGM-pppp TBL-t PARM-xxxxxxxx TIME-yyyy

– where pppp = Program name where pppp = Program name

– t = M or S for Minute or Second tablet = M or S for Minute or Second table

– xxxxxxxxx = CRET parameter, 0-9 and A-F xxxxxxxxx = CRET parameter, 0-9 and A-F

– (PARM is optional) (PARM is optional)

– yyyy = CRET time in seconds or minutes yyyy = CRET time in seconds or minutes

15

Convert pool directory ordinal and byte

or mask to file address • ZUVRT FADD ooooo dddd/Bxx ZUVRT FADD ooooo dddd/Bxx

• ZUVRT FADD ooooo dddd/mm ZUVRT FADD ooooo dddd/mm

• where: ooooo = Pool directory ordinal where: ooooo = Pool directory ordinal

• dddd = Displacement dddd = Displacement

• Bxx = Specify bit 00 - 07 Bxx = Specify bit 00 - 07

• MM = Bit mask MM = Bit mask

• (All examples are for the same file address) (All examples are for the same file address)

• ZUVRT FADD 256 256/B04 ZUVRT FADD 256 256/B04

• ZUVRT FADD H100 H100/08 ZUVRT FADD H100 H100/08

• ZUVRT FADD H100 256/FF ZUVRT FADD H100 256/FF

• ZUVRT FADD 256 H100 ZUVRT FADD 256 H100

16

Display the physical block table values • ZUVRT PBTZUVRT PBT

PBT - COMMON BASE CORE ADDR - 00123AD4 PBT - COMMON BASE CORE ADDR - 00123AD4

LOGICAL SIZE - 1000 PHYSICAL SIZE - 1000 LOGICAL SIZE - 1000 PHYSICAL SIZE - 1000

MAX HEX BLK CNT - 0296 CURRENT BLK CNT - 028E MAX HEX BLK CNT - 0296 CURRENT BLK CNT - 028E

FIRST BLOCK - 00B6A000 LAST BLOCK - 00DFF000 FIRST BLOCK - 00B6A000 LAST BLOCK - 00DFF000

PBT - FRAME BASE CORE ADDR - 00123B08 PBT - FRAME BASE CORE ADDR - 00123B08


MAX HEX BLK CNT - 8EF8 CURRENT BLK CNT - 786E MAX HEX BLK CNT - 8EF8 CURRENT BLK CNT - 786E

FIRST BLOCK - 00E00000 LAST BLOCK - 09CF7000 FIRST BLOCK - 00E00000 LAST BLOCK - 09CF7000

PBT - ECB BASE CORE ADDR - 00123420 PBT - ECB BASE CORE ADDR - 00123420


MAX HEX BLK CNT - 05DC CURRENT BLK CNT - 050D MAX HEX BLK CNT - 05DC CURRENT BLK CNT - 050D

FIRST BLOCK - 09CF8000 LAST BLOCK - 0AE89000 FIRST BLOCK - 09CF8000 LAST BLOCK - 0AE89000

PBT - SWB BASE CORE ADDR - 00123AA0 PBT - SWB BASE CORE ADDR - 00123AA0


MAX HEX BLK CNT - 3790 CURRENT BLK CNT - 35EF MAX HEX BLK CNT - 3790 CURRENT BLK CNT - 35EF

FIRST BLOCK - 0AE8C000 LAST BLOCK - 0B57DE00FIRST BLOCK - 0AE8C000 LAST BLOCK - 0B57DE00

PBT - IOB BASE CORE ADDR - 00122720PBT - IOB BASE CORE ADDR - 00122720

LOGICAL SIZE - 0100 PHYSICAL SIZE - 0100LOGICAL SIZE - 0100 PHYSICAL SIZE - 0100

MAX HEX BLK CNT - 11A0 CURRENT BLK CNT - 111AMAX HEX BLK CNT - 11A0 CURRENT BLK CNT - 111A

FIRST BLOCK - 0B57E000 LAST BLOCK - 0B697F00FIRST BLOCK - 0B57E000 LAST BLOCK - 0B697F00

17

Display the core resident program area • ZUVRT CRPAZUVRT CRPA

CSMP0097I 13.59.32 CPU-C SS-BSS SSU-AS IS-01 CSMP0097I 13.59.32 CPU-C SS-BSS SSU-AS IS-01

PSSC - 24/31 BIT CORE RESIDENT AREA AVAILABLE 4K’SPSSC - 24/31 BIT CORE RESIDENT AREA AVAILABLE 4K’S

1 2 3 4 5 6 7 8 9 1 2 3 4 5 6 7 8 9

24BIT XXXXXXXXXXXXXX………….............................. 413 24BIT XXXXXXXXXXXXXX………….............................. 413

31BIT XXXXXXXXXXXXXXXXX…………….................... 1176 31BIT XXXXXXXXXXXXXXXXX…………….................... 1176

X-PERCENT OF AREA INUSE X-PERCENT OF AREA INUSE

24BIT CORE RESIDENT AREA 24BIT CORE RESIDENT AREA

------------------------ ------------------------

002DC6BF - TOTAL SIZE 002DC6BF - TOTAL SIZE

0013F5BF - BYTES INUSE 0013F5BF - BYTES INUSE

0019D100 - BYTES AVAIL 0019D100 - BYTES AVAIL

3 - FRAGMENTED AREAS 3 - FRAGMENTED AREAS

0019CD10 - LARGEST CONTIG AREA 0019CD10 - LARGEST CONTIG AREA

00000130 - SMALLEST CONTIG AREA 00000130 - SMALLEST CONTIG AREA

0 - NUM OF OVERFLOWS0 - NUM OF OVERFLOWS

18

Display the core resident program area (continued)

31BIT CORE RESIDENT AREA 31BIT CORE RESIDENT AREA

------------------------ ------------------------

0098967F - TOTAL SIZE 0098967F - TOTAL SIZE

004F09DF - BYTES INUSE 004F09DF - BYTES INUSE

00498CA0 - BYTES AVAIL 00498CA0 - BYTES AVAIL

3 - FRAGMENTED AREAS 3 - FRAGMENTED AREAS

00497EB0 - LARGEST CONTIG AREA00497EB0 - LARGEST CONTIG AREA

00000020 - SMALLEST CONTIG AREA 00000020 - SMALLEST CONTIG AREA

0 - NUM OF OVERFLOWS 0 - NUM OF OVERFLOWS

END OF DISPLAY END OF DISPLAY

19

Map the VFA usage of a given record IDMap the VFA usage of a given record ID

• ZUCVA * REC-OM MAP FSTZUCVA * REC-OM MAP FST

CSMP0097I 13.24.15 CPU-G SS-BSS SSU-GF IS-01 CSMP0097I 13.24.15 CPU-G SS-BSS SSU-GF IS-01

UCVA0003I 13.24.15 REC-OM STATUS IS ENABLED, COMN FROM-CORE UCVA0003I 13.24.15 REC-OM STATUS IS ENABLED, COMN FROM-CORE

POOL TYPE STATUS FILE DELAY TOTAL INPROG AAA STMP POOL TYPE STATUS FILE DELAY TOTAL INPROG AAA STMP

SLT DISA DELAY 0 0 0 0 SLT DISA DELAY 0 0 0 0

SST ENAB DELAY 20211 20280 0 0 SST ENAB DELAY 20211 20280 0 0

SFX DISA DELAY 0 0 0 0 SFX DISA DELAY 0 0 0 0

LLT DISA DELAY 0 0 0 0 LLT DISA DELAY 0 0 0 0

LST ENAB DELAY 7454 7966 0 0 LST ENAB DELAY 7454 7966 0 0

LFX DISA DELAY 0 0 0 0 LFX DISA DELAY 0 0 0 0

FLT DISA DELAY 0 0 0 0 FLT DISA DELAY 0 0 0 0

FST ENAB DELAY 77 86 0 0 FST ENAB DELAY 77 86 0 0

FFX DISA DELAY 0 0 0 0 FFX DISA DELAY 0 0 0 0

TOTAL 27742 28332 TOTAL 27742 28332

20

Map the VFA usage of a given record IDMap the VFA usage of a given record ID(continued)(continued)

PERCENT OF BUFFER 381- 11 1055- 2 4095- 00 PERCENT OF BUFFER 381- 11 1055- 2 4095- 00

FILE ADDRESSES - POOL TYPE SELECTED - FST FILE ADDRESSES - POOL TYPE SELECTED - FST

B7ED23C8 B78E4BE5 B78E4AD9 B78E4AF9 B78E4C89 B7ED23C8 B78E4BE5 B78E4AD9 B78E4AF9 B78E4C89

B78E4C77 B78E4C4A B7ED0DA9 B78E4C8D B78E4C41 B78E4C77 B78E4C4A B7ED0DA9 B78E4C8D B78E4C41

B7ED2000 B78E4BE4 B78E4BC9 B78E4C6A B78E4C5F B7ED2000 B78E4BE4 B78E4BC9 B78E4C6A B78E4C5F

END OF REPORTEND OF REPORT

21

Display the contents of VFADisplay the contents of VFA

• ZUCVA * CONTZUCVA * CONT

CSMP0097I 13.14.00 CPU-G SS-BSS SSU-HA IS-01 CSMP0097I 13.14.00 CPU-G SS-BSS SSU-HA IS-01

*** CONTENTS OF VFA BUFFERS *** *** CONTENTS OF VFA BUFFERS ***

NUMBER OF RCDS FOUND IN VFA -- 473116 NUMBER OF RCDS FOUND IN VFA -- 473116

PROGRAM RECORDS - 6162 -- 1 PCT PROGRAM RECORDS - 6162 -- 1 PCT

RECORD ID QUANTITY PERCENTAGE RECORD ID QUANTITY PERCENTAGE

CP 210165 44 CP 210165 44

AA 138674 29 AA 138674 29

OR 39325 8 OR 39325 8

OM 27872 5 OM 27872 5

AQ 12848 2 AQ 12848 2

H6 5218 1 H6 5218 1

P9 4630 0 P9 4630 0

WY 3260 0 WY 3260 0

MI 2234 0 MI 2234 0

60D4 1956 0 60D4 1956 0

WX 1772 0WX 1772 0

22

More FunctionsMore Functions

ZIFIL option to write records to tape prior to altering

ZDECB option to display the level usage

ZDSYS ALL option to display the system state for all subsystems

ZDSVC to display the CSECT and listing displacement where the SVC is serviced, and to include fast link macros

ZDPAT program core copy display to display the program demand counter

23

ECB EXIT FunctionsECB EXIT Functions

ZECBL options for exiting an ECB in the following order:

– LOOP to exit a problem ECB by setting CE1PSW to an address which will cause a SERRC when this ECB gains control

– HUNG to exit a problem ECB that is in a record hold “deadlock” situation. All records held by this ECB are UNFRC’d allowing ECBs which were waiting to progress to completion. Then if there is no outstanding I/O the problem ECB is put on the Ready List with a PIA pointing to code to cause a SERRC. If there is outstanding I/O, the problem ECB is left to be exited when the I/O returns.

– KILL to guarantee the problem ECB exits

1 Z Functional Entry Support Requirement S00014 Libbye Sloan-Brooks Fall TPFUG 10/17/2000 Tucson, AZ.

Documents