MODIFY-IPL-VOLUME - Modifying an IPL disk

This statement can be used to modify an IPL disk.

MODIFY-IPL-VOLUME                                                                                                                                  

DISK-NUMBER=n / *PRIVATE(...)
	*PRIVATE(...)
		|	DISK=vsn
		|	,DEVICE-TYPE=STDDISK / device-type
,IPL-FILE=*UNCHANGED / *STD / name
,IPL-REP-FILE=*UNCHANGED / *STD / name
,SLED-REP-FILE=*UNCHANGED / *STD / name
,HSI-TYPE=*BY-OWN-HSI / *390 / *X86 1)

¹⁾ The *7500 operand value can still be specified for reasons of compatibility.

DISK-NUMBER
Specifies the IPL disk that is to be modified. Depending on the format of the pubset ID (see the DECLARE-PUBSET statement), the number of the disk in the pubset must be specified (see the CREATE-VOLUME statement).

DISK-NUMBER=n
One- to three-digit number of the IPL disk in the pubset (see "CREATE-VOLUME - Initialize disks").

DISK-NUMBER=*PRIVATE(...)
Specifies a private IPL disk that is to be modified.

DISK=vsn
Volume serial number of the private IPL disk.

DEVICE-TYPE=STDDISK
Default device type for the private IPL disk.

DEVICE-TYPE=device-type
Device type of the private IPL disk.

 

IPL-FILE
Defines the IPL load module to be anchored in the SVL.

IPL-FILE=*UNCHANGED
The load module remains unchanged. It has already been anchored.

IPL-FILE=*STD
Default file to be anchored.

IPL-FILE=name
Name of the file to be anchored (see notes).

IPL-REP-FILE
Defines the IPL REP file to be anchored in the SVL.

IPL-REP-FILE=*UNCHANGED
This file remains unchanged. It has already been anchored.

IPL-REP-FILE=*STD
Default file to be anchored.

IPL-REP-FILE=name
Name of the file to be anchored (see notes).

SLED-REP-FILE
Defines the SLED REP file to be anchored in the SVL.

SLED-REP-FILE=*UNCHANGED
This file remains unchanged. It has already been anchored.

SLED-REP-FILE=*STD
Default file to be anchored.

SLED-REP-FILE=name
Name of the file to be anchored (see notes).

HSI-TYPE
Specifies the HSI for which IPL capability is to be established (see notes).

HSI-TYPE=*BY-OWN-HSI
IPL capability is established for the HSI on which SIR is running.

HSI-TYPE=*390
IPL capability is established for the /390 HSI (/390 servers).

HSI-TYPE=*X86
IPL capability is to be established for the X86 HSI (x86 servers).

 

Notes

1. The IPL capability of disks is described in detail on "SF pubsets".

2. If *STD is specified for a file, it must either be installed using IMON or be in the pubset to be processed.

3. If DISK-NUMBER=*PRIVATE is specified, the IPL files must be in the home pubset in a compatible format.

4. The files specified by “name” do not have to be cataloged in the pubset. They are copied to the disk to be processed, where they are cataloged anew with the extension <.DSKxxx> or <.vsn> for private disks.

5. If at least one disk of the pubset is converted to an IPL disk, SIR creates the file SYS.NSI.SAVEREP in order to save system corrections during system initialization.

6. The user can specify several, noncontradictory statements for the same disk by specifying the operands for the file names individually:

   MODIFY-IPL-VOLUME DISK-NUMBER=03,IPL-FILE=IPLDATEI

   MODIFY-IPL-VOLUME DISK-NUMBER=03,IPL-REP-FILE=IPLREP

   IPLREP and IPLDATEI must be in the pubset to be processed.

7. The user can create an IPL disk with the aid of MODIFY-IPL-VOLUME by specifying at least one IPL file. If the IPL file is neither anchored nor specified, the processing is discontinued.

8. If the REP files for IPL and SLED are neither anchored nor specified, a suitable message is issued and processing is continued. The disk is then IPL capable.

9. In order to verify the consistency of the IPL file specified in the statement, the version of the included load module will be checked. The user is responsible for ensuring consistency between REP files and the IPL file.

10. All anchored files are given the file attributes BACKUP=E, DESTROY=*YES, *ACCESS=*READ and MIGRATE=*FORBIDDEN.

11. SIR does not support file protection with BASIC-ACL for IPL files. If the user has protected one of these files with BASIC-ACL, the protection must be canceled to enable SIR to modify the IPL files.

12. A disk can only ever be bootstrappable for one HSI. This means that if IPL capability is established for HSI-TYPE=*X86 using MODIFY-IPL-VOLUME, any IPL capability which previously existed for a /390 HSI is lost.

13. The HSI-TYPE operand should only be specified if IPL disk capability is not to be established for the HSI on which SIR is currently running.

14. The statement is rejected for disks of pubsets, which cannot be used as home pubsets:

    • pubsets with SYS-ID=*STD

    • pubsets with PHYSICAL-BLOCK-SIZE=*4K

    • SM pubsets