F Voyager and Pioneer Control File Parameters

The following table lists the Voyager control file parameter and corresponding descriptions:

Table F-1 Voyager Control File Parameters

Voyager Control File Parameter Descriptions

SUBPOOL_SIZE=

Size of Subpool being requested, values are 0200K to 7500K

1000K will hold 10240 messages.

TCPN=

Name of the TCPIP STC in the LPAR where Voyager is executing.

IPAD=

IP address or hostname of the LDAP Gateway Host computer.

Sample value: 192.168.1.109 myhost.com

PORT=

99999, the port LPAD is listening on.

DEBUG=

N = no debugging and Y = yes debugging. Running DEBUG=Y is meant to be used only by request and for a short duration to troubleshoot an issue.

ESIZE=

16 is the only valid parameter for encryption/decryption

DEBUGOUT=

SYSOUT,CLASS(K) the class of output to JES2 when DEBUG=Y is specified

VOYAGER_ID=

8 character unique name that will be passed with each Voyager message to the LDAP gateway. If for example 8 Lpars all running Voyager, each Voyager control file must have the same VOYAGER_ID= coded.

FILTER1

NO, no filtering, FILTER1=YES,A=TSOPROC,V=DSNUPROC,DBSPROC9,ABCPROC Any ACF2 LIDS Created or Changed with the ACF2 Attribute 'TSOPROC' in it with one of the values described will not be passed to the LDAP. It will be deleted. If AUDIT=YES is specified the Filters will be shown and actions taken

FILTER2=YES,A=TSOAACT,V=ABCD,DEFGG,POIUYT Any ACF2 LIDS created or changed with the ACF2 attribute 'TSOACCT' in it and with one of the values described will not be passed to the LDAP. It will be deleted. If AUDIT=YES is specified the Filters will be shown and actions taken. The A= field or attribute is maximum of 10 characters.The V= variable field is a maximum of 10 characters each.

FILTER2

Same as FILTER1

FILTER3

Same as FILTER1

CACHE-DELAY=

999 this value is in seconds. Only used for installations running Oracle OIM. If the installation does not have OIM installed code CACHE_DELAY=002, this delay is the amount of time that Voyager waits before it issues a write socket to the LDAP gateway.

AUDIT=

No Audit Log is to be created. YES,SYSOUT,CLASS (x), AUDIT log is required and sent to //AUDTLOG DD


The following table lists the Pioneer control file parameter and corresponding descriptions:

Table F-2 Pioneer Control File Parameters

Pioneer Control File Parameter Descriptions

TCPN=

Name of the TCPIP STC in the LPAR where Voyager is executing

IPAD=

The address will always be 0.0.0.0, do not change

PORT=

Port that Pioneer will listen on for LDAP messages

DEBUG=

Y or N, Normal operation is "N"

ESIZE=

16 is the only valid parameter for encryption/decryption

LPAR=

A 20 character unique identifier for customer usage

IDLEMSG=

Y or N, Y = idle message is displayed every 60 minutes

N = no idle messages will be displayed

DEBUGOUT=

SYSOUT,CLASS(K) the class of output to JES2 when DEBUG=Y is specified

SPIN_CLASS=K

Used in conjunction with DEBUG=Y and DEBUGOUT,SYSOUT,CLASS(X), when DEBUG is closed manually via Operator command, then the output is send to the SPIN_CLASS specified

FILTER=

NO, no filtering inbound LDAP requests YES. If YES is specified then a F1= with filter values are required. F2 and F3 are also supported for a large number of values.

CACHE-DELAY=

999 this value is in seconds. Only used for Installations running Oracle OIM. If the installation does not have OIM installed code CACHE_DELAY=002, this delay is the amount of time that Voyager waits before it issues a write socket to the LDAP gateway.

AUDIT=

No Audit Log is to be created.

YES, SYSOUT, CLASS (x), AUDIT log is required and sent to //AUDTLOG DD

STATS=

NO, no shutdown statistics, messages processed or bytes read/write

YES, provide shutdown statistics

POST_PROC_ALIAS=

If you set the value of this parameter to T, then Pioneer will honor all DEFINE/DELETE alias requests from the LDAP. If you set the value of this parameter to F, Pioneer will ignore all requests for DEFINE or DELETE aliases.

Sample value: T

C=function, m=member name, L=PDS Library name

Function can be INSERT, CHANGE or DELETE

example1, C=INSERT,M=INSERT10,L=TEST.CNTL.LIB

example2, C=CHANGE,M=CHANGE33,L=TEST.CNTL.LIB

example3, C=DELETE,M=DELETE99,L=TEST.CNTL.LIB


Running DEBUG=Y is meant to be used only by request and for a short duration to troubleshoot an issue.