ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzajc_5.4.0.1/rzajcsetclock.htm

82 lines
6.2 KiB
HTML

<?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>