Add entry to current alias catalog
Component: | ACS |
Functional area: | File processing |
Domain: | FILE |
Privileges: | STD-PROCESSING |
Function
The ADD-ALIAS-CATALOG-ENTRY command adds an entry into the current alias catalog of a task. Any existing entry for the same alias in the catalog is overwritten.
If no alias catalog yet exists for the task, it is automatically set up with the first entry. The following attributes can be defined by the user for the new entry created:
real file or job variable name to be used for the alias name
whether the alias substitution is to be logged
whether the entry is displayed in the output of the SHOW-ALIAS-CATALOG-ENTRY command
whether the entry is protected against changes or deletion by the MODIFY-ALIAS-CATALOG-ENTRY or REMOVE-ALIAS-CATALOG-ENTRY command
the range of substitution: the entry should apply only for files, only for job variables, or for both (RANGE operand)
Entries created with ADD-ALIAS-CATALOG-ENTRY are only temporarily present in the task-local alias catalog, which means they are discarded when the alias catalog is deleted (explicitly with the PURGE-ALIAS-CATALOG command or implicitly when the task is terminated). If desired, however, such entries can be saved in a file by using the STORE-ALIAS-CATALOG command.
Privileged functions
When an individual catalog entry is being created, only the ACS administrator can explicitly make a distinction between user and system entries (TYPE operand). An alias explicitly created as a system entry is subject to less rigorous checking: it is always permissible to specify a catalog ID and user ID for it (except $SYS* and $TSOS).
Format
ADD-ALIAS-CATALOG-ENTRY | ||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||
Operands
ALIAS-FILE-NAME = <filename 1..54>
Alias for which the actual file or job variable name is to be replaced by ACS.
Not permitted are names of temporary files or job variables, TSOS user ID files or job variables, files or job variables of a user ID beginning with SYS and file names containing a specification of a generation or version. The ACS administrator can impose a general inhibit on the specification of a catalog and/or user ID (see the MODIFY-ACS-OPTIONS command). Regardless of this, the user ID of the current task can always be contained in alias names.
FILE-NAME = <filename 1..54>
Actual file or job variable name to be substituted by ACS for the alias. The name of a temporary file is not allowed, nor is it permitted to specify a generation or version. If the actual name is identical to the alias, the entry is treated as a normal alias definition (in contrast to *SAME). The replacement of the file name is logged as ACS0000. The substitution of the job variable name is logged with ACS0049.
FILE-NAME = *SAME
The actual file or job variable name is the same as the alias. That is why no substitution takes place in this case. However, the entry prevents the insertion of the defined prefix (see SET-FILE-NAME-PREFIX command). The substitution of the file or job variable name is logged.
The user must have read access rights for the file.
ATTRIBUTES = *STD / *PARAMETERS(...)
Defines the attributes of the new entry created in the alias catalog.
ATTRIBUTES = *STD
Specifies that the entry in the alias catalog is to have the following attributes:
LOGGING=*NO
VISIBILITY=*YES
PROTECTION=*NO
ATTRIBUTES = *PARAMETERS(...)
Attributes of the new entry are to be defined.
LOGGING = *NO / *YES
Logs substitution of the alias names. Independently of that, logging can be requested via ACS options. For security reasons, logging takes place only if one of both settings requires it.
VISIBILITY = *YES / *NO
Prevents the entry in the alias catalog from appearing in the output of the SHOW-ALIAS-CATALOG-ENTRY command for a non-privileged user.
PROTECTION = *NO / *YES
Protects the entry in the alias catalog against changes and deletion with the MODIFY-ALIAS-CATALOG-ENTRY and REMOVE-ALIAS-CATALOG-ENTRY commands respectively.
TYPE = *USER / *SYSTEM
This operand is available only to users with the ACS-ADMINISTRATION privilege.
Indicates whether the specified entry is to be of the type USER or SYSTEM.
TYPE = *USER
Preset value: The entry made in the catalog will be a user entry. When the virtual catalog is saved, this entry will be included in the file records.
TYPE = *SYSTEM
The catalog entry is to be made as a system entry. If the catalog is saved to a nonprivileged user’s file, this entry will not be included.
RANGE = *STD / *FILE / *JV / *BOTH
Determines the range of the entry. Alias substitution can be defined for files and/or job variables.
RANGE = *STD
Default: Alias substitution takes place using the ACS setting which applies for the task (ACS option STANDARD-RANGE).
RANGE = *FILE
Alias substitution is only effective for files.
RANGE = *JV
Alias substitution is only effective for job variables.
RANGE = *BOTH
Alias substitution is effective for both files and job variables.
Return codes
(SC2) | SC1 | Maincode | Meaning |
|---|---|---|---|
0 | CMD0001 | Command executed normally | |
64 | ACS0024 | Invalid alias catalog entry | |
64 | ACS0029 | Command is not permitted | |
128 | ACS0018 | ACS is not available | |
130 | ACS0036 | Resource bottleneck |
Examples
Example 1: Load alias catalog, change entries, substitution function
/SHOW-ACS-SYSTEM-FILES —————————————————————————————————————————————— (1)
% ALIAS CATALOG ID FILE NAME
% >ALL-USER $TSOS.SYSTEM.ACS.ALL-USER %P ALL-PRIV $TSOS.SYSTEM.ACS.ALL-PIVILEGE
/SHOW-ALIAS-CATALOG-ENTRY ———————————————————————————————————————————— (2)
% ACS0017 ALIAS CATALOG NOT AVAILABLE. COMMAND REJECTED
/LOAD-ALIAS-CATALOG ALIAS-CATALOG-ID=ALL-PRIV ———————————————————————— (3)
% ACS0001 ALIAS CATALOG 'ALL-PRIV' LOADED (DESCRIPTOR=' ', DATE=2020-04-21, NUMBER OF ENTRIES=2)
/SHOW-ALIAS-CATALOG-ENTRY ———————————————————————————————————————————— (4)
% ALIAS FILE NAME -> FILE NAME
%SB : LOAD-BIND -> $.BINDER
%SB : LOAD-PAMCONV -> $.PAMCONV
% ACS0037 NUMBER OF ALIAS CATALOG ENTRIES: 2 (FOR SYSTEM: 2, FOR USER: 0)
/SHOW-FILE-ATTRIBUTES FILE-NAME=LOAD-BIND —————————————————————— (5)
27 :SE11:$TSOS.BINDER
:SE11: PUBLIC: 1 FILE RES= 27 FRE= 2 REL= 0 PAGES
/ADD-ALIAS-CATALOG-ENTRY ALIAS-FILE-NAME=LMS,FILE-NAME=$.LMSCONV —————— (6)
/SHOW-ALIAS-CATALOG-ENTRY ————————————————————————————————————————————— (7)
% ALIAS FILE NAME -> FILE NAME %UB : LMS -> $.LMSCONV
%SB : LOAD-BIND -> $.BINDER
%SB : LOAD-PAMCONV -> $.PAMCONV
% ACS0037 NUMBER OF ALIAS CATALOG ENTRIES: 3 (FOR SYSTEM: 2, FOR USER: 1)
/ADD-ALIAS-CAT-ENTRY ALIAS-F-NAME=SF.SDF,F-NAME=$TSOS.SYSSDF.BS2CP.210 —— (8)
/SHOW-ALIAS-CATALOG-ENTRY ————————————————————————————————————————————— (9)
% ALIAS FILE NAME -> FILE NAME
%UB : LMS -> $.LMSCONV
%SB : LOAD-BIND -> $.BINDER
%SB : LOAD-PAMCONV -> $.PAMCONV
%UB : SF.SDF -> $TSOS.SYSSDF.BS2CP.210
% ACS0037 NUMBER OF ALIAS CATALOG ENTRIES: 4 (FOR SYSTEM: 2, FOR USER: 2)
/ADD-ALIAS-CATALOG-ENTRY ALIAS-FILE-NAME=BSP,FILE-NAME=LST.BSP.2 ————— (10)
/SHOW-ALIAS-CATALOG-ENTRY ———————————————————————————————————————————— (11)
% ALIAS FILE NAME -> FILE NAME
%UB : BSP -> LST.BSP.2
%UB : LMS -> $.LMSCONV
%SB : LOAD-BIND -> $.BINDER
%SB : LOAD-PAMCONV -> $.PAMCONV
%UB : SF.SDF -> $TSOS.SYSSDF.BS2CP.210
% ACS0037 NUMBER OF ALIAS CATALOG ENTRIES: 5 (FOR SYSTEM: 2, FOR USER: 3)
/SHOW-FILE-ATTRIBUTES FILE-NAME=SF.SDF —————————————————————————————————— (12)
1464 :SE11:$TSOS.SYSSDF.BS2CP.210
:SE11: PUBLIC: 1 FILE RES= 1464 FRE= 14 REL= 0 PAGES
/SHOW-FILE-ATTRIBUTES FILE-NAME=SF. ——————————————————————————————————— (13)
3 :SE11:$USERACS.SF.LMSCONV
3 :SE11:$USERACS.SF.NEU
3 :SE11:$USERACS.SF.TEST.DEV.1
/SHOW-ACS-OPTIONS ———————————————————————————————————————————————————— (14)
% ALIAS CATALOG SYSTEM V21.0
% =============================
%
% STATUS: ACTIVE
%
% ACTIVATED ALIAS CATALOG FILE(S):
% ID U-INFO DESCR DATE FILE NAME
% ALL-PRIV 2020-04-21 :SE11:$TSOS.SYSTEM.ACS.ALL-PIVILEGE
% ENTRIES ADDED/MODIFIED BY INDIVIDUAL COMMANDS: 3
%
% LOGGING: ALIAS-SUBSTITUTION=STD, PREFIX-INSERTION=NO
% SUCCESS-MSG OPTIONS: USER-FILE=YES, SYSTEM-FILE=YES
% COMPLETE-ALIAS-NAMES=NOT-ALLOWED (USER-MODIF=NOT-ALLOWED)
% ALIAS-USERID =NOT-ALLOWED (USER-MODIF=NOT-ALLOWED)
% STANDARD-RANGE=BOTH
/PRINT-DOC FROM-FILE=BSP ————————————————————————————————————————————— (15)
% SCP0860 FILE ':SE11:$USERACS.LST.BSP.2' PROTECTED BY A READ OR EXEC PASSWORD. COMMAND REJECTED
/LOAD-EXE FROM-FILE=LMS —————————————————————————————————————————————— (16)
% BLS0500 PROGRAM 'LMSCONV', VERSION '03.5B' OF '2017-03-09' LOADED
% BLS0552 COPYRIGHT (C) 2017 FUJITSU TECHNOLOGY SOLUTIONS GMBH. ALL RIGHTS RESERVED
/SHOW-JOB-STATUS ————————————————————————————————————————————————————— (17)
TSN: 0GX4 TYPE: 3 DIALOG NOW: 2020-04-21.145739
JOBNAME: ACSTEST PRI: 0 240
USERID: USERACS JCLASS: JCDIALOG LOGON: 2020-04-21.1447
ACCNB: 1 CPU-MAX: 32767 CPU-USED:000000.1236
STATION: STATE2DD PROC: G02DEXN0
TID: 009800E3 UNP/Q#: 00/000
CMD: SHOW-JOB-STATUS SIZE: 1
PROG: :SE11:$TSOS.LMSCONV
MONJV: *NONE
(1) | The SHOW-ACS-SYSTEM-FILE command shows the IDs of the available AC system files. |
(2) | The SHOW-ALIAS-CATALOG-ENTRY command shows that no task-local alias catalog is loaded. |
(3) | The LOAD-ALIAS-CATALOG command loads system entries from the $TSOS.SYSTEM.ACS.ALL-PIVILEGE AC system file and activates the ACS replacement function. |
(4) | The SHOW-ALIAS-CATALOG-ENTRY command shows that two alias name definitions have been loaded. |
(5) | In the SHOW-FILE-ATTRIBUTES command, the alias name LOAD-BIND is replaced by the defined real file name $.BINDER before the command is executed. |
(6) | The ADD-ALIAS-CATALOG-ENTRY command adds to the alias catalog a definition containing the alias name LMS for the file $.LMSCONV (user entry). |
(7) | Shows the entries in the alias catalogs. |
(8) | The ADD-ALIAS-CATALOG-ENTRY command adds to the alias catalog a definition containing the alias name SF.SDF for the file $TSOS.SYS.SDF.SYSTEM.SYNTAX (user entry). |
(9) | Shows the entries in the alias catalogs. |
(10) | The ADD-ALIAS-CATALOG-ENTRY command adds to the alias catalog a definition with the alias name BSP for the file LST.BSP.2(user entry). |
(11) | Shows the entries in the alias catalogs. |
(12) | In the SHOW-FILE-ATTRIBUTES command the alias name SF.SDF is replaced by the defined real file name $TSOS.SYSSDF.BS2CP.210 before the command is executed. |
(13) | As the specified name SF. does not correspond to an alias name, the SHOW-FILE-ATTRIBUTES command is used to display all files whose real file name begins with SF. |
(14) | Shows the current ACS settings with the SHOW-ACS-OPTIONS command. |
(15) | In the PRINT-DOCUMENT command, the alias name BSP is replaced by the defined real file name LST.BSP.2 before the command is executed. |
(16) | The LOAD-EXECUTABLE-PROGRAM command loads a program not from file LMS, but from the file LMSCONV . The message BLS0500 shows that the program LMSCONV has been loaded. |
(17) | The SHOW-JOB-STATUS command shows that the program LMSCONV has been loaded from the file :SE11:$TSOS.LMSCONV . The name LMS specified in LOAD-EXECUTABLE-PROGRAM corresponds to a defined alias name. It was therefore replaced by the assigned real file name :SE11:$TSOS.LMSCONV before the command was executed. |
Example 2: Save alias catalog, change entries
/SHOW-ALIAS-CATALOG-ENTRY ————————————————————————————————————————————— (1)
% ALIAS FILE NAME -> FILE NAME
%UB : ASS -> $.ASSEMBH
%UB : BSP -> LST.BSP.2
%SB : LOAD-BIND -> $.BINDER
%SB : LOAD-PAMCONV -> $.PAMCONV
%UB : SF.SDF -> :SE11:$TSOS.SYSSDF.BS2CP.210
% ACS0037 NUMBER OF ALIAS CATALOG ENTRIES: 5 (FOR SYSTEM: 2, FOR USER: 3)
/STORE-ALIAS-CATALOG TO-FILE=ACS.A1,USER-INF=USER1AC,DESCRIPTOR=V0001A — (2)
% ACS0038 NUMBER OF ALIAS CATALOG ENTRIES STORED IN FILE ':SE11:$USERACS.ACS.A1': 3
/REMOVE-ALIAS-CATALOG-ENTRY ALIAS-FILE-NAME=LOAD-BIND ———————————————— (3)
/REMOVE-ALIAS-CATALOG-ENTRY ALIAS-FILE-NAME=ASS —————————————————————— (4)
/SHOW-ALIAS-CATALOG-ENTRY ————————————————————————————————————————————— (5)
% ALIAS FILE NAME -> FILE NAME
%UB : BSP -> LST.BSP.2
%SB : LOAD-PAMCONV -> $.PAMCONV
%UB : SF.SDF -> $TSOS.SYSSDF.BS2CP.210
% ACS0037 NUMBER OF ALIAS CATALOG ENTRIES: 3 (FOR SYSTEM: 1, FOR USER: 2)
/MODIFY-ALIAS-CATALOG-ENTRY ALIAS-FILE-NAME=SF.SDF, - —————————————————— (6)
/ATTRIBUTES=*PARAMETERS(VISIBILITY=*NO)
/SHOW-ALIAS-CATALOG-ENTRY —————————————————————————————————————————————— (7)
% ALIAS FILE NAME -> FILE NAME
%UB : BSP -> LST.BSP.2
%SB : LOAD-PAMCONV -> $.PAMCONV
% ACS0037 NUMBER OF ALIAS CATALOG ENTRIES: 3 (FOR SYSTEM: 1, FOR USER: 2)
/MODIFY-ALIAS-CATALOG-ENTRY ALIAS-FILE-NAME=SF.SDF, - ————————————————— (8)
/ATTRIBUTES=*PARAMETERS(VISIBILITY=*YES,PROTECTION=*YES)
/SHOW-ALIAS-CATALOG-ENTRY ———————————————————————————————————————————— (9)
% ALIAS FILE NAME -> FILE NAME
%UB : BSP -> LST.BSP.2
%SB : LOAD-PAMCONV -> $.PAMCONV
%UB P: SF.SDF -> $TSOS.SYSSDF.BS2CP.210
% ACS0037 NUMBER OF ALIAS CATALOG ENTRIES: 3 (FOR SYSTEM: 1, FOR USER: 2)
/REMOVE-ALIAS-CATALOG-ENTRY ALIAS-FILE-NAME=SF.SDF ————————————————————— (10)
% ACS0005 ALIAS CATALOG ENTRY CANNOT BE MODIFIED. COMMAND REJECTED
/MODIFY-ALIAS-CATALOG-ENTRY ALIAS-FILE-NAME=SF.SDF, - ————————————————— (11)
/ATTRIBUTES=*PARAMETERS(PROTECTION=*NO)
% ACS0005 ALIAS CATALOG ENTRY CANNOT BE MODIFIED. COMMAND REJECTED
/MODIFY-ALIAS-CATALOG-ENTRY ALIAS-FILE-NAME=BSP,FILE-NAME=MAX.FILE.3 ——— (12)
/ADD-ALIAS-CATALOG-ENTRY ALIAS-FILE-NAME=MAX,FILE-NAME=MAX.FILE.3 ———— (13)
/SHOW-ALIAS-CATALOG-ENTRY SELECT=*BY-ATTRIBUTES(TYPE=*USER-ENTRIES) ——— (14)
% ALIAS FILE NAME -> FILE NAME
%UB : BSP -> MAX.FILE.3
%UB : MAX -> MAX.FILE.3
%UB P: SF.SDF -> $TSOS.SYSSDF.BS2CP.210
% ACS0037 NUMBER OF ALIAS CATALOG ENTRIES: 3 (FOR SYSTEM: 0, FOR USER: 3)
/LOAD-ALIAS-CATALOG ALIAS-CATALOG-ID=*OWN(FROM-FILE=ACS.A1),MODE=*REPLACE (15)
% ACS0001 ALIAS CATALOG 'USER1AC' LOADED (DESCRIPTOR='V0001A', DATE=2020-04-22, NUMBER OF ENTRIES=3)
/SHOW-ALIAS-CATALOG-ENTRY ——————————————————————————————————————————————— (16)
% ALIAS FILE NAME -> FILE NAME
%UB : ASS -> $.ASSEMBH
%UB : BSP -> LST.BSP.2
%UB : SF.SDF -> $TSOS.SYSSDF.BS2CP.210
% ACS0037 NUMBER OF ALIAS CATALOG ENTRIES: 3 (FOR SYSTEM: 0, FOR USER: 3)
(1) | The SHOW-ALIAS-CATALOG-ENTRY command shows all entries in the task-local alias catalog. |
(2) | The STORE-ALIAS-CATALOG command saves all user entries in the alias catalog into the AC file ACS.A1. |
(3) | Delete the entry with the alias name LOAD-BIND . |
(4) | Delete the entry with the alias name ASS. |
(5) | The SHOW-ALIAS-CATALOG-ENTRY command displays all entries in the task-local alias catalog. There remain only the three entries with the alias names BSP, LOAD-PAMCONV, and SF.SDF. |
(6) | For the entry with the alias name SF.SDF the attribute VISIBILITY in the MODIFY-ALIAS-CATALOG-ENTRY command is removed. |
(7) | On output with SHOW-ALIAS-CATALOG-ENTRY the entry with the alias name SF.SDF is not shown. The total line is however shown for all existing entries. |
(8) | For the entry with the alias name SF.SDF the attribute PROTECTION und VISIBILIY is defined in the MODIFY-ALIAS-CATALOG-ENTRY command. |
(9) | In the output with the SHOW-ALIAS-CATALOG-ENTRY command the entry with the alias name SF.SDF is flagged with the letter P (for PROTECTED). |
(10) | The entry with the alias name SF.SDF is to be deleted. The REMOVE-ALIAS-CATALOG-ENTRY command is rejected due to the attribute PROTECTION . |
(11) | The entry with the alias name SF.SDF is to be changed. The MODIFY-ALIAS-CATALOG-ENTRY command is rejected due to the attribute PROTECTION . |
(12) | For the entry BSP a new real file name (MAX.FILE.3) is defined with the MODIFY-ALIAS-CATALOG-ENTRY command. |
(13) | With the ADD-ALIAS-CATALOG-ENTRY command, a new entry with the alias name MAX is defined for the file MAX.FILE.3. The file MAX.FILE.3 can now be accessed via both MAX and BSP. |
(14) | Shows the user entries in the alias catalog. |
(15) | The entries in the AC file ACS.A1 are loaded into the alias catalog. All previous entries are thereby removed ( |
(16) | Output with the SHOW-ALIAS-CATALOG-ENTRY command shows only the three user IDs saved with STORE-ALIAS-CATALOG-ENTRY to the AC file ACS.A1 (see 1 and 2 above). The system entries and all changes in the alias catalog made after saving have been removed. |
Example 3: Working with JV
/ SHOW-ACS-SYSTEM-FILES ——————————————————————————————————————————————— (1)
% ALIAS CATALOG ID FILE NAME
% >ALL-USER $TSOS.SYSTEM.ACS.ALL-USER %P ALL-PRIV $TSOS.SYSTEM.ACS.ALL-PIVILEGE
/SHOW-ALIAS-CATALOG-ENTRY —————————————————————————————————————————— (2)
% ACS0017 ALIAS CATALOG NOT AVAILABLE. COMMAND REJECTED
/LOAD-ALIAS-CATALOG ALIAS-CATALOG-ID=ALL-PRIV ———————————————————————— (3)
% ACS0001 ALIAS CATALOG 'ALL-PRIV' LOADED (DESCRIPTOR=' ', DATE=2020-04-21, NUMBER OF ENTRIES=2)
/SHOW-ALIAS-CATALOG-ENTRY —————————————————————————————————————————— (4)
% ALIAS FILE NAME -> FILE NAME
%SB : LOAD-BIND -> $.BINDER
%SB : LOAD-PAMCONV -> $.PAMCONV
% ACS0037 NUMBER OF ALIAS CATALOG ENTRIES: 2 (FOR SYSTEM: 2, FOR USER: 0)
/ADD-ALIAS-CATALOG-ENTRY ALIAS-FILE-NAME=TEST, - ——————————————————————— (5)
/FILE-NAME=JOB.TEST,RANGE=*BOTH
/ADD-ALIAS-CATALOG-ENTRY ALIAS-FILE-NAME=J.JOB,FILE-NAME= - —————————————— (6)
/JV.MONITOR.JOB.TEST,ATTRIBUTES=*PARAMETERS(LOGGING=*YES),RANGE=*JV
/ADD-ALIAS-CATALOG-ENTRY ALIAS-FILE-NAME=E.JOB, - ——————————————————————— (7)
/FILE-NAME=ENTER.JOB.TEST,RANGE=*FILE
/SHOW-ALIAS-CATALOG-ENTRY ——————————————————————————————————————————————— (8)
% ALIAS FILE NAME -> FILE NAME
%UF : E.JOB -> ENTER.JOB.TEST
%UJ + J.JOB -> JV.MONITOR.JOB.TEST
%SB : LOAD-BIND -> $.BINDER
%SB : LOAD-PAMCONV -> $.PAMCONV
%UB : TEST -> JOB.TEST
% ACS0037 NUMBER OF ALIAS CATALOG ENTRIES: 5 (FOR SYSTEM: 2, FOR USER: 3)
/SHOW-JV JV-CONTENTS=J.JOB —————————————————————————————————————————————— (9)
% ACS0049 JOB VARIABLE NAME 'J.JOB' REPLACED BY 'JV.MONITOR.JOB.TEST'
RUNNING
/SHOW-FILE-ATTRIBUTES FILE-NAME=J.JOB —————————————————————————————————— (10)
% DMS0807 ERROR FROM SHOW-FILE-ATTRIBUTES FILE-NAME ':SE11:$USERACS.J.JOB'
% DMS0533 REQUESTED FILE NOT CATALOGED IN PUBSET 'SE11'. COMMAND TERMINATED
/SHOW-FILE-ATTRIBUTES FILE-NAME=E.JOB ——————————————————————————————————— (11)
3 :SE11:$USERACS.ENTER.JOB.TEST
:SE11: PUBLIC: 1 FILE RES= 3 FRE= 2 REL= 0 PAGES
/SHOW-JV JV-CONTENTS=TEST —————————————————————————————————————————————— (12)
INITIAL
/SHOW-FILE-ATTRIBUTES FILE-NAME=TEST ——————————————————————————————————— (13)
3 :SE11:$USERACS.JOB.TEST
:SE11: PUBLIC: 1 FILE RES= 3 FRE= 2 REL= 0 PAGES
/SHOW-JV JV-CONTENTS=E.JOB —————————————————————————————————————————————— (14)
% JVS0433 REQUESTED JOB VARIABLE NOT CATALOGED. COMMAND REJECTED
(1) | The SHOW-ACS-SYSTEM-FILE command shows the IDs of the available AC system files. |
(2) | The SHOW-ALIAS-CATALOG-ENTRY command shows that no task-local alias catalog is loaded. |
(3) | The LOAD-ALIAS-CATALOG command loads system entries from the $TSOS.SYSTEM.ACS.ALL-PIVILEGE AC system file and activates the ACS replacement function. |
(4) | The SHOW-ALIAS-CATALOG-ENTRY command shows that two alias name definitions have been loaded. |
(5) | The ADD-ALIAS-CATALOG-ENTRY command adds to the alias catalog a definition containing the alias name TEST for the file or job variable name JOB.TEST (user entry). |
(6) | The ADD-ALIAS-CATALOG-ENTRY command adds to the alias catalog a definition containing the alias name J.JOB only for the job variable JV.MONITOR.JOB.TEST (user entry). |
(7) | The ADD-ALIAS-CATALOG-ENTRY command adds to the alias catalog a definition containing the alias name E.JOB only for the file ENTER.JOB.TEST (user entry). |
(8) | The SHOW-ALIAS-CATALOG-ENTRY shows new entries. |
(9) | The alias name J.JOB is replaced by the job variable name JV.MONITOR.JOB.TEST and the message ACS0049 is sent (Attribute Logging). The content RUNNING is shown for the job variable JV.MONITOR.JOB.TEST . |
(10) | The file name J.JOB of the SHOW-FILE-ATTRIBUTES command is not replaced, because the alias definition is only set for job variables. The file J.JOB does not exist. |
(11) | The alias name E.JOB is replaced by the file name ENTER.JOB.TEST and the SHOW-FILE-ATTRIBUTES command shows the file. |
(12) | The SHOW-JV command replaces the alias name TEST with the job variable JOB.TEST and shows the content INITIAL. |
(13) | The SHOW-FILE-ATTRIBUTES command replaces the alias name TEST with JOB.TEST and shows the file. |
(14) | The SHOW-JV command does not replace the alias name E.JOB, because the alias name E.JOB was only defined for files. The job variable E.JOB does not exist. |
For further examples, see the HOLD-ALIAS-SUBSTITUTION, LOAD-ALIAS-CATALOG and SET-FILE-NAME-PREFIX commands.