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 (CCVT)

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

The CCVT is the ICSF base control block and contains addresses of common areas for use by ICSF components. Indicators in the CCVT also provide ICSF status information. The CCVT is getmained in subpool 245 under the line. The ICSF CCVT is anchored off of SCVTCCVT in the SCVT macro.

Programming Interface information

CCVT

ONLY these fields are part of the programming interface:

  • CCVTDACC
  • CCVTCCVE
  • CCVTHFLG
  • CCVTSFLG
  • CCVTPRPC
  • CCVTINST
  • CCVTINS2
  • CCVTLNTH
  • CCVTFMID
  • CCVT_USERPARM
End of Programming Interface information

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

Table 88. Cryptographic Communication Vector Table
Offset (Dec)Number of BytesField NameDescription
04CCVTID

EBCDIC Cryptographic Communication Vector Table ID. This field must contain the character string CCVT.

42CCVTVERVersion.

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

62CCVTLENThe length of the CCVT.
86CCVTAUXAuxilliary flags.
Bit
Meaning When Set On
0
ICSF is terminating.
1
ICSF is abnormally terminating.
2
ICSF initialization is performing master key validation.
3
Coprocessor request interrupts enabled.
142CCVTRLVLICSF level.
164CCVTCCVECryptographic Communication Vector Table Extension (CCVE) address.

The address of a private area extension of the CCVT. You should place any fields not needed by other address spaces in the CCVE.

204CCVT_CKT_BTMBAddress of anchor for CKT.
244CCVTPC2PC number for entry into module CSFASSPC.
284CCVTPRPCEntry point for the pre-PC processing module, CSFARPC.
324CCVTINSTFor installation use.
361CCVTSFG1Status byte.
Bit
Meaning When Set On
0
ICSF services are active.
1
At least one Integrated Cryptographic Feature has a valid master key.
2
ICSF initialization complete.
3
ICSF is active and PCF is not active.
4
Compatibility is permitted. COMPAT(YES) or COMPAT(COEXIST) is specified.
5
At least one Integrated Cryptographic Feature is valid.
7
Always set to 1.
371CCVTFLAGFlag byte.
Bit
Meaning When Set On
3
Cryptographic coprocessor hardware instructions available.
4
At least one cryptographic coprocessor is active.
5
Coprocessor request interrupt support active.
6
At least one cryptographic coprocessor is online
7
At least one coprocessor or accelerator is present.
381CCVTOFLGOperational flag byte.
Bit
Meaning When Set On
0
Configuration is under PR/SM.
2
CKDS key record create, key record delete, and key record write disallowed.
3
CKDS I/O subtask is available.
4
CCVT_DEF_ALG bit. If on, CDMF is the system default algorithm; if off, DES is the default.
5
CCVT_CDMF_ENA bit. If on, hardware is capable of performing CDMF.
6
PKA master keys are valid.
7
Use ICSF reason codes.
391CCVTSVCMSVC number for key management. This is the PCF compatibility SVC.
401 Reserved
411CCVTSVCSSVC number for DES interface SVC. This is the PCF compatibility SVC.
422CCVTASIDASID of ICSF address space.
444CcvtPcGrsEntry point to CSFMIDGR.
484CCVTPC3Entry point to CSFASSPA used by compatibility SVCs.
524CCVTSRUTAddress of the access method module.
568CCVTINS2An 8-byte area for installation use.
644CCVTMDSData space server PC. PC number for entry to data space server that adds and deletes the in-storage CKDS.
684CCVTLNTHMaximum installation data length.
724CCVTASCBICSF ASCB address.
764Reserved
801CCVTHFLGFlag bytes.
Bit
Meaning When Set On
0
Crypto assist instructions available.
1
Additional secure Crypto device available.
2
Support for 64-bit callers.
3
ICSF Cross-System Services environment is active for CKDS
4
ICSF Cross-System Services environment is active for TKDS
5
RSA 4096-bit function enabled and the RNGL service is available
6
Secure key AES is available
7
AES master key is active
811CCVTSFLGFlag bytes.
Bit
Meaning When Set On
0
ICSF during initialization.
1
ICSF was able to complete cleanup, so no EOM cleanup is needed.
2
PKCS #11 operating in FIPS standard mode.
3
PKCS #11 operating in FIPS compatibility mode.
821CCVT1FLGFlag byte.
Bit
Meaning When Set On
0
ECC master key is active / ECC Secure Key Functions available
1
ECC clear key functions are supported
2
AES KEKs, TR-31, and ECC Diffie-Hellman are supported.
3
Dynamic RSA master key change enabled.
831Reserved
844CCVTENFECB for ENF listen.
884CCVTTCBICSF maintask TCB address.
924CCVTTRCECB for component trace.
964Reserved
1004CCVT_ABTERM_ECBAbnormal termination ECB.
1048CCVT_CKDS_FIXEDOffsets and lengths for fixed length CKDS.
1128CCVT_CKDS_VAROffsets and lengths for variable length CKDS.
1204CCVTLFDEECB to start the “look for disabled crypto” task.
1244CCVTIOSEECB to post to use I/O subtask.
1284CCVTPCTRPPC for CSFKSTRP entry.
1324CCVT_ACT_DURING_TERMActivity count during term.
1368CCVTFMIDICSF FMID.
1448CCVT_USERPARMICSF user parameter.
1521CCVTPKAFPKA register clear key entry processing flags.
Bit
Meaning When Set On
0
KMMK is valid for CP0.
1
SMK is valid for CP0.
2
KMMK has been reset for CP0.
3
SMK has been reset for CP0.
4
KMMK is valid for CP1.
5
SMK is valid for CP1.
6
KMMK has been reset for CP1.
7
SMK has been reset for CP1.
1531CCVTPKAR
Bit
Meaning When Set On
0 and 1
SMK status for KSU0.
2 and 3
KMMK status for KSU0.
4 and 5
SMK status for KSU1.
6 and 7
KMMK status for KSU1.
1541CCVTPKAXPKA register status (reserved).
1551CCVTPKAZPKA register status (reserved).
15616CCVTCCCCryptographic configuration control (CCC).
1724CCVTSPKBAddress of public key build.
1764CCVTSPKXAddress of public key extract.
1804CCVTPIOEECB for PKDS I/O subtask.
1848Reserved
1924CCVTGiveAwayRecovery token for cell pools.
1961CCVTPKDFPKDS processing flags.
Bit
Meaning When Set On
0
PKDS available.
2
At least one PCICA is active.
3
ICSF Cross-System Services environment is active for PKDS.
1971CCVTCICSCICS processing flags.
Bit
Meaning When Set On
0
CSFVCCPP installed.
1
CSFACKWL installed.
1981CCVTYAFF
Bit
Meaning When Set On
0
ZKA compliance environment.
1991CSFTTKDFTKDS processing flags
Bit
Meaning When Set On
0
TKDS available
2004CCVTPRPDAddress of CSFVCCPP.
2044CCVTCKWLAddress of CSFVCCKW.
20812CcvtSdtTcbAddress of CSFMISDT TCBs.
2204CCVTENFPECB for PCI Cryptographic Coprocessor online event.
2246CcvtSdtAsidAsids owning SYSZxKT
23010Reserved.
2404CCVTPC6PC6 (CSFMWCFS entry).
24416CCVT_KXMDHardware feature status.
Bit
Meaning When Set On
1
SHA-1 enabled.
2
SHA-256 enabled.
Bytes 2–16 are reserved.
2604Reserved
2644Reserved
2684CCVTCSVGAddress of CSFSCVG.
2724Reserved
2764CCVTDACCICSF DAC instructions control block for RMF.
28016CCVT_KMC_EXPORTHardware feature status.
Bit
Meaning When Set On
1
KMC DES enabled.
3
KMC TDES enabled.
9
KMC encrypted DES enabled.
11
KMC encrypted TDES enabled.
18
KMC AES 128 key enabled.
19
KMC AES 192 key enabled.
20
KMC AES 256 key enabled.
26
KMC encrypted AES-128 enabled
27
KMC encrypted AES-192 enabled.
28
KMC encrypted AES-256 enabled
Change bytes 5-16 are reserved.
2964CCVTPC7PC7 (CSFMGARM entry)
3004CCVTPC8PC8 (CSFMGTRM entry)
3048CCVTGARTToken of CSFMGARC resource manager
3128CCVTGTRTToken of CSFMGTRC resource manager
3204CCVTGARCAddress of CSFMGARC resource manager
3244CCVTGTRCAddress of CSFMGTRC resource manager
3284CCVT_IDENTITYIdentifier
3324Reserved
3368CCVT_PSMID Last used PSMID
3444CCVTEPRPAddress of CSFVCPC6
3484CCVTPKB6Address of CSFSPKB6
3524CCVTVRETAddress of CSFVRET
3564CCVTWRETAddress of CSFWRET
3604CCVTSRETAddress of CCVTSRET
3644CCVTGSRETAddress of CCVTGSRET
3684CCVTCVG6Address of CCVTCVG6
3724Ccvt_CKDS_PREPMSG_ORIGINSYSid of XCF message originator for prepare message for CKDS
3764Ccvt_PKDS_PREPMSG_ORIGINSYSid of XCF message originator for prepare message for PKDS
3804Ccvt_TKDS_PREPMSG_ORIGINSYSid of XCF message originator for prepare message for TKDS
3844CCVTTIOEECB for TKDS I/O subtask
3884CCVT_CKDS_VALUES_ACTIVEAddress of CCVT_CKDS_VALUES structures for the active CKDS
39232Reserved
4248CCVTTDSDefinition space information (TKDS)
43220Reserved
4522CCVT_PKDS_MAXLRECLMaximum logical record length for PKDS records
4542Reserved
4568CCVT_PKDS_DSCurrent PKDS data space
46416Reserved
4804CCVTPUPD_ECBECB to post for PKDS update
48444CCVT_PKDSNPKDS data set name
5284CCVTNAMESAddress of CSFNAMES
5324CCVTSNAMESAddress of CCVTSNAMES
5364CCVTGNAMESAddress of CCVTGNAMES
5404Ccvt_MTLenSize of module table.
5444Ccvt_MTSPModule table subpool Id
54848Ccvt_MtModule Table
5964CCVTRNAMESAddress of CSFRNAMES
6008Reserved
60832Ccvt_ModuleAddrsModule address.
6408Reserved
6484CCVTCSSAddress of CKDS Cross-System Services block.
6524CCVTCSSTAddress of TKDS Cross-System Services block.
6564CCVTCSSPAddress of PKDS Cross-System Services block .
66032CCVT_KeepArea preserved across a restart of ICSF.
6928CCVTGIRTToken of CSFMGIRT resource manager.
7004CCVTSMF82_14Ctrcounter to control writing of SMF records.
70444CCVT_CKDSNCKDS data set name currently in use .
74844CCVT_TKDSNTKDS data set name currently in use.
79224Reserved
8160

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014