Resize Top Secret XES Structure With CF Level 19 Microcode
search cancel

Resize Top Secret XES Structure With CF Level 19 Microcode

book

Article ID: 48147

calendar_today

Updated On:

Products

Top Secret Top Secret - LDAP

Issue/Introduction

Does the Top Secret XES structure need to be resized with the CF level 19 microcode running on a ICF on a 2828?

Environment

Release: TOPSEC00200-15-Top Secret-Security
Component:

Resolution

Specifically for CF Level 19 Microcode, the Top Secret XES structure does not have to be increased.

For any CF level microcode, to determine the new size (if needed), use the

COUPLING FACILITY STATISTICS from a TSS MODIFY STATS output and

the MVS D XCF,STR,STRNAME=xxxx console command (where 'xxxx' is the structure name).

Once the micro code is upgraded, examine the STATS output again, and see if for the same structure size, the number of MAX entries was reduced and by what percentage. The structure size should then be increased by the same percentage so that same number of blocks would fit as before. Top Secret will continue to function even without changing the structure size, but the number of CLEARS would be more frequent.

For example:

Before the CF level microcode upgrade:

TSS MODIFY STATS

TSS9573I ----- COUPLING FACILITY STATISTICS -----

TSS9574I Maximum Size ( 54272K) Size ( 54272K)

TSS9575I Max Entries (000001777) Entries (000001262)

TSS9576I Requests (000042955) Hits (000042955)

TSS9577I Writes (000003249) Clears (000000000)

TSS9578I Locks (000389281) Waits (000005443)

TSS9579I Unlocks (000383838) EXCPs (000058582)

Output from the XCF display

- D XCF,STR,STRNAME=xxxx 

IXC360I 09.53.41 DISPLAY XCF 984

STRNAME: TSS_SECFILE

STATUS: ALLOCATED

EVENT MANAGEMENT: POLICY-BASED

TYPE: SERIALIZED LIST

POLICY INFORMATION:

POLICY SIZE : 53 M

POLICY INITSIZE: 53 M

POLICY MINSIZE : 0 K

FULLTHRESHOLD : 80

ALLOWAUTOALT : NO

REBUILD PERCENT: N/A

DUPLEX : DISABLED

ALLOWREALLOCATE: YES

PREFERENCE LIST: DCC1 SRC1

ENFORCEORDER : NO

EXCLUSION LIST IS EMPTY

ACTIVE STRUCTURE

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

ALLOCATION TIME: 11/10/2013 02:47:04

CFNAME : DCC1

COUPLING FACILITY: xxxxxxxxxxxxx

PARTITION: 05 CPCID: 00

ACTUAL SIZE : 53 M

STORAGE INCREMENT SIZE: 1 M

USAGE INFO TOTAL CHANGED %

ENTRIES: 1777 1262 71

ELEMENTS: 12301 8828 71

LOCKS: 4

PHYSICAL VERSION: CC3DE1B0 5E0E2301

LOGICAL VERSION: CBA6DA75 D601E681

SYSTEM-MANAGED PROCESS LEVEL: 8

XCF GRPNAME : gggggggg

DISPOSITION : DELETE

ACCESS TIME : 999

MAX CONNECTIONS: 32

# CONNECTIONS : 4

CONNECTION NAME ID VERSION SYSNAME JOBNAME ASID STATE

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

ccc1 01 00010121 sss1 TSSA 0020 ACTIVE

ccc2 03 00030161 sss2 TSSA 0020 ACTIVE

ccc3 02 0002011D sss3 TSSA 0020 ACTIVE

ccc4 04 0004011A sss4 TSSA 0020 ACTIVE

DIAGNOSTIC INFORMATION: STRNUM: 0000000A STRSEQ: 00000001

MANAGER SYSTEM ID: 00000000

EVENT MANAGEMENT: POLICY-BASED

After the upgrade (CF on a 2828 with CF level 19).

TSS MODIFY STATS

TSS9573I ----- COUPLING FACILITY STATISTICS -----

TSS9574I Maximum Size ( 54272K) Size ( 54272K)

TSS9575I Max Entries (000001792) Entries (000001264)

TSS9576I Requests (000076671) Hits (000076671)

TSS9577I Writes (000007265) Clears (000000000)

TSS9578I Locks (001028245) Waits (000017263)

TSS9579I Unlocks (001010982) EXCPs (000099116)

Output from the XCF display:

ISF031I CONSOLE ZB43268 ACTIVATED

- D XCF,STR,STRNAME=xxxx 

IXC360I 10.22.44 DISPLAY XCF 294

STRNAME: TSS_SECFILE

STATUS: ALLOCATED

EVENT MANAGEMENT: POLICY-BASED

TYPE: SERIALIZED LIST

POLICY INFORMATION:

POLICY SIZE : 53 M

POLICY INITSIZE: 53 M

POLICY MINSIZE : 0 K

FULLTHRESHOLD : 80

ALLOWAUTOALT : NO

REBUILD PERCENT: N/A

DUPLEX : DISABLED

ALLOWREALLOCATE: YES

PREFERENCE LIST: DCC1 SRC1

ENFORCEORDER : NO

EXCLUSION LIST IS EMPTY

ACTIVE STRUCTURE

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

ALLOCATION TIME: 01/26/2014 01:14:37

CFNAME : DCC1

COUPLING FACILITY: xxxxxxxxxxxxx

PARTITION: 05 CPCID: 00

ACTUAL SIZE : 53 M

STORAGE INCREMENT SIZE: 1 M

USAGE INFO TOTAL CHANGED %

ENTRIES: 1792 1264 70

ELEMENTS: 12321 8842 71

LOCKS: 4

PHYSICAL VERSION: CC9E9CA2 FBD90785

LOGICAL VERSION: CBA6DA75 D601E681

SYSTEM-MANAGED PROCESS LEVEL: 8

XCF GRPNAME : gggggggg

DISPOSITION : DELETE

ACCESS TIME : 999

MAX CONNECTIONS: 32

# CONNECTIONS : 4

CONNECTION NAME ID VERSION SYSNAME JOBNAME ASID STATE

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

ccc1 01 00010123 sss1 TSSA 0020 ACTIVE

ccc2 03 00030161 sss2 TSSA 0020 ACTIVE

ccc3 03 00030161 sss3 TSSA 0020 ACTIVE

ccc4 02 0002011D sss4 TSSA 0020 ACTIVE

DIAGNOSTIC INFORMATION: STRNUM: 0000000A STRSEQ: 00000001

MANAGER SYSTEM ID: 00000000

EVENT MANAGEMENT: POLICY-BASED

Based on the output from before and after the micro code upgrade, no increase in the Top Secret XES structure size is necessary. The numbers for max entries in the TSS MODIFY STATS output (highlighted in red in the TSS MODIFY STATS output above) are almost identical (1777 before the micro code upgrade vs 1792 after the upgrade). If anything, a decrease in the size less than 1% post upgrade would be needed to get the same max entries as before the upgrade.