Connection factory properties for optimized local adapters on Liberty
Use the properties for the WebSphere® optimized local adapters (WOLA) to configure a connection factory when you enable WOLA on your Liberty server.
One or more connection factories must be configured to enable the optimized local adapters on z/OS® for inbound and outbound support, even though the connection factory is only used directly for outbound. For information about configuring a connection factory, see Enabling the Liberty server environment to use optimized local adapters.
| Property | Values | Description |
|---|---|---|
| RegisterName | Any alphanumeric string of 1 to 12 characters | This property defines the WOLA register name to use for connections that are obtained from this connection factory. |
| Username | String; further restrictions on supported values depend on the associated user registry | This property defines a user ID that overrides the user ID that is sent from the connection factory. The Username property is used together with the Password property to authenticate the user and obtain the corresponding MVS™ user ID. |
| Password | Any string | This property defines the password that is used together with the Username property to authenticate the user. |
| LinkTaskTranID | Any 4-character string | When you are using a Customer Information Control System (CICS®) link server, this property defines the name of the CICS transaction that starts the link task that processes requests that are issued from the connection factory. This property overrides the link task transaction ID specified by the control transaction (BBOC) when the CICS link server was started. |
| UseCICSContainer | true, false | When you are using a CICS link server, this
property defines whether the input and output messages are passed to the target CICS program in a COMMAREA object or in a CONTAINER object. If this property
is set to true, the messages are passed in a CONTAINER object. If this
property is set to false, the messages are passed in a COMMAREA
object. Note: If the input and output messages are specified using a javax.resource.cci.MappedRecord
interface, the messages are always passed in a CONTAINER object.
|
| LinkTaskReqContID | A string of 1 to 16 characters that matches the container name defined to CICS | When you are using a CICS link server, this
property defines the name of the CONTAINER object that contains input messages sent to the CICS program. Note: To use this property, the
UseCICSContainer property must be set to
true.
|
| LinkTaskReqContType | 0, 1 | When you are using a CICS link server, this property defines whether the input CONTAINER object is defined as a CHAR or a BIT container. If this property is set to 0, the target program expects a CHAR container. If this property is set to 1, the target program expects a BIT container. When a CHAR container is requested, the input data is assumed to be in the ASCII code page, and the data is converted to EBCDIC when the container is created. |
| LinkTaskRspContID | A string of 1 to 16 characters that matches the container name defined to CICS | When you are using a CICS link server, this
property defines the name of the CONTAINER that contains the output message from the CICS program. Note: To use this property, the
UseCICSContainer property must be set to
true.
|
| LinkTaskRspContType | 0, 1 | When you are using a CICS link server, this property defines whether the output CONTAINER is defined as a CHAR or a BIT container. If this property is set to 0, the target program sends a CHAR CONTAINER. If this property is set to 1, the target program sends a BIT CONTAINER. When a CHAR CONTAINER is requested, the data from the CICS program is assumed to be in the EBCDIC code page, and the data is converted to ASCII when data is retrieved from the CONTAINER. |
| LinkTaskChanID | A string of 1 to 16 characters that matches the channel name defined to CICS | When you are using a CICS link server, this
property defines the name of the CHANNEL that contains the input and output CONTAINER
objects. Note: To use this property, the UseCICSContainer property must be set
to true.
|
| LinkTaskChanType | 0,1 | When you are using a CICS link server, this
property defines whether the input and output CONTAINER objects are defined as CHAR or BIT
containers. If this property is set to 0, the target program sends and
receives CHAR containers. If this property is set to 1, the target program
sends and receives BIT containers. When a CHAR container is requested, the input data is assumed to
be in the ASCII code page, and the data is converted to EBCDIC when the containers are created.
Similarly, the data from the CICS program is assumed to be in
the EBCDIC code page, and the data is converted to ASCII when data is retrieved from the
containers. Note: Use this property only when the input and output messages are specified using a
javax.resource.cci.MappedRecord interface.
|
| ConnectionWaitTimeout | Any integer between 0 and 2147483647 | This property defines the maximum number of seconds that a request waits for a service
name to become available. The service name is specified on Interaction objects in connections that
are obtained from the connection factory. If the service name is not available after the specified
number of seconds elapse, a javax.resource.ResourceException is thrown. Setting this property to 0 disables the timer. The default value for this property is 30. |
| OTMAGroupID | String of 1 to 8 characters that matches the IMS XCF group name that is defined to IMS. | When you use IBM Information Management System (IMS), this property defines the group name that the IMS region uses to connect to the cross-system coupling facility (XCF). The value should match what is declared in the IMSPBxxx PROCLIB member for the parameter named GRNAME. |
| OTMAServerName | String of 1to 16 characters that matches the IMS XCF system name that is defined to IMS. | When you use IBM Information Management System (IMS), this property defines the system name that the IMS region uses to connect to the cross-system coupling facility (XCF). The value should match what is declared in the IMSPBxxx PROCLIB member for the parameter named OTMANM. |
| OTMAClientName | String of 1 to 16 characters, alphanumeric including national characters, defaulting to
the string DEFAULT. |
When you use IBM Information Management System (IMS), this property defines the system name that the Liberty server will use to connect to the cross-system coupling facility (XCF). The value should be unique within the XCF group that is used by the IMS region that you are connect to. |
| OTMASyncLevel | 0,1 | When you use IBM Information Management System (IMS), this property controls the sync level that is used to send messages to and from IMS. A value of 0 uses sync level NONE, and a value of 1 uses sync level CONFIRM. |
| OTMAMaxSegments | Any integer between 0 and 2147483647 | When you use IBM Information Management System (IMS), this property controls the maximum number of segments that a reply message is allowed to contain. The default value is 1. |
| OTMAMaxRecvSize | Any integer between 0 and 2147483647 | When you use IBM Information Management System (IMS), this property controls the maximum number of bytes that a reply message is allowed to contain. The default value is 32768. |
| OTMARequestLLZZ | 0,1 | When you use IBM Information Management System (IMS), this property controls the format of
the request message that is sent to IMS. A value of 1, the default, indicates
that the request starts with an LLZZ format header. A value of
0 indicates that the request starts with an LLLLZZ
header. |
| OTMAResponseLLZZ | 0,1 | When you use IBM Information Management System (IMS), this property controls the format of
the response message that is received from IMS. A value of 1 indicates that
the response starts with an LLZZ format header. A value of
0, the default, indicates that the request starts with an
LLLLZZ header. |