<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html lang="en-us" xml:lang="en-us"> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <meta name="security" content="public" /> <meta name="Robots" content="index,follow" /> <meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' /> <meta name="DC.Type" content="concept" /> <meta name="DC.Title" content="Set the environment ID and clock" /> <meta name="abstract" content="Your Cryptographic Coprocessor uses the EID to verify which Coprocessor created a key token. It uses the clock for time and date stamping and to control whether a profile can log on." /> <meta name="description" content="Your Cryptographic Coprocessor uses the EID to verify which Coprocessor created a key token. It uses the clock for time and date stamping and to control whether a profile can log on." /> <meta name="copyright" content="(C) Copyright IBM Corporation 2006" /> <meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 2006" /> <meta name="DC.Format" content="XHTML" /> <meta name="DC.Identifier" content="setclock" /> <meta name="DC.Language" content="en-us" /> <!-- All rights reserved. Licensed Materials Property of IBM --> <!-- US Government Users Restricted Rights --> <!-- Use, duplication or disclosure restricted by --> <!-- GSA ADP Schedule Contract with IBM Corp. --> <link rel="stylesheet" type="text/css" href="./ibmdita.css" /> <link rel="stylesheet" type="text/css" href="./ic.css" /> <title>Set the environment ID and clock</title> </head> <body id="setclock"><a name="setclock"><!-- --></a> <!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script> <h1 class="topictitle1">Set the environment ID and clock</h1> <div><p>Your Cryptographic Coprocessor uses the EID to verify which Coprocessor created a key token. It uses the clock for time and date stamping and to control whether a profile can log on.</p> <div class="note"><span class="notetitle">Note:</span> Read the <a href="codedisclaimer.htm#codedisclaimer">Code license and disclaimer information</a> for important legal information.</div> </div> <div class="nested1" xml:lang="en-us" id="theenvironmentid"><a name="theenvironmentid"><!-- --></a><h2 class="topictitle2">The Environment ID (EID)</h2> <div><p>Your Coprocessor stores the EID as an identifier. The easiest and fastest way to set the EID is to use the Cryptographic Coprocessor configuration web-based utility found off of the System Tasks page at http://<var class="varname">server-name</var>:2001. The utility includes the Basic configuration wizard that is used when the Coprocessor is in an un-initialized state. If the Coprocessor already has been initialized, then click on <span class="uicontrol">Manage configuration</span> and then click on <span class="uicontrol">Attributes</span> to set the EID.</p> <p>If you would prefer to write your own application to set the EID, you can do so by using the Cryptographic_Facility_Control (CSUACFC) API verb. Two example programs are provided for your consideration. One of them is written in ILE C, while the other is written in ILE RPG. Both perform the same function. </p> <p>Your Cryptographic Coprocessor copies the EID into every PKA key token that your Coprocessor creates. The EID helps the Coprocessor identify keys that it created as opposed to keys that another Coprocessor created.</p> </div> <div><div class="relref"><strong>Related reference</strong><br /> <div><a href="rzajcseteidc.htm" title="Change this program example to suit your needs for setting the environment ID on your Coprocessor.">Example: ILE C program for setting the environment ID on your Coprocessor</a></div> <div><a href="rzajcseteidrpg.htm" title="Change this program example to suit your needs for setting the environment ID on your Coprocessor.">Example: ILE RPG program for setting the environment ID on your Coprocessor</a></div> </div> </div></div> <div class="nested1" xml:lang="en-us" id="theclock"><a name="theclock"><!-- --></a><h2 class="topictitle2">The clock</h2> <div><p>The Coprocessor uses its clock-calendar to record time and date and to determine whether a profile can log on. The default time is Greenwich Mean Time (GMT). Because of its function, you should set the clock inside your Coprocessor before removing the default role's capability of setting it. </p> <p>The easiest and fastest way to set the clock is to use the Cryptographic Coprocessor configuration web-based utility found off of the System Tasks page at http://<var class="varname">server-name</var>:2001. The utility includes the Basic configuration wizard that is used when the Coprocessor is in an un-initialized state. If the Coprocessor already has been initialized, then use click on <span class="uicontrol">Manage configuration</span> and then click on <span class="uicontrol">Attributes</span> to set the clock.</p> <p>If you would prefer to write your own application to set the clock, you can do so by using the Cryptographic_Facility_Control (CSUACFC) API verb.</p> </div> <div><div class="relref"><strong>Related reference</strong><br /> <div><a href="rzajcsetclockc.htm" title="Change this program example to suit your needs for setting the clock on your Coprocessor.">Example: ILE C program for setting the clock on your Coprocessor</a></div> <div><a href="rzajcsetclockrpg.htm" title="Change this program example to suit your needs for setting the clock on your Coprocessor.">Example: ILE RPG program for setting the clock on your Coprocessor</a></div> <div><a href="rzajcsetclockc.htm" title="Change this program example to suit your needs for setting the clock on your Coprocessor.">Example: ILE C program for setting the clock on your Coprocessor</a></div> <div><a href="rzajcsetclockrpg.htm" title="Change this program example to suit your needs for setting the clock on your Coprocessor.">Example: ILE RPG program for setting the clock on your Coprocessor</a></div> </div> </div></div> </body> </html>