983 lines
44 KiB
HTML
983 lines
44 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>Override ICF Pgm Device Entry (OVRICFDEVE)</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="OVRICFDEVE.Top_Of_Page"></a>
|
||
|
|
<h2>Override ICF Pgm Device Entry (OVRICFDEVE)</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="#OVRICFDEVE.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
|
<a href="#OVRICFDEVE.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
|
<a href="#OVRICFDEVE.ERROR.MESSAGES">Error messages</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<div> <a name="OVRICFDEVE"></a>
|
||
|
|
<p>The Override with ICF Program Device Entry (OVRICFDEVE) command can be used to temporarily add the program device entry and the remote location name to the intersystem communications function (ICF) file, or to override a program device entry with the specified remote location name and attributes for an ICF file.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>Using this command does not cause a file to be overridden immediately. Information provided on this command is stored until the file is used, at which time the file is overridden.
|
||
|
|
</p>
|
||
|
|
<p>More information on how overrides processing is performed is in the Files and file systems topic in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter, the Application Display Programming book, SC41-5715, and the Basic Printing information in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#OVRICFDEVE.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
|
||
|
|
<div>
|
||
|
|
<h3><a name="OVRICFDEVE.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="#OVRICFDEVE.PGMDEV"><b>PGMDEV</b></a></td>
|
||
|
|
<td valign="top">Program device</td>
|
||
|
|
<td valign="top"><i>Character value</i></td>
|
||
|
|
<td valign="top">Required, Positional 1</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#OVRICFDEVE.RMTLOCNAME"><b>RMTLOCNAME</b></a></td>
|
||
|
|
<td valign="top">Remote location</td>
|
||
|
|
<td valign="top"><i>Communications name</i>, *REQUESTER</td>
|
||
|
|
<td valign="top">Optional, Positional 2</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#OVRICFDEVE.CMNTYPE"><b>CMNTYPE</b></a></td>
|
||
|
|
<td valign="top">Communication type</td>
|
||
|
|
<td valign="top"><b><u>*ALL</u></b>, *APPC, *ASYNC, *BSCEL, *FINANCE, *INTRA, *RETAIL, *SNUF</td>
|
||
|
|
<td valign="top">Optional, Positional 3</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#OVRICFDEVE.DEV"><b>DEV</b></a></td>
|
||
|
|
<td valign="top">Device</td>
|
||
|
|
<td valign="top"><i>Name</i>, *LOC</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#OVRICFDEVE.LCLLOCNAME"><b>LCLLOCNAME</b></a></td>
|
||
|
|
<td valign="top">Local location</td>
|
||
|
|
<td valign="top"><i>Communications name</i>, *LOC, *NETATR</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#OVRICFDEVE.MODE"><b>MODE</b></a></td>
|
||
|
|
<td valign="top">Mode</td>
|
||
|
|
<td valign="top"><i>Communications name</i>, *NETATR</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#OVRICFDEVE.RMTNETID"><b>RMTNETID</b></a></td>
|
||
|
|
<td valign="top">Remote network identifier</td>
|
||
|
|
<td valign="top"><i>Communications name</i>, *LOC, *NETATR, *NONE</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#OVRICFDEVE.FMTSLT"><b>FMTSLT</b></a></td>
|
||
|
|
<td valign="top">Format select</td>
|
||
|
|
<td valign="top">*PGM, *RECID, *RMTFMT</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#OVRICFDEVE.APPID"><b>APPID</b></a></td>
|
||
|
|
<td valign="top">Application identifier</td>
|
||
|
|
<td valign="top"><i>Name</i>, *DEVD, *USER</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#OVRICFDEVE.BATCH"><b>BATCH</b></a></td>
|
||
|
|
<td valign="top">Batch activity</td>
|
||
|
|
<td valign="top">*NO, *YES</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#OVRICFDEVE.HOST"><b>HOST</b></a></td>
|
||
|
|
<td valign="top">Host type</td>
|
||
|
|
<td valign="top">*DEVD, *CICS, *IMS, *IMSRTR</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#OVRICFDEVE.ENDSSNHOST"><b>ENDSSNHOST</b></a></td>
|
||
|
|
<td valign="top">End session with host</td>
|
||
|
|
<td valign="top">*RSHUTD, *TERMSELF</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#OVRICFDEVE.SPCHOSTAPP"><b>SPCHOSTAPP</b></a></td>
|
||
|
|
<td valign="top">Special host application</td>
|
||
|
|
<td valign="top">*DEVD, *NONE, *FLASH</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#OVRICFDEVE.INZSELF"><b>INZSELF</b></a></td>
|
||
|
|
<td valign="top">Initialize self</td>
|
||
|
|
<td valign="top">*NO, *YES</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#OVRICFDEVE.HDRPROC"><b>HDRPROC</b></a></td>
|
||
|
|
<td valign="top">Header processing</td>
|
||
|
|
<td valign="top">*SYS, *USER</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#OVRICFDEVE.MSGPTC"><b>MSGPTC</b></a></td>
|
||
|
|
<td valign="top">Message protection</td>
|
||
|
|
<td valign="top">*YES, *NO</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="3"><a href="#OVRICFDEVE.EMLDEV"><b>EMLDEV</b></a></td>
|
||
|
|
<td valign="top">Emulation device</td>
|
||
|
|
<td valign="top">Single values: *NONE<br>Other values: <i>Element list</i></td>
|
||
|
|
<td valign="top" rowspan="3">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 1: Device type</td>
|
||
|
|
<td valign="top">
|
||
|
|
3278, 3284, 3286, 3287, 3288, 3289</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 2: Data format</td>
|
||
|
|
<td valign="top">
|
||
|
|
<b><u>*UNFORMAT</u></b>, *FIELD, *NOFIELD, *EXTFIELD</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#OVRICFDEVE.CNVTYPE"><b>CNVTYPE</b></a></td>
|
||
|
|
<td valign="top">Conversation type</td>
|
||
|
|
<td valign="top">*SYS, *USER, *SRCPGM</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="3"><a href="#OVRICFDEVE.BLOCK"><b>BLOCK</b></a></td>
|
||
|
|
<td valign="top">Blocking type</td>
|
||
|
|
<td valign="top">Single values: *DEVD, *NONE, *ITB, *IRS, *NOSEP, *USER<br>Other values: <i>Element list</i></td>
|
||
|
|
<td valign="top" rowspan="3">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 1: Blocking type</td>
|
||
|
|
<td valign="top">
|
||
|
|
*SEP</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 2: Record separator, if *SEP</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Hexadecimal value</i>, <b><u>X'1E'</u></b></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#OVRICFDEVE.RCDLEN"><b>RCDLEN</b></a></td>
|
||
|
|
<td valign="top">Record length</td>
|
||
|
|
<td valign="top">1-32767, *DEVD</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#OVRICFDEVE.BLKLEN"><b>BLKLEN</b></a></td>
|
||
|
|
<td valign="top">Block length</td>
|
||
|
|
<td valign="top">1-32767, *DEVD</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#OVRICFDEVE.TRNSPY"><b>TRNSPY</b></a></td>
|
||
|
|
<td valign="top">Transmit in transparent mode</td>
|
||
|
|
<td valign="top">*DEVD, *NO, *YES</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#OVRICFDEVE.DTACPR"><b>DTACPR</b></a></td>
|
||
|
|
<td valign="top">Data compression</td>
|
||
|
|
<td valign="top">*DEVD, *NO, *YES</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#OVRICFDEVE.TRUNC"><b>TRUNC</b></a></td>
|
||
|
|
<td valign="top">Truncate trailing blanks</td>
|
||
|
|
<td valign="top">*DEVD, *NO, *YES</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#OVRICFDEVE.OVRFLWDTA"><b>OVRFLWDTA</b></a></td>
|
||
|
|
<td valign="top">Overflow data</td>
|
||
|
|
<td valign="top">*DISCARD, *RETAIN</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#OVRICFDEVE.GRPSEP"><b>GRPSEP</b></a></td>
|
||
|
|
<td valign="top">Group separator type</td>
|
||
|
|
<td valign="top">*DEVD, *EOT, *DEV3740, *OFCSYS</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#OVRICFDEVE.RMTBSCEL"><b>RMTBSCEL</b></a></td>
|
||
|
|
<td valign="top">Remote BSCEL</td>
|
||
|
|
<td valign="top">*DEVD, *NO, *YES</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#OVRICFDEVE.INLCNN"><b>INLCNN</b></a></td>
|
||
|
|
<td valign="top">Initial connection</td>
|
||
|
|
<td valign="top">*CTLD, *DIAL, *ANS</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#OVRICFDEVE.SECURE"><b>SECURE</b></a></td>
|
||
|
|
<td valign="top">Secure from other overrides</td>
|
||
|
|
<td valign="top"><b><u>*NO</u></b>, *YES</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#OVRICFDEVE.OVRSCOPE"><b>OVRSCOPE</b></a></td>
|
||
|
|
<td valign="top">Override scope</td>
|
||
|
|
<td valign="top"><b><u>*ACTGRPDFN</u></b>, *CALLLVL, *JOB</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#OVRICFDEVE.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<div> <a name="OVRICFDEVE.PGMDEV"></a>
|
||
|
|
<h3>Program device (PGMDEV)</h3>
|
||
|
|
<p>Specifies the program device name for an ICF file whose attributes are being overridden. The total number of devices that may be added to an ICF file is determined by the MAXPGMDEV parameter on the Create ICF File (CRTICFF) command or the Change ICF File (CHGICFF) command.
|
||
|
|
</p>
|
||
|
|
<p>This is a required parameter.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>character-value</i></b></dt>
|
||
|
|
<dd>Specify the name of the ICF program device entry with which the program communicates. This name is used in device-specific input/output operations to identify the program device and the session attributes. The program device name must be unique, although the same remote location name may be specified more than once. This allows more than one session to be at the same remote location, or to have different attribute values for each session at the same remote location. This program device name must be unique throughout the entries for the ICF file. If an override command is entered a second time for the same program device, then both (according to the override process rules) define the same program device entry.
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>Refer to the APPC Programming book, SC41-5443 for information on how the system uses the RMTLOCNAME, DEV, LCLLOCNAME, and RMTNETID parameters to select an APPC device description.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#OVRICFDEVE.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="OVRICFDEVE.RMTLOCNAME"></a>
|
||
|
|
<h3>Remote location (RMTLOCNAME)</h3>
|
||
|
|
<p>Specifies the remote location name with which your program communicates. A remote location must be specified using the Add ICF Program Device Entry (ADDICFDEVE) command or an applied program device override. If a remote location is not given, an escape message is sent when the program device is acquired.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>communications-name</i></b></dt>
|
||
|
|
<dd>Specify the name of the remote location with which your program communicates. The remote location does not need to exist at the time this command is run but must exist, either configured on the system or in the advanced peer-to-peer networking (APPN) network, for this remote location at the time the program acquires the program device. A given remote location may be added many times using different program device names. When running, however, only one program device name associated with each asynchronous (ASYNC), binary synchronous communications equivalence link (BSCEL), or system network architecture upline facility (SNUF) remote location may be acquired by the file at any one time. For each remote advanced program-to-program communication (APPC) location, more than one associated program device name may be acquired by the file at one time. For each SNUF remote location, there may be many devices. The system determines which device to use unless a device is specified on the <b>Device (DEV)</b> parameter.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*REQUESTER</b></dt>
|
||
|
|
<dd>The name used to refer to the communications device through which the program was started is used. The session that is assigned when the program device is acquired is the same session on which the Program Start request was received. If the program is not started as a result of a Program Start request, the acquire of the program device fails. The target program always uses *REQUESTER as the remote location name in the ICF file to connect to the session that the source program uses to send the Program Start request.
|
||
|
|
<p>*REQUESTER is valid only for a target communications job. If *REQUESTER is specified in any other type of job, an escape message is sent when the program device is acquired. When *REQUESTER is used in an acquire operation, the following parameters are ignored:
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>DEV
|
||
|
|
</li>
|
||
|
|
<li>LCLLOCNAME
|
||
|
|
</li>
|
||
|
|
<li>MODE
|
||
|
|
</li>
|
||
|
|
<li>RMTNETID
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#OVRICFDEVE.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="OVRICFDEVE.CMNTYPE"></a>
|
||
|
|
<h3>Communication type (CMNTYPE)</h3>
|
||
|
|
<p>Specifies the communications type of the ICF device. This parameter is used only for prompting purposes; it is ignored when the command is run. The value specified for this parameter determines the subset of other parameters that are displayed (prompted) for the user.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*ALL</u></b></dt>
|
||
|
|
<dd>All parameters appear in the interactive prompt.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*APPC</b></dt>
|
||
|
|
<dd>Only the APPC parameters appear in the interactive prompt.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ASYNC</b></dt>
|
||
|
|
<dd>Only the asynchronous parameters appear in the interactive prompt.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*BSCEL</b></dt>
|
||
|
|
<dd>Only the BSCEL parameters appear in the interactive prompt.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*FINANCE</b></dt>
|
||
|
|
<dd>Only the FINANCE parameters appear in the interactive prompt.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*RETAIL</b></dt>
|
||
|
|
<dd>Only the RETAIL parameters appear in the interactive prompt.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*INTRA</b></dt>
|
||
|
|
<dd>Only the INTRA parameters appear in the interactive prompt.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*SNUF</b></dt>
|
||
|
|
<dd>Only the SNUF parameters appear in the interactive prompt.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#OVRICFDEVE.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="OVRICFDEVE.DEV"></a>
|
||
|
|
<h3>Device (DEV)</h3>
|
||
|
|
<p>Specifies the communications device that is used in the remote location. This parameter applies to all communications types, but should be specified only for the APPC, INTRA, and SNUF communications types. If the device is not valid for the remote location, an escape message is sent when the program device is acquired. If the Add ICF Program Device Entry (ADDICFDEVE) command is not run for the specified program device and this parameter is not overridden, DEV(*LOC) is used.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*LOC</b></dt>
|
||
|
|
<dd>The device associated with the remote location is used. If several devices can be associated with the remote location, the system determines which device is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of the device with which your program communicates. The device name applies to all communications types, but it should be specified only for the APPC and SNUF communications types if you want to indicate a specific device for the remote location. If the device name is not valid for the remote location, an escape message is sent when the program device is acquired.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#OVRICFDEVE.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="OVRICFDEVE.LCLLOCNAME"></a>
|
||
|
|
<h3>Local location (LCLLOCNAME)</h3>
|
||
|
|
<p>Specifies the name of your location. This parameter applies to the APPC communications type only. If the Add ICF Program Device Entry (ADDICFDEVE) command is not run for the specified program device and this parameter is not overridden, LCLLOCNAME(*LOC) is used.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*LOC</b></dt>
|
||
|
|
<dd>The local location name associated with the remote location name is used.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*NETATR</b></dt>
|
||
|
|
<dd>The LCLLOCNAME value specified in the system network attributes is used.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>communications-name</i></b></dt>
|
||
|
|
<dd>Specify the name of your location. The local location name is specified only in APPC if you want to indicate a specific local location name for the remote location. If the local location name is not valid for the remote location or remote location and device, an escape message is sent when the program device is acquired.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#OVRICFDEVE.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="OVRICFDEVE.MODE"></a>
|
||
|
|
<h3>Mode (MODE)</h3>
|
||
|
|
<p>Specifies the mode name used. This parameter applies only to the APPC communications type. If the Add ICF Program Device Entry (ADDICFDEVE) command is not run for the specified program device and this parameter is not overridden, MODE(*NETATR) is used.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*NETATR</b></dt>
|
||
|
|
<dd>The mode in the network attributes is used.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*BLANK.</b></dt>
|
||
|
|
<dd>The mode name consisting of 8 blanks characters is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>communications-name</i></b></dt>
|
||
|
|
<dd>Specify a mode name for the APPC communications device. If the mode is not valid for any combination of remote location device, local location, and remote network ID, an escape message is sent when the program device is acquired.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#OVRICFDEVE.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="OVRICFDEVE.RMTNETID"></a>
|
||
|
|
<h3>Remote network identifier (RMTNETID)</h3>
|
||
|
|
<p>Specifies the remote network ID that is used with the remote location. This parameter applies to the APPC communications type only. If the Add ICF Program Device Entry (ADDICFDEVE) command is not run for the specified program device and this parameter is not overridden, RMTNETID(*LOC) is used.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*LOC</b></dt>
|
||
|
|
<dd>Any remote network ID for the remote location may be used. If several remote network IDs are associated with the remote location, the system automatically selects the remote network ID.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*NETATR</b></dt>
|
||
|
|
<dd>The remote network identifier specified in the network attributes is used.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*NONE</b></dt>
|
||
|
|
<dd>No remote network identifier is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>communications-name</i></b></dt>
|
||
|
|
<dd>Specify a remote network ID for the APPC communications device.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#OVRICFDEVE.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="OVRICFDEVE.FMTSLT"></a>
|
||
|
|
<h3>Format select (FMTSLT)</h3>
|
||
|
|
<p>Specifies the record format selection that is used for input operations. If the Add ICF Program Device Entry (ADDICFDEVE) command is not run for the specified program device, and this parameter is not overridden, FMTSLT(*PGM) is used.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*PGM</u></b></dt>
|
||
|
|
<dd>The program determines record format selections. If an input (read) operation with a record format name is specified, that format is always selected. If a record format is not specified for the input operation, the default format (the first record format in the file) is always selected.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b></b></dt>
|
||
|
|
<dd>This also means that if there are any record identification keywords specified in the data description specifications (DDS) for the file, or if any remote formats are received, they are not taken into consideration when the record is selected.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*RECID</b></dt>
|
||
|
|
<dd>The record identification keywords specified in the DDS for the file are used to do record selection. If there are no record identification keywords in the file, an error message is sent, the acquire operation of the program device ends, and the device is not acquired.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*RMTFMT</b></dt>
|
||
|
|
<dd>The remote format names received from the sending system are used to do record selection. If the device is not an APPC device and *RMTFMT is specified, a run time error occurs at the time the program device is acquired.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#OVRICFDEVE.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="OVRICFDEVE.APPID"></a>
|
||
|
|
<h3>Application identifier (APPID)</h3>
|
||
|
|
<p>Specifies (in characters) the VTAM identifier of the Customer Information Control System for Virtual Storage (CICS/VS) or Information Management System/Virtual Storage (IMS/VS) host subsystem sent with the sign-on message. This parameter applies to SNUF devices only. If the ADDICFDEVE command is not run for the specified program device and this parameter is not overridden, APPID(*DEVD) is used.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*DEVD</b></dt>
|
||
|
|
<dd>The application identifier specified in the device description is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*USER</b></dt>
|
||
|
|
<dd>The application program can send messages or a sign-on to the host. This is valid only when using the 3270 program interface.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the application identifier that is sent with the sign-on message.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#OVRICFDEVE.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="OVRICFDEVE.BATCH"></a>
|
||
|
|
<h3>Batch activity (BATCH)</h3>
|
||
|
|
<p>Specifies, for CICS/VS and IMS/VS, whether this session is used for batch jobs. This parameter applies to SNUF, Retail, and INTRA devices only. If the ADDICFDEVE command is not run for the specified program device and this parameter is not overridden, BATCH(*NO) is used.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*NO</b></dt>
|
||
|
|
<dd>Batch jobs do not occur.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*YES</b></dt>
|
||
|
|
<dd>Batch jobs occur and SNUF does not assemble physical records into logical records. If *YES is specified, *NO must also be specified on the <b>Message protection (MSGPTC)</b> parameter.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#OVRICFDEVE.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="OVRICFDEVE.HOST"></a>
|
||
|
|
<h3>Host type (HOST)</h3>
|
||
|
|
<p>Specifies the host or remote subsystem with which this session communicates. This parameter applies to SNUF devices only. If the ADDICFDEVE command is not run for the specified program device and this parameter is not overridden, HOST(*DEVD) is used.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*DEVD</b></dt>
|
||
|
|
<dd>The host system specified in the device description is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*CICS</b></dt>
|
||
|
|
<dd>The session communicates with CICS/VS.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*IMS</b></dt>
|
||
|
|
<dd>The session communicates with IMS/VS.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*IMSRTR</b></dt>
|
||
|
|
<dd>The session communicates with IMS/VS using the ready-to-receive option.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#OVRICFDEVE.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="OVRICFDEVE.ENDSSNHOST"></a>
|
||
|
|
<h3>End session with host (ENDSSNHOST)</h3>
|
||
|
|
<p>Specifies how the SNA upline facility (SNUF) ends the session with the host.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*RSHUTD</b></dt>
|
||
|
|
<dd>SNUF sends a request for a turn off command to the host.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*TERMSELF</b></dt>
|
||
|
|
<dd>SNUF sends an end-session command to the host. This value may have to be used if the value *RSHUTD fails to end a session with a non-IBM host.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#OVRICFDEVE.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="OVRICFDEVE.SPCHOSTAPP"></a>
|
||
|
|
<h3>Special host application (SPCHOSTAPP)</h3>
|
||
|
|
<p>Specifies whether SNUF customizes support for special host applications outside the CICS or IMS application layer.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*DEVD</u></b></dt>
|
||
|
|
<dd>The special host application specified in the device description is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NONE</b></dt>
|
||
|
|
<dd>SNUF does not customize support for special host applications.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*FLASH</b></dt>
|
||
|
|
<dd>SNUF customizes support for the Federal Reserve Flash application.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#OVRICFDEVE.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="OVRICFDEVE.INZSELF"></a>
|
||
|
|
<h3>Initialize self (INZSELF)</h3>
|
||
|
|
<p>Specifies whether a formatted INIT-SELF is built in place of the unformatted sign-on normally sent by SNUF to the host.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*NO</b></dt>
|
||
|
|
<dd>The unformatted default sign-on provided by SNUF is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*YES</b></dt>
|
||
|
|
<dd>The formatted INIT-SELF provided by SNUF is used.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#OVRICFDEVE.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="OVRICFDEVE.HDRPROC"></a>
|
||
|
|
<h3>Header processing (HDRPROC)</h3>
|
||
|
|
<p>Specifies, for both Customer Information Control System for Virtual Storage (CICS/VS) and Information Management System for Virtual Storage (IMS/VS), whether received function management headers are passed to the application program. This parameter applies to the SNA upline facility (SNUF) communications type only. If the ADDICFDEVE command is not run for the specified program device and this parameter is not overridden, HDRPROC(*SYS) is used.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*SYS</b></dt>
|
||
|
|
<dd>SNUF removes function management headers before passing data to the program.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*USER</b></dt>
|
||
|
|
<dd>Function management headers are passed.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#OVRICFDEVE.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="OVRICFDEVE.MSGPTC"></a>
|
||
|
|
<h3>Message protection (MSGPTC)</h3>
|
||
|
|
<p>Specifies, for both CICS/VS and IMS/VS, whether message protection is used for this session. This parameter applies to the SNUF communications type only. If the ADDICFDEVE command is not run for the specified program device, MSGPTC(*YES) is used.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*YES</b></dt>
|
||
|
|
<dd>Message protection is used. SNUF saves messages until they are responded to and tries to resynchronize if errors occur. *YES is valid only when *NO is also specified in the <b>Batch activity (BATCH)</b> parameter.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NO</b></dt>
|
||
|
|
<dd>Message protection is not used.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#OVRICFDEVE.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="OVRICFDEVE.EMLDEV"></a>
|
||
|
|
<h3>Emulation device (EMLDEV)</h3>
|
||
|
|
<p>Specifies that this program device entry is used to send and receive 3270 data streams. The emulation device parameter consists of an emulation device type and an emulation device data format. The emulation device data format specifies the format of the type 3270 data stream being sent or received. A 20- or 32-byte common header that contains type 3270 command and data flow information is located at the start of the I/O buffer that is sending or receiving the type 3270 data stream. This parameter applies only to SNUF communications. This parameter can be specified as a list of two values (elements) or as a single value (*NONE).
|
||
|
|
</p>
|
||
|
|
<p><b>Single values</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*NONE</b></dt>
|
||
|
|
<dd>This program device entry is not used to send and receive 3270 data streams.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 1: Device type</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>3278</b></dt>
|
||
|
|
<dd>The data stream is for a 3278, 3277, or 3279 display device.
|
||
|
|
</dd>
|
||
|
|
<dt><b>3284</b></dt>
|
||
|
|
<dd>The data stream is for a 3284 printer device.
|
||
|
|
</dd>
|
||
|
|
<dt><b>3286</b></dt>
|
||
|
|
<dd>The data stream is for a 3286 printer device.
|
||
|
|
</dd>
|
||
|
|
<dt><b>3287</b></dt>
|
||
|
|
<dd>The data stream is for a 3287 printer device.
|
||
|
|
</dd>
|
||
|
|
<dt><b>3288</b></dt>
|
||
|
|
<dd>The data stream is for a 3288 printer device.
|
||
|
|
</dd>
|
||
|
|
<dt><b>3289</b></dt>
|
||
|
|
<dd>The data stream is for a 3289 printer device.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 2: Data format</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*UNFORMAT</u></b></dt>
|
||
|
|
<dd>An unformatted 3270 data stream is sent or received. The user application program must translate the data stream into a display or printer image.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*FIELD</b></dt>
|
||
|
|
<dd>A formatted 3270 data stream is sent or received. The formatted 3270 data stream contains a display or printer image that contains field definitions. The field definitions indicate the location and characteristics of the fields. *FIELD is valid only if *NO is specified on the BATCH parameter.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NOFIELD</b></dt>
|
||
|
|
<dd>A formatted 3270 data stream is sent or received. The formatted 3270 data stream contains a display or printer image without field definitions. *NOFIELD is valid only if *NO is specified on the BATCH parameter.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*EXTFIELD</b></dt>
|
||
|
|
<dd>A formatted 3270 data stream is sent or received. The formatted 3270 data stream contains a display image followed by field definitions. The field definitions indicate the location and characteristics of fields. *EXTFIELD is valid only if *NO is specified on the BATCH parameter and 3278 is specified as the emulation device type.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#OVRICFDEVE.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="OVRICFDEVE.CNVTYPE"></a>
|
||
|
|
<h3>Conversation type (CNVTYPE)</h3>
|
||
|
|
<p>Specifies the conversation type for which the application program is designed. This parameter is valid for advanced program-to-program communications (APPC) communications types only. If the ADDICFDEVE command is not run for the specified program device and this parameter is not overridden, CNVTYPE(*SYS) is used. More information on the APPC communications type can be found in the APPC Programming book, SC41-5443.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*SYS</b></dt>
|
||
|
|
<dd>The APPC mapped conversation support for the LU 6.2 architecture is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*USER</b></dt>
|
||
|
|
<dd>The APPC basic conversation support for the LU 6.2 architecture is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*SRCPGM</b></dt>
|
||
|
|
<dd>The target program accepts the conversation type specified by the source program.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#OVRICFDEVE.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="OVRICFDEVE.BLOCK"></a>
|
||
|
|
<h3>Blocking type (BLOCK)</h3>
|
||
|
|
<p>Specifies whether the system or the user controls whether records are combined into blocks when they are sent. This parameter is for the BSCEL communications type. If the ADDICFDEVE command is not run for the specified program device and this parameter is not overridden, BLOCK(*DEVD) is used.
|
||
|
|
</p>
|
||
|
|
<p>With this parameter, you may specify one of the following conditions of record formatting:
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>No blocking or deblocking: The record format described in the DDS is the format for both the record and the block.
|
||
|
|
</li>
|
||
|
|
<li>User blocking or deblocking: Specify the BSCEL controls needed to describe the record format of the system.
|
||
|
|
</li>
|
||
|
|
<li>System blocking with record separator characters: Specify the record separator character used by the system to determine record boundaries in the block.
|
||
|
|
</li>
|
||
|
|
<li>System blocking of fixed-length records: The system uses fixed-length records, and blocks or deblocks records accordingly.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
<p>If you specify a parameter value other than *NONE or *USER, records are blocked as required by the system for output, and are deblocked on input.
|
||
|
|
</p>
|
||
|
|
<p><b>Single values</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*DEVD</b></dt>
|
||
|
|
<dd>The block option in the device description is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NONE</b></dt>
|
||
|
|
<dd>Blocking or deblocking is not done by the system.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ITB</b></dt>
|
||
|
|
<dd>The records are blocked or deblocked based on the location of an intermediate text block (ITB) control character. For input files, a record is delimited by locating the next intermediate text block character. An end-of-text or end-of-transmission block character is used as an intermediate text block character to delimit a block. For output files, an ITB character is added after the record. If it is the last character of the block, the ITB is replaced by an end-of-text or end-of-transmission block character.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*IRS</b></dt>
|
||
|
|
<dd>The records are blocked or deblocked based on the location of an interrecord separator (IRS) character. For input files, a record is delimited by locating the next IRS character. For output files, an IRS character is added after the record.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NOSEP</b></dt>
|
||
|
|
<dd>No record separator character is contained in the block that is sent to or received from the device. The system blocks and deblocks the records using a fixed-length record, as specified in the DDS format specifications.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*USER</b></dt>
|
||
|
|
<dd>The program gives all control characters, including record separator characters, BSCEL framing characters, transparency characters, and so forth, necessary to send records.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 1: Blocking type</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*SEP</b></dt>
|
||
|
|
<dd>The records are blocked or deblocked based on the location of a user-specified record separator character. For input files, a record is delimited by locating the next record separator character. For output files, a record separator character is added after the record.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 2: Record separator, if *SEP</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>X'1E'</u></b></dt>
|
||
|
|
<dd>The record separator character X'1E' is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>hexadecimal-value</i></b></dt>
|
||
|
|
<dd>Specify a record separator character that is unique and has a length of 1 byte. The record separator character may be specified as 2 hexadecimal characters, as in BLOCK(*SEP X'FD'), or the character may be specified as a single character, as in BLOCK(*SEP @).
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#OVRICFDEVE.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="OVRICFDEVE.RCDLEN"></a>
|
||
|
|
<h3>Record length (RCDLEN)</h3>
|
||
|
|
<p>Specifies the maximum record length (in bytes) for data sent and received. This parameter applies to the SNUF and BSCEL communications types only. If the ADDICFDEVE command is not run for the specified program device and this parameter is not overridden, RCDLEN(*DEVD) is used.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*DEVD</b></dt>
|
||
|
|
<dd>The record length specified in the device description is used. If a record is longer than the specified record length, a run time error occurs at the time the record is sent or received.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>1-32767</i></b></dt>
|
||
|
|
<dd>Specify the maximum record length to use for this device file. The value must be at least the size of the largest record sent. If a record is longer than the specified record length, a run time error occurs when the record is sent or received. Valid values range from 1 through 32767 for SNUF communication. For BSCEL communication, the maximum record length is 8192 bytes.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#OVRICFDEVE.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="OVRICFDEVE.BLKLEN"></a>
|
||
|
|
<h3>Block length (BLKLEN)</h3>
|
||
|
|
<p>Specifies the maximum block length (in bytes) for data sent. This parameter applies to the BSCEL and SNUF communications types only. If the Add ICF Program Device Entry (ADDICFDEVE) command is not run for the specified program device, or is not overridden, this parameter defaults to *DEVD.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*DEVD</b></dt>
|
||
|
|
<dd>The block length specified in the device description is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>1-32767</i></b></dt>
|
||
|
|
<dd>Specify the maximum block length of records sent when this device file is used. The value must be at least the size of the largest record sent. Valid values range from 1 to 32767 for SNUF communication. For BSCEL communication, the maximum block length is 8192 bytes.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#OVRICFDEVE.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="OVRICFDEVE.TRNSPY"></a>
|
||
|
|
<h3>Transmit in transparent mode (TRNSPY)</h3>
|
||
|
|
<p>Specifies whether text is sent in transparent text mode. Transparent text mode allows all 256 extended binary-coded decimal interchange code (EBCDIC) character codes to be sent. Use this feature when sending packed or binary data fields. This parameter is for the BSCEL communications type only. If the ADDICFDEVE command is not run for the specified program device and this parameter is not overridden, TRNSPY(*DEVD) is used.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*DEVD</b></dt>
|
||
|
|
<dd>The text transparency option specified in the device description is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NO</b></dt>
|
||
|
|
<dd>Text transparency is not used.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*YES</b></dt>
|
||
|
|
<dd>Text transparency is used, which allows all 256 EBCDIC character codes to be sent. *YES is valid only when *NONE, *NOSEP, or *USER is specified in the <b>Blocking type (BLOCK)</b> parameter.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#OVRICFDEVE.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="OVRICFDEVE.DTACPR"></a>
|
||
|
|
<h3>Data compression (DTACPR)</h3>
|
||
|
|
<p>Specifies whether blanks in BSCEL data are compressed for output and decompressed for input. *YES cannot be specified if *YES is specified in the <b>Transmit in transparent mode (TRNSPY)</b> parameter. This parameter is for the BSCEL communications type only. If the ADDICFDEVE command is not run for the specified program device and this parameter is not overridden, DTACPR(*DEVD) is used.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*DEVD</b></dt>
|
||
|
|
<dd>The data compression option specified in the device description is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NO</b></dt>
|
||
|
|
<dd>No data compression or decompression occurs.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*YES</b></dt>
|
||
|
|
<dd>Data is compressed for output and decompressed for input.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#OVRICFDEVE.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="OVRICFDEVE.TRUNC"></a>
|
||
|
|
<h3>Truncate trailing blanks (TRUNC)</h3>
|
||
|
|
<p>Specifies whether trailing blanks are removed from output records. *YES cannot be specified if *NOSEP is specified in the <b>Blocking type (BLOCK)</b> parameter. If *YES is specified and *YES is also specified in the <b>Data compression (DTACPR)</b> parameter, then truncation is ignored. This parameter is for BSCEL communications type only. If the ADDICFDEVE command is not run for the specified program device and this parameter is not overridden, DTACPR(*DEVD) is used.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*DEVD</b></dt>
|
||
|
|
<dd>The trailing blanks specified in the device description are used.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NO</b></dt>
|
||
|
|
<dd>Trailing blanks are not removed from output records.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*YES</b></dt>
|
||
|
|
<dd>Trailing blanks are removed from output records.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#OVRICFDEVE.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="OVRICFDEVE.OVRFLWDTA"></a>
|
||
|
|
<h3>Overflow data (OVRFLWDTA)</h3>
|
||
|
|
<p>Specifies whether overflow data is discarded or kept.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*DISCARD</b></dt>
|
||
|
|
<dd>Overflow data is not kept.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*RETAIN</b></dt>
|
||
|
|
<dd>Overflow data is kept.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#OVRICFDEVE.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="OVRICFDEVE.GRPSEP"></a>
|
||
|
|
<h3>Group separator type (GRPSEP)</h3>
|
||
|
|
<p>Specifies a separator for groups of data, such as data sets and documents. This parameter is for the BSCEL communications type only. If the ADDICFDEVE command is not run for the specified program device and this parameter is not overridden, GRPSEP(*DEVD) is used.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*DEVD</b></dt>
|
||
|
|
<dd>The group separator option specified in the device description is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*EOT</b></dt>
|
||
|
|
<dd>The BSCEL control character EOT (end-of-transmission) is used as a data group separator.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*DEV3740</b></dt>
|
||
|
|
<dd>A null record (STXETX) is used as a data group separator.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*OFCSYS</b></dt>
|
||
|
|
<dd>A block sent with the BSCEL control character ETX (end-of-information) is used as a data group separator.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#OVRICFDEVE.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="OVRICFDEVE.RMTBSCEL"></a>
|
||
|
|
<h3>Remote BSCEL (RMTBSCEL)</h3>
|
||
|
|
<p>Specifies whether the type of BSCEL session is with a BSCEL system. This parameter applies to the BSCEL communications type only. If the ADDICFDEVE command is not run for the specified program device and this parameter is not overridden, RMTBSCEL(*DEVD) is used.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*DEVD</b></dt>
|
||
|
|
<dd>The option for BSCEL specified in the device description is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NO</b></dt>
|
||
|
|
<dd>An attribute of *NO indicates the remote system cannot recognize BSCEL commands or messages. In most cases, *NO is used when communicating with remote systems such as a 3741 Data Entry Station, an Office System 6, a 5230 Data Collection System, or a System/38.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*YES</b></dt>
|
||
|
|
<dd>The remote system can recognize the BSCEL transaction starting commands, transaction ending commands, and online messages. In most cases, *YES indicates that the remote system is either another iSeries computer, AS/400 system, a System/38, a System/36, or a System/34 with BSCEL support.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#OVRICFDEVE.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="OVRICFDEVE.INLCNN"></a>
|
||
|
|
<h3>Initial connection (INLCNN)</h3>
|
||
|
|
<p>Specifies the method of making a connection on the line for the session being acquired. This parameter is valid for the BSCEL communications type only. If the Add ICF Program Device Entry (ADDICFDEVE) command is not run for the specified program device, or is not overridden, this parameter defaults to *CTLD.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*CTLD</b></dt>
|
||
|
|
<dd>The initial connection option specified in the controller description is used.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*DIAL</b></dt>
|
||
|
|
<dd>The local system starts the call.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*ANS</b></dt>
|
||
|
|
<dd>The remote system starts the call, and the local system answers the call.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#OVRICFDEVE.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="OVRICFDEVE.SECURE"></a>
|
||
|
|
<h3>Secure from other overrides (SECURE)</h3>
|
||
|
|
<p>Specifies whether this program device is protected from the effects of override commands issued in earlier programs.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NO</u></b></dt>
|
||
|
|
<dd>This program device override is not protected from other program device overrides. Its values can be overridden by the effects of any program device override commands issued in earlier programs.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*YES</b></dt>
|
||
|
|
<dd>This program device override is protected from the effects of any program device override commands issued in earlier programs.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#OVRICFDEVE.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="OVRICFDEVE.OVRSCOPE"></a>
|
||
|
|
<h3>Override scope (OVRSCOPE)</h3>
|
||
|
|
<p>Specifies the extent of influence (scope) of the override.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*ACTGRPDFN</u></b></dt>
|
||
|
|
<dd>The scope of the override is determined by the activation group of the program that calls this command. When the activation group is the default activation group, the scope equals the call level of the calling program. When the activation group is not the default activation group, the scope equals the activation group of the calling program.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*CALLLVL</b></dt>
|
||
|
|
<dd>The scope of the override is determined by the current call level. All open operations done at a call level that is the same as or higher than the current call level are influenced by this override.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*JOB</b></dt>
|
||
|
|
<dd>The scope of the override is the job in which the override occurs.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#OVRICFDEVE.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="OVRICFDEVE.COMMAND.EXAMPLES">Examples</a> </h3>
|
||
|
|
<p><b>Example 1: Overriding the Device Entry with the Record Format Selection Attributes</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
OVRICFDEVE PGMDEV(BSCEL2) RMTLOCNAME(BSCNYC)
|
||
|
|
FMTSLT(*RECID)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command overrides the program device named BSCEL2 with a corresponding remote location named BSCNYC for any ICF file associated with the job. The program device is overridden with the attributes of FMTSLT(*RECID).
|
||
|
|
</p>
|
||
|
|
<p><b>Example 2: Overriding the Device Entry with the Record Format Selection and the Conversation Type Attributes</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
OVRICFDEVE PGMDEV(APPC1) RMTLOCNAME(*REQUESTER)
|
||
|
|
FMTSLT(*RMTFMT) CNVTYPE(*SYS)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command overrides the program device entry named APPC1 with a remote location name of *REQUESTER. The program device entry is overridden with the FMTSLT(*RMTFMT) and CNVTYPE(*SYS) attributes.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 3: Overriding an Entry for Associated ICF Files</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
OVRICFDEVE PGMDEV(JOE) RMTLOCNAME(LU0MPLS)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command overrides the program device entry named JOE with a remote location named LU0MPLS for any ICF file associated with the job.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 4: Specifying the Communications Device</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
OVRICFDEVE PGMDEV(APPC) RMTLOCNAME(APPCMPLS) DEV(MPLSLINE2)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command overrides the program device entry named APPC with a remote location named APPCMPLS using device MPLSLINE2.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#OVRICFDEVE.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="OVRICFDEVE.ERROR.MESSAGES">Error messages</a> </h3>
|
||
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>CPF180C</b></dt>
|
||
|
|
<dd>Function &1 not allowed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF1892</b></dt>
|
||
|
|
<dd>Function &1 not allowed.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#OVRICFDEVE.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</body>
|
||
|
|
</html>
|