ibm-information-center/dist/eclipse/plugins/i5OS.ic.apiref_5.4.0.1/conInternalID.htm

57 lines
3.6 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="Internal identifiers" />
<meta name="abstract" content="You know of jobs, spooled files, and so forth, by their names. The system uses an ID that is associated with the name. The ID is assigned based on usage." />
<meta name="description" content="You know of jobs, spooled files, and so forth, by their names. The system uses an ID that is associated with the name. The ID is assigned based on usage." />
<meta name="DC.Relation" scheme="URI" content="concept.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="conInternalID" />
<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>Internal identifiers</title>
</head>
<body id="conInternalID"><a name="conInternalID"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">Internal identifiers</h1>
<div><p>You know of jobs, spooled files, and so forth, by their names.
The system uses an ID that is associated with the name. The ID is assigned
based on usage.</p>
<p>Several of the APIs either require or allow you to use an internal ID.
When you use an internal ID, it is generally faster because the system does
not have to convert the external name to the internal ID.</p>
<p>A variety of terminology is used to identify internal IDs. For example:</p>
<ul><li>Work Management uses an <em>internal job identifier</em>.</li>
<li>Spooling uses an <em>internal spooled file identifier</em>.</li>
<li>Security uses the term <em>handle</em> to mean the user profile that is
currently running the job.</li>
<li>Message handling uses the term <em>message key</em> (also appears on CL
commands) to identify a message in a message queue.</li>
</ul>
<p>The internal values are often accessed in one API and then used in another.
For example, if you want a list of jobs, you would use the List Jobs (QUSLJOB)
API, which provides the internal job ID for each job in the list. You could
then use the internal job ID to access a spooled file for a job with the Retrieve
Spooled File Attributes (QUSRSPLA) API.</p>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="concept.htm" title="Describes the underlying concepts that you need to understand to work effectively with APIs. Among the concepts covered are basic concepts, programming considerations, and terminology.">API concepts</a></div>
</div>
</div>
</body>
</html>