Delete entry from alias catalog
Component: | ACS |
Functional area: | File processing |
Domain: | FILE |
Privileges: | STD-PROCESSING |
Function
The REMOVE-ALIAS-CATALOG-ENTRY command allows the user to delete entries from the task-specific alias catalog. Protected entries cannot be deleted. If a HOLD-ALIAS-SUBSTITUTION command was issued to halt the alias substitution function, that command will remain in effect even if the last entry in the alias catalog is deleted with REMOVE-ALIAS-CATALOG-ENTRY.
Format
REMOVE-ALIAS-CATALOG-ENTRY |
ALIAS-FILE-NAME = *ALL / <filename 1..54 with-wild(80)> ,SELECT = *ALL / *USER-ENTRIES / *SYSTEM-ENTRIES |
Operands
ALIAS-FILE-NAME = *ALL / <filename 1..54 with-wild(80)>
The aliases contained in the AC entries to be deleted.
ALIAS-FILE-NAME = *ALL
Selects and deletes all AC entries matching the type specified in the SELECT operand.
ALIAS-FILE-NAME = <filename 1..54 with-wild(80)>
Selects and deletes all AC entries that have aliases which match the specified pattern string and the type specified in the SELECT operand.
SELECT = *ALL / *USER-ENTRIES / *SYSTEM-ENTRIES
Selects AC entries for deletion on the basis of their type (user or system entries)
SELECT = *ALL
Selects and deletes both user entries and system entries of the alias catalog.
SELECT = *USER-ENTRIES
Selects and deletes only the user entries of the alias catalog.
SELECT = *SYSTEM-ENTRIES
Selects only the system entries of the alias catalog for deletion.
Return codes
(SC2) | SC1 | Maincode | Meaning |
|---|---|---|---|
0 | CMD0001 | Command executed normally | |
1 | 0 | CMD0001 | No action (e.g. AC entry does not exist) |
32 | CMD0221 | Internal error | |
64 | ACS0017 | Error: alias catalog not available | |
64 | ACS0029 | Command not permitted | |
128 | ACS0018 | ACS is not available | |
130 | ACS0036 | Resource bottleneck |
Examples
For examples, see the ADD-ALIAS-CATALOG-ENTRY and LOAD-ALIAS-CATALOG commands.