Start Network Install (STRNETINS)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Start Network Install (STRNETINS) command is used to start an install of Licensed Internal Code (LIC), operating system, options, and using a network optical device of type 632B-003.
The command will perform the following checks:
- The required media is available in the selected network optical device.
- Licensed agreements have been accepted if needed.
If all checks have been completed successfully the following command is issued to start the install: PWRDWNSYS OPTION(*IMMED) RESTART(*YES *FULL) ENDSBSOPT(*DFT) TIMOUTOPT(*CONTINUE) IPLSRC(D)
Restrictions:
- The user must have job control (*JOBCTL) special authority and use (*USE) authority to the network optical device.
| Top |
Parameters
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| DEV | Network optical device | Name | Required, Positional 1 |
| OPTION | Installation option | *ALL, *OPSYS, *LNG, *LIC | Optional, Positional 2 |
| KEYLCKMOD | Keylock mode | *NORMAL, *MANUAL | Optional, Positional 3 |
| IPLSRC | IPL source | B, A | Optional |
| LNG | Language | 2901-2999, *DFT | Optional |
| CONFIRM | Confirm | *YES, *NO | Optional |
| Top |
Network optical device (DEV)
Specify the network optical virtual device to use for the install.
- name
- Specify the name of the network optical device.
| Top |
Installation option (OPTION)
Specifies the install option to be used.
- *ALL
- Specifies to perform a full install of licensed internal code, operating system, options and licensed products that that available on the install media loaded in the specified network optical device.
- *OPSYS
- Specifies to install operating system only. The installation of licensed internal code, options and products will be skipped.
- *LNG
- Specifies to install language objects only. The language used will be based on the value specified for the Language (LNG) parameter.
- *LIC
- Specifies to install Licensed Internal Code only.
| Top |
Keylock mode (KEYLCKMOD)
Specifies the system key lock mode to be used for the installation.
- *NORMAL
- Specifies to set the key lock mode to normal.
- *MANUAL
- Specifies to set the key lock mode to manual.
| Top |
IPL source (IPLSRC)
Specifies the the IPL source to be used to IPL prior to the operating system install. This parameter is only used for install option *OPSYS and *LNG.
- B
- Specifies the IPL source to be B.
- A
- Specifies the IPL source to be A.
| Top |
Language (LNG)
Specifies the language to use for the installation.
- *DFT
- If the install media contains only a single national language version (NLV), that language version is installed. If the install media contains multiple NLVs, the current primary language for the system will be selected.
- 2901-2999
- Specify the NLV identifier to be used. More information on feature identifications and a list of IBM-supplied feature codes is in the Installing, upgrading, or deleting IBM i and related software book, SC41-5120.
Note: If performing an auto install and the language specified is different than the current primary language, the QINSTLNG API should be used prior to installing to allow the specified language to be set as your new primary language.
For example, to have language 2962 set as the primary language during installation, first perform the following program call.
CALL PGM(QINSTLNG) PARM('2962')
For more information, see the Set Install National Language Version (NLV) QINSTLNG API in the information center.
| Top |
Confirm (CONFIRM)
Specifies whether the request should be confirmed before the system is powered down to start the install.
- *YES
- A confirmation panel is displayed when the PWRDWNSYS command is issued to start the install.
- *NO
- There is no confirmation when the PWRDWNSYS command is issued to start the install.
| Top |
Examples
Example 1: Start Network Install for a Software Upgrade Device Name
STRNETINS DEV(MYNETDEV) KEYLCKMOD(*NORMAL) LNG(2924)
This command checks that the device MYNETDEV contains the necessary files for a software upgrade using NLV 2924, checks for any needed license agreements, and starts the automatic installation.
Example 2: Start Network Install of the Operating System only
STRNETINS DEV(MYNETDEV) OPTION(*OPSYS) KEYLCKMOD(*MANUAL)
This command checks that device MYNETDEV contains the necessary files for an install of the operating system and starts the installation.
Example 3: Start Network Install of the Licensed Internal Code only
STRNETINS DEV(MYNETDEV) OPTION(*LIC) KEYLCKMOD(*MANUAL)
This command checks that device MYNETDEV contains the necessary files for an install of the Licensed Internal Code and starts the installation.
Example 4: Start Network Install of the language objects only
STRNETINS DEV(MYNETDEV) OPTION(*LNG) KEYLCKMOD(*MANUAL) LNG(2924)
This command checks that device MYNETDEV contains the necessary files for changing the primary language install operating system using NLV 2924 and starts the installation.
Example 5: Start Network Install bypassing confirmation panel
STRNETINS DEV(MYNETDEV) KEYLCKMOD(*MANUAL) LNG(2924) CONFIRM(*NO)
This command checks that the device MYNETDEV contains the necessary files for a software upgrade using NLV 2924, checks for any needed license agreements, and starts the manual installation bypassing the confirmation panel.
| Top |
Error messages
*ESCAPE Messages
- CPFBC32
- Unable to start network install with device &1.
- CPF9825
- Not authorized to device &1.
| Top |