z/VM: CP Commands and Utilities Reference - z/VM - IBM

SET LOADDEV
Usage Notes
1276 z/VM: CP Commands and Utilities Reference
of the FCP-I/O device. It must be a value from 0-FFFFFFFF FFFFFFFF. For
values longer than 8 hex characters at least one separator blank is required
after the 8th character. The default is 0.
SCPDATA
Designates information to be passed to the program to be loaded during a
guest IPL. If the program does not require any information, then this parameter
is optional. Up to 4096 (4K) characters of data (text or hex) may be entered for
SCPDATA. The actual number of input characters could be less depending on
the translation to UTF-8. Because two hex characters are required to represent
each UTF-8 data byte, the maximum number of UTF-8 data bytes that can be
defined using the HEX option is 2048 (1/2 of the 4K character input limit). There
is no default.
NEW
Indicates that the parameter value that follows this option should replace any
value previously defined for the parameter.
APPEND
The default APPEND option is used to add additional data to the end of any
previously specified SCPDATA data.
offset
Indicates that the parameter value that follows this option should overlay any
value previously defined for the parameter beginning at the specified offset. It
must be a value from 0 to the current length of the parameter value.
HEX
Indicates that the parameter value that follows is UTF-8 encoded hex
(characters 0-F). If not specified, the value is assumed to be EBCDIC text (code
page 924).
text
Is the SCPDATA to be passed to the program to be loaded during a guest IPL.
Quotation marks are necessary if the text includes blanks, mixed case, is a
valid keyword (NEW or APPEND), or is all numeric (a valid offset). If the HEX
option is specified, the text must be in UTF-8 encoded format using hex
characters only. If the HEX option is not specified, code page 924 is used to
convert the text data to UTF-8.
1. Initial LOADDEV settings for a user can also be specified by a LOADDEV
statement in the user’s directory entry. A guest IPL from SCSI disk cannot be
performed by a user until a load device has been defined by at least one
LOADDEV directory statement or SET LOADDEV command.
2. The LOADDEV settings of a user can be displayed with the QUERY LOADDEV
command.
3. If you are IPLing CP from a SCSI disk, specify the following information:
v Specify the world wide port name (PORTNAME)
v Specify the logical unit number (LUN)
v For the BOOTPROG operand, specify 0 (or let it default to 0).
v Specify C8 for the BR_LBA operand. The SALIPL utility writes the SCSI boot
record to block 200 (X’C8’) of a CP-formatted device.
For a CMS Formatted device, SALIPL writes the SCSI boot record at block
200 (X’C8’) into the RECOMP area.