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

442 lines
14 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>Change Contact Information (CHGCNTINF)</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="CHGCNTINF.Top_Of_Page"></a>
<h2>Change Contact Information (CHGCNTINF)</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="#CHGCNTINF.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CHGCNTINF.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CHGCNTINF.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CHGCNTINF"></a>
<p>The Change Contact Information command enables you to change the local service information that helps you contact, or be contacted by, various support centers.
</p>
<p><b>Restrictions:</b>
</p>
<ul>
<li>If the contact information has not been set previously by running this command or by using the Work with Contact Information (WRKCNTINF) command, the default value of *SAME will not be valid for some of the command parameters.
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGCNTINF.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CHGCNTINF.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="#CHGCNTINF.CMPNY"><b>CMPNY</b></a></td>
<td valign="top">Company</td>
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGCNTINF.CONTACT"><b>CONTACT</b></a></td>
<td valign="top">Contact</td>
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#CHGCNTINF.TELNBR"><b>TELNBR</b></a></td>
<td valign="top">Contact telephone numbers</td>
<td valign="top"><i>Element list</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Primary</td>
<td valign="top">
<i>Character value</i>, <b><u>*SAME</u></b></td>
</tr>
<tr>
<td valign="top">Element 2: Help desk or pager number</td>
<td valign="top">
<i>Character value</i>, <b><u>*SAME</u></b>, *NONE</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#CHGCNTINF.FAXTELNBR"><b>FAXTELNBR</b></a></td>
<td valign="top">Fax telephone numbers</td>
<td valign="top"><i>Element list</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Primary</td>
<td valign="top">
<i>Character value</i>, <b><u>*SAME</u></b>, *NONE</td>
</tr>
<tr>
<td valign="top">Element 2: Alternative</td>
<td valign="top">
<i>Character value</i>, <b><u>*SAME</u></b>, *NONE</td>
</tr>
<tr>
<td valign="top" rowspan="8"><a href="#CHGCNTINF.MAILADDR"><b>MAILADDR</b></a></td>
<td valign="top">Mailing address</td>
<td valign="top"><i>Element list</i></td>
<td valign="top" rowspan="8">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Street address line 1</td>
<td valign="top">
<i>Character value</i>, <b><u>*SAME</u></b></td>
</tr>
<tr>
<td valign="top">Element 2: Street address line 2</td>
<td valign="top">
<i>Character value</i>, <b><u>*SAME</u></b>, *NONE</td>
</tr>
<tr>
<td valign="top">Element 3: Street address line 3</td>
<td valign="top">
<i>Character value</i>, <b><u>*SAME</u></b>, *NONE</td>
</tr>
<tr>
<td valign="top">Element 4: City or locality</td>
<td valign="top">
<i>Character value</i>, <b><u>*SAME</u></b></td>
</tr>
<tr>
<td valign="top">Element 5: State or province</td>
<td valign="top">
<i>Character value</i>, <b><u>*SAME</u></b>, *NONE</td>
</tr>
<tr>
<td valign="top">Element 6: Country or region</td>
<td valign="top">
<i>Character value</i>, <b><u>*SAME</u></b></td>
</tr>
<tr>
<td valign="top">Element 7: Postal code</td>
<td valign="top">
<i>Character value</i>, <b><u>*SAME</u></b></td>
</tr>
<tr>
<td valign="top"><a href="#CHGCNTINF.LNGVER"><b>LNGVER</b></a></td>
<td valign="top">National language version</td>
<td valign="top">2902-2998, <b><u>*SAME</u></b>, *PRIMARY</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#CHGCNTINF.EMAILADDR"><b>EMAILADDR</b></a></td>
<td valign="top">Electronic mail addresses</td>
<td valign="top"><i>Element list</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Primary</td>
<td valign="top">
<i>Character value</i>, <b><u>*SAME</u></b>, *NONE</td>
</tr>
<tr>
<td valign="top">Element 2: Alternative</td>
<td valign="top">
<i>Character value</i>, <b><u>*SAME</u></b>, *NONE</td>
</tr>
<tr>
<td valign="top"><a href="#CHGCNTINF.MEDPTF"><b>MEDPTF</b></a></td>
<td valign="top">Media for mailing PTFs</td>
<td valign="top"><b><u>*SAME</u></b>, *AUTOMATIC, *CDROM</td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#CHGCNTINF.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CHGCNTINF.CMPNY"></a>
<h3>Company (CMPNY)</h3>
<p>Specifies the name of the organization that owns or is responsible for this system.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b><i>character-value</i></b></dt>
<dd>Specify the company name, enclosed in apostrophes.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGCNTINF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGCNTINF.CONTACT"></a>
<h3>Contact (CONTACT)</h3>
<p>Specifies the name of the person in your organization who is responsible for repairs and maintenance on the system. This person may be called by the service provider with information or assistance for a system problem. Also, parts or PTFs may be sent to this person.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b><i>character-value</i></b></dt>
<dd>Specify the contact person's name, enclosed in apostrophes.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGCNTINF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGCNTINF.TELNBR"></a>
<h3>Contact telephone numbers (TELNBR)</h3>
<p>Specifies the telephone numbers where the contact person can be reached.
</p>
<p><b>Element 1: Primary</b>
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b><i>character-value</i></b></dt>
<dd>Specify the complete telephone number where the person specified for the <b>Contact (CONTACT)</b> parameter may be reached most often. This number should include the area code, exchange numbers, and the extension.
</dd>
</dl>
<p><b>Element 2: Help desk or pager number</b>
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b>*NONE</b></dt>
<dd>There is no help desk telephone number or pager telephone number for the contact person.
</dd>
<dt><b><i>character-value</i></b></dt>
<dd>Specify the complete help desk or pager number. This number should include the area code, exchange numbers, and the extension.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGCNTINF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGCNTINF.FAXTELNBR"></a>
<h3>Fax telephone numbers (FAXTELNBR)</h3>
<p>Specifies the facsimile (fax) telephone numbers where information for the contact person can be transmitted.
</p>
<p><b>Element 1: Primary</b>
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b>*NONE</b></dt>
<dd>There is no primary fax number for the contact person.
</dd>
<dt><b><i>character-value</i></b></dt>
<dd>Specify the complete fax telephone number where information for the person specified for the <b>Contact (CONTACT)</b> parameter can be sent. This number should include the area code, exchange numbers, and the extension.
</dd>
</dl>
<p><b>Element 2: Alternative</b>
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b>*NONE</b></dt>
<dd>There is no alternative fax number for the contact person.
</dd>
<dt><b><i>character-value</i></b></dt>
<dd>Specify the complete fax telephone number where the information for the person specified for the <b>Contact (CONTACT)</b> parameter can be sent, if the primary fax number is not available. This number should include the area code, exchange numbers, and the extension.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGCNTINF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGCNTINF.MAILADDR"></a>
<h3>Mailing address (MAILADDR)</h3>
<p>Specifies the mailing address of the person specified for the <b>Contact (CONTACT)</b> parameter.
</p>
<p><b>Elements 1,2,3: Street address</b>
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b>*NONE</b></dt>
<dd>No additional street address information is provided. This value is valid for elements 2 and 3, but not for element 1.
</dd>
<dt><b><i>character-value</i></b></dt>
<dd>Specify the postal number and street name of the location to which you want your service provider to send parts or assistance for the problem. This should <b>not</b> be a post office box. Up to three lines of street address information can be specified. Each line is a separate parameter element, which can be up to 36 characters long, and should be enclosed in apostrophes.
</dd>
</dl>
<p><b>Element 4: City or locality</b>
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b><i>character-value</i></b></dt>
<dd>Specify the name of the city or locality to which you want your service provider to send parts or assistance.
</dd>
</dl>
<p><b>Element 5: State or province</b>
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b>*NONE</b></dt>
<dd>There is no state or province.
</dd>
<dt><b><i>character-value</i></b></dt>
<dd>Specify the name of the state or province to which you want your service provider to send parts or assistance.
</dd>
</dl>
<p><b>Element 6: Country or region</b>
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b><i>character-value</i></b></dt>
<dd>Specify the name of the country or region to which the service provider should send parts or assistance.
</dd>
</dl>
<p><b>Element 7: Postal code</b>
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b><i>character-value</i></b></dt>
<dd>Specify the postal code for the location to which the service provider should send parts or assistance.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGCNTINF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGCNTINF.LNGVER"></a>
<h3>National language version (LNGVER)</h3>
<p>Specifies the preferred language version to be used for program temporary fix (PTF) cover letters. PTF cover letters are initially written in U.S. English. Some of the cover letters are translated into other languages and may be ordered in the other languages. If the cover letter you ordered has not been translated into your preferred language, the cover letter will be sent in U.S. English.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b>*PRIMARY</b></dt>
<dd>The language version for the currently installed primary national language on the system is used.
</dd>
<dt><b><i>integer-number</i></b></dt>
<dd>Specify the preferred language version to be used for PTF cover letters.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGCNTINF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGCNTINF.EMAILADDR"></a>
<h3>Electronic mail addresses (EMAILADDR)</h3>
<p>Specifies the electronic mail (e-mail) address for the contact person.
</p>
<p><b>Element 1: Primary</b>
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b>*NONE</b></dt>
<dd>There is no primary e-mail address for the contact person.
</dd>
<dt><b><i>character-value</i></b></dt>
<dd>Specify the e-mail address where information for the person specified for the <b>Contact (CONTACT)</b> parameter can be sent. For example, 'john.brown@mycompany.com'.
</dd>
</dl>
<p><b>Element 2: Alternative</b>
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b>*NONE</b></dt>
<dd>There is no alternative e-mail address for the contact person.
</dd>
<dt><b><i>character-value</i></b></dt>
<dd>Specify the e-mail address where the information for the person specified for the <b>Contact (CONTACT)</b> parameter can be sent, if the primary e-mail address is not available.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGCNTINF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGCNTINF.MEDPTF"></a>
<h3>Media for mailing PTFs (MEDPTF)</h3>
<p>Specifies the media to be used for mailing program temporary fixes (PTFs).
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b>*AUTOMATIC</b></dt>
<dd>The system will automatically select the media to be used for sending PTFs.
</dd>
<dt><b>*CDROM</b></dt>
<dd>PTFs will be sent on CD-ROM media.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGCNTINF.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGCNTINF.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Change Contact Telephone Number</b>
</p>
<p>
<pre>
CHGCNTINF TELNBR('1-507-345-6789')
</pre>
</p>
<p>This command changes the primary telephone number for the contact person. No help desk or pager number is provided, so the help desk or pager number does not change.
</p>
<p><b>Example 2: Change Contact Information Values</b>
</p>
<p>
<pre>
CHGCNTINF CONTACT('John Smith')
TELNBR('1-507-123-4567' '1-507-123-7654')
FAXTELNBR('1-507-123-4444')
</pre>
</p>
<p>This command changes the contact person name, the primary and help desk or pager numbers and the primary fax number.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGCNTINF.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGCNTINF.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF8C84</b></dt>
<dd>Error detected while processing support contact data.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGCNTINF.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>