Privileges: SUBSYSTEM-MANAGEMENT
Function
The GENERATE-IDF statement allows you to copy (export) SCI entries from selected supply units or installation units to a different SCI. IMON generates an import procedure in which the desired target SCI is opened and a generated IDF file, which describes the structure of the selected supply components or installation units, (see "Installation definition file (IDF file, internal format) "), is read in by SYSDTA using the ADD-INSTALLATION-UNITS statement.
Note
When selecting installation units (UNIT-NAME=*INSTALL-UNIT(...)) the IDF file generated does not contain information about the assignments to supply units. Since this information may also be missing when registering later on in another SCI, the installation units exported in this manner cannot be deinstalled with the DEINSTALL-SUPPLY-UNITS statement.
In addition, the installation path (in its entirety or only the catalog ID, the user ID or the file name prefix) can be changed during the export operation. In this case, it is also possible to generate a copy procedure containing all the COPY-FILE commands for the relevant installation items and the import procedure call. When you call the copy procedure, the installation items are first transferred to the new location (placement) and are then registered in the specified SCI.
In the case of supply units whose path names belong to non-accessible files, you must enter the statement under TSOS. If you use different user IDs, the statement is not actually rejected, but the path names of the non-accessible files are replaced by an asterisk (*) in the generated IDF file and in the copy procedure. The ADD-INSTALLATION-UNITS statement is then rejected during the import procedure because of the defective IDF file. Likewise, the corresponding commands are also rejected as being defective during the copy procedure.
Format
GENERATE-IDF | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Operands
UNIT-NAME =
Selection of the installation units or supply units to be added to the import procedure.
UNIT-NAME = *SUPPLY-UNIT(...)
Select the installation units to be included in the import procedure.
UNIT-NAME = *ALL
Include all installation units from the SCI in the import procedure.
UNIT-NAME = *BY-DIALOG
Select the desired installation units using dialog boxes.
UNIT-NAME = list-poss(30): <text 1..30 without-sep>(...)
Explicitly specified name of the desired installation unit. Up to 30 installation units can
be specified in a list.
VERSION = *HIGHEST-EXISTING / *ALL / <product-version without-man-corr>
Specification of the version of the specified installation unit.
VERSION = *HIGHEST-EXISTING
Highest version of the installation unit.
VERSION = *ALL
All versions of the installation unit.
CORRECTION-STATE = *HIGHEST-EXISTING / *ALL / *LOWEST-EXISTING / list-poss(15): <alphanum-name 3..3>
Specification of the correction state of the specified installation unit with the specified version.
CORRECTION-STATE = *HIGHEST-EXISTING
Highest correction state of the installation unit.
CORRECTION-STATE = *ALL
All correction states of the installation unit.
CORRECTION-STATE = *LOWEST-EXISTING
Lowest correction state of the installation unit.
UNIT-NAME = *INSTALLATION-UNIT(...)
Select the supply units to be included in the import procedure.
UNIT-NAME = *ALL
Include all the supply units from the SCI in the import procedure.
UNIT-NAME = *BY-DIALOG
Select the desired supply units using dialog boxes.
UNIT-NAME = list-poss(30): <text 1..30 without-sep>(...)
Explicitly specified name of the desired supply unit. Up to 30 supply units can be specified in a list.
VERSION =
Specification of the version of the specified supply unit.
VERSION = *HIGHEST-EXISTING
Highest version of the supply unit.
VERSION = *ALL
All versions of the supply unit.
CORRECTION-STATE = *HIGHEST-EXISTING / *ALL / *LOWEST-EXISTING / list-poss(15): <alphanum-name 3..3>
Specification of the correction state of the specified supply unit with the specified version.
CORRECTION-STATE = *HIGHEST-EXISTING
Highest correction state of the supply unit.
CORRECTION-STATE = *ALL
All correction states of the supply unit.
CORRECTION-STATE = *LOWEST-EXISTING
Lowest correction state of the supply unit.
RENAMING =
Rename/do not rename the saving locations (and thus the path names) of the associated installation items.
RENAMING = *NONE
Do not rename the saving locations.
RENAMING = *COMPLETE-LOCATION(...)
Completely rename the saving locations. New saving locations can be allocated to old saving locations in the NAME operand. The old and new saving locations are specified using a catalog ID, a user ID and a prefix, if necessary.
NAME = list-poss(15): *PARAMETERS(...)
The allocation of the old saving location to the new saving location. The complete path name of the saving location [:<cat-id>:]<userid>[prefix] is always specified.
Up to 15 allocations can be specified in a list.
OLD-NAME = <partial-filename 2..23 without-cat-user>
Old saving location.
NEW-NAME = <partial-filename 2..23 without-cat-user>
New saving location.
NEW-NAME = *PROMPT
You are prompted to enter the new saving location when the generated procedure is being executed.
RENAMING = *COMPOSED-LOCATION(...)
Rename individual parts of the saving locations: catalog ID and/or user ID and/or prefix.
The desired allocations can be specified in the CATID, USERID and PREFIX operands.
CATID =
Change/do not change the catalog ID.
CATID = *UNCHANGED
Do not change the catalog ID.
CATID = list-poss(15): *PARAMETERS(...)
The allocation of the old catalog ID to the new catalog ID. Up to 15 allocations can be specified in a list.
OLD-NAME = <cat-id 1..4>
Old catalog ID.
NEW-NAME = <cat-id 1..4>
New catalog ID.
USERID =
Change/do not change the user ID.
USERID = *UNCHANGED
Do not change the user ID.
USERID = list-poss(15): *PARAMETERS(...)
The allocation of the old user ID to the new user ID. Up to 15 allocations can be specified in a list.
OLD-NAME = <name 1..8>
Old user ID.
NEW-NAME = <name 1..8>
New user ID.
PREFIX =
Change/do not change the prefix.
PREFIX = *UNCHANGED
Do not change the prefix.
PREFIX = list-poss(15): *PARAMETERS(...)
The allocation of the old prefix to the new prefix. Up to 15 allocations can be specified in a list.
OLD-NAME = *NONE / <partial-filename 2..7 without-cat-user> / *ALL
Old prefix. Default is *NONE, i.e. all installation items without a prefix are given the prefix specified in the NEW-NAME operand.
Specify *ALL causes all installation items to be assigned the prefix specified in the NEW-NAME operand regardless of their prefix.
NEW-NAME = *NONE / <partial-filename 2..7 without-cat-user>
New prefix. Default is *NONE, i.e. the installation items do not have a prefix after renaming.
COPY-PROC-GENERATION =
Generate/do not generate a copy procedure. The copy procedure contains COPY-FILE commands for all the selected installation items. The RENAMING operand defines the source and target location of the copy action.
COPY-PROC-GENERATION = *NO
Do not generate a copy procedure.
COPY-PROC-GENERATION = *YES(...)
Generate a copy procedure.
SAVE-FILE-LOCATION = *NONE / <partial-filename 2..23>
Determines whether backups of the installation items that already exist at the target saving location are made before copying. The backups are created at the saving location specified here. Default: *NONE, i.e. do not make a backup.
SCI-NAME = *STD / <filename 1..50 without-gen-vers>
Specifies the SCI to which the selected supply units or installation units are to be added. Default is *STD, i.e. the entries are imported into the standard SCI.
GENERATE-FILE-PREFIX = <filename 1..49 without-gen-vers>
The names of the generated procedures. The import procedure is assigned the suffix .GEN, while the copy procedure is given the suffix .COPY.
IDF-FORMAT =
Specifies which format version of IDF has to be generated, i.e. for which version of IMON this IDF is intended.
IDF-FORMAT = *CURRENT
The generated IDF is intended to be used with IMON-BAS from the current version and higher.
IDF-FORMAT = *V1
The generated IDF is intended to be used with an IMON-BAS version lower than V3.0.
IDF-FORMAT = *V2
The generated IDF is intended to be used with an IMON-BAS version from V3.0 and higher.
OUTPUT =
The output target for the result log.
OUTPUT = *SYSOUT
Output the result log to SYSOUT.
OUTPUT = *SYSLST(...)
Output the result log to SYSLST.
SYSLST-NUMBER =
Number of the SYSLST file.
SYSLST-NUMBER = *STD
Output the information to standard SYSLST.
SYSLST-NUMBER = <integer 1..99>
An explicitly specified SYSLST number.