Retrieve Contact Information (QEDRTVCI)
APIRetrieve Contact Information (QEDRTVCI)
API| 1 | Receiver variable | Output | Char(*) |
| 2 | Length of receiver variable | Input | Binary(4) |
| 3 | Format name | Input | Char(8) |
| 4 | Error Code | I/O | Char(*) |
The Retrieve Contact Information (QEDRTVCI) API returns the contact information that is supplied to a service provider when a problem is reported or a PTF is requested.
None.
The receiver variable that receives the information requested. You can specify the size of the area to be smaller than the format requested as long as you specify the length parameter correctly. As a result, the API returns only the data that the area can hold.
The length of the receiver variable provided. The length of receiver variable parameter may be specified up to the size of the receiver variable specified in the user program. If the length of receiver variable parameter specified is larger than the allocated size of the receiver variable specified in the user program, the results are not predictable. The minimum length is 8 bytes.
The format of the contact information to be returned. The possible values are:
The structure in which to return error information. For the format of the structure, see Error Code Parameter.
The following information is returned by this API when CNTI0100 format. For detailed descriptions of the fields in the table, see Field Descriptions
| Offset | Type | Field | |
|---|---|---|---|
| Dec | Hex | ||
| 0 | 0 | Binary(4) | Bytes returned |
| 4 | 4 | Binary(4) | Bytes available |
| 8 | 8 | Char(36) | Company name |
| 44 | 2C | Char(36) | Contact name |
| 80 | 50 | Char(20) | Primary telephone number |
| 100 | 64 | Char(20) | Help desk or pager number |
| 120 | 78 | Char(20) | Primary fax number |
| 140 | 8C | Char(20) | Alternative fax number |
| 160 | A0 | Char(36) | Street address line 1 |
| 196 | C4 | Char(36) | Street address line 2 |
| 232 | E8 | Char(36) | Street address line 3 |
| 268 | 10C | Char(36) | City or locality |
| 304 | 130 | Char(36) | State or province |
| 340 | 154 | Char(20) | Country or region |
| 360 | 168 | Char(12) | Postal code |
| 372 | 174 | Binary(4) | Offset to primary electronic mail address |
| 376 | 178 | Binary(4) | Length of primary electronic mail address |
| 380 | 17C | Binary(4) | Offset to alternative electronic mail address |
| 384 | 180 | Binary(4) | Length of alternative electronic mail address |
| 388 | 184 | Binary(4) | Media for mailing PTFs |
| 392 | 188 | Char(4) | National language version |
| * | * | Char(*) | Primary electronic mail address |
| * | * | Char(*) | Alternative electronic mail address |
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. The e-mail is returned as UTF8. The following special values might be returned:
| *NONE | There is no alternative electronic mail address for the contact person. |
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. The following special values might be returned:
| *NONE | There is no alternative fax number for the contact person. |
Bytes available. The number of bytes of data available to be returned. All available data is returned if enough space is provided.
Bytes returned. The number of bytes of data returned.
City or locality. The City or locality name for the location to which you want your service provider to send parts or assistance.
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.
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.
Country or region. The Country or region where the company is located to which the service provider should send parts or assistassnce.
Help desk or pager number. The complete Help desk or pager number. This number should include the area code, exchange numbers, and the extension. The following special values might be returned:
| *NONE | There is no Help desk or pager number. |
Length of alternative electronic mail address. The length of the alternative electronic mail address.
Length of primary electronic mail address. The length of the primary electronic mail address.
Media for mailing PTFs. The media currently used for mailing program temporary fixes (PTFs). The media options available are:
| 1 = *AUTOMATIC | The system will automatically select the media to be used for sending PTFs. |
| 2 = *CDROM | PTFs will be sent on CD-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.
Offset to alternative electronic mail address. The offset to the alternative electronic mail address.
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.
Primary electronic mail address. The electronic mail (e-mail) address where information for the person specified for the Contact can be sent. The e-mail is returned as UTF8. The following special values might be returned:
| *NONE | There is no primary electronic mail address for the contact person. |
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. The following special values might be returned:
| *NONE | There is no primary fax number for the contact person. |
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.
State or province. The state or province names for the location to which you want your service provider to send parts or assistance. The following special values might be returned:
| *NONE | There is no 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. The following special values might be returned:
| *NONE | No additional street address information is provided. This value is valid for lines 2 and 3, but not for line 1. |
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. |
| CPF8C81 | No Contact Information is available. |
| Top | Problem Management APIs | APIs by category |