z/OS Cryptographic Services ICSF System Programmer's Guide
Previous topic | Next topic | Contents | Index | Contact z/OS | Library | PDF


The Cryptographic Communication Vector Table Extension (CCVE)

z/OS Cryptographic Services ICSF System Programmer's Guide
SA22-7520-17

The CCVE is an extension of the CCVT that contains fields that can exist. The CCVE exists in ICSF extended private. It should contain any ICSF base control block fields that are not needed by other address spaces.

Programming Interface information

CCVE

ONLY these fields are part of the programming interface:

  • CCVEINPP
  • CCVEINPL
  • CCVESECC
End of Programming Interface information

Table 89 describes the contents of the Cryptographic Communication Vector Table Extension. Any bits that are not described in the table are reserved.

Table 89. Cryptographic Communication Vector Table Extension
Offset (Dec)Number of BytesField NameDescription
04CCVEID

Cryptographic Communication Vector Table Extension ID. This field must contain the character string CCVE.

42CCVEVERVersion.

The version number of the CCVE. This field must contain the character string 04.

62CCVELENThe length of the CCVE.
88Reserved.
164CCVESTATStatus word

First status byte - CCVESTA1

Bit
Meaning When Set On
0
Special secure mode allowed.
1
Special secure mode enabled.
3
Authentication required for key retrieval.
4
The hardware has gone from active to inactive.
5
First start of ICSF during this IPL.
6
Security Server (RACF) checking required for authorized callers.
7
PCF coexistence.

Second status byte - CCVESTA2

0
Dynamic CKDS updates disallowed.
1
PKA callable services disabled from panel.
2
Dynamic PKDS updates disabled from panel.
3
Include CKT in dump of ICSF private space.
6
PKA callable services disallowed.
7
Authenticate the CKT when bit is one.

Third status byte - CCVESTA3

1
PKDS write, create, and delete not permitted.
2
SYSPLEXCKDS(YES) was specified in Install Options Data Set.
3
SYSPLEXCKDS(YES,FAIL(YES)) was specified in Install Options Data Set.
4
SYSPLEXTKDS(YES) was specified in Install Options Data Set.
5
SYSPLEXTKDS(YES,FAIL(YES)) was specified in Install Options Data Set.
6
TKDS refresh requested.
7
TKDS empty at initialization

Fourth status byte - CCVESTA4

Bit
Meaning When Set On
0
PKDS dataspace needs refresh.
1
PKDS dataspace can't be updated.
2
Reserved
3
Reserved
4
SYSPLEXPKDS(YES)
5
SYSPLEXPKDS(YES,FAIL(YES))
6
CKDS MAC record authentication
7
Sysplex running in sysplex mode (not XCF-local mode)
204CCVECAMQPointer to MCAMQ.
244CCVEEXITPointer to the installation exit router (CSFEXIT).
284CCVECLICSoftware Crypto control block
324CCVE_ENQ_TIMEOUTXCF Failure detection interval in 0.01 seconds used for Sysplex ENQ timeout interval.
364CCVETRCBPointer to the current trace buffer.
Bit
Meaning When Set On
0
Trace is active.
404CCVECPRMAddress of CPRM.
444CCVEMGSTAddress of the generic service table. See Generic Service Table (CSFMGST) for a description of the generic service table.
484CCVEENTAddress of the exit name table.
524CCVETSKTAddress of task table.
564CCVEMKVNMaster key version numbers.

Byte 1: Current master key version number.

Bytes 2 and 3: Reserved.

Byte 4: Cryptographic domain index.

6054CCVEWLDSDataset name of WaitList dataset.
1141CCVEIBMRIBM reserved byte.
1151CCVEHFL2Hardware flags
Bit
Meaning When Set On
0
CCA level 3.41 detected
1
CCA level 4.00 detected
2
Reserved
3
AP-special-command facility available
4
AP 4096-bit ME facility available
5
AP 4096-bit CRT facility available
1164CCVE_EXTRAFALGSStatus word.
Bit
Meaning When Set On
0
The default wrapping for internal tokens is enhanced.
1
The default wrapping for external tokens is enhanced.
1204CCVE_NOPKA_MSGIDWTO message ID saved when PKA callable services are not available at startup
12412CCVEDCTLARRDCTL address array.
1364CCVESERBCPIDSERB cell pool ID
1404CCVEFIXSAddress of the fixed area storage used as dynamic storage for the RISGNL routines.
1444CCVEFIXLLength of the fixed area storage.
1484CCVECPUFCPUF routine — used to manipulate the control register.
1524CCVERFMKRFOMK routine — used to RFOMK keys on specific CPs.
1564CCVERMKVMKV RISGNL routine — used by MKV to validate a CP.
1604CCVESTHWSTHW routine — used to obtain the current status of the hardware.
1644CCVEKEYMKEYM routine — used to manipulate keys from the key entry hardware.
1684CCVEDKEFDKEF routine — used to manipulate keys for clear key entry.
17216CCVE_PKA_KMMK_HPKMMK hash pattern
18816CCVE_PKA_SMK_HPSMK hash pattern
2044CCVELFDDECB for look for disabled Cryptographic Coprocessor Feature task termination (LFD Done).
2084CCVELFDTPointer to TCB for CSFMLFDT.
2124CCVEENFSECB for Issue ENF SIGNAL.
2164CVESMCAAddress of SMCA
2204CCVE_SUBPOOLSubpool for storage
2244CCVE_SRRW_EXITSingle read/write exit addr
2284CCVEMKVBPointer to the current Master Key Verification Pattern (MKVP) block. See DES Master Key Verification Pattern Block (MKVB) for a description of the MKVP block.
23232CCVEMKB1First MKVP block.
26432CCVEMKB2Second MKVP block.
29632CCVEMKB3Third MKVP block.
3284CCVEINPPPointer to installation optional parameter.
3324CCVEINPLLength of the installation optional parameter.
3364CCVETRCNNumber of trace entries.
3404CCVEIOPB_PKDSAddress of PKDS IO subtask data.
3444CCVEIOST_TKDSAddress of TKDS IO subtask TCB.
3484CCVEIOPB_TKDSAddress of TKDS IO subtask data.
3524CCVEIOPBAddress of IO subtask data.
3564CCVECCPDPointer to CAJP Data.
3604CCVECCPVPointer to private CAJP Data .
3644CCVEWKARWork area for services.
3684CCVEMUSTAddress of UDX service table.
3728CCVESECCReserved for security exit.
3804CCVEENTKENTE for security keys exit.
3844CCVEENTSENTE for security service exit.
3884CCVEMIQIHAddress of interrupt handler
3924CCVE_TKE_KEY_CACHE@Address of TKE key cache
3964CCVEDSCBControl block for the data manager.
40012CCVE_CKDS_HASH_TABLESCKDS hash tables.
41212CCVE_PKDS_HASH_TABLESPKDS hash tables.
4244
CCVE_KEY_
STORE_POLICY

Bit
Meaning When Set On
0
CKDS key store policy enabled
1
CKDS control in fail mode
2
CKDS control in warn mode
3
CKDS default control enabled
4
No duplicates in CKDS
8
PKDS key store policy enabled
9
PKDS control in fail mode
10
PKDS control in warn mode
11
PKDS default control enabled
12
No duplicates in PKDS
16
Granular keylabel access controls enabled in fail mode
17
Granular keylabel access controls enabled in warn mode
18
Enhanced export restrictions enabled for AES keys
19
Enhanced export restrictions enabled for DES keys
24
PKA key extensions enabled.
25
PKCS #11 Token used for trusted certificate repository (SAF keyring when this bit is 0).
26
PKA key extensions in WARNONLY mode.
4284CCVE_PLEX_SYSIDSystem sysplex token
4324CCVEINQKP_ECBINQKP ECB for waking up
4364CCVE_KSP_PKAKE_DATA_PTRAddress of PKAKE data
4401CCVE_FIPSFIPS policy flags.
Bit
Meaning When Set On
1
FIPS startup known answer tests failed disabling PKCS#11.
2
FIPSMODE(xxx,FAIL(YES)) specified
3
Known answer test executed on accelerator for private key operation
4
Known answer test executed on accelerator for public key operation
4413Reserved.
4448CCVE_ECC_MKVPECC MK verification pattern

This field will contain zeros unless the ECC MK is valid.

45216CCVE_KMF_QUERYResults of CPACF KMF-Query
46816CCVE_KMCTR_QUERYResults of CPACF KMCTR-Query
48416CCVE_KMO_QUERYResults of CPACF KMO-Query
4928CCVE_AES_MKVPAES MK verification pattern.
5008CCVE_DES_MKVPDES MK verification pattern
50832CCVE_KDS_MKVPSMKVPs from key data sets
5404Ccve_MaxSysMaximum number of systems possible in sysplex
5444CCVEMWT_EBCECB to attach CSFPLMWT
5484reserved
5524CCVE_ABTERM_EBCECB to terminate ICSF
5564CCVE_HCHK_PTRPointer to Health Check blocks
56028reserved

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014