307 lines
11 KiB
HTML
307 lines
11 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>Start SDA (STRSDA)</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="STRSDA.Top_Of_Page"></a>
|
||
|
|
<h2>Start SDA (STRSDA)</h2>
|
||
|
|
<table width="100%">
|
||
|
|
<tr>
|
||
|
|
<td valign="top" align="left"><b>Where allowed to run: </b>Interactive environments (*INTERACT *IPGM *IREXX *EXEC)<br>
|
||
|
|
<b>Threadsafe: </b>No
|
||
|
|
</td>
|
||
|
|
<td valign="top" align="right">
|
||
|
|
<a href="#STRSDA.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
|
<a href="#STRSDA.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
|
<a href="#STRSDA.ERROR.MESSAGES">Error messages</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<div> <a name="STRSDA"></a>
|
||
|
|
<p>The CL command STRSDA is the primary command for the IBM Screen Design Aid (SDA) utility. This command can be invoked in all three environments of the system.
|
||
|
|
</p>
|
||
|
|
<h3>Error messages for STRSDA</h3>
|
||
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>SDA0001</b></dt>
|
||
|
|
<dd>SDA does not support a &1 workstation.
|
||
|
|
</dd>
|
||
|
|
<dt><b>SDA0002</b></dt>
|
||
|
|
<dd>SDA cannot access its display file.
|
||
|
|
</dd>
|
||
|
|
<dt><b>SDA0003</b></dt>
|
||
|
|
<dd>SDA ended because of a serious error.
|
||
|
|
</dd>
|
||
|
|
<dt><b>SDA0004</b></dt>
|
||
|
|
<dd>Error while processing the STRSDA command.
|
||
|
|
</dd>
|
||
|
|
<dt><b>SDA0005</b></dt>
|
||
|
|
<dd>SDA cannot access its panel group.
|
||
|
|
</dd>
|
||
|
|
<dt><b>SDA0601</b></dt>
|
||
|
|
<dd>SDA is already active.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRSDA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
|
||
|
|
<div>
|
||
|
|
<h3><a name="STRSDA.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="#STRSDA.OPTION"><b>OPTION</b></a></td>
|
||
|
|
<td valign="top">SDA option</td>
|
||
|
|
<td valign="top"><b><u>*SELECT</u></b>, 1, 2, 3</td>
|
||
|
|
<td valign="top">Optional, Positional 1</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="3"><a href="#STRSDA.SRCFILE"><b>SRCFILE</b></a></td>
|
||
|
|
<td valign="top">Source file</td>
|
||
|
|
<td valign="top"><i>Qualified object name</i></td>
|
||
|
|
<td valign="top" rowspan="3">Optional, Positional 2</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Qualifier 1: Source file</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>*PRV</u></b></td>
|
||
|
|
</tr><tr>
|
||
|
|
<td valign="top">Qualifier 2: Library</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>*PRV</u></b>, *LIBL, *CURLIB</td>
|
||
|
|
</tr><tr>
|
||
|
|
<td valign="top"><a href="#STRSDA.SRCMBR"><b>SRCMBR</b></a></td>
|
||
|
|
<td valign="top">Source member</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>*PRV</u></b>, *SELECT</td>
|
||
|
|
<td valign="top">Optional, Positional 3</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#STRSDA.OBJLIB"><b>OBJLIB</b></a></td>
|
||
|
|
<td valign="top">Object library</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>*PRV</u></b>, *CURLIB</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="3"><a href="#STRSDA.JOBD"><b>JOBD</b></a></td>
|
||
|
|
<td valign="top">Job description</td>
|
||
|
|
<td valign="top"><i>Qualified object name</i></td>
|
||
|
|
<td valign="top" rowspan="3">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Qualifier 1: Job description</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>*PRV</u></b>, *USRPRF</td>
|
||
|
|
</tr><tr>
|
||
|
|
<td valign="top">Qualifier 2: Library</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>*PRV</u></b>, *LIBL, *CURLIB</td>
|
||
|
|
</tr><tr>
|
||
|
|
<td valign="top" rowspan="3"><a href="#STRSDA.TSTFILE"><b>TSTFILE</b></a></td>
|
||
|
|
<td valign="top">Test file</td>
|
||
|
|
<td valign="top"><i>Qualified object name</i></td>
|
||
|
|
<td valign="top" rowspan="3">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Qualifier 1: Test file</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>*PRV</u></b></td>
|
||
|
|
</tr><tr>
|
||
|
|
<td valign="top">Qualifier 2: Library</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>*PRV</u></b>, *LIBL, *CURLIB</td>
|
||
|
|
</tr><tr>
|
||
|
|
<td valign="top"><a href="#STRSDA.MODE"><b>MODE</b></a></td>
|
||
|
|
<td valign="top">Mode</td>
|
||
|
|
<td valign="top"><b><u>*STD</u></b>, *S38, *S36</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRSDA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<div> <a name="STRSDA.OPTION"></a>
|
||
|
|
<h3>SDA option (OPTION)</h3>
|
||
|
|
<p>Specifies which option to use as a value for the SDA main menu. This parameter is ignored if MODE (*S36) is specified.
|
||
|
|
</p>
|
||
|
|
<p>The possible values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SELECT</u></b></dt>
|
||
|
|
<dd>Displays the SDA main menu.
|
||
|
|
</dd>
|
||
|
|
<dt><b>main-menu-option-number</b></dt>
|
||
|
|
<dd>Type a number between 1 and 3 that corresponds to an option on the SDA main menu. If you select this parameter value, the SDA main menu will not appear.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRSDA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRSDA.SRCFILE"></a>
|
||
|
|
<h3>Source file (SRCFILE)</h3>
|
||
|
|
<p>Specifies the name of the source file that contains the source member to be updated or to which a new source member will be added. Only the library qualifier will be used if MODE (*S36) is specified.
|
||
|
|
</p>
|
||
|
|
<p>The possible values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*PRV</u></b></dt>
|
||
|
|
<dd>Specifies that SDA is to use the name of the source file and library used in your last SDA session (only when MODE is (*STD)).
|
||
|
|
</dd>
|
||
|
|
<dt><b>qualified-source-name</b></dt>
|
||
|
|
<dd>Type the qualified name of an existing source file to be used by SDA. If *CURLIB is specified as the library qualifier, the current library entry of the library list will be searched. If no current library exists in the library list, then library QGPL will be searched. If *LIBL is specified as the library qualifier, *LIBL is used to find the file.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRSDA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRSDA.SRCMBR"></a>
|
||
|
|
<h3>Source member (SRCMBR)</h3>
|
||
|
|
<p>Specifies the name of a new or existing source file member that contains or will contain source for the displays or menus to be updated or created by SDA.
|
||
|
|
</p>
|
||
|
|
<p>The possible value is:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*PRV</u></b></dt>
|
||
|
|
<dd>Specifies that SDA is to use the name of the source member used in your last SDA session (only when MODE is (*STD)).
|
||
|
|
</dd>
|
||
|
|
<dt><b>*SELECT</b></dt>
|
||
|
|
<dd>Specifies that SDA will bring up the Design Screens display. From this display you can press F4 on the Member field to see a list of source members to select from.
|
||
|
|
</dd>
|
||
|
|
<dt><b>source-member-name</b></dt>
|
||
|
|
<dd>Type the name of the source member to be created or updated.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRSDA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRSDA.OBJLIB"></a>
|
||
|
|
<h3>Object library (OBJLIB)</h3>
|
||
|
|
<p>Specifies the name of the library into which the program or display file that SDA creates will be stored.
|
||
|
|
</p>
|
||
|
|
<p>The possible values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*PRV</u></b></dt>
|
||
|
|
<dd>Specifies that SDA is to use the name of the object library used in your last SDA session (only when MODE is (*STD)).
|
||
|
|
</dd>
|
||
|
|
<dt><b>*CURLIB</b></dt>
|
||
|
|
<dd>Specifies that SDA is to use the current library entry of the library list. If no current library entry exists in the library list, then library QGPL will be used.
|
||
|
|
</dd>
|
||
|
|
<dt><b>object-library-name</b></dt>
|
||
|
|
<dd>Type the name of the library into which objects created by SDA are to be stored.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRSDA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRSDA.JOBD"></a>
|
||
|
|
<h3>Job description (JOBD)</h3>
|
||
|
|
<p>Specifies the qualified name of the job description to be used with batch jobs being submitted by SDA. This parameter is not used if MODE (*S36) is used.
|
||
|
|
</p>
|
||
|
|
<p>The possible values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*PRV</u></b></dt>
|
||
|
|
<dd>Specifies that SDA is to use the name of the job description and library used in your last SDA session (only when MODE is (*STD)).
|
||
|
|
</dd>
|
||
|
|
<dt><b>job-description-name</b></dt>
|
||
|
|
<dd>Type the qualified name of the job description to be used with submitted jobs. If *CURLIB is specified as the library qualifier, the current library entry of the library list will be searched. If no current library exists in the library list, then library QGPL will be searched. If *LIBL is specified as the library qualifier, *LIBL is used to find the file.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*USRPRF</b></dt>
|
||
|
|
<dd>Specifies that SDA is to use the name of the job description defined in the user profile.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRSDA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRSDA.TSTFILE"></a>
|
||
|
|
<h3>Test file (TSTFILE)</h3>
|
||
|
|
<p>Specifies the qualified name of the display file to be used for testing. This parameter is ignored if MODE (*S36) is specified.
|
||
|
|
</p>
|
||
|
|
<p>The possible values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*PRV</u></b></dt>
|
||
|
|
<dd>Specifies that SDA is to use the name of the display file and library used in your last SDA session (only when MODE is (*STD)).
|
||
|
|
</dd>
|
||
|
|
<dt><b>test-file-name</b></dt>
|
||
|
|
<dd>Type the qualified name of the display file to be used for testing. If *CURLIB is specified as the library qualifier, the current library entry of the library list will be searched. If no current library exists in the library list, then library QGPL will be searched. If *LIBL is specified as the library qualifier, *LIBL is used to find the file.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRSDA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="STRSDA.MODE"></a>
|
||
|
|
<h3>Mode (MODE)</h3>
|
||
|
|
<p>Specifies which version of SDA is to use.
|
||
|
|
</p>
|
||
|
|
<p>The possible values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*STD</u></b></dt>
|
||
|
|
<dd>Specifies SDA and displays the SDA main menu. The main menu will not appear if the OPTION parameter is specified.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*S36</b></dt>
|
||
|
|
<dd>Specifies the System/36 environment of SDA and displays the System/36 SDA main menu.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*S38</b></dt>
|
||
|
|
<dd>Specifies the System/38 view of SDA and displays the System/38 SDA main menu. The main menu will not appear if the OPTION parameter is specified.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRSDA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div>
|
||
|
|
<h3><a name="STRSDA.COMMAND.EXAMPLES">Examples</a></h3>None
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRSDA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="STRSDA.ERROR.MESSAGES">Error messages</a> </h3>
|
||
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>SDA0001</b></dt>
|
||
|
|
<dd>SDA does not support a &1 workstation.
|
||
|
|
</dd>
|
||
|
|
<dt><b>SDA0002</b></dt>
|
||
|
|
<dd>SDA cannot access its display file.
|
||
|
|
</dd>
|
||
|
|
<dt><b>SDA0003</b></dt>
|
||
|
|
<dd>SDA ended because of a serious error.
|
||
|
|
</dd>
|
||
|
|
<dt><b>SDA0004</b></dt>
|
||
|
|
<dd>Error while processing the STRSDA command.
|
||
|
|
</dd>
|
||
|
|
<dt><b>SDA0005</b></dt>
|
||
|
|
<dd>SDA cannot access its panel group.
|
||
|
|
</dd>
|
||
|
|
<dt><b>SDA0601</b></dt>
|
||
|
|
<dd>SDA is already active.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#STRSDA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</body>
|
||
|
|
</html>
|