1651 lines
51 KiB
HTML
1651 lines
51 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>List Subsystem Entries (QWDLSBSE) API</title>
|
|
<!-- Begin Header Records ========================================= -->
|
|
<!-- 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. -->
|
|
<!-- WM SCRIPT A converted by B2H R4.1 (346) (CMS) by V2KEA304 -->
|
|
<!-- at RCHVMW2 on 17 Feb 1999 at 11:05:09 -->
|
|
<!-- File cleanup completed on 16 July 2001 -->
|
|
<!-- Change History: -->
|
|
<!-- YYMMDD USERID Change description -->
|
|
<!-- File cleanup completed Feb 2002 by v2cdijab -->
|
|
<!-- End Header Records -->
|
|
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
|
|
</head>
|
|
<body>
|
|
<a name="Top_Of_Page"></a>
|
|
<!-- Java sync-link -->
|
|
<script type="text/javascript" language="Javascript" src="../rzahg/synch.js">
|
|
</script>
|
|
|
|
<h2>List Subsystem Entries (QWDLSBSE) API</h2>
|
|
|
|
<div class="box" style="width: 80%;"><br>
|
|
Required Parameter Group:<br>
|
|
<!-- iddvc RMBR -->
|
|
<br>
|
|
<table width="100%">
|
|
<tr>
|
|
<td align="center" valign="top" width="10%">1</td>
|
|
<td align="left" valign="top" width="50%">Qualified user space name</td>
|
|
<td align="left" valign="top" width="20%">Input</td>
|
|
<td align="left" valign="top" width="20%">Char(20)</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">2</td>
|
|
<td align="left" valign="top">List format</td>
|
|
<td align="left" valign="top">Input</td>
|
|
<td align="left" valign="top">Char(8)</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">3</td>
|
|
<td align="left" valign="top">Qualified subsystem name</td>
|
|
<td align="left" valign="top">Input</td>
|
|
<td align="left" valign="top">Char(20)</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">4</td>
|
|
<td align="left" valign="top">Error code</td>
|
|
<td align="left" valign="top">I/O</td>
|
|
<td align="left" valign="top">Char(*)</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
Default Public Authority: *USE<br>
|
|
<!-- iddvc RMBR -->
|
|
<br>
|
|
Threadsafe: No<br>
|
|
<!-- iddvc RMBR -->
|
|
<br>
|
|
</div>
|
|
|
|
<p>The List Subsystem Entries (QWDLSBSE) API lists some of the different
|
|
entries in a subsystem description. See the format information for the types of
|
|
entries available. QWDLSBSE replaces any data that already exists in the user
|
|
space.</p>
|
|
|
|
<p>Other subsystem information is available through the following APIs:</p>
|
|
|
|
<dl>
|
|
<dd><em>QWDRSBSD</em> Retrieve Subsystem Information</dd>
|
|
|
|
<dd><em>QWDLSJBQ</em> List Job Queue Entries</dd>
|
|
</dl>
|
|
|
|
<br>
|
|
|
|
|
|
<h3>Authorities and Locks</h3>
|
|
|
|
<dl>
|
|
<dt><em>User Space Authority</em></dt>
|
|
|
|
<dd>*CHANGE</dd>
|
|
|
|
<dt><em>User Space Library Authority</em></dt>
|
|
|
|
<dd>*EXECUTE</dd>
|
|
|
|
<dt><em>User Space Lock</em></dt>
|
|
|
|
<dd>*EXCLRD</dd>
|
|
|
|
<dt><em>Subsystem Description Authority</em></dt>
|
|
|
|
<dd>*USE</dd>
|
|
|
|
<dt><em>Subsystem Description Library Authority</em></dt>
|
|
|
|
<dd>*EXECUTE</dd>
|
|
</dl>
|
|
|
|
<br>
|
|
|
|
|
|
<h3>Required Parameter Group</h3>
|
|
|
|
<dl>
|
|
<dt><strong>Qualified user space name</strong></dt>
|
|
|
|
<dd>INPUT; CHAR(20)
|
|
|
|
<p>The user space that receives the list, and the library in which it is
|
|
located. The first 10 characters contain the user space name, and the second 10
|
|
characters contain the library name. You can use these special values for the
|
|
library name:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*CURLIB</em></td>
|
|
<td align="left" valign="top">The job's current library</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*LIBL</em></td>
|
|
<td align="left" valign="top">The job's library list</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
</dd>
|
|
|
|
<dt><strong>List format</strong></dt>
|
|
|
|
<dd>INPUT; CHAR(8)
|
|
|
|
<p>The format of subsystem entries to list. You can use one of the following
|
|
format names:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>SBSE0100</em></td>
|
|
<td align="left" valign="top">Routing entry list. For details, see <a href=
|
|
"#HDRSBSE01F">SBSE0100 Format</a>.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>SBSE0200</em></td>
|
|
<td align="left" valign="top">Communications entry list. For details, see <a
|
|
href="#HDRSBSE02F">SBSE0200 Format</a>.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>SBSE0300</em></td>
|
|
<td align="left" valign="top">Remote locations entry list. For details, see <a
|
|
href="#HDRSBSE03F">SBSE0300 Format</a>.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>SBSE0400</em></td>
|
|
<td align="left" valign="top">Autostart job entry list. For details, see <a
|
|
href="#HDRSBSE04F">SBSE0400 Format</a>.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>SBSE0500</em></td>
|
|
<td align="left" valign="top">Prestart job entry list. For details, see <a
|
|
href="#HDRSBSE05F">SBSE0500 Format</a>.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>SBSE0600</em></td>
|
|
<td align="left" valign="top">Workstation name entry list. For details, see <a
|
|
href="#HDRSBSE06F">SBSE0600 Format</a>.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>SBSE0700</em></td>
|
|
<td align="left" valign="top">Workstation type entry list. For details, see <a
|
|
href="#HDRSBSE07F">SBSE0700 Format</a>.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
</dd>
|
|
|
|
<dt><strong>Qualified subsystem name</strong></dt>
|
|
|
|
<dd>INPUT; CHAR(20)
|
|
|
|
<p>The subsystem description about which to retrieve information, and the
|
|
library in which the subsystem description is located. The first 10 characters
|
|
contain the subsystem description name, and the second 10 characters contain
|
|
the library name. You can use these special values for the library name:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*CURLIB</em></td>
|
|
<td align="left" valign="top">The job's current library</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*LIBL</em></td>
|
|
<td align="left" valign="top">The job's library list</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
</dd>
|
|
|
|
<dt><strong>Error code</strong></dt>
|
|
|
|
<dd>I/O; CHAR(*)
|
|
|
|
<p>The structure in which to return error information. For the format of the
|
|
structure, see <a href="../apiref/error.htm#hdrerrcod">Error code parameter</a>.</p>
|
|
</dd>
|
|
</dl>
|
|
|
|
<br>
|
|
|
|
|
|
<h3><a name="Header_108">Format of the Generated List</a></h3>
|
|
|
|
<p>The list of entries that the QWDLSBSE API returns into the user space
|
|
consists of:</p>
|
|
|
|
<ul>
|
|
<li>A user area</li>
|
|
|
|
<li>A generic header</li>
|
|
|
|
<li>An input parameter section</li>
|
|
|
|
<li>A header section</li>
|
|
|
|
<li>A list data section</li>
|
|
</ul>
|
|
|
|
<p>The user area and generic header are described in <a href="../apiref/usf.htm">User
|
|
Space Format for List APIs</a>. The remaining items are described in the
|
|
following sections. For detailed descriptions of the fields in the tables, see
|
|
<a href="#HDRSBSEFD">Field Descriptions</a>.</p>
|
|
|
|
<p>When you retrieve list entry information from a user space, you must use the
|
|
entry size returned in the generic header. The size of each entry may be padded
|
|
at the end. If you do not use the entry size, the result may not be valid. For
|
|
examples of how to process lists, see API <a href="../apiref/apiexmp.htm">
|
|
Examples</a>.</p>
|
|
|
|
<br>
|
|
|
|
|
|
<h3><a name="Header_109">Input Parameter Section</a></h3>
|
|
|
|
<table border width="80%">
|
|
<tr>
|
|
<th align="center" valign="bottom" colspan="2">Offset</th>
|
|
<th align="left" valign="bottom" rowspan="2">Type</th>
|
|
<th align="left" valign="bottom" rowspan="2">Field</th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<th align="center" valign="bottom">Dec</th>
|
|
<th align="center" valign="bottom">Hex</th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top" width="10%">0</td>
|
|
<td align="center" valign="top" width="10%">0</td>
|
|
<td align="left" valign="top" width="20%">CHAR(10)</td>
|
|
<td align="left" valign="top" width="60%">User space name specified</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">10</td>
|
|
<td align="center" valign="top">A</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">User space library name specified</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">20</td>
|
|
<td align="center" valign="top">14</td>
|
|
<td align="left" valign="top">CHAR(8)</td>
|
|
<td align="left" valign="top">Format name specified</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">28</td>
|
|
<td align="center" valign="top">1C</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Subsystem name specified</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">38</td>
|
|
<td align="center" valign="top">26</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Subsystem library name specified</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<br>
|
|
|
|
|
|
<h3><a name="Header_110">Header Section</a></h3>
|
|
|
|
<table border width="80%">
|
|
<tr>
|
|
<th align="center" valign="bottom" colspan="2">Offset</th>
|
|
<th align="left" valign="bottom" rowspan="2">Type</th>
|
|
<th align="left" valign="bottom" rowspan="2">Field</th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<th align="center" valign="bottom">Dec</th>
|
|
<th align="center" valign="bottom">Hex</th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top" width="10%">0</td>
|
|
<td align="center" valign="top" width="10%">0</td>
|
|
<td align="left" valign="top" width="20%">CHAR(10)</td>
|
|
<td align="left" valign="top" width="60%">Subsystem name used</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">10</td>
|
|
<td align="center" valign="top">A</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Subsystem library name used</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<br>
|
|
|
|
|
|
<h3><a name="HDRSBSE01F">SBSE0100 Format</a></h3>
|
|
|
|
<table border width="80%">
|
|
<tr>
|
|
<th align="center" valign="bottom" colspan="2">Offset</th>
|
|
<th align="left" valign="bottom" rowspan="2">Type</th>
|
|
<th align="left" valign="bottom" rowspan="2">Field</th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<th align="center" valign="bottom">Dec</th>
|
|
<th align="center" valign="bottom">Hex</th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top" width="10%">0</td>
|
|
<td align="center" valign="top" width="10%">0</td>
|
|
<td align="left" valign="top" width="20%">BINARY(4)</td>
|
|
<td align="left" valign="top" width="60%">Routing entry sequence number</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">4</td>
|
|
<td align="center" valign="top">4</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Routing entry program name</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">14</td>
|
|
<td align="center" valign="top">E</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Routing entry program library name</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">24</td>
|
|
<td align="center" valign="top">18</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Routing entry class name</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">34</td>
|
|
<td align="center" valign="top">22</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Routing entry class library name</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">44</td>
|
|
<td align="center" valign="top">2C</td>
|
|
<td align="left" valign="top">BINARY(4)</td>
|
|
<td align="left" valign="top">Maximum active routing steps</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">48</td>
|
|
<td align="center" valign="top">30</td>
|
|
<td align="left" valign="top">BINARY(4)</td>
|
|
<td align="left" valign="top">Routing entry pool identifier</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">52</td>
|
|
<td align="center" valign="top">34</td>
|
|
<td align="left" valign="top">BINARY(4)</td>
|
|
<td align="left" valign="top">Compare start position</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">56</td>
|
|
<td align="center" valign="top">38</td>
|
|
<td align="left" valign="top">CHAR(80)</td>
|
|
<td align="left" valign="top">Compare value</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">136</td>
|
|
<td align="center" valign="top">88</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Routing entry thread resources affinity group</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">146</td>
|
|
<td align="center" valign="top">92</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Routing entry thread resources affinity level</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">156</td>
|
|
<td align="center" valign="top">9C</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Routing entry resources affinity group</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<br>
|
|
|
|
|
|
<h3><a name="HDRSBSE02F">SBSE0200 Format</a></h3>
|
|
|
|
<table border width="80%">
|
|
<tr>
|
|
<th align="center" valign="bottom" colspan="2">Offset</th>
|
|
<th align="left" valign="bottom" rowspan="2">Type</th>
|
|
<th align="left" valign="bottom" rowspan="2">Field</th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<th align="center" valign="bottom">Dec</th>
|
|
<th align="center" valign="bottom">Hex</th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top" width="10%">0</td>
|
|
<td align="center" valign="top" width="10%">0</td>
|
|
<td align="left" valign="top" width="20%">CHAR(10)</td>
|
|
<td align="left" valign="top" width="60%">Device</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">10</td>
|
|
<td align="center" valign="top">A</td>
|
|
<td align="left" valign="top">CHAR(8)</td>
|
|
<td align="left" valign="top">Mode</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">18</td>
|
|
<td align="center" valign="top">12</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Communication entry job description name</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">28</td>
|
|
<td align="center" valign="top">1C</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Communication entry job description library
|
|
name</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">38</td>
|
|
<td align="center" valign="top">26</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Default user</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">48</td>
|
|
<td align="center" valign="top">30</td>
|
|
<td align="left" valign="top">BINARY(4)</td>
|
|
<td align="left" valign="top">Maximum active jobs</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<br>
|
|
|
|
|
|
<h3><a name="HDRSBSE03F">SBSE0300 Format</a></h3>
|
|
|
|
<table border width="80%">
|
|
<tr>
|
|
<th align="center" valign="bottom" colspan="2">Offset</th>
|
|
<th align="left" valign="bottom" rowspan="2">Type</th>
|
|
<th align="left" valign="bottom" rowspan="2">Field</th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<th align="center" valign="bottom">Dec</th>
|
|
<th align="center" valign="bottom">Hex</th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top" width="10%">0</td>
|
|
<td align="center" valign="top" width="10%">0</td>
|
|
<td align="left" valign="top" width="20%">CHAR(8)</td>
|
|
<td align="left" valign="top" width="60%">Remote location</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">8</td>
|
|
<td align="center" valign="top">8</td>
|
|
<td align="left" valign="top">CHAR(8)</td>
|
|
<td align="left" valign="top">Mode</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">16</td>
|
|
<td align="center" valign="top">10</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Remote location entry job description name</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">26</td>
|
|
<td align="center" valign="top">1A</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Remote location entry job description library
|
|
name</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">36</td>
|
|
<td align="center" valign="top">24</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Default user</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">38</td>
|
|
<td align="center" valign="top">26</td>
|
|
<td align="left" valign="top">CHAR(2)</td>
|
|
<td align="left" valign="top">Reserved</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">48</td>
|
|
<td align="center" valign="top">30</td>
|
|
<td align="left" valign="top">BINARY(4)</td>
|
|
<td align="left" valign="top">Maximum active jobs</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<br>
|
|
|
|
|
|
<h3><a name="HDRSBSE04F">SBSE0400 Format</a></h3>
|
|
|
|
<table border width="80%">
|
|
<tr>
|
|
<th align="center" valign="bottom" colspan="2">Offset</th>
|
|
<th align="left" valign="bottom" rowspan="2">Type</th>
|
|
<th align="left" valign="bottom" rowspan="2">Field</th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<th align="center" valign="bottom">Dec</th>
|
|
<th align="center" valign="bottom">Hex</th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top" width="10%">0</td>
|
|
<td align="center" valign="top" width="10%">0</td>
|
|
<td align="left" valign="top" width="20%">CHAR(10)</td>
|
|
<td align="left" valign="top" width="60%">Autostart job name</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">10</td>
|
|
<td align="center" valign="top">A</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Autostart job description name</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">20</td>
|
|
<td align="center" valign="top">14</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Autostart job description library name</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<br>
|
|
|
|
|
|
<h3><a name="HDRSBSE05F">SBSE0500 Format</a></h3>
|
|
|
|
<table border width="80%">
|
|
<tr>
|
|
<th align="center" valign="bottom" colspan="2">Offset</th>
|
|
<th align="left" valign="bottom" rowspan="2">Type</th>
|
|
<th align="left" valign="bottom" rowspan="2">Field</th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<th align="center" valign="bottom">Dec</th>
|
|
<th align="center" valign="bottom">Hex</th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top" width="10%">0</td>
|
|
<td align="center" valign="top" width="10%">0</td>
|
|
<td align="left" valign="top" width="20%">CHAR(10)</td>
|
|
<td align="left" valign="top" width="60%">Prestart job program name</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">10</td>
|
|
<td align="center" valign="top">A</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Prestart job program library name</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">20</td>
|
|
<td align="center" valign="top">14</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">User profile name</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">30</td>
|
|
<td align="center" valign="top">1E</td>
|
|
<td align="left" valign="top">CHAR(1)</td>
|
|
<td align="left" valign="top">Start jobs</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">31</td>
|
|
<td align="center" valign="top">1F</td>
|
|
<td align="left" valign="top">CHAR(1)</td>
|
|
<td align="left" valign="top">Wait for job</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">32</td>
|
|
<td align="center" valign="top">20</td>
|
|
<td align="left" valign="top">BINARY(4)</td>
|
|
<td align="left" valign="top">Initial number of jobs</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">36</td>
|
|
<td align="center" valign="top">24</td>
|
|
<td align="left" valign="top">BINARY(4)</td>
|
|
<td align="left" valign="top">Threshold</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">40</td>
|
|
<td align="center" valign="top">28</td>
|
|
<td align="left" valign="top">BINARY(4)</td>
|
|
<td align="left" valign="top">Additional number of jobs</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">44</td>
|
|
<td align="center" valign="top">2C</td>
|
|
<td align="left" valign="top">BINARY(4)</td>
|
|
<td align="left" valign="top">Maximum number of jobs</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">48</td>
|
|
<td align="center" valign="top">30</td>
|
|
<td align="left" valign="top">BINARY(4)</td>
|
|
<td align="left" valign="top">Maximum number of uses</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">52</td>
|
|
<td align="center" valign="top">34</td>
|
|
<td align="left" valign="top">BINARY(4)</td>
|
|
<td align="left" valign="top">Pool identifier</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">56</td>
|
|
<td align="center" valign="top">38</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Prestart job name</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">66</td>
|
|
<td align="center" valign="top">42</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Prestart job description name</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">76</td>
|
|
<td align="center" valign="top">4C</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Prestart job description library name</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">86</td>
|
|
<td align="center" valign="top">56</td>
|
|
<td align="left" valign="top">CHAR(2)</td>
|
|
<td align="left" valign="top">Reserved</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">88</td>
|
|
<td align="center" valign="top">58</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">First class name</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">98</td>
|
|
<td align="center" valign="top">62</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">First class library name</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">108</td>
|
|
<td align="center" valign="top">6C</td>
|
|
<td align="left" valign="top">BINARY(4)</td>
|
|
<td align="left" valign="top">Number of jobs to use first class</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">112</td>
|
|
<td align="center" valign="top">70</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Second class name</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">122</td>
|
|
<td align="center" valign="top">7A</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Second class library name</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">132</td>
|
|
<td align="center" valign="top">84</td>
|
|
<td align="left" valign="top">BINARY(4)</td>
|
|
<td align="left" valign="top">Number of jobs to use second class</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">136</td>
|
|
<td align="center" valign="top">88</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Prestart job thread resources affinity group</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">146</td>
|
|
<td align="center" valign="top">92</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Prestart job thread resources affinity level</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">156</td>
|
|
<td align="center" valign="top">9C</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Prestart job resources affinity group</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<br>
|
|
|
|
|
|
<h3><a name="HDRSBSE06F">SBSE0600 Format</a></h3>
|
|
|
|
<table border width="80%">
|
|
<tr>
|
|
<th align="center" valign="bottom" colspan="2">Offset</th>
|
|
<th align="left" valign="bottom" rowspan="2">Type</th>
|
|
<th align="left" valign="bottom" rowspan="2">Field</th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<th align="center" valign="bottom">Dec</th>
|
|
<th align="center" valign="bottom">Hex</th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top" width="10%">0</td>
|
|
<td align="center" valign="top" width="10%">0</td>
|
|
<td align="left" valign="top" width="20%">CHAR(10)</td>
|
|
<td align="left" valign="top" width="60%">Workstation name</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">10</td>
|
|
<td align="center" valign="top">A</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Job description name for workstation</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">20</td>
|
|
<td align="center" valign="top">14</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Job description library name for workstation</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">30</td>
|
|
<td align="center" valign="top">1E</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Control job (allocation)</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">40</td>
|
|
<td align="center" valign="top">28</td>
|
|
<td align="left" valign="top">BINARY(4)</td>
|
|
<td align="left" valign="top">Maximum active jobs</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<br>
|
|
|
|
|
|
<h3><a name="HDRSBSE07F">SBSE0700 Format</a></h3>
|
|
|
|
<table border width="80%">
|
|
<tr>
|
|
<th align="center" valign="bottom" colspan="2">Offset</th>
|
|
<th align="left" valign="bottom" rowspan="2">Type</th>
|
|
<th align="left" valign="bottom" rowspan="2">Field</th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<th align="center" valign="bottom">Dec</th>
|
|
<th align="center" valign="bottom">Hex</th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top" width="10%">0</td>
|
|
<td align="center" valign="top" width="10%">0</td>
|
|
<td align="left" valign="top" width="20%">CHAR(10)</td>
|
|
<td align="left" valign="top" width="60%">Workstation type</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">10</td>
|
|
<td align="center" valign="top">A</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Job description name for type</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">20</td>
|
|
<td align="center" valign="top">14</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Job description library name for type</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">30</td>
|
|
<td align="center" valign="top">1E</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Control job (allocation)</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">40</td>
|
|
<td align="center" valign="top">28</td>
|
|
<td align="left" valign="top">BINARY(4)</td>
|
|
<td align="left" valign="top">Maximum active jobs</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<br>
|
|
|
|
|
|
<h3><a name="HDRSBSEFD">Field Descriptions</a></h3>
|
|
|
|
<p><strong>Additional number of jobs.</strong> The additional number of
|
|
prestart jobs that are started when the number of prestart jobs drops below the
|
|
value specified for the threshold parameter.</p>
|
|
|
|
<p><strong>Autostart job description library name.</strong> The name of the
|
|
library in which the job description for the autostart job entry resides.</p>
|
|
|
|
<p><strong>Autostart job description name.</strong> The name of the job
|
|
description for the autostart job entry about which information is being
|
|
returned.</p>
|
|
|
|
<p><strong>Autostart job name.</strong> The simple name of the job that is
|
|
automatically started when the associated subsystem is started.</p>
|
|
|
|
<p><strong>Communication entry job description library name.</strong> The name
|
|
of the library in which the communications entry job description resides.</p>
|
|
|
|
<p><strong>Communication entry job description name.</strong> The name of the
|
|
job description used when a job is started as a result of receiving a program
|
|
start request and processed through this communications entry. Possible special
|
|
values follow:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*USRPRF</em></td>
|
|
<td align="left" valign="top">The job description name that is specified in the
|
|
user profile of the user that made the program start request is used for jobs
|
|
that are processed through this communications entry.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Compare start position.</strong> The starting position for the
|
|
routing data comparison. The comparison between the compare value and the
|
|
routing data begins with this position in the routing data character string,
|
|
and the last character position compared must be less than or equal to the
|
|
length of the routing data used in the comparison.</p>
|
|
|
|
<p><strong>Compare value.</strong> A value that is compared with the routing
|
|
data to determine whether this is the routing entry that is used for starting a
|
|
routing step. The special value *ANY means that any routing data is considered
|
|
a match.</p>
|
|
|
|
<p><strong>Control job (allocation).</strong> How the workstations that are
|
|
associated with this job entry are allocated. Possible special values
|
|
follow:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*SIGNON</em></td>
|
|
<td align="left" valign="top">The workstations are allocated when the subsystem
|
|
is started if the workstation is not already in use (signed on) in another
|
|
subsystem. A sign-on prompt is displayed at each workstation that is associated
|
|
with this work entry. If a workstation becomes allocated to a different
|
|
subsystem, interactive jobs that are associated with the workstation are
|
|
allowed to enter this subsystem through the Transfer Job (TFRJOB) command.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*ENTER</em></td>
|
|
<td align="left" valign="top">The workstations that are associated with this
|
|
work entry are not allocated when the subsystem is started. However, the
|
|
interactive jobs that are associated with the workstations are allowed to enter
|
|
this subsystem through the Transfer Job (TFRJOB) command.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Default user.</strong> The name of the default user profile used for
|
|
evoke requests that enter the subsystem through this entry and contain no
|
|
security information. Possible special values follow:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="10 90" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*NONE</em></td>
|
|
<td align="left" valign="top">No user profile is specified as the default.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*SYS</em></td>
|
|
<td align="left" valign="top">All user program start requests are treated the
|
|
same as *NONE. For program start requests that are sent by system functions,
|
|
the request runs under a predetermined user profile if a user profile is not
|
|
specified on the program start request.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Device.</strong> The name of the device description or the type of
|
|
the device being used with this communications entry. Possible special values
|
|
follow:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*ALL</em></td>
|
|
<td align="left" valign="top">All communications device types are used with
|
|
this communications entry.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*APPC</em></td>
|
|
<td align="left" valign="top">All advanced program-to-program communications
|
|
devices can be used with this communications entry.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*ASYNC</em></td>
|
|
<td align="left" valign="top">All asynchronous communications devices can be
|
|
used with this communications entry.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*BSCEL</em></td>
|
|
<td align="left" valign="top">All bisynchronous equivalency link communications
|
|
devices can be used with this communications entry.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*FINANCE</em></td>
|
|
<td align="left" valign="top">All finance communications devices can be used
|
|
with this communications entry.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*INTRA</em></td>
|
|
<td align="left" valign="top">All intrasystem communications devices can be
|
|
used with this communications entry.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*RETAIL</em></td>
|
|
<td align="left" valign="top">All retail communications devices can be used
|
|
with this communications entry.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*SNUF</em></td>
|
|
<td align="left" valign="top">All SNA upline facility communications devices
|
|
can be used with this communications entry.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>First class library name.</strong> The name of the library in which
|
|
the first class resides.</p>
|
|
|
|
<p><strong>First class name.</strong> The name of one of the two classes that
|
|
the prestart jobs run under. Jobs start by using the first class that is
|
|
specified until the number of jobs specified for the first class is reached.
|
|
After the number of jobs that are specified for the first class is reached,
|
|
then jobs are started by using the second class.</p>
|
|
|
|
<p><strong>Format name specified.</strong> The format name as specified in the
|
|
call to the API.</p>
|
|
|
|
<p><strong>Initial number of jobs.</strong> The initial number of prestart jobs
|
|
that are started when the subsystem is started.</p>
|
|
|
|
<p><strong>Job description library name for type.</strong> The name of the
|
|
library in which the job description for this workstation type resides.</p>
|
|
|
|
<p><strong>Job description library name for workstation.</strong> The name of
|
|
the library in which the job description for this workstation name resides.</p>
|
|
|
|
<p><strong>Job description name for type.</strong> The name of the job
|
|
description that is used for jobs started through this type of workstation
|
|
entry. The possible special value follows:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*USRPRF</em></td>
|
|
<td align="left" valign="top">The job description named in the user profile of
|
|
the user that signs on at this type of workstation is used for jobs started
|
|
through this entry.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Job description name for workstation.</strong> The name of the job
|
|
description that is used for jobs started through this workstation name entry.
|
|
The possible special value follows:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*USRPRF</em></td>
|
|
<td align="left" valign="top">The job description named in the user profile of
|
|
the user that signs on at this workstation is used for jobs started through
|
|
this entry.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Maximum active jobs.</strong> The maximum number of jobs that can be
|
|
active at the same time through this entry. If the entry specifies *NOMAX,
|
|
indicating that there is no maximum, this number is -1.</p>
|
|
|
|
<p><strong>Maximum active routing steps.</strong> The maximum number of routing
|
|
steps (jobs) that can be active at the same time through this routing entry. If
|
|
the routing entry specifies *NOMAX, indicating that there is no maximum, this
|
|
number is -1.</p>
|
|
|
|
<p><strong>Maximum number of jobs.</strong> The maximum number of prestart jobs
|
|
that can be active at the same time for this prestart job entry. If the entry
|
|
specifies *NOMAX, which indicates that there is no maximum, this number is
|
|
-1.</p>
|
|
|
|
<p><strong>Maximum number of uses.</strong> The maximum number of requests that
|
|
can be handled by each prestart job in the pool before the job is ended. If the
|
|
entry specifies *NOMAX, which indicates that there is no maximum, this number
|
|
is -1.</p>
|
|
|
|
<p><strong>Mode.</strong> The mode name of the communications device. The
|
|
possible special value follows:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="10 90" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*ANY</em></td>
|
|
<td align="left" valign="top">Any available modes defined to the communications
|
|
device are allocated to the subsystem. If the communications device does not
|
|
have defined modes associated with it, the communications device itself is
|
|
allocated to the subsystem.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Number of jobs to use first class.</strong> The maximum number of
|
|
jobs to run by using the first class. Possible special values follow:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="5 95" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>-3</em></td>
|
|
<td align="left" valign="top">The system calculates how many prestart jobs use
|
|
this class.
|
|
|
|
<p>If only one class is specified and -3 is specified, all of the jobs use that
|
|
class.</p>
|
|
|
|
<p>If two classes are specified and -3 is specified for both, the first class
|
|
is the value of the maximum number of jobs field divided by two, and the second
|
|
class is the value of the maximum number of jobs field minus the value that is
|
|
calculated for the first class.</p>
|
|
|
|
<p>If a specific number of jobs is specified for either class and -3 is
|
|
specified for the other class, the system calculates the difference between
|
|
maximum number of jobs and the specific number of jobs for the -3
|
|
designation.</p>
|
|
</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>-4</em></td>
|
|
<td align="left" valign="top">All of the prestart jobs use the specified
|
|
class.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Number of jobs to use second class.</strong> The maximum number of
|
|
jobs to run by using the second class. Possible special values follow:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="5 95" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>-3</em></td>
|
|
<td align="left" valign="top">The system calculates how many prestart jobs use
|
|
this class.
|
|
|
|
<p>If only one class is specified and -3 is specified, all of the jobs use that
|
|
class.</p>
|
|
|
|
<p>If two classes are specified and -3 is specified for both, the first class
|
|
is the value of the maximum number of jobs field divided by two. The second
|
|
class is the value of the maximum number of jobs field minus the value that is
|
|
calculated for the first class.</p>
|
|
|
|
<p>If a specific number of jobs is specified for either class and -3 is
|
|
specified for the other class, the system calculates the difference between
|
|
maximum number of jobs and the specific number of jobs for the -3
|
|
designation.</p>
|
|
</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>-4</em></td>
|
|
<td align="left" valign="top">All of the prestart jobs use the specified
|
|
class.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Pool identifier.</strong> The name of the subsystem pool identifier
|
|
in which the prestart jobs will run.</p>
|
|
|
|
<p><strong>Prestart job resources affinity group.</strong> Specifies whether or not the prestart jobs started by this entry are grouped together having affinity to the same set of processors and memory. The possible values are:</p>
|
|
<table cellpadding="5">
|
|
<!-- cols="10 90" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*NO</em></td>
|
|
<td align="left" valign="top">Prestart jobs will not be grouped together. They will be spread across all the available system resources.
|
|
</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*YES</em></td>
|
|
<td align="left" valign="top">Prestart jobs will be grouped together such that they will have affinity to the same system resources.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Prestart job thread resources affinity group.</strong> Specifies whether or not secondary threads running in the prestart jobs are grouped together with the initial thread, or spread across the system resources. The possible values are:</p>
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*SYSVAL</em></td>
|
|
<td align="left" valign="top">The thread resources affinity group and level in the QTHDRSCAFN system value will be used when the job starts.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td align="left" valign="top"><em>*NOGROUP</em></td>
|
|
<td align="left" valign="top">Secondary threads running in the prestart job will not necessarily have affinity to the same set of processors and memory as the initial thread. They will be spread across all the available system resources.
|
|
</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*GROUP</em></td>
|
|
<td align="left" valign="top">Secondary threads running in the prestart job will all have affinity to the same set of processors and memory as the initial thread.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Prestart job thread resources affinity level.</strong> The degree to which the system tries to maintain the affinity between threads and system resources. When the prestart jobs thread resources affinity group is *SYSVAL, this field will contain blanks. The possible special values are:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*NORMAL</em></td>
|
|
<td align="left" valign="top">A thread will use any processor or memory in the system if the resources it has affinity to are not readily available.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*HIGH</em></td>
|
|
<td align="left" valign="top">A thread will only use the resources it has affinity to, and will wait until they become available if necessary.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Prestart job description library name.</strong> The name of the
|
|
library in which the job description for the prestart job entry resides.</p>
|
|
|
|
<p><strong>Prestart job description name.</strong> The name of the job
|
|
description that is used for the prestart job entry. The possible special value
|
|
follows:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*USRPRF</em></td>
|
|
<td align="left" valign="top">The job description that has the same name as the
|
|
user profile that is used.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Prestart job name.</strong> The name of the prestart job.</p>
|
|
|
|
<p><strong>Prestart job program library name.</strong> The name of the library
|
|
in which the prestart job program resides.</p>
|
|
|
|
<p><strong>Prestart job program name.</strong> The program name that is used to
|
|
match an incoming request with an available prestart job.</p>
|
|
|
|
<p><strong>Remote location.</strong> The name of the remote location for this
|
|
entry.</p>
|
|
|
|
<p><strong>Remote location entry job description library name.</strong> The
|
|
name of the library in which the job description resides.</p>
|
|
|
|
<p><strong>Remote location entry job description name.</strong> The name of the
|
|
job description used when a job is started as a result of receiving a program
|
|
start request and processed through this remote location entry. Possible
|
|
special values follow:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*USRPRF</em></td>
|
|
<td align="left" valign="top">The job description name that is specified in the
|
|
user profile of the user that made the program start request is used for jobs
|
|
that are processed through this remote location entry.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Reserved.</strong> An ignored field.</p>
|
|
|
|
<p><strong>Routing entry class library name.</strong> The name of the library
|
|
in which the routing entry class resides.</p>
|
|
|
|
<p><strong>Routing entry class name.</strong> The name of the class that is
|
|
used when a routing step is started through this routing entry.</p>
|
|
|
|
<p><strong>Routing entry pool identifier.</strong> The pool identifier of the
|
|
storage pool in which the routing entry program is run.</p>
|
|
|
|
<p><strong>Routing entry program library name.</strong> The name of the library
|
|
in which the routing entry program resides.</p>
|
|
|
|
<p><strong>Routing entry program name.</strong> The name of the program that is
|
|
started when a routing step is started through this routing entry in the
|
|
subsystem description. If *RTGDTA is returned, the program name is taken from
|
|
the routing data that was supplied and matched against this entry. The
|
|
qualified program name will be taken from the routing data in this case, where
|
|
the program name is specified in positions 37 through 46 and the library name
|
|
is taken from positions 47 through 56.</p>
|
|
|
|
<p><strong>Routing entry resources affinity group.</strong> Specifies whether or not the jobs using this routing entry are grouped together having affinity to the same set of processors and memory. The possible values are:</p>
|
|
<table cellpadding="5">
|
|
<!-- cols="10 90" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*NO</em></td>
|
|
<td align="left" valign="top">The jobs will not be grouped together. They will be spread across all the available system resources.
|
|
</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*YES</em></td>
|
|
<td align="left" valign="top">The jobs will be grouped together such that they will have affinity to the same system resources.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Routing entry sequence number.</strong> The sequence number of the
|
|
routing entry.</p>
|
|
|
|
<p><strong>Routing entry thread resources affinity group.</strong> Specifies whether or not secondary threads running in jobs that started through this routing entry are grouped together with the initial thread, or spread across the system resources. The possible values are:</p>
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*SYSVAL</em></td>
|
|
<td align="left" valign="top">The thread resources affinity group and level in the QTHDRSCAFN system value will be used when the job starts.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td align="left" valign="top"><em>*NOGROUP</em></td>
|
|
<td align="left" valign="top">Secondary threads will not necessarily have affinity to the same set of processors and memory as the initial thread. They will be spread across all the available system resources.
|
|
</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*GROUP</em></td>
|
|
<td align="left" valign="top">Secondary threads will all have affinity to the same set of processors and memory as the initial thread.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Routing entry thread resources affinity level.</strong> The degree to which the system tries to maintain the affinity between threads and system resources. When the routing entry thread resources affinity group is *SYSVAL, this field will contain blanks. The possible special values are:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*NORMAL</em></td>
|
|
<td align="left" valign="top">A thread will use any processor or memory in the system if the resources it has affinity to are not readily available.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*HIGH</em></td>
|
|
<td align="left" valign="top">A thread will only use the resources it has affinity to, and will wait until they become available if necessary.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Second class library name.</strong> The name of the library in which
|
|
the second class resides.</p>
|
|
|
|
<p><strong>Second class name.</strong> One of the two classes that the prestart
|
|
jobs run under. Jobs start by using the first class that is specified until the
|
|
number of jobs specified for the first class is reached. After the number of
|
|
jobs that are specified for the first class is reached, then jobs are started
|
|
using the second class. The possible special value follows:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="10 90" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*NONE</em></td>
|
|
<td align="left" valign="top">Only one class is used.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Start jobs.</strong> Whether the prestart jobs are started at the
|
|
time the subsystem is started. Possible special values follow:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="5 95" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>1</em></td>
|
|
<td align="left" valign="top">The prestart jobs are started at the time the
|
|
subsystem is started.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>0</em></td>
|
|
<td align="left" valign="top">The prestart jobs are not started at the time the
|
|
subsystem is started. The Start Prestart Jobs (STRPJ) command is used to start
|
|
these prestart jobs.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Subsystem library name specified.</strong> The name or special value
|
|
specified in the call to this API for the library in which the subsystem
|
|
description resides.</p>
|
|
|
|
<p><strong>Subsystem library name used.</strong> The name of the library in
|
|
which the subsystem description resides.</p>
|
|
|
|
<p><strong>Subsystem name specified.</strong> The name of the subsystem
|
|
specified in the call to this API.</p>
|
|
|
|
<p><strong>Subsystem name used.</strong> The name of the subsystem about which
|
|
information is being returned.</p>
|
|
|
|
<p><strong>Threshold.</strong> The number at which additional prestart jobs are
|
|
started. When the pool of available jobs (jobs available to service a program
|
|
start request) is reduced below this number, more jobs (specified on the
|
|
additional number of jobs field) are started and added to the available pool.
|
|
This number is checked after a prestart job is attached to a procedure start
|
|
request.</p>
|
|
|
|
<p><strong>User profile name.</strong> The name of the user profile under which
|
|
the prestart job runs.</p>
|
|
|
|
<p><strong>User space library name specified.</strong> The name specified for
|
|
the library that contains the user space to receive the generated list.</p>
|
|
|
|
<p><strong>User space name specified.</strong> The name specified for the user
|
|
space that is to receive the generated list.</p>
|
|
|
|
<p><strong>Wait for job.</strong> Whether requests wait for a prestart job to
|
|
become available or are rejected if a prestart job is not immediately available
|
|
when the request is received. Possible special values follow:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="5 95" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>1</em></td>
|
|
<td align="left" valign="top">Requests wait until there is an available
|
|
prestart job, or until a prestart job is started, to handle the request.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>0</em></td>
|
|
<td align="left" valign="top">Requests are rejected if a prestart job is not
|
|
immediately available when the request is received.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Workstation name.</strong> The name of the workstation that is used
|
|
by the subsystem. A generic workstation entry like DSP* is allowed.</p>
|
|
|
|
<p><strong>Workstation type.</strong> The display device type. (See the TYPE
|
|
keyword in the <a href="../books/c4154010.pdf">Communications
|
|
Configuration</a><img src="wbpdf.gif" alt="Link to PDF"> book
|
|
on the V5R1 Supplemental Manuals Web site.</p>
|
|
|
|
<p>Possible special values follow:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*ALL</em></td>
|
|
<td align="left" valign="top">All workstation devices. This includes devices
|
|
with 5250, ASCII, and 327x device types.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*ASCII</em></td>
|
|
<td align="left" valign="top">ASCII display station.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*NONASCII</em></td>
|
|
<td align="left" valign="top">All workstation devices that use a 5250 data
|
|
stream. This includes the 327x device types.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*CONS</em></td>
|
|
<td align="left" valign="top">System console display. This entry overrides a
|
|
device type entry that specifies the same device type as the device being used
|
|
as the console.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
|
|
|
|
<h3>Error Messages</h3>
|
|
|
|
<table width="100%" cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<th align="left" valign="top" nowrap>Message ID</th>
|
|
<th align="left" valign="top">Error Message Text</th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF1605 E</td>
|
|
<td align="left" valign="top">Cannot allocate subsystem description
|
|
&1.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF1606 E</td>
|
|
<td align="left" valign="top">Error during allocation of subsystem &1.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF1607 E</td>
|
|
<td align="left" valign="top">Previous request pending for subsystem
|
|
&1.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF1608 E</td>
|
|
<td align="left" valign="top">Subsystem description &1 not found.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF1619 E</td>
|
|
<td align="left" valign="top">Subsystem description &1 in library &2
|
|
damaged.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF1835 E</td>
|
|
<td align="left" valign="top">Not authorized to subsystem description.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF3CF1 E</td>
|
|
<td align="left" valign="top">Error code parameter not valid.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF3CF2 E</td>
|
|
<td align="left" valign="top">Error(s) occurred during running of &1
|
|
API.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF3C21 E</td>
|
|
<td align="left" valign="top">Format name &1 is not valid.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF3C90 E</td>
|
|
<td align="left" valign="top">Literal value cannot be changed.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF811A E</td>
|
|
<td align="left" valign="top">User space &4 in &9 damaged.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF8122 E</td>
|
|
<td align="left" valign="top">&8 damage on library &4.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF9801 E</td>
|
|
<td align="left" valign="top">Object &2 in library &3 not found.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF9802 E</td>
|
|
<td align="left" valign="top">Not authorized to object &2 in &3.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF9803 E</td>
|
|
<td align="left" valign="top">Cannot allocate object &2 in library
|
|
&3.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF9807 E</td>
|
|
<td align="left" valign="top">One or more libraries in library list
|
|
deleted.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF9808 E</td>
|
|
<td align="left" valign="top">Cannot allocate one or more libraries on library
|
|
list.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF9810 E</td>
|
|
<td align="left" valign="top">Library &1 not found.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF9820 E</td>
|
|
<td align="left" valign="top">Not authorized to use library &1.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF9830 E</td>
|
|
<td align="left" valign="top">Cannot assign library &1.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF9838 E</td>
|
|
<td align="left" valign="top">User profile storage limit exceeded.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF9872 E</td>
|
|
<td align="left" valign="top">Program or service program &1 in library
|
|
&2 ended. Reason code &3.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<hr>
|
|
API introduced: V3R7
|
|
|
|
<hr>
|
|
<table align="center" cellpadding="2" cellspacing="2">
|
|
<tr align="center">
|
|
<td valign="middle" align="center"><a href="#Top">Top</a> | <a href="wm1.htm">
|
|
Work Management APIs</a> | <a href="aplist.htm">APIs by category</a></td>
|
|
</tr>
|
|
</table>
|
|
</body>
|
|
</html>
|