A - Page 1 - ------------------------------------------------------------------- | README file for DRV V03.1A | | Edition: 10.11.2005 | ------------------------------------------------------------------- This document describes the changes/extensions in DRV version 03.0B (sections 1 to 3) and version 03.0C (section 4). The extensions in DRV version 3.1A have no influence on the user interface. The changes/extensions refer to the following manual: DRV V03.0A Edition October 2003 Order number U6515-J-Z125-4 References to chapters and sections in this README file are those in the above manual. Contents -------- 1. Subsystem configuration file ............................. Page 2 2. SET-DRV-ENVIRONMENT ...................................... Page 3 3. SHOW-DRV-ENVIRONMENT...................................... Page 6 4. Disk migration with DRV................................... Page 9 A - Page 2 - 1. Subsystem configuration file As of V3.0B, DRV supports a subsystem configuration file. - Specifying The subsystem configuration file can be specified in the DSSM subsystem catalog entry of DRV as SUBSYSTEM-INFO-FILE (command MODIFY-SUBSYSTEM-PARAMETERS for the dynamic catalog or the MODIFY-SUBSYSTEM-ATTRIBUTES statement for the static catalog) or as a subsystem parameter when starting DRV (START-SUBSYSTEM command), in the form SUBSYSTEM-PARAMETER='FILE-NAME=' (where is the name of the configuration file). Specification as a subsystem parameter has priority over entry in the DSSM subsystem catalog. One of the following keywords can be specified instead of a file name: 1. *SYSTEM - $TSOS.SYS.DRV-CONFIGURATION is used as the name of the configuration file 2. *DEFAULT - $TSOS.SYSPAR.DRV.030 is used as the name of the configuration file 3. *NONE - No configuration file is used - File name The configuration file can be stored with any desired name under any user ID, but must always be on the home pubset of the host. However, in this case the file name must be specified in full in the above commands. If no user ID is specified, a search is made for the specified file under the $TSOS ID or the system default ID (secondary read). - File attributes The configuration file must be a SAM file with variable record length (FILE-STRUC=SAM, REC-FORM=V). It should have the attributes USERACCESS=*OWNER-ONLY and ACCESS=*READ and, if necessary, be write-protected with a password. - Configuration file formats All the DRV action commands are permitted in the configuration file, except for the SHOW commands: SET-DRV-ENVIRONMENT SET-DRV-PARAMETER START-DRV-DUAL-MODE STOP-DRV-DUAL-MODE PREPARE-PUBSET-MIGRATION FINISH-PUBSET-MIGRATION ABORT-PUBSET-MIGRATION If an error occurs while a command is being during executed, the configuration file processing is not terminated. But processing is aborted if syntax errors are encountered. Unique abbreviations are permitted for the commands. The commands generally conform to the SDF rules. Only the following points deviate from this: - The continuation character (" - ") can be placed anywhere. - Continuation lines must begin with "/". - The maximum permitted record length is 256 bytes (including record length field). - The maximum length permitted for each command is 4000 bytes A - Page 3 - 2. SET-DRV-ENVIRONMENT (replace the "SET-DRV-ENVIRONMENT" command in chapter 7 of the manual on page 102ff) SET-DRV-ENVIRONMENT Make general DRV settings Application range: DEVICE Privileges: TSOS OPERATING Authorization key: D Functional description The /SET-DRV-ENVIRONMENT command is used to make general settings for DRV. The command defines a set of devices as local devices. This is meaningful for disaster protection when using DRV. The /STOP-DRV-DUAL-MODE command therefore creates pubsets that are only made up of devices in the local computer center or in remote computer centers. The COPY-SPEED-PARAMETER and SERVER-LIMIT operands are provided to control system loading when synchronizing/reconstructing disks. Format ----------------------------------------------------------------------- | SET-DRV-ENVIRONMENT | |---------------------------------------------------------------------| | LOCAL-UNITS = *UNCHANGED / *ALL / | | ---------- | | list-poss(100): / / | | *DEVICE-RANGE(...) | | | | *DEVICE-RANGE(...) | | | FROM = / | | | TO = / | | COPY-SPEED-PARAMETER = *UNCHANGED / *STD / | | ---------- | | list-poss(3): *LOW() / *MEDIUM() / *HIGH() | | *LOW() | | | USER-ALLOCATION = *UNCHANGED / list-poss(2): *YES() / *NO() | | ---------- | | | | *YES() | | | | | WAIT-TIME = *UNCHANGED / *STD / integer_0..999 | | ---------- | | | | | NUM-IOS = *UNCHANGED / *STD / integer_1..999 | | ---------- | | | | *NO() | | | | | WAIT-TIME = *UNCHANGED / *STD / integer_0..999 | | ---------- | | | | | NUM-IOS = *UNCHANGED / *STD / integer_1..999 | | ---------- | A - Page 4 - | *MEDIUM() | | | USER-ALLOCATION = *UNCHANGED / list-poss(2): *YES() / *NO() | | ---------- | | | | *YES() | | | | | WAIT-TIME = *UNCHANGED / *STD / integer_0..999 | | ---------- | | | | | NUM-IOS = *UNCHANGED / *STD / integer_1..999 | | ---------- | | | | *NO() | | | | | WAIT-TIME = *UNCHANGED / *STD / integer_0..999 | | ---------- | | | | | NUM-IOS = *UNCHANGED / *STD / integer_1..999 | | ---------- | | *HIGH() | | | USER-ALLOCATION = *UNCHANGED / list-poss(2): *YES() / *NO() | | ---------- | | | | *YES() | | | | | WAIT-TIME = *UNCHANGED / *STD / integer_0..999 | | ---------- | | | | | NUM-IOS = *UNCHANGED / *STD / integer_1..999 | | ---------- | | | | *NO() | | | | | WAIT-TIME = *UNCHANGED / *STD / integer_0..999 | | ---------- | | | | | NUM-IOS = *UNCHANGED / *STD / integer_1..999 | | ---------- | | SERVER-TASK-LIMIT = *UNCHANGED / *STD / integer_1..500 | | ---------- | ----------------------------------------------------------------------- Operands LOCAL-UNITS = Specifies devices in the local computer center. LOCAL-UNITS = *ALL All devices are in the local computer center (start value). LOCAL-UNITS = list-poss(100): / Mnemonic name of the device. The list may only contain a maximum of 100 entries. LOCAL-UNITS = *DEVICE-RANGE(...) Range of mnemonic device names. FROM = list-poss(100): / First mnemonic device name in the range. TO = list-poss(100): / Last mnemonic device name in the range. COPY-SPEED-PARAMETER = Defines the settings of COPY-SPEED (see SET-DRV-PARAMETER). DRV synchronizes volumes in cycles: in each cycle, a number of copy I/Os are executed initially followed by a wait period to allow the applications time to complete their disk operations. The number of executed I/Os and the wait time differs for different COPY-SPEED values and depends on the allocation state. COPY-SPEED-PARAMETER = *STD The default values are used. A - Page 5 - COPY-SPEED-PARAMETER = *LOW / *MEDIUM / *HIGH Defines the settings for the relevant COPY-SPEED. USER-ALLOCATION = Defines the settings dependent on the volume allocation. USER-ALLOCATION = *YES / *NO *YES defines the settings for the allocated volumes (e.g. for imported volumes. *NO defines the settings for non-allocated volumes. WAITTIME = Specifies the wait time in milliseconds in a DRV cycle. WAITTIME = *STD Sets the wait time to the default value for the corresponding COPY-SPEED and allocation state. WAITTIME = int0..999 Sets the wait time for the corresponding COPY-SPEED and allocation state to the specified time in milliseconds. By default, no wait time is set for non-allocated volumes. NUM-IOS = Specifies the number of I/Os in a DRV cycle. NUM-IOS = *STD Sets the number of I/Os to the default value for the relevant COPY-SPEED and allocation state. NUM-IOS = int1..999 Specifies the number of I/Os in a DRV cycle for the relevant COPY-SPEED and allocation state. SERVER-TASK-LIMIT = *STD / Specifies the maximum number of concurrently active DRV server tasks. The number is unlimited with the default value *STD. Command results and command return code With commands from the console, a global completion message NBR0740 is issued and this contains the command return code. The command is processed synchronously and is completed when the input prompt reappears. 0 CMD0001 All part-jobs were completed successfully 32 CMD0221 Interface error, command aborted 32 DRV0084 Internal error, command aborted 64 CMD2241 Command not available because DRV subsystem not loaded 64 CMD0216 Missing privilege A - Page 6 - 3. SHOW-DRV-ENVIRONMENT (replace the "SHOW-DRV-ENVIRONMENT" command in chapter 7 of the manual on page 118ff) SHOW-DRV-ENVIRONMENT Query information on general DRV settings Application range: DEVICE Privileges: TSOS OPERATING Authorization key: D Functional description The /SHOW-DRV-ENVIRONMENT command queries information on the general settings of DRV. The command supports structured output in S variables (refer to the manual "Commands Volume 6" for working with S variables). Format ----------------------------------------------------------------------- | SHOW-DRV-ENVIRONMENT | |---------------------------------------------------------------------| | INFORMATION = *ALL / *LOCAL-UNITS / *COPY-SPEED-PARAMETERS | | ---- | | OUTPUT = *SYSOUT / *SYSLST(...) | | ------- | | *SYSLST(...) | | | SYSLST-NUMBER = *STD / | | ---- | |---------------------------------------------------------------------| Operands INFORMATION = Specifies the general DRV settings that are to be output. INFORMATION = *ALL Outputs all global settings. INFORMATION = *LOCAL-UNITS Displays the disks or disk ranges that were defined as local with the /SET-DRV-ENVIRONMENT command. INFORMATION = *COPY-SPEED-PARAMETERS Displays the settings of the parameters for COPY-SPEED that were specified with the /SET-DRV-ENVIRONMENT command. A - Page 7 - OUTPUT = Defines the output media for the current SHOW-DRV-ENVIRONMENT command. OUTPUT = *SYSOUT Default value. Output is via the SYSOUT system file, i.e. in dialog mode to the data terminal. OUTPUT = *SYSLST(...) Output is to SYSLST, formatted for printing. The first byte of each output record is X'40'. SYSLST-NUMBER = *STD/ Specifies whether the output is to go to the SYSLST system file or into a SYSLST file from the set SYSLST01 to SYSLST99. Default value is *STD, i.e. output goes to the SYSLST system file. Output columns Local disk ranges /SHOW-DRV-ENVIRONMENT outputs the information under the following heading: LOCAL DEVICES if no devices were defined with /SET-DRV-ENVIRONMENT, the line *ALL follows, otherwise the list of set ranges is output: FROM TO FROM Name of the first disk device from a range of local disks TO Name of the last disk device from a range of local disks If single devices were entered with /SET-DRV-ENVIRONMENT, such a device appears in both the FROM and the TO column. COPY-SPEED settings /SHOW-DRV-ENVIRONMENT outputs the information under the following heading: COPY PARAMETER The current settings for each combination of COPY-SPEED and allocation state are output in one line. Example (with default values): SPEED ALLOC WAIT-TIME NUM-IO LOW FREE 0 10 LOW IN-USE 500 1 MEDIUM FREE 0 10 MEDIUM IN-USE 500 10 HIGH FREE 0 30 HIGH IN-USE 50 30 Maximum number of DRV servers /SHOW-DRV-ENVIRONMENT outputs the information in one line, for example: SERVER TASK LIMIT: *NONE NUMBER OF SERVER: 2 This means: the number of concurrently active DRV server tasks is unlimited (default) and two servers are currently active. A - Page 8 - Output in S variables S variable: var(*LIST).NUM-OF-DEV-RANGE Type: integer, contents: Number of local disk ranges. If this number is zero, all disks are local. S variable: var(*LIST).DEV-RANGE(*LIST).FROM Type: string, contents: Mnemonic name of the first disk in a local disk range. S variable: var(*LIST).DEV-RANGE(*LIST).TO Type: string, contents: Mnemonic name of the last disk in a local disk range. S variable: var(*LIST).COPY-PARAM(*LIST).SPEED Type: string, contents: LOW / MEDIUM / HIGH COPY-SPEED of the parameter record S variable: var(*LIST).COPY-PARAM(*LIST).ALLOC-STA Type: string, contents: FREE / IN-USE Allocation state of the parameter record S variable: var(*LIST).COPY-PARAM(*LIST).NUM-OF-IO Type: integer, contents: Number of I/Os in one cycle of the parameter record S variable: var(*LIST).COPY-PARAM(*LIST).WAIT-TIME Type: Integer, contents: Wait time in one cycle of the parameter record S variable: var(*LIST). SERVER-LIM Type: integer, contents: Maximum number of DRV server tasks S variable: var(*LIST).ACT-SERVER-NUM Type: integer, contents: Current number of DRV server tasks Command results and command return code With commands from the console, a global completion message NBR0740 is issued and this contains the command return code. The command is processed synchronously and is completed when the last output line has been output. 0 CMD0001 All part-jobs were completed successfully 32 CMD0221 Interface error, command aborted 32 CMD2009 Internal error with OPS output 32 DRV0084 Internal error, command aborted 64 CMD2241 Command not available because DRV subsystem not loaded 64 CMD0216 Missing privilege A - Page 9 - 4. Disk migration with DRV (Chapter 4.6.1 in manual: 1. The only target disks supported are D3435 disks in a Symmetrix controller on a channel type S or channel type 2.) With DRV 03.0C target disks on a channel type FC of S-Servers are supported too, beginning with BS2000 OSD V5.0B.