Start of changeChange 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 Format CNTC0100 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
* * Char(*) Primary electronic mail address
* * Char(*) Alternative electronic mail address


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.

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.

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.

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 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:

0 = *SAME The value does not change.
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.

*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 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.


End of change
API introduced: V5R4
Top | Problem Management APIs | APIs by category