EMS Manual

Collector Commands and Responses
EMS Manual—426909-005
19-37
CONTROL Command (ZEMS-CMD-CONTROL)
ZCOL-MAXFILENNNN (uint field)
specifies the maximum number of files that can exist at one time in the log
subvolume. Allowed values for this field are 2 through 1000; the default is 4.
ZCOL-PRIMARYEXTENT (uint field)
selects the value for the primary extent size used when a collector creates a
log file. The value must be expressed as an even number of pages. The
default value for this attribute is 20. For more information about file creation,
see the CREATE procedure in the Guardian Procedure Calls Reference
Manual.
ZCOL-SECONDARYEXTENT (uint field)
selects the value for the secondary extent size used when a collector creates a
log file. The value must be expressed as an even number of pages. The
default value for this attribute is 100. For more information about file creation,
see the CREATE procedure in the Guardian Procedure Calls Reference
Manual.
ZCOL-WRITETHRUCACHE (Boolean field)
selects a new value for the WRITETHRUCACHE attribute. A value of TRUE in
this field sets WRITETHRUCACHE to ON, which causes the disk process to
write records immediately to disk rather than store them in the disk cache
buffer. A value of FALSE sets the WRITETHRUCACHE attribute to OFF,
causing log records to be written to a disk cache buffer. Setting the attribute
ZCOL-WRITETHRUCACHE to TRUE is equivalent to running EMSCCTRL with
the BUFFERED option set to OFF. The default value for this attribute is FALSE.
ZCOL-EOFREFRESH (Boolean field)
selects a new value for the EOFREFRESH attribute. A value of TRUE in this
field sets EOFREFRESH to ON, which tells a collector to update the end-of-file
pointer on disk for each block written to the log file. This is safer than updating
the pointer less often, but less efficient because it involves more writes to disk.
The default value of this attribute is OFF.
ZCOL-DISCACCESSID (uint field)
specifies the user ID to be used when gaining access to primary collector log
files. Unless you specify otherwise, the default ID is -1 (super ID).
This field must be left null when issuing commands to the alternate collector.