SET IPLPARMS

Read syntax diagramSkip visual syntax diagram Set IPLparms

Authorization

Privilege Class: A

Purpose

Use SET IPLPARMS to change the IPL parameters currently in CP storage that CP will use for a shutdown re-IPL or a software restart.

Usage Notes

  1. The SET IPLPARMS command prompts the user for up to 3 lines of data. Each line is either truncated to 80 characters or padded with blanks out to 80 characters. These lines are joined together with no intervening blanks to form the IPL parameters.
  2. Specify all of the IPL parameters you want CP to use, even if they are already in CP storage. The SET IPLPARMS command replaces all the IPL parameters in CP storage. For example, if you IPLed with the IPL parameter to override the default console address (CONS) and then issued a SET IPLPARMS command to override the default file name of the system configuration file (FN), CP storage would contain only the new value for FN. The next shutdown re-IPL or software restart would use the default console address because you did not specify it on the SET IPLPARMS command.
  3. The IPL parameters (listed below) are described in z/VM: System Operation.
    Table 1. IPL Parameters
    Parameter Purpose
    CLEARPDR Reinitialize the PDR when all other SSI members are down.
    CONS= or CON= The operator console address.
    FN= The system configuration file name.
    FT= The system configuration file type.
    IPLVAR= The value of the CP.IPLPARMS.IPLVAR system environment variable.
    NOEXITS Do not pass certain options in the configuration file.
    NOHCD Ignore the IODF statement in the system configuration file.
    PDNUM= The parm disk number.
    PDOFF= The parm disk offset in the IPL volume.
    PDVOL= The real address of the parm disk.
    PROMPT The prompt for startup options at IPL.
    REPAIR Bypass SSI cluster initialization and management functions. For non-SSI, this is equivalent to specifying the NOAUTOLOG and DISABLE IPL options.
    selector:value (IPL parameter substring) Define conditional IPL parameters based on the value of the specified selector.
    STORE= The storage amount.
  4. After all of the IPL parameter data has been accepted, CP checks each parameter for syntax errors. If you make a syntax error (typing the name of an IPL parameter incorrectly, specifying a non-numeric value for an IPL parameter that is expecting a number, and so forth), CP issues error message HCP6770E and ignores your SET IPLPARMS command. CP does not change the IPL parameters in CP storage unless the SET IPLPARMS completes without errors. See Response 3 for an example of making a typographical error in the name of an IPL parameter.
  5. To display the IPL parameters in CP storage, use the QUERY IPLPARMS command (see QUERY IPLPARMS).

Responses

Response 1:

To set or reset the IPL parameters that CP will use after the next SHUTDOWN REIPL command or CP abend, enter the following SET IPLPARMS command: 
set iplparms
ENTER UP TO 3 LINES. ENTER A NULL LINE TO END.
FN=SYSTEM FT=CONFIG CONS=08E6
PROMPT
 
IPL parameters have been replaced.
Ready;

Response 2:

To clear the IPL parameters in CP storage so that CP will use the default values, use the following SET IPLPARMS command: 
set iplparms
ENTER UP TO 3 LINES. ENTER A NULL LINE TO END.
 
IPL parameters have been replaced.
Ready;

Response 3:

If you enter a mistake after the prompt, CP does not replace any of the IPL parameters, even the ones that were not in error. For example, suppose you wanted to set (or reset) the IPL parameters as in Response 1, but you made a typographical error. CP would ignore your entire SET IPLPARMS command, not just the IPL parameter in error: 
set iplparms
ENTER UP TO 3 LINES. ENTER A NULL LINE TO END.
FN=SYSTEM FT=CONFIG CONS=08E6
PRIMPT
 
HCP6770E IPL parameters: Unrecognized option - PRIMPT
IPL parameters have not been replaced.
Ready(06770);

Response 4:

If you enter an IPL parameter more than once, CP stores the last occurrence in CP storage and ignores all previous occurrences. For example, suppose you wanted to set (or reset) the IPL parameters as in Response 1, but you specified the wrong file name for the system configuration file. If you catch the mistake before you enter the null line that ends the SET IPLPARMS command, you can enter another file name: 
set iplparms
ENTER UP TO 3 LINES. ENTER A NULL LINE TO END.
FN=SYSTUM FT=CONFIG CONS=08E6
PROMPT
FN=SYSTEM
 
IPL parameters have been replaced.
Ready;

Messages

  • HCP003E Invalid option - {command|statement} contains extra option(s) starting with option
  • HCP2872E Command line is too long for CP. CP can accept no more than 240 characters. Your command was nnn characters in length
  • HCP6014I command cancelled at user request.
  • HCP6015E command cancelled because of console read error.
  • HCP6770E IPL parameters: Expected ( not found following selector
  • HCP6770E IPL parameters: Expected ) but found end of string
  • HCP6770E IPL parameters: Invalid console address - address
  • HCP6770E IPL parameters: Invalid file name - fn
  • HCP6770E IPL parameters: Invalid file type - ft
  • HCP6770E IPL parameters: Invalid parm disk number - n
  • HCP6770E IPL parameters: Invalid parm disk offset - offset
  • HCP6770E IPL parameters: Invalid parm disk volume - address
  • HCP6770E IPL parameters: Invalid selector value - value
  • HCP6770E IPL parameters: Invalid storage specification - nnnn
  • HCP6770E IPL parameters: Invalid IPLVAR value - value
  • HCP6770E IPL parameters: No value specified for selector selector
  • HCP6770E IPL parameters: Option option ignored. No longer supported
  • HCP6770E IPL parameters: Selector not allowed - selector
  • HCP6770E IPL parameters: Unrecognized option - option
  • HCP6770E IPL parameters: Unrecognized selector - selector