Installation definition file (IDF file, internal format)

IMON uses an internal format of an IDF file for the “Exporting/importing SCI entries” function.

In the case of an export operation (Generate installation definition file menu option in the Edit  menu or GENERATE-IDF statement), IMON generates an IDF file in which the SCI entries of selected supply components or installation units are described in full. The data records of the internal IDF file are part of the generated import procedure and are read there by SYSDTA using the ADD-INSTALLATION-UNITS statement.

The individual records have a structured format in accordance with the following syntax. The syntax consists of keywords (in uppercase letters) and parameters. Blanks and end of record characters are used as separators; a number of blanks or end or record characters are interpreted as one separator.

An IDF file in internal format should only be created using the export function as manual processing could result in structural inconsistencies that could then lead to a defective SCI being produced during the import operation.

Syntax in the generated IDF file

Syntax when selecting one or more supply units:

*GEN-IDF

*GEN-IDF

*DEL-ID <package name> <user code>

*SU <SU name1> <SU version> <SU correction state>

  :

  :         Description of the relevant installation units

  :

*DEL-ID <package name> <user code>

*SU <SU name2> <SU version> <SU correction state>

  :

  :         Description of the relevant installation units

  :

*END

Syntax when selecting one or more installation units:

*GEN-IDF

*GEN-IDF

*IU <IU name1> <IU version> <IU correction state> <lost+found>

*IU-ATTR <functional level> <BS2000 version>

  :

  :        Description of the relevant installation items

  :

*IU <IU name2> <IU version> <IU correction state> <lost+found>

*IU-ATTR <functional level> <BS2000 version>

  :

  :        Description of the relevant installation items

  :

*END

Subsyntax for describing an installation unit:

*IU <IU name1> <IU version> <IU correction state> <lost+found>

*IU-ATTR <functional level> <BS2000 version>

  :

  :        Description of the relevant installation items

  :

Subsyntax for describing an installation item:

*ITEM <II name> <II version> <II type>
*II-ATTR <functional level> <user-access> <migrate> <access> <format>
<target>
*LOG-ID <logical id> <GPN-path>
*LOG-ID-ATTR <mandatory> <updatable> :

depends on the item type:

*FILE <filename 1..54 with-cat-user-without-gen-vers>

or

*MERGED <filename 1..54 with-cat-user-without-gen-vers>

or

*DF <filename 1..54 with-cat-user-without-gen-vers>

Description of the keywords and parameter values

                               

*GEN-IDF

Identifies the start of the generated IDF file (data record 1 and 2)

*DEL-ID	Identifies the delivery for the supply unit described subsequently (*SU)
<package name>	Package name
<user code>	User code

*SU	Description of the supply unit (consists of one or more installation units)
<SU name>	Name of the supply unit
<SU version>	Version of the supply unit
<SU correction-state >	Modification state of the supply unit

*IU	Description of an installation unit
<IU name>	Name of the installation unit
<IU version>	Version of the installation unit
<IU correction-state>	Modification state of the installation unit
<lost+found>	Assignment identifier: Y = Assigned to Lost+Found N = Installation unit could not assigned

*IU-ATTR	Attribute description of the installation unit
<functional level>	Functional state in which the installation unit is running:
	U	TU
	P	TPR or SIH
	B	Can run in both functional states
<BS2000 version>	BS2000 version:
	*NONE		No version information
	190		V19.0
	200		V20.0
	210		V21.0

*ITEM	Description of an installation item
<II name>	Name of the installation item: <filename-without-cat-user-gen-vers 1..30>
<II version>	Version of the installation item
<II type>	Type of the installation item

*II-ATTR	Attribute description of the installation item
<functional level>	Functional statement in which the installation item is running:
	U	TU
	P	TPR or SIH
	B	Can run in both functional states
	*	Undefined
<user access>	Access right (USER-ACCESS) for the assigned file:
	A	All users
	O	Owner
	S	All users including Service department
	*	Undefined
<migrate>	Migration identifier and backup class of the assigned file:
	S	MIGRATE=*STD and BACKUP-CLASS=*STD
	I	MIGRATE=*INHIBIT and BACKUP-CLASS=*STD
	E	MIGRATE=*INHIBIT and BACKUP-CLASS=E
	*	Undefined
<access>	Access right (ACCESS) for the assigned file:
	R	Read only
	W	Write
	*	Undefined

<format>	Format of the assigned file:
	K	PAMKEY
	2	NK2
	4	NK4
	*	Undefined
<target>	Hardware dependencies:
	K	X86 mode
	A	hardware-independent (ANY)
	S	/390 mode
	P	SPARC mode
	*	Undefined

*LOG-ID	Logical name of the installation item and assigned path name
<logical-id>	Logical name of the installation item
<GPNpath>	GPN path name of the installation item, if it exists and is fully qualified: <filename 1..54 with-cat-user-without-gen-vers> If it does not exist: *NONE

*LOG-ID-ATTR	Attribute description of the logical name
<mandatory>	Identifies whether the path name is mandatory
	Y	Yes
	N	No
<updatable>	Identifies whether the path name can be updated
	Y	Yes
	N	No

*FILE	Name of the installation item
*MERGED	Name of a merged installation item (library elements mixed in)
*DF	Dummy item of the type *DF
<filename>	Fully qualified filename
*END	Identifies the end of the generated IDF file (last data record).

Example of a generated IDF file (in an import procedure)

/SET-PROCEDURE-OPTIONS DATA-ESCAPE-CHAR='&&'
/DECL-PARAMETER NAME=(SCI -
/ (INITIAL-VALUE='*STD'))
/ASSIGN-SYSOUT TRANSFERSCI.MAR301501492021.GI
/ASSIGN-SYSDTA *SYSCMD
/REMARK :4H21:$TSOS.SYS.IMON.SCI
/START-IMON
//MODIFY-IMON-OPTIONS SOFTWARE-INVENTORY = &SCI
//ADD-INSTALLATION-UNITS FROM-FILE = *SYSDTA
*GEN-IDF
*GEN-IDF
*IU IMON-BAS 03.4 A00 N                                 Definition of the installation unit IMON-BAS
*IU-ATTR B *NONE
*IU-ACT NS 255 N
*ITEM SINLIB.IMON-BAS.034 001 *NP
*II-ATTR U A S R 4 A
*LOG-ID SINLIB :4H21:$TSOS.SINLIB.IMON-BAS.034
*LOG-ID-ATTR Y N
*FILE :4H21:$TSOS.SINLIB.IMON-BAS.034
.
.      Not all of the output is shown here.
.
*ITEM SYSSSC.IMON-BAS.034 001 SSC
*II-ATTR P O S R 4 A
*LOG-ID SYSSSC :4H21:$TSOS.SYSSSC.IMON-BAS.034
*LOG-ID-ATTR Y N
*FILE :4H21:$TSOS.SYSSSC.IMON-BAS.034
*IU IMON-GPN 03.4 A00 N                                 Definition of the installation unit IMON-GPN
*IU-ATTR B *NONE
*IU-ACT NS 255 N
*ITEM SKMLNK.IMON-GPN.034 001 DAT
*II-ATTR P O I R 4 K
*LOG-ID SYSLNK :4H21:$TSOS.SKMLNK.IMON-GPN.034
*LOG-ID-ATTR Y N
*FILE :4H21:$TSOS.SKMLNK.IMON-GPN.034
*ITEM SYSLIB.IMON-GPN.034 001 PL*
*II-ATTR B A S R 4 A
*LOG-ID SYSLIB :4H21:$TSOS.SYSLIB.IMON-GPN.034
*LOG-ID-ATTR Y Y
*FILE :4H21:$TSOS.SYSLIB.IMON-GPN.034
.
.      Not all of the output is shown here.
.
*ITEM SYSSSC.IMON-GPN.034 001 SSC
*II-ATTR U O S R 4 A
*LOG-ID SYSSSC :4H21:$TSOS.SYSSSC.IMON-GPN.034
*LOG-ID-ATTR Y N
*FILE :4H21:$TSOS.SYSSSC.IMON-GPN.034
*IU IMON-SIC 03.4 A00 N                                 Definition of the installation unit IMON-SIC
*IU-ATTR U *NONE
*IU-ACT NS 255 N
*ITEM SYSFHS.IMON-SIC.034 001 *DF
*II-ATTR U A S R 4 A
*LOG-ID SYSFHS *NONE
*LOG-ID-ATTR N Y
*ITEM SYSFHS.IMON-SIC.034.D 001 DAT
*II-ATTR U A S R 4 A
*LOG-ID SYSFHS.D :4H21:$TSOS.SYSFHS.IMON-SIC.034.D
*LOG-ID-ATTR Y Y
*FILE :4H21:$TSOS.SYSFHS.IMON-SIC.034.D
*ITEM SYSFHS.IMON-SIC.034.E 001 DAT
*II-ATTR U A S R 4 A
*LOG-ID SYSFHS.E :4H21:$TSOS.SYSFHS.IMON-SIC.034.E
*LOG-ID-ATTR Y Y
*FILE :4H21:$TSOS.SYSFHS.IMON-SIC.034.E
.
.      Not all of the output is shown here.
.
*FILE :4H21:$TSOS.SYSSII.IMON-SIC.034
*END
//END
/ASSIGN-SYSOUT *PRIMARY
/ASSIGN-SYSDTA *PRIMARY
/ENDP