Domain: | SECURITY-ADMINISTRATION |
Privileges: | SECURITY-ADMINISTRATION, SAT-FILE-MANAGEMENT |
The /CHANGE-SAT-FILE command is used by the SAT file manager to close the current SATLOG file and to open a new one during normal system operation. No data is lost during the changeover. New attributes can be specified for the new SATLOG file.
Using the functionality of this command, we can move the SATLOG file to any available pubset. The first SATLOG file created in a session is always created on the home pubset. If there is the pubset other than home pubset and default pubset in the SAT parameters, SAT waits until it receives information that the given pubset was imported, then moves the SATLOG file to it. If pubset is to be exported, SAT is informed and automatically moves the SATLOG file back to home pubset.
The security administrator can also use this command to change the logging file, but in contrast is allowed only to use the default values of the operands.
CHANGE-SAT-FILE | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
BUFFER-LENGTH =
This defines the buffer size for the SATLOG file.
BUFFER-LENGTH = *UNCHANGED
The current buffer size is retained.
BUFFER-LENGTH = *STD(...)
This defines a new buffer size. The default size is 2 PAM pages. A small value for BUFFER-LENGTH increases the input/output rate and minimizes the amount of data lost in the event of a system crash.
SIZE = 2 / <integer 1..16>
The default of the new buffer size is 2 PAM pages.
SPACE =
Specifies the storage space allocation.
SPACE = *UNCHANGED
The current storage space allocation is retained.
SPACE = *RELATIVE(...)
This defines the size of the primary and the secondary allocations.
PRIMARY-ALLOCATION = 1002 / <integer 6..50331645>
Primary allocation.
SECONDARY-ALLOCATION = 1002 / <integer 2..32767>
Secondary allocation.
A large secondary allocation must be selected if a large number of events are to be audited; a small secondary allocation is sufficient if the installation is small and the default values are used.
SUPPORT =
This defines the disk storages on which the SATLOG files are to be created.
SUPPORT = *UNCHANGED
The current disk storage is retained.
SUPPORT = *PUBLIC(...)
The SATLOG files are created on public disks. The first SATLOG file created in a session is always created on a public disk.
PUBSET = *HOME
The SATLOG file is moved in the disk storage of the home pubset.
PUBSET = <cat-id 1..4>
Catalog identifier of the pubset where the SATLOG file is moved. The pubset must be imported locally for this.
REPEAT = *UNCHANGED / *NO / *PERIOD(...)
This defines whether the SATLOG file is to be changed periodically.
REPEAT = *NO
The SATLOG file is not changed periodically.
REPEAT = *PERIOD(...)
The SATLOG file is to be changed periodically.
DAYS=1 / <integer 0..10>
Specification of the interval for periodic change, in days.
HOURS = 0 / <integer 0..23>
Specification of the interval for periodic change, in hours.
Command return codes
(SC2) | SC1 | Maincode | Meaning |
0 | CMD0001 | Command successfully executed | |
32 | SAT0000 | Unrecoverable error | |
32 | SAT2030 | DMS error when opening file | |
64 | SAT2040 | DMS error when creating catalog entry | |
64 | SAT1000 | User not privileged for command | |
64 | SAT1025 | Invalid time specified for periodic change | |
128 | SAT1050 | Command permitted only if logging function is activated | |
128 | SAT1010 | Another command is currently being processed | |
128 | SAT1080 | Exchange being prepared |
Notes
Any modification remains valid until another /CHANGE-SAT-FILE command with different operands is issued or until the next shutdown. If the selected pubset is different than home pubset and default pubset then, we can save the name of this pubset as the SAT parameter using the command /SAVE-SAT-PAR SAT-FILE-ATTR=*CURRENT.
See also the general notes on SAT commands on "Functional overview".
Example
SAT file management wishes to
- change the SATLOG file (explicit changeover)
/change-sat-file
- create the new SATLOG file on pubset USRP
/change-sat-file support = *public(pubset = usrp)
- return the SATLOG file to home pubset
/change-sat-file support = *public(pubset = *home)