Change system accounting file
Component: | BS2000 |
Functional area: | Accounting system control |
Domain: | ACCOUNTING |
Privileges: | TSOS |
Function
The current accounting file, in which all accounting-specific data is stored, is closed and a new file is opened. After the accounting file has been changed, the old accounting file can still be accessed during the session for evaluation purposes, e.g. with the product RAV.
The default value *UNCHANGED in the corresponding operand means that the current specification remains valid.
Format
CHANGE-ACCOUNTING-FILE | ||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||
Operands
NAME =
Defines the name of the accounting file to be opened.
NAME = *NEXT
The name of the continuation file is taken over for the new accounting file. The continuation file is determined:
from the START-ACCOUNTING command if a list of alternative file names was defined in the ALTERNATE-FILES operand,
by automatic generation of the file name by incrementing the current number by 1(prerequisite: the old accounting file name was formed automatically).
NAME = *STD
The new accounting file receives the standard file name$TSOS.SYS.ACCOUNT.<date>.xxx.nn.
This file name is made up of the following elements:
<date> | : | yyyy-mm-dd | date (year number as four digits) |
xxx | : | session number | |
nn | : | current number of the accounting file | |
NAME = <filename 1..54>
Specifies a fully qualified name for the accounting file to be opened.
NAME = <partial-filename 2..53>
Specifies a partially qualified file name.
This specification results in automatic generation of the file name. The following points must be observed when specifying a partially qualified file name:
the partial qualification must not exceed 26 characters in length (not including the user ID) because <date>.xxx.nn is added to the name;
for catalog IDs that consist of more than one character, this value is reduced by the number of extra characters; if four-digit year numbers are being used (class 2 system parameter FMTYFNLG), only 24 characters may be used.the partial qualification may be terminated with the user ID; the file name automatically receives the suffix SYS.ACCOUNT.<date>.xxx.nn
if no user ID is specified, the file is cataloged under TSOS.
SPACE =
Defines the storage space allocation for the file on the disk.
SPACE = *STD
The storage space for the file is 48 PAM blocks each for primary and secondary allocation.
SPACE = *RELATIVE(...)
Relative storage space allocation for the file.
PRIMARY-ALLOCATION = <integer 1..65535>
Number of PAM blocks for primary allocation.
SECONDARY-ALLOCATION = <integer 0..32767>
Number of PAM blocks for subsequent file extensions.
BUFFER-LENGTH = *UNCHANGED / *BY-PROGRAM / *STD(...)
Defines the block size for the input/output buffer of the accounting file.
Specification of this operand is meaningful only for new files and is otherwise ignored.
BUFFER-LENGTH = *BY-PROGRAM
Specifies a buffer of 2048 bytes (1 PAM block) for input/output of the file.
BUFFER-LENGTH = *STD(...)
SIZE = 1 / <integer 1..16>
The specified number of PAM blocks is to be used as the buffer size. If the accounting file is to be set up on an NK4 pubset, the value specified should be an even number. However, any odd number will automatically be converted to the next highest multiple of 2 when the command is processed. In such cases, a message will inform the user of this action.
VOLUME =
Specifies that the new accounting file is to be created on a certain volume.
VOLUME = *STD
The Data Management System of BS2000 decides on which volume the accounting file will be created.
VOLUME = <vsn 1..6>
The accounting file is to be created on the volume with the specified volume serial number. The VOLUME operand supports only volumes that do not require device-specific information.
If the accounting file is to be created on a tape or on a private disk, the system must be informed with a CREATE-FILE command before the accounting file is changed.
If in the case of a public disk this does not belong to the default pubset of the designated user ID, the catalog ID of the volume must be included in the file name. If the complete name is to be generated automatically, :catid:$TSOS. must be specified.
Return codes
(SC2) | SC1 | Maincode | Meaning |
|---|---|---|---|
0 | CMD0001 | No error | |
2 | 0 | NAM3001 | Requested action has been performed, but was accompanied by a warning |
1 | CMD0202 | Syntax error | |
32 | CMD0221 | Internal system error | |
64 | NAM0012 | No authorization for command | |
64 | NAM3003 | Semantic error | |
128 | CMD2280 | Temporarily unable to execute the command |