79 lines
4.9 KiB
HTML
79 lines
4.9 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="Threadsafe classification" />
|
|
<meta name="abstract" content="The threadsafe classification indicates whether a command is threadsafe. Each command has a threadsafe classification." />
|
|
<meta name="description" content="The threadsafe classification indicates whether a command is threadsafe. Each command has a threadsafe classification." />
|
|
<meta name="DC.Relation" scheme="URI" content="rbam6comdesform.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="rbam6environ.htm" />
|
|
<meta name="copyright" content="(C) Copyright IBM Corporation 1998, 2006" />
|
|
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 1998, 2006" />
|
|
<meta name="DC.Format" content="XHTML" />
|
|
<meta name="DC.Identifier" content="rbam6runthread" />
|
|
<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>Threadsafe classification</title>
|
|
</head>
|
|
<body id="rbam6runthread"><a name="rbam6runthread"><!-- --></a>
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
|
<h1 class="topictitle1">Threadsafe classification</h1>
|
|
<div><p>The threadsafe classification indicates whether a command is threadsafe.
|
|
Each command has a threadsafe classification. </p>
|
|
<p>The three types of threadsafe classifications are as follows:</p>
|
|
<ul><li>Threadsafe: Yes <p>This classification indicates that you can safely call
|
|
the command simultaneously in multiple threads without restrictions. This
|
|
classification also indicates that all functions called by this command are
|
|
threadsafe.</p>
|
|
</li>
|
|
<li>Threadsafe: Conditional <p>This classification indicates that not all
|
|
functions provided by the command are threadsafe. The Restrictions section
|
|
of the command provides information relating to thread safety limitations.
|
|
Many commands are classified conditionally threadsafe because either some
|
|
underlying system support is not threadsafe or the command can cause an exit
|
|
point to be called. </p>
|
|
</li>
|
|
<li>Threadsafe: No <p>This classification indicates that the command is not
|
|
threadsafe and should not be used in a multithreaded program. While some thread
|
|
unsafe commands may deny access, most thread unsafe commands do not. A diagnostic
|
|
message, CPD000D, may be sent to the job log to indicate that a non-threadsafe
|
|
command has been called. Whether or not the diagnostic message CPD000D is
|
|
sent to the job log depends on the "multithreaded job action" attribute of
|
|
the command; that attribute can be determined by using the <span class="cmdname">Display
|
|
Command (DSPCMD)</span> command. The possible values and actions are:</p>
|
|
<ul><li>*SYSVAL - Action is based on system value QMLTTHDACN</li>
|
|
<li>*RUN - Command runs. No messages are sent.</li>
|
|
<li>*MSG - Diagnostic message CPD000D is sent to the job log. The command
|
|
runs.</li>
|
|
<li>*NORUN - Diagnostic message CPD000D is sent to the job log, and escape
|
|
message CPF0001 is sent. The command does not run.</li>
|
|
</ul>
|
|
<p>If the command is run, the results are unpredictable.</p>
|
|
</li>
|
|
</ul>
|
|
<div class="note"><span class="notetitle">Note:</span> Some command definition objects shipped as part of i5/OS™ are not
|
|
intended to be used as CL commands. For example, the CMD and PARM command
|
|
definition objects are used in command definition source. These special-purpose
|
|
command objects will not have any Threadsafe information.</div>
|
|
</div>
|
|
<div>
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="rbam6comdesform.htm" title="Command documentation is provided for i5/OS commands in the form of online help and information in the iSeries Information Center. In the Information Center, each command description follows the same format.">Command documentation format</a></div>
|
|
</div>
|
|
<div class="relconcepts"><strong>Related concepts</strong><br />
|
|
<div><a href="rbam6environ.htm" title="At the very top of the command description documentation are environment classification. The environment information describes where the command is allowed to run.">Environment</a></div>
|
|
</div>
|
|
</div>
|
|
</body>
|
|
</html> |