friedkiwi/ibm-information-center
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
14ed2849c6
ibm-information-center/dist/eclipse/plugins/i5OS.ic.cl_5.4.0.1/chgicfdeve.htm

1045 lines
39 KiB
HTML
Raw Blame History

<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Change ICF Device Entry (CHGICFDEVE)</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="CHGICFDEVE.Top_Of_Page"></a>
<h2>Change ICF Device Entry (CHGICFDEVE)</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="#CHGICFDEVE.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CHGICFDEVE.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CHGICFDEVE.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CHGICFDEVE"></a>
<p>The Change Intersystem Communications Function Device Entry (CHGICFDEVE) command changes the attributes of the program device entry in the specified ICF file.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGICFDEVE.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CHGICFDEVE.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="#CHGICFDEVE.FILE"><b>FILE</b></a></td>
<td valign="top">ICF communication file</td>
<td valign="top"><i>Qualified object name</i></td>
<td valign="top" rowspan="3">Required, Key, Positional 1</td>
</tr>
<tr>
<td valign="top">Qualifier 1: ICF communication 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="#CHGICFDEVE.PGMDEV"><b>PGMDEV</b></a></td>
<td valign="top">Program device</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Required, Key, Positional 2</td>
</tr>
<tr>
<td valign="top"><a href="#CHGICFDEVE.RMTLOCNAME"><b>RMTLOCNAME</b></a></td>
<td valign="top">Remote location</td>
<td valign="top"><i>Communications name</i>, <b><u>*SAME</u></b>, *REQUESTER</td>
<td valign="top">Optional, Positional 3</td>
</tr>
<tr>
<td valign="top"><a href="#CHGICFDEVE.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="#CHGICFDEVE.DEV"><b>DEV</b></a></td>
<td valign="top">Device</td>
<td valign="top"><i>Name</i>, <b><u>*SAME</u></b>, *LOC</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGICFDEVE.LCLLOCNAME"><b>LCLLOCNAME</b></a></td>
<td valign="top">Local location</td>
<td valign="top"><i>Communications name</i>, <b><u>*SAME</u></b>, *LOC, *NETATR</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGICFDEVE.MODE"><b>MODE</b></a></td>
<td valign="top">Mode</td>
<td valign="top"><i>Communications name</i>, <b><u>*SAME</u></b>, *NETATR</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGICFDEVE.RMTNETID"><b>RMTNETID</b></a></td>
<td valign="top">Remote network identifier</td>
<td valign="top"><i>Communications name</i>, <b><u>*SAME</u></b>, *LOC, *NETATR, *NONE</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGICFDEVE.FMTSLT"><b>FMTSLT</b></a></td>
<td valign="top">Format select</td>
<td valign="top"><b><u>*SAME</u></b>, *PGM, *RECID, *RMTFMT</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGICFDEVE.APPID"><b>APPID</b></a></td>
<td valign="top">Application identifier</td>
<td valign="top"><i>Name</i>, <b><u>*SAME</u></b>, *DEVD, *USER</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGICFDEVE.BATCH"><b>BATCH</b></a></td>
<td valign="top">Batch activity</td>
<td valign="top"><b><u>*SAME</u></b>, *NO, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGICFDEVE.HOST"><b>HOST</b></a></td>
<td valign="top">Host type</td>
<td valign="top"><b><u>*SAME</u></b>, *DEVD, *CICS, *IMS, *IMSRTR</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGICFDEVE.ENDSSNHOST"><b>ENDSSNHOST</b></a></td>
<td valign="top">End session with host</td>
<td valign="top"><b><u>*SAME</u></b>, *RSHUTD, *TERMSELF</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGICFDEVE.SPCHOSTAPP"><b>SPCHOSTAPP</b></a></td>
<td valign="top">Special host application</td>
<td valign="top"><b><u>*SAME</u></b>, *DEVD, *NONE, *FLASH</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGICFDEVE.INZSELF"><b>INZSELF</b></a></td>
<td valign="top">Initialize self</td>
<td valign="top"><b><u>*SAME</u></b>, *NO, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGICFDEVE.HDRPROC"><b>HDRPROC</b></a></td>
<td valign="top">Header processing</td>
<td valign="top"><b><u>*SAME</u></b>, *SYS, *USER</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGICFDEVE.MSGPTC"><b>MSGPTC</b></a></td>
<td valign="top">Message protection</td>
<td valign="top"><b><u>*SAME</u></b>, *YES, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#CHGICFDEVE.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">
<b><u>*SAME</u></b>, 3278, 3284, 3286, 3287, 3288, 3289</td>
</tr>
<tr>
<td valign="top">Element 2: Data format</td>
<td valign="top">
<b><u>*SAME</u></b>, *UNFORMAT, *FIELD, *EXTFIELD, *NOFIELD</td>
</tr>
<tr>
<td valign="top"><a href="#CHGICFDEVE.CNVTYPE"><b>CNVTYPE</b></a></td>
<td valign="top">Conversation type</td>
<td valign="top"><b><u>*SAME</u></b>, *SYS, *USER, *SRCPGM</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#CHGICFDEVE.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>*SAME</u></b>, *DEVD, *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>, *SAME</td>
</tr>
<tr>
<td valign="top"><a href="#CHGICFDEVE.RCDLEN"><b>RCDLEN</b></a></td>
<td valign="top">Record length</td>
<td valign="top">1-32767, <b><u>*SAME</u></b>, *DEVD</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGICFDEVE.BLKLEN"><b>BLKLEN</b></a></td>
<td valign="top">Block length</td>
<td valign="top">1-32767, <b><u>*SAME</u></b>, *DEVD</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGICFDEVE.TRNSPY"><b>TRNSPY</b></a></td>
<td valign="top">Transmit in transparent mode</td>
<td valign="top"><b><u>*SAME</u></b>, *DEVD, *NO, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGICFDEVE.DTACPR"><b>DTACPR</b></a></td>
<td valign="top">Compress and decompress data</td>
<td valign="top"><b><u>*SAME</u></b>, *DEVD, *NO, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGICFDEVE.TRUNC"><b>TRUNC</b></a></td>
<td valign="top">Truncate trailing blanks</td>
<td valign="top"><b><u>*SAME</u></b>, *DEVD, *NO, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGICFDEVE.OVRFLWDTA"><b>OVRFLWDTA</b></a></td>
<td valign="top">Overflow data</td>
<td valign="top"><b><u>*SAME</u></b>, *DISCARD, *RETAIN</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGICFDEVE.GRPSEP"><b>GRPSEP</b></a></td>
<td valign="top">Group separator type</td>
<td valign="top"><b><u>*SAME</u></b>, *DEVD, *EOT, *DEV3740, *OFCSYS</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGICFDEVE.RMTBSCEL"><b>RMTBSCEL</b></a></td>
<td valign="top">Remote BSCEL</td>
<td valign="top"><b><u>*SAME</u></b>, *DEVD, *NO, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGICFDEVE.INLCNN"><b>INLCNN</b></a></td>
<td valign="top">Initial connection</td>
<td valign="top"><b><u>*SAME</u></b>, *CTLD, *DIAL, *ANS</td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#CHGICFDEVE.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CHGICFDEVE.FILE"></a>
<h3>ICF communication file (FILE)</h3>
<p>Specifies the intersystem communications function (ICF) file that contains the ICF program device entry to be changed.
</p>
<p>This is a required parameter.
</p>
<p><b>Qualifier 1: ICF communication 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="#CHGICFDEVE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGICFDEVE.PGMDEV"></a>
<h3>Program device (PGMDEV)</h3>
<p>Specifies the program device entry name in the ICF file whose attributes are being changed.
</p>
<p>This is a required parameter.
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the program device entry in the ICF file whose attributes are to be changed. The program device entry must exist in the specified ICF file.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGICFDEVE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGICFDEVE.RMTLOCNAME"></a>
<h3>Remote location (RMTLOCNAME)</h3>
<p>Specifies the remote location name with which the program communicates.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The remote location name does not change.
</dd>
<dt><b><i>communications-name</i></b></dt>
<dd>Specify the name of the remote location with which your program communicates. When the program is running, 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 to the file at any one time.
</dd>
</dl>
<dl>
<dt><b>*REQUESTER</b></dt>
<dd>The name used to refer to the communication device through which the program is started is used. 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 EVOKE request. *REQUESTER may be specified for only one program device entry.
<p>*REQUESTER is valid only for a target system communication job. If it is specified in any other type of job, an escape message is sent when the program device is accessed.
</p>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGICFDEVE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGICFDEVE.CMNTYPE"></a>
<h3>Communication type (CMNTYPE)</h3>
<p>Specifies the communications type that appears in the prompt.
</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="#CHGICFDEVE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGICFDEVE.DEV"></a>
<h3>Device (DEV)</h3>
<p>Specifies the communications device that is used. The DEV parameter is applies only to advanced program-to-program communications (APPC) and System Network Architecture upline facility (SNUF) communications.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The device name does not change.
</dd>
<dt><b>*LOC</b></dt>
<dd>The device associated with the remote location 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.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGICFDEVE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGICFDEVE.LCLLOCNAME"></a>
<h3>Local location (LCLLOCNAME)</h3>
<p>Specifies the local location name.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The local location name does not change.
</dd>
<dt><b>*LOC</b></dt>
<dd>The local location name is the same as the remote location name.
</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="#CHGICFDEVE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGICFDEVE.MODE"></a>
<h3>Mode (MODE)</h3>
<p>Specifies the mode name used. This parameter applies only to APPC communications.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The mode name does not change.
</dd>
</dl>
<dl>
<dt><b>*NETATR</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="#CHGICFDEVE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGICFDEVE.RMTNETID"></a>
<h3>Remote network identifier (RMTNETID)</h3>
<p>Specifies the remote network ID. This parameter applies only to APPC communications.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The remote network ID does not change.
</dd>
<dt><b>*LOC</b></dt>
<dd>Any remote network ID for the remote location may be 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 ID.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGICFDEVE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGICFDEVE.FMTSLT"></a>
<h3>Format select (FMTSLT)</h3>
<p>Specifies the type of record format selection used for input operations for all devices.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The record format selection value does not change.
</dd>
</dl>
<dl>
<dt><b>*PGM</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 DDS for the file are used to do record selection. If there are no RECID 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="#CHGICFDEVE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGICFDEVE.APPID"></a>
<h3>Application identifier (APPID)</h3>
<p>Specifies (in characters) the Virtual Telecommunications Access Method (VTAM) identifier of the Costumer Information Control System for Virtual Storage (CICS/VS) or Information Management System for Virtual Storage (IMS/V) host subsystem sent with the sign-on message. This parameter applies only to SNUF communications.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The application ID does not change.
</dd>
<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 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. The specified application identifier is sent with the sign-on message.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGICFDEVE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGICFDEVE.BATCH"></a>
<h3>Batch activity (BATCH)</h3>
<p>Specifies, for both Customer Information Control System for Virtual Storage (CICS/VS) and 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>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<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 be specified for the <b>Message protection (MSGPTC)</b> parameter.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGICFDEVE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGICFDEVE.HOST"></a>
<h3>Host type (HOST)</h3>
<p>Specifies the host or remote subsystem with which this session is communicating. This parameter applies only to SNUF communications.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<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 Customer Information Control System for Virtual Storage.
</dd>
<dt><b>*IMS</b></dt>
<dd>The session communicates with Information Management System for Virtual Storage.
</dd>
<dt><b>*IMSRTR</b></dt>
<dd>The session communicates with IMS/VS by using the ready-to-receive option.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGICFDEVE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGICFDEVE.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>*SAME</u></b></dt>
<dd>The end session with host value does not change.
</dd>
<dt><b>*RSHUTD</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="#CHGICFDEVE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGICFDEVE.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>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b>*DEVD</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="#CHGICFDEVE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGICFDEVE.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>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<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="#CHGICFDEVE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGICFDEVE.HDRPROC"></a>
<h3>Header processing (HDRPROC)</h3>
<p>Specifies, for both Customer Information Control System for Virtual Storage (CICS/VS) and Information Management System in Virtual Storage (IMS/VS), whether received function management headers are passed to the application program. This parameter applies to the SNUF communications type only.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<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 to the program.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGICFDEVE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGICFDEVE.MSGPTC"></a>
<h3>Message protection (MSGPTC)</h3>
<p>Specifies, for both Customer Information Control System for Virtual Storage (CICS/VS) and Information Management Storage for Virtual Storage (IMS/VS), whether message protection is used for this session. This parameter applies only to SNUF communications.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b>*YES</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="#CHGICFDEVE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGICFDEVE.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><u>*SAME</u></b></dt>
<dd>The emulation device does not change.
</dd>
<dt><b>*NONE</b></dt>
<dd>
</dd>
<dt><b>3278</b></dt>
<dd>The data stream is for a 3278 or 3277 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>*SAME</u></b></dt>
<dd>The emulation device data format does not change.
</dd>
<dt><b>*UNFORMAT</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 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 BBATCH parameter and 3278 is specified for the device type on this parameter.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGICFDEVE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGICFDEVE.CNVTYPE"></a>
<h3>Conversation type (CNVTYPE)</h3>
<p>Specifies the conversation type for which the application program is designed. This parameter applies only to advanced program-to-program communications (APPC).
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b>*SYS</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. For the LU 6.2 architecture, this is the mapped conversation support.
</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. For the LU 6.2 architecture, this is the basic conversation support.
</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="#CHGICFDEVE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGICFDEVE.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 used 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
</li>
<li>User blocking or deblocking
</li>
<li>System blocking with record separator characters
</li>
<li>System blocking of fixed-length records
</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>Element 1: Blocking type</b>
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b>*DEVD</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.
</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 transmission block sent to or received from the device. The system blocks and deblocks the records by 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>
<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>The record separator character is a hexadecimal <b>1E</b>.
</dd>
<dt><b>*SAME</b></dt>
<dd>The value does not change.
</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>
<b>Note: </b>See the table in the description of the ADDICFDEVE command for more information about BSC control characters that cannot be used as record separator characters.
</p>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGICFDEVE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGICFDEVE.RCDLEN"></a>
<h3>Record length (RCDLEN)</h3>
<p>Specifies the maximum record length (in bytes) for data sent and received. This parameter applies only to SNUF and BSCEL communications.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<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 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="#CHGICFDEVE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGICFDEVE.BLKLEN"></a>
<h3>Block length (BLKLEN)</h3>
<p>Specifies the maximum block length (in bytes) for data sent. This parameter applies only to BSCEL and SNUF communications.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The block length does not change.
</dd>
<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 through 32767 bytes 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="#CHGICFDEVE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGICFDEVE.TRNSPY"></a>
<h3>Transmit in transparent mode (TRNSPY)</h3>
<p>Specifies whether data 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 function to send packed or binary data fields. This parameter applies only to BSCEL communications.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<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 permits the transmission of all 256 EBCDIC character codes. *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), the BSCEL communications type ignores the transparency indicator during write operations. Correct controls must be given with the data to get transparent transmission of data. For example, the data-link escape (DLE) and start-of-text (STX) character control characters must first be specified; the system gives the remaining control characters for transparent sending of data.
</p>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGICFDEVE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGICFDEVE.DTACPR"></a>
<h3>Compress and decompress data (DTACPR)</h3>
<p>Specifies whether data compression is performed.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<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="#CHGICFDEVE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGICFDEVE.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>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<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.
<p>
<b>Note: </b>TRUNC(*YES) cannot be specified if BLOCK(*NOSEP) or BLOCK(*ITB) is specified. If TRUNC(*YES) is specified when DTACPR(*YES) or BLOCK(*USER) is specified, then truncation is ignored.
</p>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGICFDEVE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGICFDEVE.OVRFLWDTA"></a>
<h3>Overflow data (OVRFLWDTA)</h3>
<p>Specifies whether overflow data is discarded or retained.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<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="#CHGICFDEVE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGICFDEVE.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>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b>*DEVD</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="#CHGICFDEVE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGICFDEVE.RMTBSCEL"></a>
<h3>Remote BSCEL (RMTBSCEL)</h3>
<p>Specifies the type of BSCEL session with the remote system. This parameter applies only to BSCEL communications.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b>*DEVD</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="#CHGICFDEVE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGICFDEVE.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>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b>*CTLD</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.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGICFDEVE.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGICFDEVE.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Changing the Record Format Selection</b>
</p>
<p>
<pre>
CHGICFDEVE FILE(ICFTEST) PGMDEV(BSCEL2)
RMTLOCNAME(BSCNYC) FMTSLT(*RECID)
</pre>
</p>
<p>This command changes the program device entry named BSCEL2 in ICF file ICFTEST. The program device is changed to attributes of FMTSLT(*RECID). The remote location name is changed to BSCNYC.
</p>
<p><b>Example 2: Changing the Conversation Type</b>
</p>
<p>
<pre>
CHGICFDEVE FILE(QGPL/ICF1) PGMDEV(APPC1)
RMTLOCNAME(*REQUESTER)
FMTSLT(*RMTFMT) CNVTYPE(*SYS)
</pre>
</p>
<p>This command changes the program device entry named APPC1 in ICF file ICF1 to have the remote location name *REQUESTER. This program device entry is changed to the FMTSLT(*RMTFMT) and CNVTYPE(*SYS) attributes.
</p>
<p><b>Example 3: Changing the Communications Device</b>
</p>
<p>
<pre>
CHGICFDEVE FILE(ICFLIB/ICFAPPL1) PGMDEV(APPC)
RMTLOCNAME(APPCMPLS) DEV(MPLSLINE2)
</pre>
</p>
<p>This command changes the program device entry named APPC in file ICFAPPL1. The remote location name is changed to APPCMPLS and the device is changed to MPLSLINE2.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGICFDEVE.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGICFDEVE.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF7367</b></dt>
<dd>Device not changed in file &amp;1 in &amp;2.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGICFDEVE.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>
Reference in New Issue View Git Blame Copy Permalink