Ykfreeze Command - HP StorageWorks P9000 Reference Manual

Function
This command:
Is a TSO/E command called from REXX scripts.
Is executable for a copy group specified by the consistency group ID.
Freezes the specified copy group, changes it to the SCP status and suspends update I/O to
the P-VOL.
Works when the storage system has the corresponding function.
Parameters
STEM(stem-name- 1 ) ~ <REXX prefix of 64 or fewer characters>
Specify the prefix of the name of the copy group structure that stores information about the copy
group whose status you want to freeze (place in SCP status). Specify the same character string as
the one specified in the STEM parameter of the YKLOAD command that loaded the corresponding
copy group. You must also include a trailing period character.
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 called.
TIMEOUT(timeout-value) ~ <numeric characters> ((100-5000)) <<1000>>
Specify the timeout value in milliseconds. When the time specified with this value has elapsed after
executing the YKFREEZE command, the system automatically resets the SCP status.
You can specify a value up to 5000 milliseconds in increments of 100 milliseconds. If you omit
this parameter, 1000 milliseconds is assumed.
Return Codes
Table 1 16 (page 216)
Table 1 16 YKFREEZE Command Return Code List
Return Code
-4095 to -4040
-3
-1
0
32
36
40
44
216 CLI Commands
lists the return codes to be returned when the YKFREEZE 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.
I/O errors were encountered.
A change in an I/O configuration definition was detected.
Invalid or unknown elements are found in the structure.
An error occurred while a REXX variable was being written.
Terminating due to processing errors.