Ykscan Command - HP StorageWorks P9000 Reference Manual

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-parameter0, 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)
Table 132 YKSCAN Command Return Code List
Return Code
-4095 to -4040
-3
-1
0
246 CLI Commands
lists the return codes to be returned when the YKSCAN command terminates.
Meaning
The command terminated abnormally, possibly because the user SVC routine has
not been included properly.
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.
An interruption occurred during execution.
The command completed normally. The REXX variable corresponding to the scanned
volume is created.