CSS Unitec Home Page
      

CSS Environment

 css.default(C)

Name   Platforms   Description   Parameters   Notes

Name

/etc/css.default

Platforms

Unix, Windows NT

Description

Css.default contains the definitions of system-wide CSS parameters. When operating virtual CSS print servers, each of these servers has an additional default file in its home path identified by the CSS_ENV environment variable.  Each command searches for this file whenever it has been invoked. The file contains one or more entries that define the default information. Each entry has the form:

keyword=Value

where keyword identifies the type of information available and value defines its value. Both keyword and value must consist of letters, digits and punctuation. The exact spelling of a keyword and the appropriate value are described in the following table.

Any line starting with a number sign (#) is considered a comment and is ignored.

In contrast to parameter values, parameter names (keywords) are case insensitive.

Parameters  

In the current CSS version, the following configuration parameters are available:

Name

Description Default Value
AUTO_REORG Automatic reorganization of the report queue upon the first call of the css(U) program per day (removal of reports whose keep date has expired):
no: no reorganization
all: all reports with keep date expired
printed: all reports with keep date expired and that have been fully printed

See also csa(U), k- and K-options.

no
BANNER_MARGIN Normally banners print from the first to the last line of the page. On misadjusted forms, this may cause report pages to have banner lines printed on. To avoid this effect, the BANNER_MARGIN parmeter may be used to set the top and bottom margins of banner pages. 0
BINARY_VIEW Enable / disable the view of binary type reports in the css(U) dialog: true or false. We recommend to disable this option for end-users. false
CSS_BASE_DIR Base directory containing all CSS control files, the license validation file and the print daemon lpd. The path name may be specified during setup. /usr/lib/css
 

CssNT:
 
lib
CSS_SPOOL_DIR Directory where CSS will store report requests. The path name may be specified during setup. /usr/spool/css
 
CssNT:
 
spool
CSS_VERSION Installed CSS System version. This entry is generated by the setup(I) process and should never be changed.  
DATE_TYPE Date format to bu used in the css(U) dialog screens:

AM, US: MM/DD/YY
EU: DD.MM.YY
IN: YY/MM/DD
EU
DEFAULT_FORM Defines the default form, if the f-option of lpr(U) is not specified. A
DEFUALT_DEVICE Defines the default device, if the d-option of lpr(U) is not specified. 0
DEV_STOP_TIMEOUT This parameter controls the behavior of the lpd despooler program on stop request for active printouts. If it is set to a value other than zero, the despooler process will stop after the defined number of seconds are elapsed, even if the current page has not been spooled completely. The device and the current report are set to the 'hold' state. Please note, that even if DEV_STOP_TIMEOUT has been set, it might be possible, that the process is unable to terminate. Many Unix systems do not allow a process to stop if it is performing an output operation that the OS has not yet been able to complete (typically if a printer is turned off). As soon as the printer is switched on again, this feature should behave as expected. In order to give CSS a chance to stop after the current page has been processed, this parameter should be set to a reasonable value (e.g. 90). The default value is 0 (zero, no timeout processing). 0
ERRLOG_SIZE This parameter sets the size of the CSS lpd error log file css.errlog in KB. Once the file reaches the defined size, it is reset and any previously recorded information is lost. 4
EXT_LOCK Locking method to be used for the processing of the el-parameter in css.devices:
 
lock: The lock file is locked through internal Unix locking and will be automatically removed by the kernel, even if the lpd daemon does not terminate in a graceful way. The file will be created automatically and remains in the file system after the unlock operation. This is the safest el locking method.
sema: The lock file acts as a file semaphore. It is automatically created during the lock operation and removed to signal the end of the lock. This method is intended to synchronize printer sharing with other software packages. Since the (unrecommended) use of kill -9 or other abnormal program termination may lead to zombie lock files, this method should be used as a last resort only.
lock
JOB_FLAGS This parameter may be set to true to mimic prerelease 3.4 condition flag behavior. For details refer to the migration notes in Chapter 1. false
LANGENV This parameter may specify an environment variable name to be inspected for css(U) dialog language information. If set, the variable takes precedence over the LANGUAGE parameter but may be overwritten by L-option of css(U).  
LANGUAGE Language to be used in the css(U) dialog screens:dutch, english, french oder german english
PROTECTION Protection to be applied in the report queue maintenance:
user: user ID
group: group ID
none: no protection
user
PUBLIC_GROUP Reports owned by any group specified in this parameter will be accessible by all users, despite the setting of the PROTECTION parameter. By default a new report will be owned by the creating user and the group associated with that user. Ownership may also be controlled by the lpr(U) u- and g-options. This parameter may define one or more groups (name or numeric ID), delimited by the pipe symbol ‘|‘ or by comma ‘,’.  
PUBLIC_USER Reports owned by any user specified in this parameter will be accessible by all users, despite the setting of the PROTECTION parameter. This parameter may define one or more users (name or numeric ID), delimited by the pipe symbol ‘|‘ or by comma ‘,’.  
SHOW_CSSFLAGS Causes to show the d-, u- and x-option flags in appropriate screen headers of the css(U) dialog, when set to true. false
TEST_PRINT Enable / disable the test-print feature after form changes through css(U):true or false true
TEST_PRINT_ACHAR Substitution character of alphabetic characters during test-print through css(U). X
TEST_PRINT_NCHAR Substitution character of numeric characters during test-print through css(U). 9
VIEW_CONTROL_CHAR Defines the substitution character of nonprintable values in the report view screen of css(U). Control characters are from 0x00 through 0x19, 0x7f and 0xff, except CR, LF, BS and TAB. The following values are possible:
space: use 0x20, space
null: do not show
x: use character x
 
VIEW_DEVICE Defines the device definition to use to display a report in the css(U) report preview screen.  
WINDOWS_SERVER Defines the service name of the Windows server cssws(U)). The same name must be present in the /etc/services file. cssws
WINCSS_PORT Defines the TCP/IP port number to be used by the Windows server cssws(U) or the NT service process CssNTSrv(U). 6801
WINCSS_VIEW_DEVICE Defines the device definition to use to display a report in the WinCss(U) report preview screen. setting in VIEW_DEVICE
WRAP_SCREEN Enable / disable the navigation default in the css(U) dialog to wrap screens from last to first. false


The next table describes system dependent parameters that are used in special environments only:

Name Description Default Value
INT_LOCK Internal locking method to be used for all CSS databases. This parameter was introduced due to an error in the lockd(1) daemon of Ultrix Rel. 4.30. If e.g. the command csu -i1 hangs, try to set int_lock to the value sema. We strongly recommend however to use the lockd program of Rel. 4.2a or 4.3a, which both work fine:
lock: The normal locking method.
sema: Causes CSS to use file semaphores for its internal locking. Please note, that if ever you have to stop a CSS process, it should be killed with signal 15 (i.e. use kill or kill -15). If for any reason you have to use kill -9, you must check the CSS spool directory (normally /usr/spool/css) and remove the following files:
lck..dev (devices)
lck..form (forms)
lck..rep (reports)

You may also use
rm -f /usr/spool/css/lck..* in your system startup procedure.

lock
LOCAL_TIME Enable / disable the timezone and seasonal time adjustment through the localtime(3) library function for all report time and date information:
true or false. The false value may fix incorrect time information caused by nonstandard use of the TZ environment or by kernels generated with a nonlocal time zone.
true
Some users reported problems with printers connected to printer- or terminal-servers. To avoid these problems, the rigid IO checks of the CSS despooler daemon lpd have been relaxed starting with Rel. 3.08f. They can however be enabled by setting some or all of the parameter values to true. To see the error messages of failed system calls, consult the file css.errlog, located in the CSS base directory (normally /usr/lib/css).
LPD_CLOSE_CHECK Check the close(2) system call status, true or false False
LPD_CLOSE_DLAY Wait n seconds before calling close(2). 0
LPD_DV_MULTY_OPEN Do perform an open(2) / close(2) combination for each report, true or false. No effect for output pipes. false
LPD_FLUSH_CHECK Check the fflush(3) system call status, true or false false
LPD_FLUSH_DELAY Wait n seconds before calling fflush(3). 0
LPD_OP_CLOSE_CHECK Check the pclose(3) system call status for output pipes, true or false false
LPD_SIGPIPE_CHECK Check the broken pipe signal sigpipe, true or false false
LPD_WRITE_CHECK Check the write(2) system call status, true or false false

 

 

Notes

Except the TIME entry, CssNT ignores all system dependent parameters.

If /etc/css.default is missing, CSS will run with the default configuration.
 

Important!

If the directory entries (x_dir) do not correspond to the current configuration, CSS will not be able to run correctly.

 

Back to top