CICS® Transaction Gateway Programming Reference V3.1

com.ibm.ctg.util
Class RACFUserid

java.lang.Object
  |
  +--com.ibm.ctg.util.RACFUserid

public class RACFUserid
extends java.lang.Object

This class is a CICS Transaction Gateway for OS/390 utility. This class will attempt to map an X.509 certificate (client) to a RACF userid. The certificate must already be associated with a valid RACF userid using the RACDCERT ADD(dataset-name) TRUST command on OS/390. Note: com.ibm.util.Base64 utility is provided to perform Base64 -> BER conversions


Constructor Summary
RACFUserid()
          Constructs a default RACFUserid object.
RACFUserid(byte[] baCertData)
          Constructs a RACFUserid object and sets its internal data members with an X.509 certificate.
 
Method Summary
(package private) static void ()
           
 java.lang.String getRACFUserid()
          Returns the RACF userid which maps to the supplied X.509 certificate
 void setCertificate(byte[] baCertData)
          Sets the X.509 certificate data.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

RACFUserid

public RACFUserid()
Constructs a default RACFUserid object. This object has no settings. You should use the setCertificate method to set this objects internal data members.

RACFUserid

public RACFUserid(byte[] baCertData)
Constructs a RACFUserid object and sets its internal data members with an X.509 certificate. Calls the relevant setCertificate() method, and so has the same result as constructing a default RACFUserid and then setting its properties prior to getRACFUserid().
Parameters:
baCertData - Byte array containing a BER encoded X.509 certificate
Method Detail

static void ()

setCertificate

public void setCertificate(byte[] baCertData)
Sets the X.509 certificate data. This must an ASN.1/BER encoded certificate representation.
Parameters:
baCertData - byte array containing a BER encoded X.509 certificate

getRACFUserid

public java.lang.String getRACFUserid()
                               throws java.io.IOException
Returns the RACF userid which maps to the supplied X.509 certificate
Returns:
String RACF userid
Throws:
java.io.IOException - If RACF passes a -1 (failure) return code

© Copyright IBM Corp. 1994, 1999