Your Browser is not longer supported

Please use Google Chrome, Mozilla Firefox or Microsoft Edge to view the page correctly
Loading...

{{viewport.spaceProperty.prod}}

MODIFY-ACCOUNTING-PARAMETERS

&pagelevel(3)&pagelevel

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 **