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

253 lines
9.2 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 WSCST source (RTVWSCST)</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="RTVWSCST.Top_Of_Page"></a>
<h2>Retrieve WSCST source (RTVWSCST)</h2>
<table width="100%">
<tr>
<td valign="top" align="left"><b>Where allowed to run: </b>All environments (*ALL)<br>
<b>Threadsafe: </b>No
</td>
<td valign="top" align="right">
<a href="#RTVWSCST.PARAMETERS.TABLE">Parameters</a><br>
<a href="#RTVWSCST.COMMAND.EXAMPLES">Examples</a><br>
<a href="#RTVWSCST.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="RTVWSCST"></a>
<p>The Retrieve Work Station Customizing Object (RTVWSCST) command allows the user to retrieve a system-supplied set of table attributes for a given device type, keyboard language type, and keyboard type or a given manufacturer, type, and model of an ASCII printer into a source physical file member.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVWSCST.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="RTVWSCST.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="#RTVWSCST.DEVTYPE"><b>DEVTYPE</b></a></td>
<td valign="top">Device type</td>
<td valign="top">*TRANSFORM, 3101, 3151, 3161, 3162, 3163, 3164, 3179, 3180, 3196, 3197, 3476, 3477, 3486, 3487, 4019, 4201, 4202, 4207, 4208, 4216, 4224, 4234, 5204, 5251, 5291, 5292, 6252, D220, T910, T925, T955, V100, V220, W30, W50, W60</td>
<td valign="top">Required, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#RTVWSCST.KBDTYPE"><b>KBDTYPE</b></a></td>
<td valign="top">Keyboard language type</td>
<td valign="top">AGB, AGE, AGI, ALI, BGB, BLI, BLM, BRB, BRE, CAB, CAI, CAM, CLB, CSB, CYB, DMB, DME, DMI, FAB, FAE, FAI, FNB, FNE, FNI, FQB, FQI, GKB, GNB, HNB, ICB, ICE, ICI, INB, INI, ITB, ITE, IRB, ITI, JEB, JEI, JPB, KAB, MKB, NCB, NEB, NEE, NEI, NWB, NWE, NWI, PLB, PRB, PRE, PRI, RMB, ROB, RUB, SFI, SFM, SGI, SGM, SKB, SPB, SPE, SQB, SPI, SSB, SSE, SSI, SWB, SWE, SWI, THB, TKB, TRB, UKB, UKE, UKI, USB, USE, USI, YGI</td>
<td valign="top">Optional, Positional 2</td>
</tr>
<tr>
<td valign="top"><a href="#RTVWSCST.MFRTYPMDL"><b>MFRTYPMDL</b></a></td>
<td valign="top">Manufacturer type and model</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RTVWSCST.SRCMBR"><b>SRCMBR</b></a></td>
<td valign="top">Source member</td>
<td valign="top"><i>Name</i></td>
<td valign="top">Optional, Positional 3</td>
</tr>
<tr>
<td valign="top"><a href="#RTVWSCST.KBD"><b>KBD</b></a></td>
<td valign="top">Keyboard attached</td>
<td valign="top">*DATA5250, *TYPE5250, *DATA122, *TYPE122, *ENHANCED</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#RTVWSCST.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</td>
</tr>
<tr>
<td valign="top">Qualifier 1: Source file</td>
<td valign="top"><i>Name</i>, <b><u>QTXTSRC</u></b></td>
</tr><tr>
<td valign="top">Qualifier 2: Library</td>
<td valign="top"><i>Name</i>, *CURLIB, <b><u>*LIBL</u></b></td>
</tr><tr>
<td valign="top"><a href="#RTVWSCST.TEXT"><b>TEXT</b></a></td>
<td valign="top">Text 'description'</td>
<td valign="top"><i>Character value</i>, <b><u>*BLANK</u></b></td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#RTVWSCST.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="RTVWSCST.DEVTYPE"></a>
<h3>Device type (DEVTYPE)</h3>
<p>Specifies the device type.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b>*TRANSFORM</b></dt>
<dd>The SCS-to-ASCII host print transform function support is used by the ASCII printer.
</dd>
<dt><b><i>device-type</i></b></dt>
<dd>Specify the device type to be used. See the Workstation Customization Programming book for a list of allowed device types.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVWSCST.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVWSCST.KBDTYPE"></a>
<h3>Keyboard language type (KBDTYPE)</h3>
<p>Specifies the 3-character keyboard language identifier (used for EBCDIC and ASCII) for this display station.
</p>
<p>The possible value is:
</p>
<dl>
<dt><b><i>keyboard-language-type</i></b></dt>
<dd>Specify the 3-character country or region identifier (used for EBCDIC and ASCII) for this display station.
<p>See the <b>Keyboard language type</b> prompt (KBDTYPE parameter) on the Change Device Description (Display) (CHGDEVDSP) or the Create Device Description (Display) (CRTDEVDSP) in the CL Reference for a list of the valid identifiers and the language the identifier represents. The ASCII device groups (if applicable) are also shown for each language.
</p>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVWSCST.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVWSCST.MFRTYPMDL"></a>
<h3>Manufacturer type and model (MFRTYPMDL)</h3>
<p>Specifies the manufacturer, type, and model for an ASCII printer using host print transform function support. See the Create Device Description (Printer) (CRTDEVPRT) command in the CL Reference for a list of the supported manufacturers, types, and models for ASCII printers using host print transform function support.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVWSCST.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVWSCST.SRCMBR"></a>
<h3>Source member (SRCMBR)</h3>
<p>Specifies the name of the source file member to receive the retrieved table attributes.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVWSCST.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVWSCST.KBD"></a>
<h3>Keyboard attached (KBD)</h3>
<p>Specifies the keyboard type.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b>*DATA5250</b></dt>
<dd>A 5250 data entry keyboard is specified.
</dd>
<dt><b>*TYPE5250</b></dt>
<dd>A 5250 typewriter keyboard is specified.
</dd>
<dt><b>*DATA122</b></dt>
<dd>A 122 key data entry keyboard is specified.
</dd>
<dt><b>*TYPE122</b></dt>
<dd>A 122 key typewriter keyboard is specified.
</dd>
<dt><b>*ENHANCED</b></dt>
<dd>An enhanced keyboard is specified.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVWSCST.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVWSCST.SRCFILE"></a>
<h3>Source file (SRCFILE)</h3>
<p>Specifies the name of the source file in which a member is created to contain the retrieved table attributes. If the source file does not exist, it is created. The coded character set identifier for the source file is *HEX.
</p>
<p>The possible library values are:
</p>
<dl>
<dt><b><u>*LIBL</u></b></dt>
<dd>The library list is used to locate the source file.
</dd>
<dt><b>*CURLIB</b></dt>
<dd>The current library for the job is used to locate the source file. If no library is specified as the current library for the job, the QGPL library is used.
</dd>
<dt><b><i>library-name</i></b></dt>
<dd>Specify the name of the library where the source file is located.
</dd>
</dl>
<p>The possible values are:
</p>
<dl>
<dt><b><u>QTXTSRC</u></b></dt>
<dd>The IBM-supplied source file QTXTSRC is used.
</dd>
<dt><b><i>source-file-name</i></b></dt>
<dd>Specify the name of the source file.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVWSCST.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVWSCST.TEXT"></a>
<h3>Text 'description' (TEXT)</h3>
<p>Specifies the description of the created source physical file member.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*BLANK</u></b></dt>
<dd>Text is not specified.
</dd>
<dt><b><i>'description'</i></b></dt>
<dd>Specify a description for the source physical file member.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVWSCST.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="RTVWSCST.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
RTVWSCST DEVTYPE(5251) KBDTYPE(USB) SRCMBR(MYSOURCE)
KBD(*DATA5250) SRCFILE(MYLIB/QTXTSRC)
</pre>
</p>
<p>This command retrieves the system mapping tables for a 5251 twinaxial display with a 5250 data entry type keyboard attached using the U.S. basic language. The tables are stored in source member MYSOURCE in source file QTXTSRC in library MYLIB.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVWSCST.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="RTVWSCST.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF5D33</b></dt>
<dd>Request for system table failed. Reason code &amp;4.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVWSCST.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>