CICS® Transaction Gateway Programming Reference v1.1.0.0

com.ibm.ctg.util
Class RACFUserid

java.lang.Object
  extended by 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
 java.lang.String getRACFUserid()
          Returns the RACF user ID 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
equals, 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

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 user ID which maps to the supplied X.509 certificate.

Returns:
String RACF user ID.
Throws:
java.io.IOException - If RACF passes a -1 (failure) return code

©Copyright IBM Corp. 1994, 2014
Legal