Privileges: TSOS
A syntax file merged with SDF-I can be unmerged using the REMOVE statement.
Format 1: Merging software unit syntax files
REMOVE |
PRODUCT-NAME = <structured-name 1..15> |
PRODUCT-NAME = <structured-name 1..15>
Defines the name of the product whose syntax file is to be removed from the input file assigned in the preceding OPEN statement.
This operand can only be used for Fujitsu products. It is identical with the product name (SUSF name), which is output for syntax files via the SHOW-SYNTAX-FILE statement.
Format 2: Unmerging user-generated syntax files
REMOVE |
REMOVE-ID = <structured-name 1..15> |
REMOVE-ID = <structured-name 1..15>
Defines the name of the product whose syntax file is to be removed from the input file assigned in the preceding OPEN statement.
This operand can only be used for syntax files the user himself has generated. It is identical with the REMOVE-ID declared by means of MERGE.
Example
Unmerging a software unit syntax file
The input syntax file SF.base contains the following SUSFs: L1 Version 1, L2 Version 1, L3 Version 1, L4 Version 1.
The syntax file SF.in to be merged contains the SUSF L2 Version 2.
OPEN INPUT-FILE=SF.base,OUTPUT-FILE=SF.out ———————————————————————————— (1) REMOVE PRODUCT-NAME=L2 ———————————————————————————————————————————————— (2) MERGE FILE=SF.in —————————————————————————————————————————————————————— (3) END ——————————————————————————————————————————————————————————————————— (4)
(1) | The input syntax file SF.base and the name of the output syntax file SF.out are defined. |
(2) | Product L2 is removed from the input syntax file SF.base because the next step involves merging of the syntax file SF.in which contains a new version of product L2. This ensures that no residues of Version 1 remain in the syntax file (e.g. if a command had been omitted in Version 2, this command would not be removed by merely merging Version 2). |
(3) | The syntax file SF.in is merged with the input syntax file SF.base to produce the internal SDF-I work file (see section “Handling work files”). |
(4) | SDF-I is terminated. The work file receives the name SF.out defined via OPEN and contains the following SUSFs: L1 Version 1, L2 Version 2, L3 Version 1, L4 Version 1. SUSF L2 is now present in its new version. |
Notes
Only syntax files merged beforehand with the SDF-I statement MERGE can be unmerged.
Objects overwritten with MERGE... REPLACE-PRODUCT=YES are not restored.
If multiple syntax files for a number of products are to be merged, it is better to regenerate the system and group syntax files from the original syntax files by means of a batch task. The additional overhead in terms of memory is offset in this case by the increased integrity of the generated syntax files.