ibm-information-center/dist/eclipse/plugins/i5OS.ic.cl_5.4.0.1/rtvs36a.htm

429 lines
18 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">
<title>Retrieve S/36 Environment Attr (RTVS36A)</title>
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
</head>
<body bgcolor="white">
<script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<a name="RTVS36A.Top_Of_Page"></a>
<h2>Retrieve S/36 Environment Attr (RTVS36A)</h2>
<table width="100%">
<tr>
<td valign="top" align="left"><b>Where allowed to run: </b>
<ul><li>Batch program (*BPGM)</li>
<li>Interactive program (*IPGM)</li>
<li>Interactive REXX procedure (*IREXX)</li>
</ul><b>Threadsafe: </b>No
</td>
<td valign="top" align="right">
<a href="#RTVS36A.PARAMETERS.TABLE">Parameters</a><br>
<a href="#RTVS36A.COMMAND.EXAMPLES">Examples</a><br>
<a href="#RTVS36A.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="RTVS36A"></a>
<p>The Retrieve System/36 Attributes (RTVS36A) command allows the user to retrieve specific attribute information about the System/36 environment configuration and provide that information to a specified variable of a CL program or REXX procedure. Information about one or more attributes can be retrieved.
</p>
<p>More information about the System/36 attributes that can be retrieved is in the help information for the Change System/36 Attributes (CHGS36A) command.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVS36A.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="RTVS36A.PARAMETERS.TABLE">Parameters</a></h3>
<table border="1" cellpadding="4" cellspacing="0">
<!-- col1="10" col2="15" col3="30" col4="10" -->
<tr>
<th bgcolor="aqua" valign="bottom" align="left">Keyword</th>
<th bgcolor="aqua" valign="bottom" align="left">Description</th>
<th bgcolor="aqua" valign="bottom" align="left">Choices</th>
<th bgcolor="aqua" valign="bottom" align="left">Notes</th>
</tr>
<tr>
<td valign="top"><a href="#RTVS36A.ENV"><b>ENV</b></a></td>
<td valign="top">Environment name</td>
<td valign="top"><i>Name</i>, <b><u>#LIBRARY</u></b></td>
<td valign="top">Optional, Key</td>
</tr>
<tr>
<td valign="top"><a href="#RTVS36A.SLIB"><b>SLIB</b></a></td>
<td valign="top">CL var for SLIB (8)</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RTVS36A.FLIB"><b>FLIB</b></a></td>
<td valign="top">CL var for FLIB (10)</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RTVS36A.LIBL"><b>LIBL</b></a></td>
<td valign="top">CL var for LIBL (4)</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RTVS36A.DATDIFF"><b>DATDIFF</b></a></td>
<td valign="top">CL var for DATDIFF (4)</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RTVS36A.S36ESHARE"><b>S36ESHARE</b></a></td>
<td valign="top">CL var for S36ESHARE (4)</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RTVS36A.RCDBLK"><b>RCDBLK</b></a></td>
<td valign="top">CL var for RCDBLK (4)</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RTVS36A.CACHEDLTF"><b>CACHEDLTF</b></a></td>
<td valign="top">CL var for CACHEDLTF (4)</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RTVS36A.LPPAGE"><b>LPPAGE</b></a></td>
<td valign="top">CL var for LPPAGE (3)</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RTVS36A.FORMTYPE"><b>FORMTYPE</b></a></td>
<td valign="top">CL var for FORMTYPE (4)</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RTVS36A.DFTMSGACN"><b>DFTMSGACN</b></a></td>
<td valign="top">CL var for DFTMSGACN (9)</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RTVS36A.HALTOPT"><b>HALTOPT</b></a></td>
<td valign="top">CL var for HALTOPT (4)</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RTVS36A.EVKJOBINIT"><b>EVKJOBINIT</b></a></td>
<td valign="top">CL var for EVKJOBINIT (6)</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RTVS36A.EVKJOBPOL"><b>EVKJOBPOL</b></a></td>
<td valign="top">CL var for EVKJOBPOL (8)</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RTVS36A.EVKJOBPTY"><b>EVKJOBPTY</b></a></td>
<td valign="top">CL var for EVKJOBPTY (10)</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RTVS36A.SRCRCDLEN"><b>SRCRCDLEN</b></a></td>
<td valign="top">CL var for SRCRCDLEN (3)</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RTVS36A.CHGACT"><b>CHGACT</b></a></td>
<td valign="top">CL var for CHGACT (4)</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RTVS36A.ADDS36ONLY"><b>ADDS36ONLY</b></a></td>
<td valign="top">CL var for ADDS36ONLY (4)</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RTVS36A.ICFSUBST"><b>ICFSUBST</b></a></td>
<td valign="top">CL var for ICFSUBST (4)</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RTVS36A.MRTUSRPRF"><b>MRTUSRPRF</b></a></td>
<td valign="top">CL var for MRTUSRPRF (8)</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RTVS36A.MRTAUT"><b>MRTAUT</b></a></td>
<td valign="top">CL var for MRTAUT (8)</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RTVS36A.MRTDLY"><b>MRTDLY</b></a></td>
<td valign="top">CL var for MRTDLY (5)</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RTVS36A.MRTJOBINIT"><b>MRTJOBINIT</b></a></td>
<td valign="top">CL var for MRTJOBINIT (6)</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RTVS36A.MRTJOBPOL"><b>MRTJOBPOL</b></a></td>
<td valign="top">CL var for MRTJOBPOL (8)</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RTVS36A.MRTJOBPTY"><b>MRTJOBPTY</b></a></td>
<td valign="top">CL var for MRTJOBPTY (10)</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#RTVS36A.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="RTVS36A.ENV"></a>
<h3>Environment name (ENV)</h3>
<p>Specifies the name of the System/36 environment from which you are retrieving attributes. The value is #LIBRARY and cannot be changed.
</p>
<p>This is a required parameter.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVS36A.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVS36A.SLIB"></a>
<h3>CL var for SLIB (8) (SLIB)</h3>
<p>Specifies the name of an 8-character variable to receive the name of the default session library for jobs running in the System/36 environment.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVS36A.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVS36A.FLIB"></a>
<h3>CL var for FLIB (10) (FLIB)</h3>
<p>Specifies the name of a 10-character variable to receive the name of the default files library for jobs running in the System/36 environment.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVS36A.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVS36A.LIBL"></a>
<h3>CL var for LIBL (4) (LIBL)</h3>
<p>Specifies the name of a 4-character variable to receive information on whether the library list is used for jobs running in the System/36 environment. A value of *YES or *NO is returned in the variable.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVS36A.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVS36A.DATDIFF"></a>
<h3>CL var for DATDIFF (4) (DATDIFF)</h3>
<p>Specifies the name of a 4-character variable to receive information on whether files with the same name but different dates can be used for jobs running in the System/36 environment. A value of *YES or *NO is returned in the variable.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVS36A.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVS36A.S36ESHARE"></a>
<h3>CL var for S36ESHARE (4) (S36ESHARE)</h3>
<p>Specifies the name of a 4-character variable to receive information on whether programs share an open data path (ODP) to database files opened in the System/36 environment. A value of *YES or *NO is returned in the variable.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVS36A.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVS36A.RCDBLK"></a>
<h3>CL var for RCDBLK (4) (RCDBLK)</h3>
<p>Specifies the name of a 4-character variable to receive information on whether record blocking is used for sequential database files sharing an open data path in the System/36 environment. A value of *YES or *NO is returned in the variable.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVS36A.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVS36A.CACHEDLTF"></a>
<h3>CL var for CACHEDLTF (4) (CACHEDLTF)</h3>
<p>Specifies the name of a 4-character variable to receive information on whether deleted files are stored in a cache in the System/36 environment. A value of *YES or *NO is returned in the variable.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVS36A.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVS36A.LPPAGE"></a>
<h3>CL var for LPPAGE (3) (LPPAGE)</h3>
<p>Specifies the name of a 3-character variable to receive the number of lines printed on a page for jobs running in the System/36 environment. A value ranging from 1 through 112 is returned in the variable.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVS36A.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVS36A.FORMTYPE"></a>
<h3>CL var for FORMTYPE (4) (FORMTYPE)</h3>
<p>Specifies the name of a 4-character variable to receive the form type of the printer form used when printing a job in the System/36 environment. A value of *STD or a user-defined form type is returned in the variable.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVS36A.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVS36A.DFTMSGACN"></a>
<h3>CL var for DFTMSGACN (9) (DFTMSGACN)</h3>
<p>Specifies the name of a 9-character variable to receive the default message action used by the System/36 environment when an error occurs during the running of a CL command within a System/36 environment procedure. A value of *CONTINUE, *HALT, IGNORE, or *CANCEL is returned in the variable.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVS36A.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVS36A.HALTOPT"></a>
<h3>CL var for HALTOPT (4) (HALTOPT)</h3>
<p>Specifies the name of a 4-character variable to receive the options list for continuation after an error occurs in the System/36 environment and *HALT is specified for the default message action.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVS36A.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVS36A.EVKJOBINIT"></a>
<h3>CL var for EVKJOBINIT (6) (EVKJOBINIT)</h3>
<p>Specifies the name of a 6-character variable to receive the value for the method used to start EVOKE jobs or job steps in the System/36 environment. A value of *IMMED or *JOBQ is returned in the variable.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVS36A.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVS36A.EVKJOBPOL"></a>
<h3>CL var for EVKJOBPOL (8) (EVKJOBPOL)</h3>
<p>Specifies the name of an 8-character variable to receive the value for the storage pool used for jobs started with the *IMMED option in the System/36 environment. A value of *BASE or *CURRENT is returned in the variable.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVS36A.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVS36A.EVKJOBPTY"></a>
<h3>CL var for EVKJOBPTY (10) (EVKJOBPTY)</h3>
<p>Specifies the name of a 10-character variable to receive the value for the priority at which a job is started when it is started with the *IMMED option in the System/36 environment. A value ranging from 1 through 99 or the value *SUBMITTER is returned in the variable.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVS36A.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVS36A.SRCRCDLEN"></a>
<h3>CL var for SRCRCDLEN (3) (SRCRCDLEN)</h3>
<p>Specifies the name of a 3-character variable to receive the record length in bytes for System/36 source files QS36PRC and QS36SRC. A value ranging from 52 through 132 is returned in the variable.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVS36A.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVS36A.CHGACT"></a>
<h3>CL var for CHGACT (4) (CHGACT)</h3>
<p>Specifies the name of a 4-character CL variable to receive the value indicating whether the configuration object can be updated using the Change System/36 (CHGS36) command while others are signed on to the System/36 environment. A value of *NO or *YES is returned in the variable.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVS36A.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVS36A.ADDS36ONLY"></a>
<h3>CL var for ADDS36ONLY (4) (ADDS36ONLY)</h3>
<p>Specifies the name of a 4-character CL variable to receive the value indicating whether workstation devices can be added to the System/36 environment configuration when the device signs on to the System/36 environment. A value of *NO or *YES is returned in the variable.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVS36A.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVS36A.ICFSUBST"></a>
<h3>CL var for ICFSUBST (4) (ICFSUBST)</h3>
<p>Specifies the name of a 4-character CL variable to receive the value indicating whether to scan intersystem communications function (ICF) start requests for substitution expressions. A value of *NO or *YES is returned in the variable.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVS36A.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVS36A.MRTUSRPRF"></a>
<h3>CL var for MRTUSRPRF (8) (MRTUSRPRF)</h3>
<p>Specifies the name of an 8-character variable to receive the user profile under which the Multiple Requester Terminal (MRT) program is running. A value of *OWNER or *FRSTUSR is returned in the variable.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVS36A.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVS36A.MRTAUT"></a>
<h3>CL var for MRTAUT (8) (MRTAUT)</h3>
<p>Specifies the name of an 8-character variable to receive the user authority to files used by the MRT program. A value of *ALLUSR or *FRSTUSR is returned in the variable.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVS36A.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVS36A.MRTDLY"></a>
<h3>CL var for MRTDLY (5) (MRTDLY)</h3>
<p>Specifies the name of a 5-character variable to receive the time in seconds that the system delays before ending the MRT program. A value ranging from 0 through 32767 is returned in the variable.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVS36A.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVS36A.MRTJOBINIT"></a>
<h3>CL var for MRTJOBINIT (6) (MRTJOBINIT)</h3>
<p>Specifies the name of a 6-character variable to receive the value for the method used to start an MRT job in the System/36 environment. A value of *IMMED or *JOBQ is returned in the variable.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVS36A.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVS36A.MRTJOBPOL"></a>
<h3>CL var for MRTJOBPOL (8) (MRTJOBPOL)</h3>
<p>Specifies the name of an 8-character variable to receive the value for the storage pool to be used for an MRT job started with the *IMMED option in the System/36 environment. A value of *BASE or *CURRENT is returned in the variable.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVS36A.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVS36A.MRTJOBPTY"></a>
<h3>CL var for MRTJOBPTY (10) (MRTJOBPTY)</h3>
<p>Specifies the name of a 10-character variable to receive the the value for the priority to start an MRT job started with the *IMMED option. A value ranging from 1 through 99 or the value *SUBMITTER is returned in the variable.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVS36A.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="RTVS36A.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
RTVS36A RCBBLK(&amp;RBLOCK) HALT(&amp;OPTION) MRTUSRPRF(&amp;USERID)
</pre>
</p>
<p>This command retrieves the shared file record blocking value, the halt options list, and the user profile under which the MRT is running. The file record blocking value is copied into the CL variable &amp;RBLOCK, which must be 4 characters in length. The halt options list is copied into the CL variable &amp;OPTION, which must be at least 4 characters in length. The user profile under which the MRT is running is copied into the CL variable &amp;USERID, which must be 8 characters in length.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVS36A.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="RTVS36A.ERROR.MESSAGES">Error messages</a> </h3>
<p>None
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVS36A.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>