ACB (BASE) Configuration

Caution
Debug logging modes should not be used in a production system. Debug logging modes are off by default. Turning on these settings in a production system could overflow UNIX file systems. Furthermore, do not create .FormatIds or .ObjectDef files in $PARMLIB/parms/BASE or copy samples of these files into $PARMLIB/parms/BASE. Doing so could cause the ACB to function incorrectly.

ACB Parameters

Table 8-1: ACB (BASE) Parameters

Parameter Description Valid Values and Defaults

CurrencyType

Defines the currency used when speaking or presenting money.
Note This attribute is modifiable at run time.
US: Spoken as US dollars and cents.

GERMAN: Spoken as German Deutsche Marks.

Default = US.

DateFormat

Defines the presentation format for the date.
Note This attribute is modifiable at run time.
USDATE: US -- mm/dd/yy.

INTERDATE: International -- dd/mm/yy.

ALTDATE: Alternate International -- yy/mm/dd.

LONGDATE: Long date form -- Month, Day, Year.

Default = LONGDATE.

DestBillAPI

Defines where to log API usage detail messages.

Note This attribute is modifiable at run time.
OFF: Do not log these messages.

LOCAL: Log messages to the associated local file.

NET: Log messages to a server.

LOCAL_NET: Store messages locally, then send them to a server.

Default = OFF.

DestBillResource

Defines where to log messages concerning the allocation and freeing of resources.

Note This attribute is modifiable at run time.
OFF: Do not log these messages.

LOCAL: Log messages to the associated local file.

NET: Log messages to a server.

LOCAL_NET: Store messages locally, then send them to a server.

Default = LOCAL.

DestDebug

Defines where to log debug messages.

Note This attribute is modifiable at run time.
OFF: Do not log these messages.

LOCAL: Log messages to the associated local file.

Default = OFF.

DestDetail

Defines where to log messages concerning consumed/idle resources.

Note This attribute is modifiable at run time.
OFF: Do not log these messages.

LOCAL: Log messages to the associated local file.

NET: Log messages to a central database.

LOCAL_NET: Store messages locally, then send them to a server.

Default = OFF.

DestError

Defines where to log error messages.

Note This attribute is modifiable at run time.
OFF: Do not log these messages.

LOCAL: Log messages to the associated local file.

Default = LOCAL.

DestEvent

Defines where to forward event messages.

Note This attribute is modifiable at run time.
OFF: Do not log these messages.

LOCAL: Log messages to the associated local file.

NET: Log messages to a server.

LOCAL_NET: Store messages locally, then send them to a server.

Default = LOCAL.

DestInfo

Defines where to log informational messages.

Note This attribute is modifiable at run time.
OFF: Do not log these messages.

LOCAL: Log messages to the associated local file.

Default = LOCAL.

DestShortage

Defines where to log messages concerning the shortage of resources.

Note This attribute is modifiable at run time.
OFF: Do not log these messages.

LOCAL: Log messages to the associated local file.

NET: Log messages to a server.

LOCAL_NET: Store messages locally, then send them to a server.

Default = OFF.

DestWarning

Defines where to log warning messages.

Note This attribute is modifiable at run time.
OFF: Do not log these messages.

LOCAL: Log messages to the associated local file.

Default = LOCAL.

DomainName

Identifies the name hosting the entire domain of objects. Only objects with the same domain name can communicate.

1-15 alphanumeric characters.

Default = r303.

Language

Defines the language used for spoken phrases.

Use USENGLISH or GERMAN when the user will be prompted for input. Use NONE when there are no user prompts, such as when a caller records a message or when a subscriber plays a message.
Note This attribute is modifiable at run time.
USENGLISH: United States English.

GERMAN: German language.

NONE: No language specified.

Default = USENGLISH.

LogMaxFile

Defines the maximum size of the log file (in megabytes) before an old log file closes and a new log file opens.

1 - 8: (If you don't specify a range between 1 and 8, the system will use the default.)

Default = 8.

LogServer

Specifies whether the iteration of LOGSUB on this host will act as the server, client, or neither.

Yes: server mode.

<hostname>: client mode.

No: Neither server or client mode.

Default: No.

MaxBufArea

Defines the size of the buffer area allocated for messages, in bytes.

The buffer area is organized in 256-byte blocks. As many blocks as needed to hold a message are allocated to a message. The first block of a message holds 136 bytes; each block thereafter holds 256 bytes. To support, for example, 1,000 messages with a maximum size of 1,000 bytes, you will need 5,000 256-byte blocks, or 1,280,000 bytes.

512 - 100,000,000.

Default = 1,000,000.

MaxBufSize

Defines the largest message that can be handled by LACS (SSIO).

2 - 100,000.

Default = 10,000.

MaxSubSystems

Defines the largest number of subsystems that can be registered at one time.

6 - 10,000.

Default = 300.

MaxSubSystemBufs

Defines the maximum number of buffers that can be queued up for a subsystem in the shared file.

2 - 10,000.

Default = 50.

MoneyFormat

Defines the format of the currency used.

Note This attribute is modifiable at run time.
US1: Dollar symbol followed by a space then amount ($12.34).

US2: Dollar symbol followed by amount (no space) ($12.34).

DM1: German currency amount then space then symbol (12.34 DM).

DM2: German currency amount no space then symbol (12.34DM).

Default = US1.

RecoverRetry

The minimum amount of time between retries to the logging server when it is unavailable for transmission. This is used when logging message destination equals NET and a failure has occurred.
Note Setting the Recovery Retry time to 300 seconds, for example, does not mean that the system polls the server every 5 minutes. The system polls the server only after it tries to send another record, and then checks to see if 5 minutes or more have elapsed since the last try.
SHORT: 60 seconds.

MEDIUM: 300 seconds (5 minutes).

LONG: 900 seconds (15 minutes).

Default = MEDIUM.

RecoverSend

Number of records to send at a time from the escalation file to the logging server after re-establishing transmission to the server. This is used when logging message destination equals NET and a failure has occurred.

1 - 500.

Default = 20.

RecoverTimeUnix

Amount of time in seconds between sending groups of records from the escalation file to the logging server after re-establishing transmission to the database. This is used when logging message destination equals NET and a failure has occurred.

1 - 60.

Default = 5.

RollOver

Defines the time in hours when the old log closes and a new log opens.

1 - 24.

Default = 24.

TimeFormat

Identifies the time format that is to be used for this instance.

Note This attribute is modifiable at run time.
STDTIME: Standard Time -- HH:MM AM/PM.

MILTIME: Military US -- HH:MM 24-hour clock.

Default = STDTIME.

Sockets

Identifies means by which ACBs on separate hosts communicate - sockets or RPC.

Yes: sockets.

No: RPC.

Default = No.

Parameter	Description	Valid Values and Defaults
CurrencyType	Defines the currency used when speaking or presenting money. Note This attribute is modifiable at run time.	US: Spoken as US dollars and cents. GERMAN: Spoken as German Deutsche Marks. Default = US.
DateFormat	Defines the presentation format for the date. Note This attribute is modifiable at run time.	USDATE: US -- mm/dd/yy. INTERDATE: International -- dd/mm/yy. ALTDATE: Alternate International -- yy/mm/dd. LONGDATE: Long date form -- Month, Day, Year. Default = LONGDATE.
DestBillAPI	Defines where to log API usage detail messages. Note This attribute is modifiable at run time.	OFF: Do not log these messages. LOCAL: Log messages to the associated local file. NET: Log messages to a server. LOCAL_NET: Store messages locally, then send them to a server. Default = OFF.
DestBillResource	Defines where to log messages concerning the allocation and freeing of resources. Note This attribute is modifiable at run time.	OFF: Do not log these messages. LOCAL: Log messages to the associated local file. NET: Log messages to a server. LOCAL_NET: Store messages locally, then send them to a server. Default = LOCAL.
DestDebug	Defines where to log debug messages. Note This attribute is modifiable at run time.	OFF: Do not log these messages. LOCAL: Log messages to the associated local file. Default = OFF.
DestDetail	Defines where to log messages concerning consumed/idle resources. Note This attribute is modifiable at run time.	OFF: Do not log these messages. LOCAL: Log messages to the associated local file. NET: Log messages to a central database. LOCAL_NET: Store messages locally, then send them to a server. Default = OFF.
DestError	Defines where to log error messages. Note This attribute is modifiable at run time.	OFF: Do not log these messages. LOCAL: Log messages to the associated local file. Default = LOCAL.
DestEvent	Defines where to forward event messages. Note This attribute is modifiable at run time.	OFF: Do not log these messages. LOCAL: Log messages to the associated local file. NET: Log messages to a server. LOCAL_NET: Store messages locally, then send them to a server. Default = LOCAL.
DestInfo	Defines where to log informational messages. Note This attribute is modifiable at run time.	OFF: Do not log these messages. LOCAL: Log messages to the associated local file. Default = LOCAL.
DestShortage	Defines where to log messages concerning the shortage of resources. Note This attribute is modifiable at run time.	OFF: Do not log these messages. LOCAL: Log messages to the associated local file. NET: Log messages to a server. LOCAL_NET: Store messages locally, then send them to a server. Default = OFF.
DestWarning	Defines where to log warning messages. Note This attribute is modifiable at run time.	OFF: Do not log these messages. LOCAL: Log messages to the associated local file. Default = LOCAL.
DomainName	Identifies the name hosting the entire domain of objects. Only objects with the same domain name can communicate.	1-15 alphanumeric characters. Default = r303.
Language	Defines the language used for spoken phrases. Use USENGLISH or GERMAN when the user will be prompted for input. Use NONE when there are no user prompts, such as when a caller records a message or when a subscriber plays a message. Note This attribute is modifiable at run time.	USENGLISH: United States English. GERMAN: German language. NONE: No language specified. Default = USENGLISH.
LogMaxFile	Defines the maximum size of the log file (in megabytes) before an old log file closes and a new log file opens.	1 - 8: (If you don't specify a range between 1 and 8, the system will use the default.) Default = 8.
LogServer	Specifies whether the iteration of LOGSUB on this host will act as the server, client, or neither.	Yes: server mode. <hostname>: client mode. No: Neither server or client mode. Default: No.
MaxBufArea	Defines the size of the buffer area allocated for messages, in bytes. The buffer area is organized in 256-byte blocks. As many blocks as needed to hold a message are allocated to a message. The first block of a message holds 136 bytes; each block thereafter holds 256 bytes. To support, for example, 1,000 messages with a maximum size of 1,000 bytes, you will need 5,000 256-byte blocks, or 1,280,000 bytes.	512 - 100,000,000. Default = 1,000,000.
MaxBufSize	Defines the largest message that can be handled by LACS (SSIO).	2 - 100,000. Default = 10,000.
MaxSubSystems	Defines the largest number of subsystems that can be registered at one time.	6 - 10,000. Default = 300.
MaxSubSystemBufs	Defines the maximum number of buffers that can be queued up for a subsystem in the shared file.	2 - 10,000. Default = 50.
MoneyFormat	Defines the format of the currency used. Note This attribute is modifiable at run time.	US1: Dollar symbol followed by a space then amount ($12.34). US2: Dollar symbol followed by amount (no space) ($12.34). DM1: German currency amount then space then symbol (12.34 DM). DM2: German currency amount no space then symbol (12.34DM). Default = US1.
RecoverRetry	The minimum amount of time between retries to the logging server when it is unavailable for transmission. This is used when logging message destination equals NET and a failure has occurred. Note Setting the Recovery Retry time to 300 seconds, for example, does not mean that the system polls the server every 5 minutes. The system polls the server only after it tries to send another record, and then checks to see if 5 minutes or more have elapsed since the last try.	SHORT: 60 seconds. MEDIUM: 300 seconds (5 minutes). LONG: 900 seconds (15 minutes). Default = MEDIUM.
RecoverSend	Number of records to send at a time from the escalation file to the logging server after re-establishing transmission to the server. This is used when logging message destination equals NET and a failure has occurred.	1 - 500. Default = 20.
RecoverTimeUnix	Amount of time in seconds between sending groups of records from the escalation file to the logging server after re-establishing transmission to the database. This is used when logging message destination equals NET and a failure has occurred.	1 - 60. Default = 5.
RollOver	Defines the time in hours when the old log closes and a new log opens.	1 - 24. Default = 24.
TimeFormat	Identifies the time format that is to be used for this instance. Note This attribute is modifiable at run time.	STDTIME: Standard Time -- HH:MM AM/PM. MILTIME: Military US -- HH:MM 24-hour clock. Default = STDTIME.
Sockets	Identifies means by which ACBs on separate hosts communicate - sockets or RPC.	Yes: sockets. No: RPC. Default = No.

Table of Contents