HP P9000, Reference Manual

Page: 246 / 399

The range from the
FROM
parameter to the
TO
parameter is scanned in hexadecimal ascending
order.
FROMVSN(
volser
)
~ <from 1 to 6 alphanumeric characters>
Specify the volume serial number of the first volume to be scanned.
This parameter and the
FROM
and
TO
parameters are mutually exclusive.
TOVSN(
volser
)
~ <from 1 to 6 alphanumeric characters>
Specify the volume serial number of the last volume to be scanned.
This parameter and the
FROM
and
TO
parameters are mutually exclusive.
The range from the
FROMVSN
parameter to the
TOVSN
parameter is scanned in EBCDIC order.
MSG(
stem-name-2
)
~ <REXX prefix of 64 or fewer characters>
Specify an optional prefix for the name of the message structure used to store the messages to be
generated by this command. You must also include a trailing period character.
The message structure is initialized when the CLI command with the same name as the
MSG
parameter is specified.
ARRAYS(
stem-name-3
)
~ <REXX prefix of 64 or fewer characters>
Specify an optional prefix for the name of the Host-Discovered Array Index structure. You must
also include a trailing period character.
The
YKSCAN
command returns the number of storage systems detected to
stem-name-specified-in-ARRAYS-parameter
0
, and returns the information about the nth detected
storage system to the corresponding REXX variable (the REXX variable with the name formed by
appending n to the stem name specified by the
ARRAYS
parameter).
NOTE:
•
Before creating a copy group, use the
YKSCAN
command to obtain the information on the
volumes available on this site.
•
If storage system functions or information such as the Software Keys or microcode number is
changed, storage system information should be obtained again by using the
YKSCAN
command.
In this case, at least one volume is scanned once, and storage system information can be
obtained.
•
The alias volume (PAV-Alias) bound to a parallel access volume (PAV) is not scanned.
Return Codes
Table 132 (page 246) lists the return codes to be returned when the
YKSCAN
command terminates.
Table 132 YKSCAN Command Return Code List
Meaning Return Code
The command terminated abnormally, possibly because the user SVC routine has
not been included properly.
-4095
to
-4040
The module cannot be loaded. Possible causes are as follows:
•
The library dataset has not been linked.
•
The module is protected by the RACF program control function.
-3
An interruption occurred during execution.
-1
The command completed normally. The REXX variable corresponding to the scanned
volume is created.
0
246 CLI Commands