Activate accounting system and open accounting file
Component: | BS2000 |
Functional area: | Accounting system control |
Domain: | ACCOUNTING |
Privileges: | TSOS |
Function
The system administration can use this command to activate the accounting system. The names of the accounting file, the accounting records and record extensions to be logged are defined as well as job classes to be cyclically monitored.
It should be borne in mind that the accounting system does not check the specifications for accounting records or job classes. Specifications of undefined accounting records or job classes are accepted without challenge and no error message is issued.
Format
START-ACCOUNTING | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Operands
NAME =
Defines the name of the accounting file.
NAME = *STD
The accounting file receives the standard name $TSOS.SYS.ACCOUNT.<date>.xxx.nn that consists of the fixed prefix $TSOS.SYS.ACCOUNT and a variable part.
Key:
<date> | : | yyyy-mm-dd | date (year in two or four digit form) |
xxx | : | session number | |
nn | : | serial number of the accounting file | |
NAME = <filename 1..54>
Specifies a fully qualified file name.
NAME = <partial-filename 2..53>
Specifies a partially qualified file name.
This specification results in automatic generation of the file name.
It should be borne in mind that:
the partial qualification must not exceed 26 characters in length (without user ID) because the suffix <date>.xxx.nn is added automatically; in the case of a catalog ID with more than one character, this value is reduced by the number of extra characters; if the year is specified in four-digit form, only 24 characters may be used
partial qualification can be terminated with the user ID; the file name is then automatically given 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 to be opened.
SPACE = *STD
Allocates to the file 48 PAM blocks for primary storage and 48 PAM blocks for secondary storage.
SPACE = *RELATIVE(...)
Specifies the relative storage space allocation.
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 =
Defines the block size for the input/output buffer of the accounting file.
Specification of this operand is meaningful only for new accounting files. The operand is ignored if the specified file is already cataloged.
BUFFER-LENGTH = *BY-PROGRAM
Defines a buffer of 2048 bytes 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 length. If the accounting file is to be set up in an NK4 pubset, an even number should be specified. However, when the command is processed, an odd value will automatically be rounded up to the next higher multiple of 2. The user will be informed of this action by a message.
VOLUME =
Specifies that the new accounting file is to be created on a specific volume.
VOLUME = *STD
The BS2000 (DMS) data management system determines the volume on which the accounting file is to 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 require no device-specific information. If the accounting file is to be created on a tape or a private disk, the system must be informed of this with the CREATE-FILE command before the file is changed.
If, in the case of a shared disk, this does not belong to the default pubset of the specified user ID, the catalog ID of the volume must be specified in the file name. If automatic file name generation is required, the specification should be: :catid:$TSOS.
ALTERNATE-FILES =
Defines the names of continuation files to be opened automatically if the accounting file is changed or in the event of a DMS error.
Defining a list of continuation files is meaningful only if the current accounting file was not automatically generated.
ALTERNATE-FILES = *NONE
No continuation files are defined.
ALTERNATE-FILES = list-poss(5): <filename 1..54> / <partial-filename 2..53>
Fully or partially qualified names of the continuation files.
If a partially qualified name is entered in the list, this must be specified last. Subsequent file names - both partially and fully qualified - are ignored.
A partially qualified file name specification causes the file name to be generated automatically when the accounting file is changed (see also the CHANGE-ACCOUNTING-FILE command).
SET-RECORD-TYPE =
Defines the accounting records and record extensions to be written to the accounting file.
SET-RECORD-TYPE = *STD
The system determines which accounting records and record extensions are to be written to the accounting file. Default settings defined by the system for record selection are:
deactivated records: DALC, DRFA, PACC, RCPU, RSRV, SPLI, and TATR
- deactivated extensions:
- JD, JP, JR from record JOBS
- CA, ID, PC, TI from record PRGS
- CA, ID, PC, TI from record PRGT
- CA, ID, PC, TI from record TASK
- ID, VU from record TDEV
activated extensions: ID from record UACC
SET-RECORD-TYPE = *ALL
All accounting records and implicitly activated record extensions are written to the accounting file.
SET-RECORD-TYPE = list-poss(64): <name 1..6>
Labels of the accounting records or record extensions to be written.
Up to 64 accounting records/record extensions may be specified (see note).
ADD-RECORD-TYPE =
Defines the accounting records and record extensions to be written in addition to the default settings.
This operand is permitted only in conjunction with the specification SET-RECORD-TYPE=*STD.
ADD-RECORD-TYPE = *NONE
No additional accounting records and record extensions are written.
ADD-RECORD-TYPE = list-poss(64): <name 1..6>
Labels of the accounting records and record extensions to be additionally written. Up to 64 accounting records/record extensions can be specified (see note).
REMOVE-RECORD-TYPE =
Declares that the specified accounting records or record extensions are no longer to be written to the accounting file.
The specification is permitted only if the value *STD or *ALL was specified for the SET-RECORD-TYPE operand.
REMOVE-RECORD-TYPE = *NONE
No accounting records and record extensions are deleted from the list of accounting records to be written.
REMOVE-RECORD-TYPE = list-poss(64): <name 1..6>
Labels of the accounting records and record extensions that are no longer to be written. Up to 64 accounting records/record extensions can be specified (see note).
ACCOUNTING-PERIOD =
Defines the cycle of the periodic accounting interval in minutes.
Certain records of the accounting system and job classes are periodically updated to determine average values.
The frequency of this periodic monitoring should be based on the lower end of the permissible range only in exceptional cases in order to avoid overloading.
The maximum value corresponds to one day.
ACCOUNTING-PERIOD = *STD
The default value of 20 minutes applies.
ACCOUNTING-PERIOD = <integer 10..1440>
Value in minutes determining the frequency of periodic monitoring of accounting records and job classes.
JOB-CLASS =
List of job classes to be subjected to periodic monitoring by the accounting system.
JOB-CLASS = *NONE
No job classes are monitored.
JOB-CLASS = *ALL
All job classes are to be monitored.
JOB-CLASS = list-poss(16): <name 1..8>
Specification of up to 16 job classes to be monitored within the specified period.
Return codes
(SC2) | SC1 | Maincode | Meaning |
|---|---|---|---|
0 | CMD0001 | No error | |
1 | 0 | CMD0001 | No error, but no action |
2 | 0 | NAM3001 | Requested action performed, but another file had to be set up due to a DMS error |
1 | CMD0202 | Syntax error | |
32 | CMD0221 | Internal system error | |
64 | NAM0012 | No authorization for the command | |
64 | NAM3003 | Semantic error | |
128 | CMD2280 | Temporarily unable to execute the command |
Note
The accounting records are addressed via the record label (field 1 of the record description), the record extensions via the record label and the label of the extension.
If an accounting record is activated, all record extensions of this record are implicitly also activated. If only certain extensions are to be activated or deactivated, they must be explicitly specified. The accounting record is then monitored along with the remaining extensions.
Certain records and record extensions must not be deactivated. The relevant commands are checked to ensure that these conditions are met, and the accounting system issues a corresponding message to the user.
Up to 64 records or record extensions can be specified with the SET/ADD/REMOVE-RECORD-TYPE operand. It should be noted that a maximum number of 30 records with 10 extensions each can be managed internally by the accounting system.