SHOW-ACS-SYSTEM-FILES

Show names of available AC system files

Component:	ACS
Functional area:	File processing
Domain:	FILE
Privileges:	STD-PROCESSING SAT-FILE-EVALUATION SAT-FILE-MANAGEMENT SECURITY-ADMINISTRATION

Function

The SHOW-ACS-SYSTEM-FILES command displays the alias catalog IDs and file names of all AC system files that the ACS system administrator has made available to all users. The output is written to SYSOUT. AC system files with the attribute INVISIBLE are shown only to the ACS administrator. The default AC system file is identified in the output by a preceding “>” symbol.

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

Format

SHOW-ACS-SYSTEM-FILES                                                                                                                       

ALIAS-CATALOG-ID = *ALL / *STD / <composed-name 1..20>

Operands

ALIAS-CATALOG-ID =
Specifies which AC system files are to be displayed. AC system files which were created by the ACS-administrator with the INVISIBLE attribute are only shown to the ACS administrator.

ALIAS-CATALOG-ID = *ALL
Displays all AC system files.

ALIAS-CATALOG-ID = *STD
Displays only the default AC system file.

ALIAS-CATALOG-ID = <composed-name 1..20 with-wild>
ID of the AC system file to be displayed or a wildcard sequence to identify and select AC system files to be displayed. 

Return codes

(SC2)	SC1	Maincode	Meaning
	0	CMD0001	Command executed normally
	32	CMD2009	Error during S variable generation
	32	CMD0221	Internal error
	64	ACS0012	Error: AC system file not found
	64	OPS0001	Insufficient memory for output in S variables
	130	ACS0036	Resource bottleneck

Output in S variables

This command outputs the alias catalog IDs and file names of all the AC system files that the ACS administrator makes available to all users.

Output information	Name of the S variable	T	Contents	Condition
Symbolic name of the AC system file	var(*LIST).ALIAS-CAT-ID	S	<name 1...20 >
Fully qualified actual file name of the AC system file	var(*LIST).F-NAME	S	*SYS <filename 1..54>
Entries in the AC system file are added to the task's virtual alias catalog as system entries	var(*LIST).PRIVIL	S	*NO *YES
The string *SYS is output instead of the file name of the AC system file, if a nonprivileged user outputs his AC system files	var(*LIST).SECRET-F-NAME	S	*NO *YES
The AC system file acts as a default AC system file	var(*LIST).SYS-DEF	S	*NO *YES
The AC system file name is displayed if a nonprivileged user has AC system files output	var(*LIST).VISIBLE	S	*NO *YES

Example

See the ADD-ALIAS-CATALOG-ENTRY command.