RACF (IBMJCECCA Class Documentation)

java.lang.Object
- com.ibm.crypto.hdwrCCA.provider.RACF

```
public class RACF
extends java.lang.Object
```
This class represents a RACF object which contains the contents of a keyring. This class is an interface to the JNI code for performing the key ring reading and storing the records.

Field Summary

Fields
Modifier and Type	Field and Description
`boolean`	`debug`
`static boolean`	`IsAvailable`
`static int`	`RACF_CERTAUTH`
`static int`	`RACF_DH_KEY`
`static int`	`RACF_DSA_KEY`
`static int`	`RACF_ICSF_KEY`
`static int`	`RACF_PCICC_KEY`
`static int`	`RACF_PERSONAL`
`static int`	`RACF_PKDS_ECC_KEY`
`static int`	`RACF_SOFTWARE_ECC_KEY`
`static int`	`RACF_SOFTWARE_KEY`
`static int`	`RACF_TKDS_DSA_KEY`
`static int`	`RACF_TKDS_ECC_KEY`
`static int`	`RACF_TKDS_RSA_KEY`

Constructor Summary

Constructors
Constructor and Description

RACF()

Constructors
Constructor and Description
`RACF()`

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`java.util.Hashtable`	`getRACFHashtable()` Return the hash table which contains the key ring records.
`int`	`getRecords(java.lang.String userid, java.lang.String alias, java.lang.String ringid)` Get the records from the key ring.
`boolean`	`isTrusted(java.lang.String userid, java.lang.String ringid, byte[] cert)` Check if the certificate is trusted.
`int`	`putRecords(RACFResults results, byte[] useridbytes, byte[] ringidbytes, int numDeleteRecords, int numPutRecords, byte[] recordsbytes)` Put the records into the key ring.
`void`	`setDebug(boolean dbg)` Turn tracing on or off for the native methods.
`void`	`TestLibrary()` Test if the DLL for reading the keyring is available.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - RACF_SOFTWARE_KEY
```
public static final int RACF_SOFTWARE_KEY
```
    See Also:
    
    Constant Field Values
  - RACF_ICSF_KEY
```
public static final int RACF_ICSF_KEY
```
    See Also:
    
    Constant Field Values
  - RACF_PCICC_KEY
```
public static final int RACF_PCICC_KEY
```
    See Also:
    
    Constant Field Values
  - RACF_DSA_KEY
```
public static final int RACF_DSA_KEY
```
    See Also:
    
    Constant Field Values
  - RACF_DH_KEY
```
public static final int RACF_DH_KEY
```
    See Also:
    
    Constant Field Values
  - RACF_SOFTWARE_ECC_KEY
```
public static final int RACF_SOFTWARE_ECC_KEY
```
    See Also:
    
    Constant Field Values
  - RACF_PKDS_ECC_KEY
```
public static final int RACF_PKDS_ECC_KEY
```
    See Also:
    
    Constant Field Values
  - RACF_TKDS_RSA_KEY
```
public static final int RACF_TKDS_RSA_KEY
```
    See Also:
    
    Constant Field Values
  - RACF_TKDS_ECC_KEY
```
public static final int RACF_TKDS_ECC_KEY
```
    See Also:
    
    Constant Field Values
  - RACF_TKDS_DSA_KEY
```
public static final int RACF_TKDS_DSA_KEY
```
    See Also:
    
    Constant Field Values
  - RACF_CERTAUTH
```
public static final int RACF_CERTAUTH
```
    See Also:
    
    Constant Field Values
  - RACF_PERSONAL
```
public static final int RACF_PERSONAL
```
    See Also:
    
    Constant Field Values
  - IsAvailable
```
public static boolean IsAvailable
```
  - debug
```
public boolean debug
```
- Constructor Detail
  - RACF
```
public RACF()
```
- Method Detail
  - TestLibrary
```
public void TestLibrary()
```
    Test if the DLL for reading the keyring is available.
  - getRecords
```
public int getRecords(java.lang.String userid,
                      java.lang.String alias,
                      java.lang.String ringid)
```
    Get the records from the key ring.
    
    Parameters:
    
    userid - the userid of the key ring owner
    
    alias - the name of the certificate to be retrieved
    
    ringid - the key ring to read
  - putRecords
```
public int putRecords(RACFResults results,
                      byte[] useridbytes,
                      byte[] ringidbytes,
                      int numDeleteRecords,
                      int numPutRecords,
                      byte[] recordsbytes)
```
    Put the records into the key ring.
    
    Parameters:
    
    results - the results are written back to this object
    
    useridbytes - the userid of the key ring owner
    
    ringidbytes - the key ring to write
    
    numDeleteRecords - number of delete records
    
    numPutRecords - number of put records
    
    recordsbytes - containing certificates and keys to write to RACF
  - isTrusted
```
public boolean isTrusted(java.lang.String userid,
                         java.lang.String ringid,
                         byte[] cert)
```
    Check if the certificate is trusted.
    
    Parameters:
    
    userid - the userid of the key ring owner
    
    ringid - the key ring which contains the certificate
    
    cert - the certificate to be checked for trust status
  - getRACFHashtable
```
public java.util.Hashtable getRACFHashtable()
```
    Return the hash table which contains the key ring records.
    
    Returns:
    
    the key ring entries
  - setDebug
```
public void setDebug(boolean dbg)
```
    Turn tracing on or off for the native methods.
    
    Parameters:
    
    dbg - true to turn tracing on and false to turn it off

Methods inherited from class java.lang.Object

RACF_SOFTWARE_KEY

RACF_ICSF_KEY

RACF_PCICC_KEY

RACF_DSA_KEY

RACF_DH_KEY

RACF_SOFTWARE_ECC_KEY

RACF_PKDS_ECC_KEY

RACF_TKDS_RSA_KEY

RACF_TKDS_ECC_KEY

RACF_TKDS_DSA_KEY

RACF_CERTAUTH

RACF_PERSONAL

IsAvailable

debug

RACF

TestLibrary

getRecords

putRecords

isTrusted

getRACFHashtable

setDebug