590 lines
22 KiB
HTML
590 lines
22 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 CICS CVT Entry (ADDCICSCVT)</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="ADDCICSCVT.Top_Of_Page"></a>
|
|
<h2>Add CICS CVT Entry (ADDCICSCVT)</h2>
|
|
<table width="100%">
|
|
<tr>
|
|
<td valign="top" align="left"><b>Where allowed to run: </b>
|
|
<ul><li>Batch job (*BATCH)</li>
|
|
<li>Interactive job (*INTERACT)</li>
|
|
<li>Batch program (*BPGM)</li>
|
|
<li>Interactive program (*IPGM)</li>
|
|
<li>Batch REXX procedure (*BREXX)</li>
|
|
<li>Interactive REXX procedure (*IREXX)</li>
|
|
<li>Using QCMDEXEC, QCAEXEC, or QCAPCMD API (*EXEC)</li>
|
|
</ul><b>Threadsafe: </b>No
|
|
</td>
|
|
<td valign="top" align="right">
|
|
<a href="#ADDCICSCVT.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#ADDCICSCVT.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#ADDCICSCVT.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="ADDCICSCVT"></a>
|
|
<p>Use the Add CICS Conversion Vector Table (ADDCICSCVT) command to add an entry to the CVT.
|
|
</p>
|
|
<p>Conversion Vector Table (CVT) entries define templates for data conversion either from EBCDIC to ASCII, or when the code page and character set used by the other CICS system is different from that used by the iSeries system. The data conversion must be defined by the system sending the data. Data conversion is required for:
|
|
</p>
|
|
<ul>
|
|
<li>File control commands
|
|
</li>
|
|
<li>Transient data queue commands
|
|
</li>
|
|
<li>Temporary storage queue commands
|
|
</li>
|
|
<li>START commands
|
|
</li>
|
|
<li>LINK commands
|
|
</li>
|
|
</ul>
|
|
<p>Data is converted according to templates that have been predefined in the CVT. A template describes the type of data, how it is arranged in the record, and the type of conversion required. If your data contains alphabetic and numeric fields, you may need to define a template for each field in the record.
|
|
</p>
|
|
<p>There are three types of conversion templates:
|
|
</p>
|
|
<ul>
|
|
<li>For conversion of file keys, use the Key conversion data (KEYINF) parameter. This type of conversion is valid only for key-sequenced files.
|
|
</li>
|
|
<li>For conversion of variable format data in accordance with defined selection criteria, use the Selection criteria (SLTCTL) parameter.
|
|
</li>
|
|
<li>For default conversion to be applied when no other conversion template matches the data. Use the Conversion information (CNVINF) parameter.
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDCICSCVT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="ADDCICSCVT.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="#ADDCICSCVT.LIB"><b>LIB</b></a></td>
|
|
<td valign="top">Library</td>
|
|
<td valign="top"><i>Communications name</i>, *LIBL, *CURLIB</td>
|
|
<td valign="top">Required, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ADDCICSCVT.GROUP"><b>GROUP</b></a></td>
|
|
<td valign="top">Group</td>
|
|
<td valign="top"><i>Communications name</i></td>
|
|
<td valign="top">Required, Positional 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ADDCICSCVT.CMDTYPE"><b>CMDTYPE</b></a></td>
|
|
<td valign="top">API command type</td>
|
|
<td valign="top">*FILE, *TDQUEUE, *TSQUEUE, *START, *LINK</td>
|
|
<td valign="top">Required, Positional 3</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#ADDCICSCVT.RSRCID"><b>RSRCID</b></a></td>
|
|
<td valign="top">Resource identifier</td>
|
|
<td valign="top"><i>Character value</i></td>
|
|
<td valign="top">Required, Positional 4</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#ADDCICSCVT.CNVCHRID"><b>CNVCHRID</b></a></td>
|
|
<td valign="top">Character identifier</td>
|
|
<td valign="top"><i>Element list</i></td>
|
|
<td valign="top" rowspan="3">Required, Positional 5</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Code page</td>
|
|
<td valign="top">
|
|
1-65535</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Graphic character set</td>
|
|
<td valign="top">
|
|
0-65535, *CCSID</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="5"><a href="#ADDCICSCVT.CNVINF"><b>CNVINF</b></a></td>
|
|
<td valign="top">Conversion information</td>
|
|
<td valign="top">Values (up to 30 repetitions): <i>Element list</i></td>
|
|
<td valign="top" rowspan="5">Optional, Positional 6</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Starting location</td>
|
|
<td valign="top">
|
|
0-65535, <b><u>0</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Type of conversion</td>
|
|
<td valign="top">
|
|
<b><u>*CHAR</u></b>, *PACKED, *BINARY, *IDC, *INTEL</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 3: Length of conversion</td>
|
|
<td valign="top">
|
|
1-65535, <b><u>1</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 4: User specified DBCS data</td>
|
|
<td valign="top">
|
|
<b><u>*NO</u></b>, *YES</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="5"><a href="#ADDCICSCVT.KEYINF"><b>KEYINF</b></a></td>
|
|
<td valign="top">Key conversion data</td>
|
|
<td valign="top">Values (up to 30 repetitions): <i>Element list</i></td>
|
|
<td valign="top" rowspan="5">Optional, Positional 7</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Starting location</td>
|
|
<td valign="top">
|
|
0-65535, <b><u>0</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Type of conversion</td>
|
|
<td valign="top">
|
|
<b><u>*CHAR</u></b>, *PACKED, *BINARY, *IDC, *INTEL</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 3: Length of conversion</td>
|
|
<td valign="top">
|
|
1-65535, <b><u>1</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 4: User specified DBCS data</td>
|
|
<td valign="top">
|
|
<b><u>*NO</u></b>, *YES</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="8"><a href="#ADDCICSCVT.SLTCTL"><b>SLTCTL</b></a></td>
|
|
<td valign="top">Selection criteria</td>
|
|
<td valign="top">Values (up to 30 repetitions): <i>Element list</i></td>
|
|
<td valign="top" rowspan="8">Optional, Positional 8</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Starting location</td>
|
|
<td valign="top">
|
|
0-65535, <b><u>0</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Character or hex format</td>
|
|
<td valign="top">
|
|
<b><u>*CHAR</u></b>, *HEX</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 3: Value to compare against</td>
|
|
<td valign="top">
|
|
<i>Character value</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 4: Starting location</td>
|
|
<td valign="top">
|
|
Values (up to 30 repetitions): 0-65535, <b><u>0</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 5: Type of conversion</td>
|
|
<td valign="top">
|
|
Values (up to 30 repetitions): <b><u>*CHAR</u></b>, *PACKED, *BINARY, *IDC, *INTEL</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 6: Length of conversion</td>
|
|
<td valign="top">
|
|
Values (up to 30 repetitions): 1-65535, <b><u>1</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 7: User specified DBCS data</td>
|
|
<td valign="top">
|
|
Values (up to 30 repetitions): <b><u>*NO</u></b>, *YES</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDCICSCVT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="ADDCICSCVT.LIB"></a>
|
|
<h3>Library (LIB)</h3>
|
|
<p>Enter the name of the OS/400 library that contains the group. Possible values are:
|
|
</p>
|
|
<ul>
|
|
<li><b>*LIBL:</b> The library list is used to locate the first OS/400 library that contains the group.
|
|
</li>
|
|
<li><b>*CURLIB:</b> The current library contains the group. If no current library is specified, the QGPL library is used.
|
|
</li>
|
|
<li><b>library-name:</b> The name of the OS/400 library that contains the group.
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDCICSCVT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDCICSCVT.GROUP"></a>
|
|
<h3>Group (GROUP)</h3>
|
|
<p>Enter the name of the group to which this CVT entry is to be added.
|
|
</p>
|
|
<p><b>group-name:</b> The group name may have a maximum length of 10 characters. The first character must be alphabetic, or one of the special characters, $, @, or #. The remaining characters can be alphanumeric or one of the special characters, $, @, or #.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDCICSCVT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDCICSCVT.CMDTYPE"></a>
|
|
<h3>API command type (CMDTYPE)</h3>
|
|
<p>Indicates the type of EXEC CICS command that will use this entry for user data conversion. This field is used with the resource identifier field to identify this CVT entry.
|
|
</p>
|
|
<p>Possible values are:
|
|
</p>
|
|
<ul>
|
|
<li><b>*FILE:</b> File control commands.
|
|
</li>
|
|
<li><b>*TDQUEUE:</b> Transient data queue commands.
|
|
</li>
|
|
<li><b>*TSQUEUE:</b> Temporary storage queue commands.
|
|
</li>
|
|
<li><b>*START:</b> The START command.
|
|
</li>
|
|
<li><b>*LINK:</b> The LINK command.
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDCICSCVT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDCICSCVT.RSRCID"></a>
|
|
<h3>Resource identifier (RSRCID)</h3>
|
|
<p>Enter the resource identifier associated with the EXEC CICS command type. This field is used with the command type field to identify this CVT entry. This resource identifier should have an entry in the appropriate table, as follows:
|
|
</p>
|
|
<dl>
|
|
<dt><b>CMDTYPE</b></dt>
|
|
<dd><b> CICS table
|
|
</b></dd>
|
|
<dt><b>*TDQUEUE</b></dt>
|
|
<dd>Destination Control Table
|
|
</dd>
|
|
<dt><b>*START</b></dt>
|
|
<dd>Program Control Table
|
|
</dd>
|
|
<dt><b>*FILE</b></dt>
|
|
<dd>File Control Table
|
|
</dd>
|
|
<dt><b>*TSQUEUE</b></dt>
|
|
<dd>Temporary Storage Table
|
|
</dd>
|
|
<dt><b>*LINK</b></dt>
|
|
<dd>Processing Program Table
|
|
</dd>
|
|
</dl>
|
|
<p><b>resource-identifier: </b>For a command type of *TDQUEUE or *START, the maximum length of the resource identifier is 4 characters. For a command type of *FILE, *TSQUEUE, or *LINK, the maximum length of the resource identifier is 8 characters. Any characters on the keyboard can be entered, but lowercase letters and special characters should be enclosed in apostrophes.
|
|
</p>
|
|
<p>When there is not enough space to enter the apostrophes, then enter an ampersand (&) in the first character position to get an extended field size that allows for the entry of additional characters. Blanks are accepted but, when the entry is defined to a control region, anything after the blank is ignored. For example, 'ab g' will be treated as 'ab' in the control region.
|
|
</p>
|
|
<p>Hexadecimal characters should be enclosed in apostrophes and preceded by an uppercase X, for example X'A1A2A3A4'. Any hexadecimal value will be accepted, but, if the value is not a printable character, the entry will be rejected when it is defined to a control region.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDCICSCVT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDCICSCVT.CNVCHRID"></a>
|
|
<h3>Character identifier (CNVCHRID)</h3>
|
|
<p>Enter the code page and character set for the character data representation that will be used by the remote system.
|
|
</p>
|
|
<p>The representation may either be specified by a code page and character set pair, or by a CCSID
|
|
</p>
|
|
<p>There are two elements to this field. Possible values are:
|
|
</p>
|
|
<ul>
|
|
<li><b>Element 1: Code page</b>
|
|
<p>The code page or CCSID of the representation used by the remote system.
|
|
</p>
|
|
<ul>
|
|
<li><b>code-page:</b> Enter the code page identifier, a number in the range 1 through 65535. An appropriate character set must be specified in element 2.
|
|
</li>
|
|
<li><b>CCSID:</b> Enter a CCSID, a number in the range 1 through 65535. Element 2 must be set to 0 or specified as the special value *CCSID.
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
<li><b>Element 2: Graphic character set</b>
|
|
<p>Enter the graphic character set to be used by the conversion, or the special value *CCSID if element 1 represents a CCSID rather than a code page
|
|
</p>
|
|
<ul>
|
|
<li><b>character-set:</b> Enter an appropriate character set identifier, a number in the range 2 through 65535.
|
|
</li>
|
|
<li><b>*CCSID</b><i>, </i><b>0</b><i>, </i><b>1:</b> Element 1 contains a CCSID.
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
<p>When installed into a control region, if translation tables for a given code page and character set pair can not be found, and the given code page is recognised as a supported CCSID, then the code page will be treated as if it had been specified as a CCSID.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDCICSCVT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDCICSCVT.CNVINF"></a>
|
|
<h3>Conversion information (CNVINF)</h3>
|
|
<p>This field defines a default conversion template. Use this field to define conversion information for data that does not satisfy the selection criteria defined in the selection criteria field.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>Use the key information field for converting key fields.
|
|
</p>
|
|
<p>Specify:
|
|
</p>
|
|
<ul>
|
|
<li>The position of the data in the record.
|
|
</li>
|
|
<li>The type of data in the field.
|
|
</li>
|
|
<li>The length of the data.
|
|
</li>
|
|
<li>Whether or not the data contains shift out/shift in (SO/SI) characters.
|
|
</li>
|
|
</ul>
|
|
<p>There are 4 elements to this field. Possible values are:
|
|
</p>
|
|
<ul>
|
|
<li><b>Element 1: Starting location (offset)</b>
|
|
<p>The position in the record of the start of the data to be converted.
|
|
</p>
|
|
<ul>
|
|
<li>0: Conversion should start at the beginning of the file.
|
|
</li>
|
|
<li><b>offset:</b> A number in the range 0 through 65535.
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
<li><b>Element 2: Type of conversion</b>
|
|
<p>Type of conversion to be done on the field.
|
|
</p>
|
|
<ul>
|
|
<li>*CHAR: The data is alphabetic and will be converted from the code page specified in the character identifier (CNVCHRID) parameter to the iSeries code page specified in the iSeries system values.
|
|
</li>
|
|
<li><b>*PACKED:</b> The data is in packed decimal format and will not be converted.
|
|
</li>
|
|
<li><b>*BINARY:</b> The data is in binary format and will not be converted.
|
|
</li>
|
|
<li><b>*IDC:</b> The data is in ideographic format and will be converted from the character set specified in the CNVCHRID field to the iSeries code page specified in the iSeries system values.
|
|
</li>
|
|
<li><b>*INTEL:</b> The data is in INTEL format and will be converted by reversing the bytes The field can only have a length of two or four.
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
<li><b>Element 3: Length of conversion</b>
|
|
<p>The length in bytes of the field to be converted.
|
|
</p>
|
|
<ul>
|
|
<li>1: A data length of one byte will be converted.
|
|
</li>
|
|
<li><b>length:</b> Enter a number in the range 1 through 65535. If the data is in INTEL format, this field must contain 2 or 4.
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
<li><b>Element 4: User specified DBCS data (SO/SI)</b>
|
|
<p>This element, which is valid only when type of *CHAR is specified for the field, indicates whether or not the data to be converted contains SO/SI delimiters. When SO/SI delimiters are used then only data prior to the SO delimiter and after the SI delimiter is converted, if the language is not an ideographic based one.
|
|
</p>
|
|
<ul>
|
|
<li>*NO: The data does not have SO/SI characters.
|
|
</li>
|
|
<li><b>*YES:</b> The data has SO/SI characters.
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDCICSCVT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDCICSCVT.KEYINF"></a>
|
|
<h3>Key conversion data (KEYINF)</h3>
|
|
<p>This field defines the conversion template for one key field. Specify:
|
|
</p>
|
|
<ul>
|
|
<li>The position of the key field in the record.
|
|
</li>
|
|
<li>The length of the key.
|
|
</li>
|
|
<li>The type of conversion to be applied to the key.
|
|
</li>
|
|
</ul>
|
|
<p>This parameter is only valid for a command type of *FILE is specified, and if the file is accessed using keys, that is it is a key-sequenced data set (KSDS).
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>The FCT entry will define the location of the key.
|
|
</p>
|
|
<p>Possible values are:
|
|
</p>
|
|
<ul>
|
|
<li><b>Element 1: Starting location (offset)</b>
|
|
<p>The position in the record of the key field.
|
|
</p>
|
|
<ul>
|
|
<li>0: The key is at the beginning of the record.
|
|
</li>
|
|
<li><b>offset:</b> A number in the range 0 through 65535 that gives the key position in bytes from the start of the record.
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
<li><b>Element 2: Type of conversion</b>
|
|
<p>The type of conversion to be done on the field.
|
|
</p>
|
|
<ul>
|
|
<li>*CHAR: The data is alphabetic and will be converted from the code page specified in the CNVCHRID field to the iSeries code page specified in the iSeries system values.
|
|
</li>
|
|
<li><b>*PACKED:</b> The data is in packed decimal format and will not be converted.
|
|
</li>
|
|
<li><b>*BINARY:</b> The data is in binary format and will not be converted.
|
|
</li>
|
|
<li><b>*IDC:</b> The data is in ideographic format and will be converted from the character set specified in the CNVCHRID field to the iSeries code page specified in the iSeries system values.
|
|
</li>
|
|
<li><b>*INTEL:</b> The data is in INTEL format and will be converted by reversing the bytes The field can only have a length of two or four.
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
<li><b>Element 3: Length of conversion</b>
|
|
<p>The length in bytes of the field to be converted.
|
|
</p>
|
|
<ul>
|
|
<li>1: A data length of one byte will be converted.
|
|
</li>
|
|
<li><b>length:</b> Enter a number in the range 1 through 65535. If the data is in INTEL format, this field must contain 2 or 4.
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
<li><b>Element 4: User specified DBCS data (SO/SI)</b>
|
|
<p>This element, which is valid only when type of *CHAR is specified for the field, indicates whether or not the data to be converted contains SO/SI delimiters. When SO/SI delimiters are used then only data prior to the SO delimiter and after the SI delimiter is converted, if the language is not an ideographic based one.
|
|
</p>
|
|
<ul>
|
|
<li>*NO: The data does not have SO/SI characters.
|
|
</li>
|
|
<li><b>*YES:</b> The data has SO/SI characters.
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDCICSCVT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="ADDCICSCVT.SLTCTL"></a>
|
|
<h3>Selection criteria (SLTCTL)</h3>
|
|
<p>Enter the selection criteria and the conversion information for each field in the user data that is to be sent from, or to, another CICS system. Selection criteria consists of the position and value to be checked in the user data in order to use the associated conversion information. The conversion information consists of position and length of the field and the type of conversion to be applied to it.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>When the user data did not satisfy the conditions that are specified by any of the selection criteria, then the conversion information (CNVINF) field is used to convert the user data.
|
|
</p>
|
|
<p>Possible values are:
|
|
</p>
|
|
<ul>
|
|
<li><b>Element 1: Starting location (Offset)</b>
|
|
<p>The position in the record where the comparison of data should start.
|
|
</p>
|
|
<ul>
|
|
<li>0: The comparison should start at the beginning of the record.
|
|
</li>
|
|
<li><b>offset:</b> Enter a number in the range 0 through 65535 that specifies the position in bytes of the start of the data.
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
<li><b>Element 2: Character or hex format</b>
|
|
<p>Indicates whether the selection data is character or hexadecimal data.
|
|
</p>
|
|
<ul>
|
|
<li>*CHAR: Character data.
|
|
</li>
|
|
<li><b>*HEX:</b> Hexadecimal data.
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
<li><b>Element 3: Value to compare against (text)</b>
|
|
<p>The value with which the data is to be compared, in order to use the associated conversion information.
|
|
</p>
|
|
<ul>
|
|
<li><b>text:</b> Alphanumeric and up to 254 characters or 127 hexadecimal characters.
|
|
</li>
|
|
</ul>
|
|
<p><b>Selection information (SLTINF)</b>
|
|
</p>
|
|
<p>The conversion information for each field in the user data to be used when the selection criteria is a match.
|
|
</p>
|
|
<p>Possible values are:
|
|
</p>
|
|
<ul>
|
|
<li><b>Element 1: Starting location (offset)</b>
|
|
<p>The position in the record where conversion of data should start.
|
|
</p>
|
|
<ul>
|
|
<li>0: Conversion of data should start at the beginning of the record.
|
|
</li>
|
|
<li><b>offset:</b> A number in the range 0 through 65535 that gives the position in bytes from the start of the record.
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
<li><b>Element 2: Type of conversion</b>
|
|
<p>The type of conversion to be done on the field.
|
|
</p>
|
|
<ul>
|
|
<li>*CHAR: The data is alphabetic and will be converted from the code page specified in the CNVCHRID field to the iSeries code page specified in the iSeries system values.
|
|
</li>
|
|
<li><b>*PACKED:</b> The data is in packed decimal format and will not be converted.
|
|
</li>
|
|
<li><b>*BINARY:</b> The data is in binary format and will not be converted.
|
|
</li>
|
|
<li><b>*IDC:</b> The data is in ideographic format and will be converted from the character set specified in the CNVCHRID field to the iSeries code page specified in the iSeries system values.
|
|
</li>
|
|
<li><b>*INTEL:</b> The data is in INTEL format and will be converted by reversing the bytes The field can only have a length of two or four.
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
<li><b>Element 3: Length of conversion</b>
|
|
<p>The length in bytes of the field to be converted.
|
|
</p>
|
|
<ul>
|
|
<li>1: A data length of one byte will be converted.
|
|
</li>
|
|
<li><b>length:</b> Enter a number in the range 1 through 65535. If the data is in INTEL format, this field must contain 2 or 4.
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
<li><b>Element 4: User specified DBCS data (SO/SI)</b>
|
|
<p>This element, which is valid only when type of *CHAR is specified for the field, indicates whether or not the data to be converted contains SO/SI delimiters. When SO/SI delimiters are used then only data prior to the SO delimiter and after the SI delimiter is converted, if the language is not an ideographic based one.
|
|
</p>
|
|
<ul>
|
|
<li>*NO: The data does not have SO/SI characters.
|
|
</li>
|
|
<li><b>*YES:</b> The data has SO/SI characters.
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDCICSCVT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div>
|
|
<h3><a name="ADDCICSCVT.COMMAND.EXAMPLES">Examples</a></h3>None
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDCICSCVT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div>
|
|
<h3><a name="ADDCICSCVT.ERROR.MESSAGES">Error messages</a></h3>Unknown
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#ADDCICSCVT.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|