Change Contact Information (QEDCHGIN) API
Required Parameter Group:
| 1 | Contact information | Input | Char(*) |
| 2 | Length of contact information | Input | Binary(4) |
| 3 | Format name | Input | Char(8) |
| 4 | Error Code | I/O | Char(*) |
Default Public Authority: *EXCLUDE
Threadsafe: Yes
The Change Contact Information (QEDCHGIN) API updates the contact information that is supplied to a service provider when a problem is reported or a PTF is requested.
Authorities and Locks
None.
Required Parameter Group
- Contact information
- INPUT; CHAR(*)
The contact information that is changed.
- Length of contact information
- INPUT; BINARY(4)
The total length in bytes of the contact information input variable.
- Format name
- INPUT; CHAR(8)
The format of the contact information input data. The possible values are:
- CNTC0100
- This format updates all of the contact information. See CNTC0100 Format for details.
Error code- I/O; CHAR(*)
The structure in which to return error information. For the format of the structure, see Error code parameter.
CNTC0100 Format
Use this format when changing contact information. For detailed descriptions of the fields in this table, see Field Descriptions.
| Offset | Type | Field | |
|---|---|---|---|
| Dec | Hex | ||
| 0 | 0 | Char(36) | Company name |
| 36 | 24 | Char(36) | Contact name |
| 72 | 48 | Char(20) | Primary telephone number |
| 92 | 5C | Char(20) | Help desk or pager number |
| 112 | 70 | Char(20) | Primary fax number |
| 132 | 84 | Char(20) | Alternative fax number |
| 152 | 98 | Char(36) | Street address line 1 |
| 188 | BC | Char(36) | Street address line 2 |
| 224 | E0 | Char(36) | Street address line 3 |
| 260 | 104 | Char(36) | City or locality |
| 296 | 128 | Char(36) | State or province |
| 332 | 14C | Char(20) | Country or region |
| 352 | 160 | Char(12) | Postal code |
| 364 | 16C | Binary(4) | Offset to primary electronic mail address |
| 368 | 170 | Binary(4) | Length of primary electronic mail address |
| 372 | 174 | Binary(4) | Offset to alternative electronic mail address |
| 376 | 178 | Binary(4) | Length of alternative electronic mail address |
| 380 | 17C | Binary(4) | Media for mailing PTFs |
| 384 | 180 | Char(10) | National language version |
| 394 | 18A | Char(2) | Reserved |
| 396 | 18C | Binary(4) | Call central site support |
| 400 | 190 | Char(8) | Customer identifier 1 |
| 408 | 198 | Char(8) | Customer identifier 2 |
| 416 | 1A0 | Char(8) | Customer identifier 3 |
| 424 | 1A8 | Char(8) | Customer identifier 4 |
| 432 | 1B0 | Char(8) | Customer identifier 5 |
| 440 | 1B8 | Char(7) | Contract identifier 1 |
| 447 | 1BF | Char(7) | Contract identifier 2 |
| 454 | 1C6 | Char(7) | Contract identifier 3 |
| 461 | 1CD | Char(7) | Contract identifier 4 |
| 468 | 1D4 | Char(7) | Contract identifier 5 |
| 475 | 1DB | Char(1) | Reserved2 |
| 476 | 1DC | Binary(4) | Offset to customer description 1 |
| 480 | 1E0 | Binary(4) | Length of customer description 1 |
| 484 | 1E4 | Binary(4) | Offset to customer description 2 |
| 488 | 1E8 | Binary(4) | Length of customer description 2 |
| 492 | 1EC | Binary(4) | Offset to customer description 3 |
| 496 | 1F0 | Binary(4) | Length of customer description 3 |
| 500 | 1F4 | Binary(4) | Offset to customer description 4 |
| 504 | 1F8 | Binary(4) | Length of customer description 4 |
| 508 | 1FC | Binary(4) | Offset to customer description 5 |
| 512 | 200 | Binary(4) | Length of customer description 5 |
| 516 | 204 | Binary(4) | Offset to contract description 1 |
| 520 | 208 | Binary(4) | Length of contract description 1 |
| 524 | 20C | Binary(4) | Offset to contract description 2 |
| 528 | 210 | Binary(4) | Length of contract description 2 |
| 532 | 214 | Binary(4) | Offset to contract description 3 |
| 536 | 218 | Binary(4) | Length of contract description 3 |
| 540 | 21C | Binary(4) | Offset to contract description 4 |
| 544 | 220 | Binary(4) | Length of contract description 4 |
| 548 | 224 | Binary(4) | Offset to contract description 5 |
| 552 | 228 | Binary(4) | Length of contract description 5 |
| * | * | Char(*) | Primary electronic mail address |
| * | * | Char(*) | Alternative electronic mail address |
| * | * | Char(*) | Customer description 1 |
| * | * | Char(*) | Customer description 2 |
| * | * | Char(*) | Customer description 3 |
| * | * | Char(*) | Customer description 4 |
| * | * | Char(*) | Customer description 5 |
| * | * | Char(*) | Contract description 1 |
| * | * | Char(*) | Contract description 2 |
| * | * | Char(*) | Contract description 3 |
| * | * | Char(*) | Contract description 4 |
| * | * | Char(*) | Contract description 5 |
Field Descriptions
Alternative electronic mail address. The electronic mail (e-mail) address where information for the person specified for the Contact can be sent, if the primary e-mail address is not available.
| *SAME | The value does not change. |
| *NONE | There is no alternative electronic mail address for the contact person. |
| character-value | Specify the alternative electronic mail address. |
Alternative fax number. The complete telephone number where information for the Contact can be faxed, if the primary fax number is not available. This number should include the area code, exchange numbers, and the extension.
| *SAME | The value does not change. |
| *NONE | There is no alternative fax number for the contact person. |
| character-value | Specify the alternative fax number. |
Call central site support. It will be used to indicate that a customer wants their Central Site Support desk called by the CE or the Product Support center. The call central site support options available are:
| 0 = *NO | The central site support desk is not called. |
| 1 = *YES | The central site support desk will be called by the CE or the Product Support center. |
| -1 = *SAME | The value does not change. |
City or locality. The city or locality name for the location to which you want your service provider to send parts or assistance.
| *SAME | The value does not change. |
| character-value | Specify the city or locality. |
Company name. The name of the organization that owns or is responsible for this system. The name should appear in this field as it appears on a mailing label.
| *SAME | The value does not change. |
| character-value | Specify the company name. |
Contact name. 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.
| *SAME | The value does not change. |
| character-value | Specify the contact person's name. |
Contract identifier 1, 2, 3, 4 and 5. A unique identifier IBM assigned to the customer's services contract. This number enables the look-up of all customer purchased services under the identified contract.
| *SAME | The value does not change. |
| *NONE | No additional contract identifier information is provided. |
| character-value | Specify the contract identifier. Up to five lines of contract identifier information can be specified. Each line is a separate parameter element. The value cannot contains blanks and must contain only digits 0-9 and uppercase letters A-Z |
Contract description 1, 2, 3, 4 and 5. The contract description.
| *SAME | The value does not change. |
| *NONE | No additional contract identifier information is provided. |
| character-value | Specify the contract description. Up to five lines of contract identifier information can be specified. Each line is a separate parameter element. Which can be up to 256 characters long. |
Country or region. The country or region where the company is located to which the service provider should send parts or assistance.
| *SAME | The value does not change. |
| character-value | Specify the country or region. |
Customer identifier 1, 2, 3, 4 and 5. A unique number that IBM has assigned to the customer. This number is used to identify the customer during a multitude of business and services transactions.
| *SAME | The value does not change. |
| *NONE | No additional customer identifier information is provided. |
| character-value | Specify the customer identifier. Up to five lines of customer identifier information can be specified. Each line is a separate parameter element. The value cannot contains blanks and must contain only digits 0-9. |
Customer description 1, 2, 3, 4 and 5. The customer description.
| *SAME | The value does not change. |
| *NONE | No additional customer identifier information is provided. |
| character-value | Specify the customer description. Up to five lines of customer identifier information can be specified. Each line is a separate parameter element which can be up to 256 characters long. |
Help desk or pager number. The complete Help desk or pager number. This number should include the area code, exchange numbers, and the extension.
| *SAME | The value does not change. |
| *NONE | There is no Help desk telephone number. |
| character-value | Specify the Help desk telephone number. |
Length of alternative electronic mail address. The length of the alternative electronic mail address.
Length of contract description 1, 2, 3, 4 and 5. The length of contract description 1, 2, 3, 4 and 5.
Length of customer description 1, 2, 3, 4 and 5. The length of customer description 1, 2, 3, 4 and 5.
Length of primary electronic mail address. The length of the primary electronic mail address.
Media for PTFs. The media currently used for mailing program temporary fixes (PTFs). The media options available are:
| 0 = *SAME | The value does not change. |
| 1 = *AUTOMATIC | The system will automatically select the media to be used for sending PTFs. If the system does not detect any device, the default value will be *DVDROM. |
| 2 = *CDROM | PTFs will be sent on CD-ROM media. |
| 3 = *DVDROM | PTFs will be sent on DVD-ROM media. |
National language version. The national language version code currently being used for PTF cover letters. If the cover letter you ordered has not been translated into this language the cover letter will be sent in U.S. English.
| *SAME | The value does not change. |
| *PRIMARY | The language version for the currently installed primary national language on the system is used. |
| character-value | Specify the preferred language version code to be used for PTF cover letters. |
Offset to alternative electronic mail address. The offset to the alternative electronic mail address.
Offset to contract description 1,2,3,4 and 5. The offset to contract description 1, 2, 3, 4 and 5.
Offset to customer description 1,2,3,4 and 5. The offset to customer description 1, 2, 3, 4 and 5.
Offset to primary electronic mail address. The offset to the primary electronic mail address.
Postal code. The Postal code for the location to which the service provider should send parts or assistance.
| *SAME | The value does not change. |
| character-value | Specify the Postal code. |
Primary electronic mail address. The electronic mail (e-mail) address where information for the person specified for the Contact can be sent.
| *SAME | The value does not change. |
| *NONE | There is no primary electronic mail address for the contact person. |
| character-value | Specify the primary electronic mail address. |
Primary fax number. The complete telephone number where information for the Contact can be faxed. This number should include the area code, exchange numbers, and the extension
| *SAME | The value does not change. |
| *NONE | There is no primary fax number for the contact person. |
| character-value | Specify the primary fax number. |
Primary telephone number. The complete telephone number where the person named for the Contact may be reached most often. This number should include the area code, exchange numbers, and the extension.
| *SAME | The value does not change. |
| character-value | Specify the primary telephone number. |
State or province. The state or province names for the location to which you want your service provider to send parts or assistance.
| *SAME | The value does not change. |
| *NONE | There is no State or province. |
| character-value | Specify the State or province. |
Street address lines 1, 2 and 3. 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 not be a post office box.
| *SAME | The value does not change. |
| *NONE | No additional street address information is provided. This value is valid for lines 2 and 3, but not for line 1. |
| character-value | Specify the street address. 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. |
Error Messages
The following messages may be sent from this function:
| Message ID | Error Message Text |
|---|---|
| CPF24B4 | Severe error while addressing parameter list. |
| CPF3CF1 | Error code parameter not valid. |
| CPF3CF2 | Error(s) occurred during running of &1 API. |
| CPF3C19 | Error occurred with receiver variable specified. |
| CPF3C21 | Format name &1 is not valid. |
| CPF3C24 | Length of the receiver variable is not valid. |
| CPF8C83 | One or more required fields to add contact information missing. See previous messages. |
API introduced: V5R4
[ Back to top | Problem Management APIs | APIs by category ]