77 lines
3.0 KiB
HTML
77 lines
3.0 KiB
HTML
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<html>
|
|
<head>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
|
|
<meta name="Copyright" content="Copyright (c) 2006 by IBM Corporation">
|
|
<title>Using User Space APIs</title>
|
|
<!-- 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. -->
|
|
<!-- Change History: -->
|
|
<!-- YYMMDD USERID Change description -->
|
|
<!-- 050729 HGOMEZV d3602.3 Adding general information about using -->
|
|
<!-- optimum alignment spaces. -->
|
|
<!-- 020801 JETAYLOR fix for RID3 PTR 9A13480 -->
|
|
<!-- End Header Records -->
|
|
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
|
|
</head>
|
|
<body>
|
|
<!-- Java sync-link -->
|
|
<script type="text/javascript" language="Javascript" src="../rzahg/synch.js">
|
|
</script>
|
|
|
|
<a name="Top_Of_Page"></a>
|
|
|
|
<h2>Using User Space APIs</h2>
|
|
|
|
<p><strong>User spaces</strong> are objects that consist of a collection of
|
|
bytes used for storing user-defined information. They are permanent objects
|
|
that are located in either the system domain or the user domain. They have an
|
|
object type of *USRSPC and a maximum size of 16MB. You can save and restore
|
|
user spaces to other systems. If, however, the user spaces contain pointers,
|
|
you cannot restore the pointers even if you want to restore them to the same
|
|
system.</p>
|
|
|
|
<p> You can use the user space APIs to:</p>
|
|
|
|
<ul>
|
|
<li>Create user spaces to be used by list APIs to generate lists of data.</li>
|
|
|
|
<li>Store pointers.</li>
|
|
|
|
<li>Store large amounts of data. You can create a user space as large as 16
|
|
megabytes. You cannot create a data area larger than 2000 bytes.</li>
|
|
|
|
<li>Save information in user space objects, and save and restore the object
|
|
with the information in it using CL commands.</li>
|
|
|
|
<li>Pass data from job to job or from system to system.</li>
|
|
</ul>
|
|
|
|
|
|
<p> <strong>Note:</strong> If the allow user domain (QALWUSRDMN) system value
|
|
contains only the QTEMP library, you can use only the user space APIs to create and manipulate
|
|
user domain spaces in library QTEMP. You cannot use the Retrieve Pointer to User
|
|
Space API.
|
|
</p>
|
|
|
|
<p><img src="delta.gif" alt="Start of change">The performance benefits of using optimally aligned spaces may vary over time, so creating a user space with optimum alignment is highly recommended, even if an application does not experience a performance benefit from using an optimally aligned user space on one particular release.<img src="deltaend.gif" alt="End of change">
|
|
</p>
|
|
|
|
|
|
<br>
|
|
|
|
<hr>
|
|
<table align="center" cellpadding="2" cellspacing="2">
|
|
<tr align="center">
|
|
<td valign="middle" align="center">
|
|
<a href="#Top_Of_Page">Top</a> |
|
|
<a href="obj1.htm">Object APIs</a> |
|
|
<a href="aplist.htm">APIs by category</a></td>
|
|
</tr>
|
|
</table>
|
|
</body>
|
|
</html>
|
|
|