Modify ACS option settings
Component: | ACS |
Functional area: | File processing |
Domain: | FILE |
Privileges: | STD-PROCESSING |
Function
The MODIFY-ACS-OPTIONS command allows the user to modify the following globally set AC options for the current task:
output of messages when loading the alias catalog
logging of alias substitutions and prefix insertions
permission to use the catalog ID and user ID in aliases (fully qualified)This ACS option may be restricted by the ACS administrator!
permission to use user IDs in aliases
This ACS option may be restricted by the ACS administrator!range of the substitution (for files or for files and job variables)
The currently applicable settings can be determined by the user from the output of the SHOW-ACS-OPTIONS command.
Privileged functions
The ACS administrator uses SCOPE=*SYSTEM to set AC options for the whole system and can specify that users are not allowed to modify the AC options relating to the use of catalog and user IDs in alias names.
The ACS administrator also globally defines the pubset on which temporary spool files may be created.
The changes to the global options remain in effect until the next MODIFY-ACS-OPTIONS or until shutdown, or until the ACS subsystem is unloaded.
Following the loading of the ACS subsystem, the following preset values apply:
SUCCESS-MSG=PAR(USER-FILES=*YES, SYSTEM-FILES=*YES) LOGGING=*PAR(ALIAS-SUBSTITUTION=*STD, PREFIX-INSERTION=*NO) COMPLETE-ALIAS-NAMES=*NOT-ALLOWED(USER-MODIFICATION=*NOT-ALLOWED) ALIAS-USERID=*NOT-ALLOWED(USER-MODIFICATION=*NOT-ALLOWED) SPOOL-FILE-PUBSET=*STD STANDARD-RANGE=*BOTH
Format
MODIFY-ACS-OPTIONS | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Operands
SUCCESS-MSG = *UNCHANGED / *YES / *NO / *PARAMETERS(...)
Affects the default setting for the output of message ACS0001 when loading an alias catalog. The specification made here applies as the default value *STD in the SUCCESS-MSG operand of the LOAD-ALIAS-CATALOG command.
SUCCESS-MSG = *UNCHANGED
The default setting is not changed.
SUCCESS-MSG = *YES
The output of message ACS0001 is set as the task-specific default.
SUCCESS-MSG = *NO
Suppression of message ACS0001 is set as the task-specific default.
SUCCESS-MSG = *PARAMETERS(...)
Enables the output of message ACS0001 to be set independently for AC system files and AC files.
SYSTEM-FILE-MSG = *UNCHANGED / *YES / *NO
Defines the default setting for AC system files.
USER-FILE-MSG = *UNCHANGED / *YES / *NO
Defines the default setting for AC files.
LOGGING = *UNCHANGED / *YES / *STD / *PARAMETERS(...)
Specifies whether a message is to be output for each alias substitution and prefix insertion. Note that alias substitutions and prefix insertions are performed whenever the system internally accesses the actual file or job variable name, so a correspondingly large number of messages will be generated.
LOGGING = *UNCHANGED
The default setting is not changed.
LOGGING = *YES
The messages must always be output.
LOGGING = *STD
Messages for alias substitutions are output only if the corresponding AC entry has the LOGGING attribute; no messages are output for the insertion of prefixes.
*STD is equivalent to LOGGING=*PARAMETERS(ALIAS-SUBSTITUTION=*STD, PREFIX-INSERTION=*NO).
LOGGING = *PARAMETERS(...)
Enables the output of messages to be set independently for alias substitutions and the insertion of prefixes.
ALIAS-SUBSTITUTION = *UNCHANGED / *STD / *YES
Specifies whether message ACS0000 or ACS0049 is to be output for each alias substitution, i.e. whenever the actual file or job variable name is substituted for the alias. *YES causes the message to be output for every alias substitution; *STD for aliases with the attribute LOGGING.
PREFIX-INSERTION = *UNCHANGED / *YES / *NO
Specifies whether message ACS0000 or ACS0049 is to be output for each prefix insertion.
COMPLETE-ALIAS-NAMES = *UNCHANGED / *ALLOWED / *NOT-ALLOWED(...)
Defines whether the catalog and user ID may be used in aliases. This modification of the global setting for the local task must be permitted by the ACS administrator.
The ALLOWED setting should only be used when really necessary. Not allowing the catalog ID and user ID in aliases prevents the possibility of duplicate substitutions in cases where the already substituted and completed actual file or job variable name is inadvertently specified instead of the alias. Preventing such file or job variable names from appearing as an alias in the catalog thus ensures that no unwanted file or job variable is referenced.
COMPLETE-ALIAS-NAMES = *NOT-ALLOWED(...)
Catalog and user IDs are not allowed within alias names.
For users with ACS-ADMINISTRATION privilege:
Specifies (in conjunction with SCOPE=*SYSTEM) that the ACS option of COMPLETE-ALIAS-NAMES is by default unavailable to the users. However, in the substructure which follows, a user can be given the right to use this option by explicitly requesting it.
Use of this operand together with SCOPE=*TASK modifies the setting for the current administrator task; in this case, the substructure is ignored.
USER-MODIFICATION =
Makes a system-wide specification of whether a user may utilize the COMPLETE-ALIAS-NAME option of ACS.
USER-MODIFICATION = *UNCHANGED
Preset value: the previous declaration continues to apply.
USER-MODIFICATION = *ALLOWED
Every ACS user is to be allowed to use the COMPLETE-ALIAS-NAME option of ACS, and hence use fully qualified file or job variable names, with catalog ID and user ID, in alias catalogs.
USER-MODIFICATION = *NOT-ALLOWED
The COMPLETE-ALIAS-NAME option of ACS may not be used by nonprivileged users. A corresponding request in the user command, with COMPLETE-ALIAS-NAMES = *ALLOWED, will be rejected with an error message.
This is the preset value which applies following loading of the subsystem.
ALIAS-USERID = *UNCHANGED / *ALLOWED / *NOT-ALLOWED(...)
Defines whether user IDs are permitted within aliases. The right to modify the global setting NOT-ALLOWED for the local task must have been granted by the ACS administrator.
ALIAS-USERID = *ALLOWED
Allows the use of user IDs in aliases. The user ID TSOS and all user IDs beginning with the string SYS are not permitted.
ALIAS-USERID = *NOT-ALLOWED(...)
No foreign user IDs other than the system default ID may be used in an alias.
For users with ACS-ADMINISTRATION privilege:
Specifies in conjunction with SCOPE=*SYSTEM that the ACS option of ALIAS-USERID is by default unavailable to the users. However, in the substructure which follows, a user can be given the right to use this option by explicitly requesting it.
USER-MODIFICATION =
Makes a system-wide specification of whether a user may utilize the ALIAS-USERID option of ACS.
USER-MODIFICATION = *UNCHANGED
Preset value: the previous declaration continues to apply.
USER-MODIFICATION = *ALLOWED
Every ACS user is to be allowed to use the ALIAS-USERID option of ACS, and hence use alias names containing any required user IDs (exception: $SYS*. and $TSOS.).
USER-MODIFICATION = *NOT-ALLOWED
The ALIAS-USERID option of ACS must not be amended by nonprivileged users.
A corresponding request in the user command, with ALIAS-USERID = *ALLOWED/ *NOT-ALLOWED will be rejected with an error message.
This is the preset value which applies following loading of the subsystem.
SPOOL-FILE-PUBSET =
Only for users with ACS-ADMINISTRATION privilege:
Specifies the pubset on which temporary spool files (S.OUT., S.LST. files) should be created.
The operand will only be evaluated when the command is called if SCOPE=SYSTEM is also set, i.e. the ACS administration cannot exercise control specifically over its own spool files.
SPOOL-FILE-PUBSET = *UNCHANGED
Preset value: the previous declaration continues to apply.
SPOOL-FILE-PUBSET = *STD
For setting up temporary SPOOL files, use should be made of the default pubset for the task which is creating the file.
This is the preset value which applies following loading of the subsystem.
SPOOL-FILE-PUBSET = <cat-id 1..4>
Catalog ID of the pubset on which all temporary SPOOL files should be created.
If a SPOOL pubset is defined, the system administration must make sure that all the users of the system are entered in the user catalog for this pubset.
SCOPE =
Only for users with ACS-ADMINISTRATION privilege:
Defines the scope of validity of the specified options.
SCOPE = *TASK
Preset value:
The specified options are only to apply task-locally, i.e. to the user’s current task.
SCOPE = *SYSTEM
Specifies that the options are to have system-global validity.
STANDARD-RANGE =
Defines the standard range for substituting aliases and inserting a prefix. The range determines whether alias substitution and insertion of a prefix should apply both for files and for job variables.
In the case of alias substitution, this range applies for all AC entries which were set up with RANGE=*STD. A range deviating from this can be specified explicitly for each AC entry (see the ADD- and MODIFY-ALIAS-CATALOG-ENTRY commands).
For a prefix specification, this range applies with RANGE=*STD (see the SET-FILE-NAME-PREFIX command).
STANDARD-RANGE = *UNCHANGED
Preset value: the previous declaration continues to apply.
STANDARD-RANGE = *FILE
Alias substitution and the prefix specification are effective only for files.
STANDARD-RANGE = *BOTH
Alias substitution and the prefix specification are effective for both files and job variables.
This is the preset value which applies following loading of the subsystem.
Return codes
(SC2) | SC1 | Maincode | Meaning/Guaranteed messages |
|---|---|---|---|
0 | CMD0001 | Command executed normally | |
64 | ACS0029 | Command not permitted | |
64 | ACS0038 | Pubset could not be reserved | |
128 | ACS0018 | ACS is not available |
Examples
For examples, see the ADD-ALIAS-CATALOG-ENTRY and SET-FILE-NAME-PREFIX commands.