Modify accounting system parameters
Component: | BS2000 |
Functional area: | Accounting system control |
Domain: | ACCOUNTING |
Privileges: | TSOS |
Function
This command allows system administration to modify the following accounting system parameters set with the START-ACCOUNTING command:
accounting records and record extensions to be included in the accounting file
the list of continuation files in the case of file switching
the job classes to be monitored
the monitoring cycle
Neither in the definition of the accounting records and their extensions nor in the definition of the job classes is a logical check of the ACCOUNT function for consistency of the specifications performed. The default value *UNCHANGED in the corresponding operands means that the previously valid definition still applies.
Format
MODIFY-ACCOUNTING-PARAMETERS |
SET-RECORD-TYPE = *UNCHANGED / *ALL / list-poss(64): <name 1..6> ,ADD-RECORD-TYPE = *NONE / list-poss(64): <name 1..6> ,REMOVE-RECORD-TYPE = *NONE / list-poss(64): <name 1..6> ,ALTERNATE-FILES = *UNCHANGED / *NONE / list-poss(5): <filename 1..54> / <partial-filename 2..53> ,ACCOUNTING-PERIOD = *UNCHANGED / <integer 10..1440 minutes> / *STD ,JOB-CLASS = *UNCHANGED / *NONE / *ALL / list-poss(16): <name 1..8> |
Operands
SET-RECORD-TYPE = *UNCHANGED / *ALL / list-poss(64): <name 1..6>
Defines the accounting records and record extensions to be written to the accounting file.
SET-RECORD-TYPE = *ALL
All accounting records and implicitly active record extensions are written to the accounting file.
SET-RECORD-TYPE = list-poss(64): <name 1..6>
Identifiers of the accounting records or record extensions to be written. Up to 64 accounting records or extensions can be specified (see notes).
ADD-RECORD-TYPE = *NONE / list-poss(64): <name 1..6>
Defines whether the specified accounting records and record extensions, and which ones (maximum 64), are also to be added to the list of accounting records/record extensions to be written (see the notes).
REMOVE-RECORD-TYPE = *NONE / list-poss(64): <name 1..6>
Defines whether the specified accounting records and record extensions (maximum 64) are no longer to be written to the accounting file (see notes).
ALTERNATE-FILES = *UNCHANGED / *NONE / <filename 1..54> / <partial-filename 2..53>
Replaces the list of accounting file names defined by means of the START-ACCOUNTING command.
Specification of a list of continuation files is meaningful only if the name of the current accounting file was not automatically generated.
ALTERNATE-FILES = *NONE
Deletes the list of continuation file names.
ALTERNATE-FILES = list-poss(5): <filename 1..54> / <partial-file-name 2..53>
Names of the continuation files to replace the file names in the list of continuation files. Up to 5 file names may be specified (see the notes).
ACCOUNTING-PERIOD = *UNCHANGED / *STD / <integer 10..1440 minutes>
Modifies the cycle of the periodic accounting interval.
Specific records of the accounting system and job classes are periodically monitored to derive average values.
To avoid overloading, the frequency of this periodic monitoring should be oriented towards the lower threshold of the value range only in exceptional cases.
The maximum value corresponds to one day.
ACCOUNTING-PERIOD = *STD
The default value of 20 minutes applies.
ACCOUNTING-PERIOD = <integer 10..1440 minutes>
Value in minutes defining the frequency of the periodic monitoring of accounting records and job classes.
JOB-CLASS = *UNCHANGED / *NONE / *ALL / list-poss(16): <name 1..8>
List of job classes to be subject to periodic monitoring of the accounting system.
JOB-CLASS = *NONE
No job classes are to be monitored any longer.
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 | |
2 | 0 | NAM3001 | Requested action has been carried out, but accompanied by a warning |
1 | CMD0202 | Syntax error | |
32 | CMD0221 | Internal system error | |
64 | NAM0012 | No authorization for this command | |
64 | NAM3003 | Semantic error | |
128 | CMD2280 | Temporarily unable to execute the command |
Notes
The accounting records are addressed via the record label (field 1 in the record definition). Activation of the accounting record implies that all record extensions are activated. If only specific record extensions are to be activated or suppressed, these must be addressed explicitly. The record extension is identified by adding the extension label to the record label. The deactivation of one or more record extensions means that the accounting record is written with the remaining record extensions.
For example, the operand ADD-RECORD-TYPE=(DALC,TASKCA,TASKTI) causes memory allocation record DALC and two record extensions of the task accounting record (TASKCA and TASKTI) to be activated as well.The name of the continuation file or the last name in the list of continuation files may be a partially qualified file name. This causes automatic file name generation to be activated following a switch of accounting files.
Example
/show-acc-sta inf=*files
ACCOUNTING STATUS INFORMATION ============================= CURRENT ACCOUNTING FILE: (AUTOMATIC) ------------------------ :SBZ8:$TSOS.SYS.ACCOUNT.2017-01-26.074.01 OPENED AT : 2017-01-26, 17:02:07-W ALTERNATE FILENAMES: -------------------- ** NONE SPECIFIED **
/mod-acc-par alter-files=(account2,accoount3),add=(dalc,jobsjd),remove=splo
/show-acc-sta inf=*all
ACCOUNTING STATUS INFORMATION
=============================
CURRENT ACCOUNTING FILE: (AUTOMATIC)
------------------------
:SBZ8:$TSOS.SYS.ACCOUNT.2014-01-26.074.01
OPENED AT : 2017-01-26, 17:02:07-W
ALTERNATE FILENAMES:
--------------------
ACCOUNT2
ACCOUNT3
ACCOUNTING RECORD INFORMATION:
------------------------------
RECORD IDS TURNED OFF:
DRFA PACC RCPU RSRV SOPA SPLI SPLO TATR
RECORD EXTENSIONS TURNED ON:
UACC: ID
RECORD EXTENSIONS TURNED OFF:
RECORD IDS TURNED OFF:
DRFA PACC RCPU RSRV SOPA SPLI SPLO TATR
RECORD EXTENSIONS TURNED ON:
UACC: ID
RECORD EXTENSIONS TURNED OFF:
JOBS: JP JR
PRGS: CA ID PC TI
PRGT: CA ID PC TI
TASK: CA ID PC TI
TDEV: ID VU
***** NOT LISTED RECORD IDS ARE TURNED ON *****
ACCOUNTING PROCESSING PARAMETERS:
---------------------------------
ACCOUNTING PERIOD : 20
JOB-CLASSES :
** NONE SPECIFIED **