SHOW-ACCOUNTING-STATUS

Display accounting system information

Component:	BS2000
Functional area:	Accounting system control
Domain:	ACCOUNTING
Privileges:	TSOS

Function

The following information on the accounting system can be requested by means of the SHOW-ACCOUNTING-STATUS command.

• state of the accounting procedure

• name of the current accounting file

• time at which the file was opened

• names of the continuation files

• list of account records and record extensions that were explicitly activated or deactivated

• frequency of periodic saving of specific accounting records

• names of cyclically monitored job classes

The command supports structured output in S variables (see "Output in S variables").

Format

SHOW-ACCOUNTING-STATUS                                                                                                                   

INFORMATION = *SUMMARY / *FILES / *PARAMETERS / *ALL

Operands

INFORMATION =
Defines the type of information desired.

INFORMATION = *SUMMARY
If the accounting system is active, the name of the currently active accounting file is displayed in addition to the information ACCOUNTING ACTIVE.
If the accounting system is inactive, the following information is displayed:

ACCOUNTING NOT ACTIVE.

INFORMATION = *FILES
Specifies:

• whether the accounting system is active/inactive

• name of the currently active accounting file

• time and date when the file was opened

• continuation file names 

INFORMATION = *PARAMETERS
Displays all accounting records and record extensions that were explicitly activated or deactivated as well as the frequency of the accounting interval and the names of the job classes monitored within this interval.

INFORMATION = *ALL
Displays an overview of all information provided by this command.

Return codes

(SC2)	SC1	Maincode	Meaning
	0	CMD0001	No error
2	0	NAM3001	Requested action has been performed, but linked with warnings
	1	CMD0202	Syntax error
	32	CMD0221	Internal system error
	64	NAM0012	No authorization for the command
	128	CMD2280	Command cannot temporarily be executed

Example

/show-acc

ACCOUNTING ACTIVE, FILENAME= :B6F1:$TSOS.SYS.ACCOUNT.2017-01-26.074.01 

/show-acc 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 **

Output in S variables

The command's INFORMATION operand identifies the S variables which are to be created. The following specifications are possible for INFORMATION:

Notation used in command	Abbreviated form used in table
INFORMATION = SUMMARY	1
INFORMATION = FILES	2
INFORMATION = PARAMETERS	3
INFORMATION = ALL	4

Supplementary conditions which work in combination with the INFORMATION specifications:

Supplementary conditions	Abbreviated form used in table
Value assignment; only if ACCOUNT-ACTIVE=TRUE	a
*NONE and <name> cannot appear together as values	b
*ALL and <name> cannot appear together as values	c

Output information	Name of the S variable	T	Contents	Condition
Accounting system active	var(*LIST).ACCOUNT-ACTIVE	B	TRUE FALSE	1-4
Frequency of periodic saving of accounting records	var(*LIST).ACCOUNT-PERIOD	I	<integer>	3,4,a
Names of continuation files	var(*LIST).ALT-FILES(*LIST)	S	*NONE <name>	2,4,a,b
Names of job classes cyclically monitored by the accounting system	var(*LIST).JOB-CLASS(*LIST)	S	*NONE <name>	3,4,a,b
Name of the current accounting files	var(*LIST).NAME	S	<filename>	1,2,4,a
Activation of list of accounting records and record extensions	var(*LIST).NOT-LISTED-REC	S	*ON *OFF	3,4,a
Date when the file was opened	var(*LIST).OPEN-DATE	S	<date>	2,4,a
Time when the file was opened	var(*LIST).OPEN-TIME	S	<open time & season>	2,4,a
Deactivated accounting records	var(*LIST).REM-REC-TYPE(*LIST)	S	*NONE <name>	3,4,a,b
Activated accounting records	var(*LIST).SET-REC-TYPE(*LIST)	S	*ALL <name>	3,4,a,c