992 lines
42 KiB
HTML
992 lines
42 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>Add ICF Device Entry (ADDICFDEVE)</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="ADDICFDEVE.Top_Of_Page"></a>
|
|
<h2>Add ICF Device Entry (ADDICFDEVE)</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="#ADDICFDEVE.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#ADDICFDEVE.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#ADDICFDEVE.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="ADDICFDEVE"></a>
|
|
<p>The Add Intersystem Communications Function Device Entry (ADDICFDEVE) command adds a program device entry to the specified intersystem communications function (ICF) file.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDICFDEVE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="ADDICFDEVE.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" rowspan="3"><a href="#ADDICFDEVE.FILE"><b>FILE</b></a></td>
|
|
<td valign="top">File</td>
|
|
<td valign="top"><i>Qualified object name</i></td>
|
|
<td valign="top" rowspan="3">Required, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: File</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 2: Library</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB</td>
|
|
</tr><tr>
|
|
<td valign="top"><a href="#ADDICFDEVE.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 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ADDICFDEVE.RMTLOCNAME"><b>RMTLOCNAME</b></a></td>
|
|
<td valign="top">Remote location</td>
|
|
<td valign="top"><i>Communications name</i>, *REQUESTER</td>
|
|
<td valign="top">Required, Positional 3</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ADDICFDEVE.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 4</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ADDICFDEVE.DEV"><b>DEV</b></a></td>
|
|
<td valign="top">Device</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*LOC</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ADDICFDEVE.LCLLOCNAME"><b>LCLLOCNAME</b></a></td>
|
|
<td valign="top">Local location</td>
|
|
<td valign="top"><i>Communications name</i>, <b><u>*LOC</u></b>, *NETATR</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ADDICFDEVE.MODE"><b>MODE</b></a></td>
|
|
<td valign="top">Mode</td>
|
|
<td valign="top"><i>Communications name</i>, <b><u>*NETATR</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ADDICFDEVE.RMTNETID"><b>RMTNETID</b></a></td>
|
|
<td valign="top">Remote network identifier</td>
|
|
<td valign="top"><i>Communications name</i>, <b><u>*LOC</u></b>, *NETATR, *NONE</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ADDICFDEVE.FMTSLT"><b>FMTSLT</b></a></td>
|
|
<td valign="top">Format select</td>
|
|
<td valign="top"><b><u>*PGM</u></b>, *RECID, *RMTFMT</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ADDICFDEVE.APPID"><b>APPID</b></a></td>
|
|
<td valign="top">Application identifier</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*DEVD</u></b>, *USER</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ADDICFDEVE.BATCH"><b>BATCH</b></a></td>
|
|
<td valign="top">Batch activity</td>
|
|
<td valign="top">*YES, <b><u>*NO</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ADDICFDEVE.HOST"><b>HOST</b></a></td>
|
|
<td valign="top">Host type</td>
|
|
<td valign="top"><b><u>*DEVD</u></b>, *CICS, *IMS, *IMSRTR</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ADDICFDEVE.ENDSSNHOST"><b>ENDSSNHOST</b></a></td>
|
|
<td valign="top">End session with host</td>
|
|
<td valign="top"><b><u>*RSHUTD</u></b>, *TERMSELF</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ADDICFDEVE.SPCHOSTAPP"><b>SPCHOSTAPP</b></a></td>
|
|
<td valign="top">Special host application</td>
|
|
<td valign="top"><b><u>*DEVD</u></b>, *NONE, *FLASH</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ADDICFDEVE.INZSELF"><b>INZSELF</b></a></td>
|
|
<td valign="top">Initialize self</td>
|
|
<td valign="top"><b><u>*NO</u></b>, *YES</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ADDICFDEVE.HDRPROC"><b>HDRPROC</b></a></td>
|
|
<td valign="top">Header processing</td>
|
|
<td valign="top"><b><u>*SYS</u></b>, *USER</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ADDICFDEVE.MSGPTC"><b>MSGPTC</b></a></td>
|
|
<td valign="top">Message protection</td>
|
|
<td valign="top"><b><u>*YES</u></b>, *NO</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#ADDICFDEVE.EMLDEV"><b>EMLDEV</b></a></td>
|
|
<td valign="top">Emulation device</td>
|
|
<td valign="top">Single values: <b><u>*NONE</u></b><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, *EXTFIELD, *NOFIELD</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ADDICFDEVE.CNVTYPE"><b>CNVTYPE</b></a></td>
|
|
<td valign="top">Conversation type</td>
|
|
<td valign="top"><b><u>*SYS</u></b>, *USER, *SRCPGM</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#ADDICFDEVE.BLOCK"><b>BLOCK</b></a></td>
|
|
<td valign="top">Blocking type</td>
|
|
<td valign="top"><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">
|
|
<b><u>*DEVD</u></b>, *NONE, *ITB, *IRS, *NOSEP, *USER, *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="#ADDICFDEVE.RCDLEN"><b>RCDLEN</b></a></td>
|
|
<td valign="top">Record length</td>
|
|
<td valign="top">1-32767, <b><u>*DEVD</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ADDICFDEVE.BLKLEN"><b>BLKLEN</b></a></td>
|
|
<td valign="top">Block length</td>
|
|
<td valign="top">1-32767, <b><u>*DEVD</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ADDICFDEVE.TRNSPY"><b>TRNSPY</b></a></td>
|
|
<td valign="top">Transmit in transparent mode</td>
|
|
<td valign="top"><b><u>*DEVD</u></b>, *NO, *YES</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ADDICFDEVE.DTACPR"><b>DTACPR</b></a></td>
|
|
<td valign="top">Compress and decompress data</td>
|
|
<td valign="top"><b><u>*DEVD</u></b>, *NO, *YES</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ADDICFDEVE.TRUNC"><b>TRUNC</b></a></td>
|
|
<td valign="top">Truncate trailing blanks</td>
|
|
<td valign="top"><b><u>*DEVD</u></b>, *NO, *YES</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ADDICFDEVE.OVRFLWDTA"><b>OVRFLWDTA</b></a></td>
|
|
<td valign="top">Overflow data</td>
|
|
<td valign="top"><b><u>*DISCARD</u></b>, *RETAIN</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ADDICFDEVE.GRPSEP"><b>GRPSEP</b></a></td>
|
|
<td valign="top">Group separator type</td>
|
|
<td valign="top"><b><u>*DEVD</u></b>, *EOT, *DEV3740, *OFCSYS</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ADDICFDEVE.RMTBSCEL"><b>RMTBSCEL</b></a></td>
|
|
<td valign="top">Remote BSCEL</td>
|
|
<td valign="top"><b><u>*DEVD</u></b>, *NO, *YES</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ADDICFDEVE.INLCNN"><b>INLCNN</b></a></td>
|
|
<td valign="top">Initial connection</td>
|
|
<td valign="top"><b><u>*CTLD</u></b>, *DIAL, *ANS</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDICFDEVE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="ADDICFDEVE.FILE"></a>
|
|
<h3>File (FILE)</h3>
|
|
<p>Specifies the intersystem communications function (ICF) file to which the ICF program device entry is to be added.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<p><b>Qualifier 1: File</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the ICF file.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 2: Library</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LIBL</u></b></dt>
|
|
<dd>All libraries in the library list for the current thread are searched until the first match is found.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*CURLIB</b></dt>
|
|
<dd>The current library is used to locate the ICF file. If no library is specified as the current library for the job, QGPL is used.
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the library where the ICF file is located.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDICFDEVE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDICFDEVE.PGMDEV"></a>
|
|
<h3>Program device (PGMDEV)</h3>
|
|
<p>Specifies the name by which the ICF program device entry being added is known. The total number of program device entries that may be added to an ICF file (as specified on the ADDICFDEVE or OVRICFDEVE command) is determined by the <b>Maximum program devices (MAXPGMDEV)</b> parameter on the Create Intersystem Communications Function File (CRTICFF) or Change Intersystem Communications Function File (CHGICFF) command.
|
|
</p>
|
|
<p>The name specified for this parameter is the ICF program device entry with which the user's program communicates. This name is used on device-specific input/output operations to identify the program device and its attributes. Although the user may specify the same remote location name on more than one device entry, each program device name must be unique among the entries for the ICF file. This allows the user to have more than one session to the same remote location, or to have different attribute values for each session to the same remote location.
|
|
</p>
|
|
<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>
|
|
<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 being added. This name is used on device-specific input/output operations to identify the program device entry and the attributes. This program device entry name must be unique throughout the program device entries for the ICF file.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDICFDEVE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDICFDEVE.RMTLOCNAME"></a>
|
|
<h3>Remote location (RMTLOCNAME)</h3>
|
|
<p>Specifies the name of the remote location with which your program communicates.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<dl>
|
|
<dt><b>*REQUESTER</b></dt>
|
|
<dd>The name used to refer to the communications device through which the program is started is used. The session that is assigned when the program device is acquired is the same session in which the program start request is received. If the program is not started as a result of a program start request, the acquire operation of the program device fails. The target program uses *REQUESTER as the remote location name in the intersystem communications function (ICF) file to connect to the session that the source program used to send the program start request.
|
|
<p>The *REQUESTER value can be specified on only one program device entry and is valid only for a target communication job. If *REQUESTER is specified in any other type of job, a message is sent.
|
|
</p>
|
|
</dd>
|
|
<dt><b><i>communications-name</i></b></dt>
|
|
<dd>Specify the full name of a remote location. The remote location does not need to exist at the time this command is run, but it must exist (be configured on the system as a device description or in the advanced peer-to-peer networking (APPN) function) for this remote location at the time the program acquires the program device. The same remote location name may be specified for many different program device entries. However, only one program device name associated with each asynchronous (ASYNC), SNA upline facility (SNUF), or binary synchronous communication equivalence link (BSCEL) remote location may be added to the file at any one time. This value cannot be specified with CNVTYPE(*SRCPGM).
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDICFDEVE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDICFDEVE.CMNTYPE"></a>
|
|
<h3>Communication type (CMNTYPE)</h3>
|
|
<p>Specifies the communications types that may appear in the prompt display. This parameter is used only for the purpose of prompting. The value specified for this parameter determines the subset of other parameters that are shown (prompted) for the user.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>All parameters appear in the prompt.
|
|
</dd>
|
|
<dt><b>*APPC</b></dt>
|
|
<dd>Only the advanced program-to-program communications (APPC) parameters appear in the prompt.
|
|
</dd>
|
|
<dt><b>*ASYNC</b></dt>
|
|
<dd>Only the asynchronous communications (ASYNC) parameters appear in the prompt.
|
|
</dd>
|
|
<dt><b>*BSCEL</b></dt>
|
|
<dd>Only the binary synchronous communications equivalence link (BSCEL) parameters appear in the prompt.
|
|
</dd>
|
|
<dt><b>*FINANCE</b></dt>
|
|
<dd>Only the FINANCE parameters appear in the prompt.
|
|
</dd>
|
|
<dt><b>*INTRA</b></dt>
|
|
<dd>Only the INTRA parameters appear in the prompt.
|
|
</dd>
|
|
<dt><b>*RETAIL</b></dt>
|
|
<dd>Only the RETAIL parameters appear in the prompt.
|
|
</dd>
|
|
<dt><b>*SNUF</b></dt>
|
|
<dd>Only the Systems Network Architecture Upline Facility (SNUF) parameters appear in the prompt.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDICFDEVE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDICFDEVE.DEV"></a>
|
|
<h3>Device (DEV)</h3>
|
|
<p>Specifies the communications device used in the remote location. This parameter is specified only for APPC, Finance, Retail, SNUF, and INTRA communications.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LOC</u></b></dt>
|
|
<dd>The device associated with the remote location is used. If several devices are 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 a communications device associated with 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. More information on device names is in the APPC Programming book, SC41-5443.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDICFDEVE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDICFDEVE.LCLLOCNAME"></a>
|
|
<h3>Local location (LCLLOCNAME)</h3>
|
|
<p>Specifies the local location name.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LOC</u></b></dt>
|
|
<dd>The local location name associated with the remote location 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 local location name associated with the program device. The local location name is specified only if you want to indicate a different specific local location name for the remote location. If the local location name is not valid, an escape message is sent when the program device is acquired.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDICFDEVE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDICFDEVE.MODE"></a>
|
|
<h3>Mode (MODE)</h3>
|
|
<p>Specifies the mode name being used. This parameter applies only to APPC communications.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NETATR</u></b></dt>
|
|
<dd>The mode in the network attributes is used.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>BLANK</b></dt>
|
|
<dd>A mode name consisting of 8 blank characters is used.
|
|
</dd>
|
|
<dt><b><i>communications-name</i></b></dt>
|
|
<dd>Specify a mode name for the APPC communication 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="#ADDICFDEVE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDICFDEVE.RMTNETID"></a>
|
|
<h3>Remote network identifier (RMTNETID)</h3>
|
|
<p>Specifies the remote network identifier used with the remote location. This parameter applies only to the APPC communications.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LOC</u></b></dt>
|
|
<dd>Any remote network identifier for the remote location may be used. If several remote network IDs are associated with the remote location, the system determines which remote network ID is used.
|
|
</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 identifier to be associated with the program device entry.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDICFDEVE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDICFDEVE.FMTSLT"></a>
|
|
<h3>Format select (FMTSLT)</h3>
|
|
<p>Specifies the type of record format selection used for input operations.
|
|
</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>*RECID</b></dt>
|
|
<dd>The RECID keywords specified in the data description specifications (DDS) for the file are used to do a record selection. If there are no RECID keywords in the DDS, an error message is returned, and the program device is not acquired.
|
|
</dd>
|
|
<dt><b>*RMTFMT</b></dt>
|
|
<dd>The remote format names received from the sending system are used to do a record selection. If the device is not an APPC device and *RMTFMT is specified, a run time error message is sent at the time the program device is acquired.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDICFDEVE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDICFDEVE.APPID"></a>
|
|
<h3>Application identifier (APPID)</h3>
|
|
<p>Specifies (in characters) the Virtual Telecommunications Access Method (VTAM) identifier of the Customer Information Control System for Virtual Storage (CICS/VS) or the Information Management System for Virtual Storage (IMS/VS) host subsystem sent with the sign-on message. This parameter applies only to SNUF communications.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*DEVD</u></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 logon to the host. This is valid only when using the 3270 program interface.
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify an application identifier for the VTAM of the CICS/VS or IMS/VS.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDICFDEVE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDICFDEVE.BATCH"></a>
|
|
<h3>Batch activity (BATCH)</h3>
|
|
<p>Specifies, for both the Customer Information Control System for Virtual Storage(CICS/VS) and the Information Management System for Virtual Storage (IMS/VS), whether this session is used for batch jobs. This parameter applies to SNUF, INTRA, and RETAIL communications.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NO</u></b></dt>
|
|
<dd>Batch jobs do not occur in this session.
|
|
</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 be specified for the <b>Message protection (MSGPTC)</b> parameter.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDICFDEVE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDICFDEVE.HOST"></a>
|
|
<h3>Host type (HOST)</h3>
|
|
<p>Specifies the host system or remote subsystem with which the local system or subsystem is communicating during this session. This parameter applies only to SNUF communications.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*DEVD</u></b></dt>
|
|
<dd>The host system specified in the device description is used.
|
|
</dd>
|
|
<dt><b>*CICS</b></dt>
|
|
<dd>The Customer Information Control System for Virtual Storage is used during this communication session.
|
|
</dd>
|
|
<dt><b>*IMS</b></dt>
|
|
<dd>The Information Management System for Virtual Storage is used during this communication session.
|
|
</dd>
|
|
<dt><b>*IMSRTR</b></dt>
|
|
<dd>The Information Management System for Virtual Storage uses the ready-to-receive option during this communication session.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDICFDEVE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDICFDEVE.ENDSSNHOST"></a>
|
|
<h3>End session with host (ENDSSNHOST)</h3>
|
|
<p>Specifies how the Systems Network Architecture upline facility (SNUF) ends the session with the host.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*RSHUTD</u></b></dt>
|
|
<dd>SNUF sends a request to 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="#ADDICFDEVE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDICFDEVE.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="#ADDICFDEVE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDICFDEVE.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><u>*NO</u></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="#ADDICFDEVE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDICFDEVE.HDRPROC"></a>
|
|
<h3>Header processing (HDRPROC)</h3>
|
|
<p>Specifies, for both the Customer Information Control System for Virtual Storage (CICS/VS) and the Information Management System for Virtual Storage (IMS/VS) whether the received function management headers are passed to the application program. This parameter applies only to SNUF communications.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SYS</u></b></dt>
|
|
<dd>SNUF removes function management headers before passing data to the program.
|
|
</dd>
|
|
<dt><b>*USER</b></dt>
|
|
<dd>SNUF does not remove function management headers before passing data to the program.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDICFDEVE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDICFDEVE.MSGPTC"></a>
|
|
<h3>Message protection (MSGPTC)</h3>
|
|
<p>Specifies, for both the Customer Information Control System for Virtual Storage (CICS/VS) and Information Management System for Virtual Storage (IMS/VS), whether message protection is being used for this session. This parameter applies only to SNUF communications.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*YES</u></b></dt>
|
|
<dd>Message protection is used. SNUF saves messages until you respond to them, and tries synchronization again if additional errors occur. *YES is valid only when *NO is specified for 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="#ADDICFDEVE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDICFDEVE.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>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.
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NONE</u></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 for the <b>Batch activity (BATCH)</b> 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 for 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 or printer image followed by field definitions. The field definitions indicate the location and characteristics of fields. *EXTFIELD is valid only if *NO is specified for the BATCH parameter and 3278 is specified as the emulation device type.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDICFDEVE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDICFDEVE.CNVTYPE"></a>
|
|
<h3>Conversation type (CNVTYPE)</h3>
|
|
<p>Specifies the conversation type for which the application program is designed. This parameter is valid only for (APPC) communications. More information on the APPC communications type can be found in the APPC Programming book, SC41-5443.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SYS</u></b></dt>
|
|
<dd>The system gives the length and general data stream identifier values that precede each section of user data in the APPC device protocol. The application gives the data portion of the general data stream on output operations, and receives only the data portion of the general data stream on input operations. This is the mapped conversation support for LU 6.2 architecture.
|
|
</dd>
|
|
<dt><b>*USER</b></dt>
|
|
<dd>The application program gives the length and general data stream identifier values that precede each section of user data in the APPC device protocol. This is the basic conversation support for LU 6.2 architecture.
|
|
</dd>
|
|
<dt><b>*SRCPGM</b></dt>
|
|
<dd>The target program accepts the conversation type specified by the source program. If this value is specified, RMTLOCNAME(*REQUESTER) must also be specified.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDICFDEVE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDICFDEVE.BLOCK"></a>
|
|
<h3>Blocking type (BLOCK)</h3>
|
|
<p>Specifies whether the system or the user controls how records are combined into blocks when they are sent. This parameter is only for BSCEL communications. 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: Gives the BSC 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 within the block.
|
|
</li>
|
|
<li>System blocking of fixed-length records: The system uses fixed-length records, and blocks or deblocks accordingly.
|
|
</li>
|
|
</ul>
|
|
<p>If you specify a value other than *NONE or *USER, records are blocked as required by the system for output, and are deblocked on input.
|
|
</p>
|
|
<p><b>Element 1: Blocking type</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*DEVD</u></b></dt>
|
|
<dd>The block option specified 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 following the record.
|
|
</dd>
|
|
<dt><b>*NOSEP</b></dt>
|
|
<dd>No record separator character is contained in the block that is either sent to or received from the device. The system blocks and deblocks the records by using a fixed-length record, as specified in the data description specifications (DDS) format specifications.
|
|
</dd>
|
|
<dt><b>*USER</b></dt>
|
|
<dd>The program supplies the control characters, including record separator characters, BSCEL framing characters, transparency characters, and so forth, that are necessary to send records. More information about the device and binary synchronous communications equivalence link (BSCEL) support characteristics is in the BSC Equivalence Link Programming book, SC41-5445.
|
|
</dd>
|
|
<dt><b>*SEP</b></dt>
|
|
<dd>The records are blocked or deblocked based on the location of a record separator character specified by the user. 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>Record separator character X'1E' is used.
|
|
</dd>
|
|
<dt><b><i>hexadecimal-value</i></b></dt>
|
|
<dd>Specify a unique, 1-byte record separator character. The record separator character may be specified as 2 hexadecimal characters, as in BLOCK(*SEP FD) where X'FD' is the separator character.
|
|
<p>The following characters are not not valid as separator characters because these characters are used for BSC control:
|
|
</p>
|
|
<table border="1">
|
|
<caption align="bottom"><b>Figure: Characters Unavailable for Record Separators</b>
|
|
</caption>
|
|
<tr>
|
|
<td>
|
|
<p>
|
|
<pre>
|
|
EBCDIC ASCII BSC Control
|
|
------ ----- -----------------------------------
|
|
X'01' X'01' SOH (start-of-header)
|
|
X'02' X'02' STX (start-of-text)
|
|
X'03' X'03' ETX (end-of-text)
|
|
X'10' X'10' DLE (data-link escape)
|
|
X'1D' X'1D' IGS (interchange group separator)
|
|
X'1F' X'1F' ITB (intermediate text block)
|
|
X'26' X'17' ETB (end-of-transmission block)
|
|
X'2D' X'05' ENQ (enquiry)
|
|
X'32' X'16' SYN (synchronization)
|
|
X'37' X'04' EOT (end-of-transmission)
|
|
X'3D' X'15' NAK (negative acknowledgment)
|
|
</pre>
|
|
</p>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDICFDEVE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDICFDEVE.RCDLEN"></a>
|
|
<h3>Record length (RCDLEN)</h3>
|
|
<p>Specifies the maximum record length (in bytes) for data being sent and received. This parameter applies only to SNUF and BSCEL communications.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*DEVD</u></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 allowed record length when this device file 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. Valid values range from 1 through 32767 bytes for SNUF communications. For BSCEL communications, the maximum record length is 8192 bytes.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDICFDEVE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDICFDEVE.BLKLEN"></a>
|
|
<h3>Block length (BLKLEN)</h3>
|
|
<p>Specifies the maximum block length (in bytes) for data being sent. This parameter applies only to BSCEL and SNUF communications.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*DEVD</u></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 (in bytes) of records sent when using this device file. The value must be at least the size of the largest record sent. Valid values range from 1 through 32767 for SNUF communications. For BSCEL communications, the maximum block length is 8192 bytes.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDICFDEVE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDICFDEVE.TRNSPY"></a>
|
|
<h3>Transmit in transparent mode (TRNSPY)</h3>
|
|
<p>Specifies whether data is sent in transparent text mode. Text transparency allows all 256 EBCDIC character codes to be sent. Use this function when sending packed or binary data fields. This parameter applies only to BSCEL communications.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*DEVD</u></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 for the <b>Blocking type (BLOCK)</b> parameter.
|
|
<p>
|
|
<b>Note: </b>Transparency of received data is determined by the data stream; therefore, this parameter is not relevant for received data. If TRNSPY(*YES) is specified with BLOCK(*USER), BSCEL ignores the transparency indicator during write operations. Correct controls must be given with the data to get transparent sending of data. For example, the data-link escape (DLE) and start-of-text (STX) control characters must first be specified; the system provides the remaining control characters required for transparent sending of data.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDICFDEVE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDICFDEVE.DTACPR"></a>
|
|
<h3>Compress and decompress data (DTACPR)</h3>
|
|
<p>Specifies whether blanks in BSCEL data are compressed for output and decompressed for input. This parameter applies only to BSCEL communications.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*DEVD</u></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 is used.
|
|
</dd>
|
|
<dt><b>*YES</b></dt>
|
|
<dd>Data is compressed for output and decompressed for input. *YES cannot be specified here if *YES is specified for the <b>Transmit in transparent mode (TRNSPY)</b> parameter.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDICFDEVE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDICFDEVE.TRUNC"></a>
|
|
<h3>Truncate trailing blanks (TRUNC)</h3>
|
|
<p>Specifies whether trailing blanks are removed from output records. This parameter applies only to BSCEL communications.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*DEVD</u></b></dt>
|
|
<dd>The trailing blanks option specified in the device description is 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. *YES cannot be specified if BLOCK(*NOSEP) is specified for the <b>Blocking type (BLOCK)</b> parameter. If *YES is specified here and *YES is also specified for the <b>Compress and decompress data (DTACPR)</b> parameter, trailing blanks are not removed from output records.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDICFDEVE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDICFDEVE.OVRFLWDTA"></a>
|
|
<h3>Overflow data (OVRFLWDTA)</h3>
|
|
<p>Specifies whether overflow data is discarded or retained.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*DISCARD</u></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="#ADDICFDEVE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDICFDEVE.GRPSEP"></a>
|
|
<h3>Group separator type (GRPSEP)</h3>
|
|
<p>Specifies a separator for groups of data (for example, data sets and documents). This parameter applies only to BSCEL communications.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*DEVD</u></b></dt>
|
|
<dd>The group separator option specified in the device description is used.
|
|
</dd>
|
|
<dt><b>*DEV3740</b></dt>
|
|
<dd>A null record (STXETX) is used as a data group separator.
|
|
</dd>
|
|
<dt><b>*EOT</b></dt>
|
|
<dd>A block is sent that ends with the BSCEL end-of-transmission (EOT) control character used as a data group separator.
|
|
</dd>
|
|
<dt><b>*OFCSYS</b></dt>
|
|
<dd>A block is sent that ends with the BSCEL end-of-information (ETX) control character is used as a data group separator.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDICFDEVE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDICFDEVE.RMTBSCEL"></a>
|
|
<h3>Remote BSCEL (RMTBSCEL)</h3>
|
|
<p>Specifies the type of BSCEL session established with the remote system. This parameter applies only to BSCEL communications.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*DEVD</u></b></dt>
|
|
<dd>The RMTBSCEL option specified in the device description is used.
|
|
</dd>
|
|
<dt><b>*NO</b></dt>
|
|
<dd>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 recognizes the BSCEL transaction starting commands, transaction ending commands, and online messages. In most cases, *YES indicates that the remote system is another iSeries, or a System/38, System/36, or System/34 with BSCEL support.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDICFDEVE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDICFDEVE.INLCNN"></a>
|
|
<h3>Initial connection (INLCNN)</h3>
|
|
<p>Specifies the method of making a connection on the line for the session being accessed. This parameter applies only to binary synchronous communications equivalence link (BSCEL) communications.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*CTLD</u></b></dt>
|
|
<dd>The initial connection option specified in the controller description is used.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*ANS</b></dt>
|
|
<dd>The remote system starts the call, and the local system answers the call.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*DIAL</b></dt>
|
|
<dd>The local system starts the call, and the remote system answers the call.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDICFDEVE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="ADDICFDEVE.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Using RECID Keywords for Record Selection</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
ADDICFDEVE FILE(ICFFILE1) PGMDEV(BSCEL2)
|
|
RMTLOCNAME(BSCNYC) FMTSLT(*RECID)
|
|
</pre>
|
|
</p>
|
|
<p>This command adds the program device entry named BSCEL2 with a corresponding remote location named BSCNYC for the ICF file ICFFILE1. The program device is added with the attributes of FMTSLT(*RECID).
|
|
</p>
|
|
<p><b>Example 2: Using Remote Format Names for Record Selection</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
ADDICFDEVE FILE(QGPL/ICFTEST) PGMDEV(APPC1)
|
|
RMTLOCNAME(*REQUESTER)
|
|
FMTSLT(*RMTFMT) CNVTYPE(*SYS)
|
|
</pre>
|
|
</p>
|
|
<p>This command adds the program device entry named APPC1 with a remote location name of *REQUESTER for the ICF file ICFTEST in the QGPL library. This program device entry has the FMTSLT(*RMTFMT) and CNVTYPE(*SYS) attributes.
|
|
</p>
|
|
<p><b>Example 3: Adding a Program Device Entry</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
ADDICFDEVE FILE(ICFLIB/TESTFILE) PGMDEV(JOE)
|
|
RMTLOCNAME(LU0MPLS)
|
|
</pre>
|
|
</p>
|
|
<p>This command adds the program device entry named JOE with remote location named LU0MPLS for the ICF file TESTFILE in library ICFLIB.
|
|
</p>
|
|
<p><b>Example 4: Adding a Program Device Entry</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
ADDICFDEVE FILE(TESTFILE) PGMDEV(APPC)
|
|
RMTLOCNAME(APPCMPLS) DEV(MPLSLINE2)
|
|
</pre>
|
|
</p>
|
|
<p>This command adds the program device entry named APPC with a remote location name of APPCMPLS using device MPLSLINE2 to the ICF file TESTFILE.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDICFDEVE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="ADDICFDEVE.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF7365</b></dt>
|
|
<dd>Device not added to file &1 in &2.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDICFDEVE.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|