HOLD-ALIAS-SUBSTITUTION

Suspend substitution functions of alias catalog

Component:	ACS
Functional area:	File processing
Domain:	FILE
Privileges:	STD-PROCESSING SAT-FILE-EVALUATION SAT-FILE-MANAGEMENT SECURITY-ADMINISTRATION

Function

The HOLD-ALIAS-SUBSTITUTION command halts alias substitutions for the current task. The prefix insertion and SPOOL-FILE-PUBSET functions of ACS are not affected by this command.
The user can cancel the effect of this command and resume alias substitution with the RESUME-ALIAS-SUBSTITUTION command.
The HOLD-ALIAS-SUBSTITUTION command can be specified several times in sequence, but each HOLD-ALIAS-SUBSTITUTION command must be canceled with a separate RESUME-ALIAS-SUBSTITUTION command.

Format

HOLD-ALIAS-SUBSTITUTION                                                                                                                    

Return codes

(SC2)	SC1	Maincode	Meaning
	0	CMD0001	Command executed normally
2	0	ACS0042	Command has no effect: HOLD counter overflow
	128	ACS0018	ACS is not available
	130	ACS0036	Resource bottleneck

Example

Interrupting the replacement function, preventing replacement

/show-alias-cat   —————————————————————————————————————————   (1)

%       ALIAS FILE NAME         ->     FILE NAME
%UB : ASS                       -> $.ASSEMBH
%UB : BSP                       -> LST.BSP.2
%SF : COB85                     -> $RZ.COBOL85
%SF : FORTRAN                   -> $RZ.FOR1
%UF : SF.SDF                    -> $TSOS.SYS.SDF.SYSTEM.SYNTAX
%  ACS0037 NUMBER OF ALIAS CATALOG ENTRIES: 5 (FOR SYSTEM: 2, FOR USER: 3)

/hold-alias-substitution ——————————————————————————————————   (2)

%  ACS0007 /HOLD-ALIAS-SUBSTITUTION PROCESSED

/show-acs-opt  ————————————————————————————————————————————   (3)

%
% ALIAS CATALOG SYSTEM V20.0
% =============================
%
% STATUS: IN HOLD
%
% ACTIVATED ALIAS CATALOG FILE(S):
%  ID                   U-INFO   DESCR    DATE       FILE NAME
% ACS-FOR-USER1        SYSADM04 ACS0193  2012-02-09 :2OST:$TSOS.OTTY.XY
% 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

/show-file-attr sf.sdf  ————————————————————————————————————————————   (4)

%  DMS0533 REQUESTED FILE NOT CATALOGED IN PUBSET '2OS2'. COMMAND TERMINATED

/copy-file sf.robar,sf.sdf  ————————————————————————————————————————   (5)
show-file-attr sf.sdf  —————————————————————————————————————————————   (6)

%        48 :2OS2:$USER1.SF.SDF
%:2OS2: PUBLIC:      1 FILE  RES=        48 FRE=         7 REL=         0 PAGES

/resume-alias-substitution  —————————————————————————————————————————   (7)

%  ACS0008 /RESUME-ALIAS-SUBSTITUTION PROCESSED
%  ACS0009 ALIAS CATALOG OPERATION CONTINUES

/show-file-attr sf.sdf  ————————————————————————————————————————————   (8)

%      5328 :2OST:$TSOS.SYS.SDF.SYSTEM.SYNTAX
%:2OST: PUBLIC:      1 FILE  RES=      5328 FRE=         1 REL=         0 PAGES

/show-file-attr $USER1.sf.sdf  ——————————————————————————————————————   (9)

%        48 :2OS2:$USER1.SF.SDF
%:2OS2: PUBLIC:      1 FILE  RES=        48 FRE=         7 REL=         0 PAGES

(1)	The SHOW-ALIAS-CATALOG-ENTRY command displays all entries of the task-local alias catalog.
(2)	The HOLD-ALIAS-SUBSTITUTION command is used to halt the ACS substitution function.
(3)	The SHOW-ACS-OPTIONS command shows the current ACS settings for the task. The output field STATUS has the value IN HOLD, which means that the ACS substitution function has been interrupted.
(4)	The specified file name SF.SDF in the SHOW-FILE-ATTRIBUTES command is not replaced, despite the fact that it matches a defined alias. A file with the actual name SF.SDF does not exist.
(5)	The COPY-FILE command copies the contents of the file SF.ROBAR to the file SF.SDF. The alias SF.SDF is not replaced in this case either, but a file with the actual name SF.SDF is created.
(6)	In the SHOW-FILE-ATTRIBUTES command is used the specified file name SF.SDF.
(7)	The interrupted ACS substitution function is resumed with the RESUME-ALIAS-SUBSTITUTION command.
(8)	The defined actual file name $TSOS.SYS.SDF.SYSTEM.SYNTAX is now substituted for the alias SF.SDF in the SHOW-FILE-ATTRIBUTES command before that command is executed.
(9)	In order to retrieve the catalog entry for the file SF.SDF, the file name is specified along with the user ID ($USER1.SF.SDF). No substitution takes place in this case since the specified name differs from that of the alias due to the user ID. Such differentiation can also be achieved by specifying the catalog ID or the complete path name.

For further examples see the commands ADD-ALIAS-CATALOG-ENTRY, LOAD-ALIAS-CATALOG, and SET-FILE-NAME-PREFIX.