Modify assignment or attributes of ACS system files
Component: | ACS |
Functional area: | File processing |
Domain: | FILE |
Privileges: | ACS-ADMINISTRATION |
Function
The command MODIFY-ACS-SYSTEM-FILE permits the ACS administration to modify AC system file definitions which were specified by an ADD-ACS-SYSTEM-FILE command. An AC system file is addressed not by its file name, but instead by its symbolic name, which is its identifier. Using this command, it is possible to redefine both the assignment to a real file name and also the attributes of an AC system file.
Among the changes that are possible by modifying the attributes, the ACS system administration can specify that an identifier which has already been declared is to be used as the default AC system file for all subsequent calls. In this case, the entries from this file will be read whenever the user specifies the identifier “*STD” (in the LOAD-ALIAS-CATALOG command).
If there is no AC system file with the specified identifier, the command will be rejected with an error message.
Format
MODIFY-ACS-SYSTEM-FILE |
ALIAS-CATALOG-ID = <composed-name 1..20> ,FILE-NAME = *UNCHANGED / <filename 1..54> ,ATTRIBUTES = *UNCHANGED / *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 a display of the list of all the available AC system files by a SHOW-ACS-SYSTEM-FILES command.
FILE-NAME = *UNCHANGED / <filename 1..54>
The assignment to the fully qualified, real file name of an AC system file, in which the entries are stored, is either to be kept unchanged or modified.
Before the file is inserted into the list of AC system files, the operand FILE-NAME will be supplemented, where appropriate, by the user ID of the calling task and its default pubset.
ATTRIBUTES =
Specifies the attributes which the AC system file is to be given.
ATTRIBUTES = *UNCHANGED
The declarations made by the ADD-ACS-SYSTEM-FILES command are to remain valid.
ATTRIBUTES = *STD
The AC system file is not to be given any of the attributes which follow, although the attribute SYSTEM-DEFAULT cannot be reset by this.
ATTRIBUTES = *SYSTEM-DEFAULT
This AC system file is to act as the default AC system file. The entries in this file will then automatically be loaded into the alias catalog of any user who specifies the value *STD for the ALIAS-CAT-ID operand in a LOAD-ALIAS-CATALOG command.
If the attribute SYSTEM-DEFAULT is given to more than one AC system file, the last assignment which was made will always apply. If there is no AC system file which has been explicitly given this attribute, it is implicitly given to the first of the system files which was declared.
ATTRIBUTES = *INVISIBLE
When the AC system files which are available to the nonprivileged user are being output (SHOW-ACS-SYSTEM-FILES command) the entry for this file will not be shown. The identifier of such an AC system file can only be used by users who have previously been informed of it, or who invoke specially provided procedures.
When the command SHOW-ACS-OPTIONS is used to output details of AC files which are loaded, the character ‘*’ will appear for such files instead of their IDs, unless the caller is the ACS administrator.
ATTRIBUTES = *SECRET-FILE-NAME
When the AC files which are available to the user are being output (SHOW-ACS-SYSTEM-FILES and SHOW-ACS-OPTIONS commands), then instead of the file name for such a file, the string ‘*SYSTEM’ will appear, unless the caller is the ACS administration. The nonprivileged user thus has no way of discovering the real file name.
ATTRIBUTES = *PRIVILEGED
When this AC system file is used in the LOAD-ALIAS-CATALOG command, its entries should be copied into the task’s virtual alias catalog as system entries.
Return codes
(SC2) | SC1 | Maincode | Meaning |
|---|---|---|---|
0 | CMD0001 | Command correctly executed | |
32 | CMD0221 | Internal system error | |
64 | ACS0012 | Error: ACSF not found | |
130 | ACS0036 | Resource bottleneck |