Declare ACS system file
Component: | ACS |
Functional area: | File processing |
Domain: | FILE |
Privileges: | ACS-ADMINISTRATION |
Function
The ADD-ACS-SYSTEM-FILE command is used by system administration to declare a new AC system file identifier, and to assign the file name and attributes to this identifier. Users who wish to load the entries from an AC system file into their virtual alias catalog can use this identifier, i.e. the symbolic name of the AC system file, to address the file. The SHOW-ACS-SYSTEM-FILES command enables the user to request that the list of available AC system files is displayed. However, the ACS administrator can specify, when setting the attributes, that output of the identifier and its associated file name is suppressed. The system administration can also specify that the identifier which is being declared is to act as the default AC system file. In this case, the entries in this file will be read if the user specifies in command LOAD-ALIAS-CATALOG the identifier as “*STD”. The access protection of the AC system file is observed (e.g. user-ACCESS=*OWNER-ONLY denies access to the AC system file from a foreign userid).
If the specified identifier already exists for an AC system file, the existing definition will be replaced by the new one. The declarations relating to the AC system files remain in effect until shutdown. When the subsystem is unloaded, the declarations will only be deleted if the operand SUBSYSTEM-PARAMETER = ‘RESET’ is specified in the STOP-SUBSYSTEM command.
Format
ADD-ACS-SYSTEM-FILE |
ALIAS-CATALOG-ID = <composed-name 1..20> ,FILE-NAME = <filename 1..54> ,ATTRIBUTES = *STD / list-poss(4): *SYSTEM-DEFAULT / *INVISIBLE / *SECRET-FILE-NAME / *PRIVILEGED |
Operands
ALIAS-CATALOG-ID = <composed-name 1..20>
The symbolic name under which the AC system file can be addressed by a LOAD-ALIAS-CATALOG command. The user can request display of a list of all the available AC system files by a SHOW-ACS-SYSTEM-FILES command.
FILE-NAME = <filename 1..54>
The fully qualified actual name of the AC system file, in which the entries are stored. Before the file is added into the list of AC system files, the FILE-NAME operand will, if necessary, be supplemented by the user ID and default catalog ID of the calling task.
The user must be able to read the file.
ATTRIBUTES =
Declares the attributes to be given to the AC system file.
ATTRIBUTES = *STD
Preset value: The AC system file is not to be given any of the following attributes.
ATTRIBUTES = *SYSTEM-DEFAULT
The AC system file is to be used as the default AC system file. The entries from this file will then automatically be loaded into the user’s alias catalog if the ALIAS-CATALOG-ID operand in the LOAD-ALIAS-CATALOG command has the value *STD. If more than one AC system file is given the attribute SYSTEM-DEFAULT, then the last assignment will always be the one which applies. If none of the AC system files is explicitly given this attribute, it is implicitly given to the first which was declared as a system file.
ATTRIBUTES = *INVISIBLE
Specifies that when the AC system files which are available to the nonprivileged user are output (SHOW-ACS-SYSTEM-FILES command), the entry for this file should not be displayed. The identifier of this AC system file can thus only be used by users to whom it has previously been notified, or who can invoke specially prepared procedures. If the SHOW-ACS-OPTIONS command is used to output the AC files which are loaded then, instead of its ID, the character ‘*’ will be shown for this file if the caller is not the ACS administration.
ATTRIBUTES = *SECRET-FILE-NAME
Specifies that when the list of AC files which are available to nonprivileged users is output (SHOW-ACS-SYSTEM-FILES and SHOW-ACS-OPTIONS commands), instead of the file name of this AC system file the string ‘*SYSTEM’ is to appear. The (nonprivileged) user thus has no way of revealing the actual name of the file.
ATTRIBUTES = *PRIVILEGED
Specifies that when the AC system file is used (LOAD-ALIAS-CATALOG ALIAS-CATALOG-ID = <id> command), its entries are to be copied into the virtual alias catalog of the task as system entries.
Return codes
(SC2) | SC1 | Maincode | Meaning |
|---|---|---|---|
0 | CMD0001 | Command executed normally | |
32 | CMD0221 | Internal error | |
64 | ACS0013 | Invalid ACSF declaration | |
130 | ACS0036 | Resource bottleneck |