Started Task Parameters

Restriction: This topic applies to Windows environments only.

Sample parameters are shipped in xdblink.v100.PARAM(PARMTCP). This file member contains the following definitions.

Note:

Do not use commas or periods when assigning a numeric value to a parameter.

Parameter Description
ORGANIZATION= 
Specifies the organization ID of the owner of the XDB Link software license. The format is:

ORGANIZATION=org-id

where org-id is the organization ID. This parameter must be a string of up to 60 characters. There is no default.

PORT= 

                              
Specifies the port number that the Host Option will use. The format is:
PORT=port-number

where port-number is the number of the TCP/IP port dedicated to the XDB Link Host Option. This parameter must be an integer from 1 to 32767. There is no default.

BACKLOG=
Specifies the length of the backlog queue maintained in TCP/IP for connection requests that have not yet been assigned sockets by the listener. The format is:
BACKLOG=backlog-length

where backlog-length is the length of the backlog queue. This parameter must be an integer from 1 to 32767. The default is 5.

NETWORK ID=
Specifies the SSCP (system services control point) network ID for ACF/VTAM (the host node). The format is:
NETWORK ID=sscp-id

where sscp-id is the SSCP network ID. This must be a string of up to eight characters. There is no default.

LU6.2 APPLID=
Specifies the APPLID (LU or ACBNAME) for XDB Link. The format is:
APPLID=applid

where applid is the APPLID for XDB Link. This is a string of up to eight characters, and equals the ACBNAME defined for the VTAM application. There is no default.

APPLID PASSWORD=
Specifies the password of the APPLID defined in the PTRCT parameter of the VTAM APPLID definition. The format is:
APPLID PASSWORD=applid-pw

where applid-pw is the password. This must be a string of up to eight characters. There is no default.

TRACE=
Specifies the trace facility name. The format is:
TRACE={GTF | WTOR | SYSPRINT}

This parameter can be set to GTF, WTOR, or SYSPRINT trace facilities. There is no default.

EID=
Specifies the event ID of the GTF (Generalized Trace Facility) trace record. The format is:
EID=event-id

where event-id is the event ID of the GTF trace record. This must be a two-byte hexadecimal number (for example, 88FF), and it must match the USR value in the GTF trace parameter. There is no default.

TIME OUT FOR CONNECTION=
Specifies the timeout period used for the TCP/IP accept call to get the connection request. The format is:
TIME OUT FOR CONNECTION=timeout

where timeout is the time out for connection in minutes. This must be an integer from 1 to 32767. Zero (0) specifies no timeout. There is no default.

COMPRESS=
Not used.
ROUTE=
Specifies the WTO (Write To Operator) and WTOR (Write To Operator with Reply) console route parameters.
ROUTE=(number1,number2)

Refer to the MVS/ESA SP V5 Auth Assembler Services Reference manual (GC28-1478) for descriptions of the values and their valid ranges. There are no defaults.

PRODUCT PASSWORD=
Specifies the product password assigned for the software license. The format is:
PRODUCT PASSWORD=password

where password is the assigned product password. This is a six-byte hexadecimal number. The correct password will already be specified in this parameter, so there is no need for you to edit it. There is no default.

Example

The following is an example of a complete parameter definition. Lines beginning with "*" are comments.

**************************************************** 
  * * 
  * XDB STARTED TASK INITIALIZATION PARAMETERS * 
  * XDBLINK V1.00 * 
  * * 
  **************************************************** 
  * 
  * ORGANIZATION ID 
  * 
  ORGANIZATION=XDB SYSTEMS, INC.  
  * 
  * STARTED TASK TCPIP PORT NUMBER 
  PORT=5170 
  *  
  * TCPIP LISTEN BACKLOG PARAMETER  
  BACKLOG=5  
  *  
  * SNA NETWORK ID OF DB2 DDF  
  NETWORK ID=USXDB  
  *  
  * STARTED TASK APPLID  
  LU62 APPLID=XDB62APP  
  *  
  * STARTED TASK APPLID PASSWORD  
  APPLID PASSWORD=XDB62APP  
  *  
  * TRACE OPTION  
  TRACE=GTF  
  *  
  * GTF TRACE EID  
  EID=00E9  
  *  
  * TCPIP ACCEPT TIME OUT PARAMETER  
  TIME OUT FOR CONNECTION=0  
  *  
  * COMPRESSION OPTION  
  COMPRESS=YES  
  *  
  ROUTE=(2,11)  
  *  
  * PRODUCT PASSWORD  
  PRODUCT PSWD=2D0910D9A1C0  
  *  
  END