INTERFACENAME

Property

Value

Kind

Client library or connection library

Type

EBCDIC string

Read

Anytime

Write

Client libraries: While not linked

Connection libraries: While not ready and no connections are linked

Default

Value of INTNAME library attribute

Explanation

The INTERFACENAME library attribute identifies a particular connection library in a connection library program.

The INTERFACENAME library attribute does not identify the program that contains the connection library. To identify that program, you must use the LIBACCESS library attribute, usually in combination with the TITLE library attribute or the FUNCTIONNAME library attribute.

Direct Library Linkages

The INTERFACENAME library attribute has no effect when direct library linkage is used. Refer to Directly Linking to Server Libraries and Directly Linking Connection Libraries earlier in this section.

Connection Libraries

Connection library programs can potentially contain more than one connection library. To provide unique identification, you should assign a different INTERFACENAME value to each connection library that is declared in the same program.

Client Libraries

You can assign the INTERFACENAME value to a client library. This attribute has no effect if the client library links to a server library. However, if the client library links to a connection library, the INTERFACENAME attribute of the client library specifies the connection library to link to in the connection library program.

Also, if the client library links to a server library program that includes a connection library, and the INTERFACENAME value matches the connection library, then the system links the client library to the connection library instead of to the server library.