Consideration: DFSMS and MVS commands apply only to SMS-defined libraries. The library name that is defined during the definition of a library in Interactive Storage Management Facility (ISMF) is required for libname in the DFSMS commands. The activation of a source control data set (SCDS) with this libname must have already been performed for SMS to recognize the library.
|
Note: A composite and distributed IBM Virtual Tape Server (VTS) library can be varied online and offline like any VTS library, though varying a distributed library offline from the host really has no meaning (does not prevent outboard usage of the library). Message CBR3016I warns the user when a distributed library is initialized or
varied offline. |
Keyword1
|
Keyword2
|
Keyword3
|
Keyword4
|
Description
|
Comp Lib
|
Dist Lib
|
TS7720
TS7720T
TS7740
|
CACHE
|
|
|
|
Requests information about the current state of the cache and the data managed within it.
|
N/A
|
Y
|
ALL
|
COPY
|
ACTIVITY
|
See the User’s Guide
|
|
Requests information about Active Copy jobs.
|
N/A
|
Y
|
ALL
|
COPY
|
SUMMARY
|
|
|
Requests information about all the copy jobs.
|
N/A
|
Y
|
ALL
|
LVOL
|
volser
|
FLASH
|
|
Requests information about a specific logical volume.
|
Y
|
N/A
|
ALL
|
LVOL
|
volser
|
PREFER MIGRATE
REMOVE
REMOVE
REMOVE
|
PROMOTE
INFO
|
Requests a change in the cache management for a logical volume.
|
N/A
N/A
N/A
N/A
N/A
|
Y
Y
Y
Y
Y
|
ALL
TS7740
TS7720
TS7720
TS7720
|
LVOL
|
volser
|
COPY
|
KICK
FORCE
|
KICK requests to move a logical volume to the front of the copy queue.
FORCE puts a copy job against a removed logical volume and promotes it to the front of the copy queue. It is useful when it is required to get a removed volume back into a TS7720 by copying it from another consistent cluster.
|
N/A
|
Y
|
ALL
|
PDRIVE
|
|
|
|
Requests information about the physical drives and their current usage associated with the specified distributed library.
|
N/A
|
Y
|
TS7740
and TS7720T
|
POOLCNT
|
00-32
|
|
|
Requests information about the media types and counts, which are associated with a specified distributed library, for volume pools beginning with the value in keyword2.
|
N/A
|
Y
|
TS7740
and TS7720T
|
PVOL
|
volser
|
|
|
Requests information about a specific physical volume.
|
N/A
|
Y
|
TS7740
and TS7720T
|
PVOL
|
volser
|
DELETE
|
|
Requests the specified physical volume record to be deleted from the TS7700 database. The specified physical volume must be empty and not physically in the library.
|
N/A
|
Y
|
TS7740
and TS7720T
|
RECALLQ
|
volser
|
|
|
Requests the content of the recall queue starting with the specified logical volume. Keyword2 can be blank.
|
N/A
|
Y
|
TS7740 and TS7720T
|
RECALLQ
|
volser
|
PROMOTE
|
|
Requests that the specified logical volume be promoted to the top of the recall queue.
|
N/A
|
Y
|
TS7740
and TS7720T
|
RRCLSUN
|
ENABLE
DISABLE
STATUS
|
|
|
In response to the RRCLSUN request, the cluster that is associated with the distributed library enables, disables, or displays the status of the force residency on recall feature.
|
N/A
|
Y
|
TS7740 and TS7720T
|
SETTING
|
ALERT,
CACHE,
THROTTLE
DEVALLOC
RECLAIM
CPYCNT
COPY
LINK
DELEXP
EXISTDEL
|
See Settings descriptions after this table
|
See Settings descriptions after this table
|
Settings to control functions in the grid.
|
N/A
|
Y
|
ALL
|
SETTINGS2
|
SCRATCH
CACHE
|
PFRLOCO
MAXLGMC
|
ENABLE
DISABLE
|
Additional settings to control functions in the grid.
|
N/A
|
N/A
|
ALL
|
STATUS
|
GRID
|
|
|
Requests information about the copy, reconcile, and ownership takeover status of the libraries in a grid configuration.
|
Y
|
N/A
|
ALL
|
STATUS
|
GRIDLINK
|
|
|
Requests information about the status and performance of the links between the TS7700 tape drives in the grid configuration.
|
N/A
|
Y
|
ALL
|
COPYRFSH
|
volser
|
See the User’s Guide
|
See the User’s Guide
|
Refreshes copy policy and queue a copy job on the copy target clusters without mounting or dismounting a volume.
|
N/A
|
Y
|
ALL
|
DRSETUP
|
CCCCCCCC (DR family name)
|
ADD
REMOVE
|
0-7
(cluster ID)
|
Adds/removes a cluster to/from the disaster recovery (DR) family.
|
Y
|
N/A
|
ALL
|
WP
|
ENABLE/
DISABLE
|
Enables/disables write protect mode within the DR family.
|
Y
|
N/A
|
ALL
|
||
FLASH
|
ENABLE/
DISABLE
|
Enables/disables Flash
Copy within the DR
family.
|
Y
|
N/A
|
ALL
|
||
DOALL
|
ENABLE/
DISABLE
|
Enables/disables write protect mode and FlashCopy with a single command.
|
Y
|
N/A
|
ALL
|
||
LIVECOPY
|
FAMILY/
NONE
|
Enables or disallows the use of a live copy within the DR family.
|
Y
|
N/A
|
ALL
|
||
SELFLIVE
|
ENABLE/
DISABLE
|
Enables or disables accessing live copy created after time zero.
|
N
|
Y
|
ALL
|
||
SHOW
|
CCCCCCCC (DR family name)
|
|
Views information about the DR family.
|
Y
|
N/A
|
ALL
|
|
PARTRFSH
|
|
|
|
Changes cache partition assignment.
|
|
|
TS7720T
|
Remember: All settings are persistent across system restarts, service actions, or code updates. The settings are not carried forward as part of disaster recovery (DR) from copy-exported tapes or the recovery of a system.
|
Keyword3
|
Keyword4
|
Description
|
COPYHIGH
|
value
|
Uncopied Data High Warning Limit
This is the threshold, in gigabytes of data in cache, that needs to be copied to other TS7700 tape drives in a grid configuration, at which point the TS7700 generates a message indicating that the amount of uncopied data has exceeded a high warning limit. The following message text is shown:
•When above the threshold:
AL5000 Uncopied data of xxxxxxxx GB above high warning limit of yyyyyyyy GB.
•When below the threshold:
AL5001 No longer above uncopied data high warning limit of yyyyyyyy GB.
|
COPYLOW
|
value
|
Uncopied Data Low Warning Limit
This is the threshold, in gigabytes of data, in cache that must to be copied to other TS7700 tape drives in a grid configuration, at which the TS7700 generates a message indicating that the amount of uncopied data has exceeded a low warning limit. The following message text is shown:
•When above the threshold:
AL0000 Uncopied data of xxxxxxxx GB above low warning limit of yyyyyyyy GB.
•When below the threshold:
AL0001 No longer above uncopied data low warning limit of yyyyyyyy GB.
|
PDRVCRIT
|
value
|
Available Physical Drive Critical Warning Limit
This is the threshold, in number of physical drives, at which the TS7700 generates a message indicating that the number of available physical drives has fallen below the critical warning limit. The following message text is shown:
•When fallen below the threshold:
AL5004 Available physical drives of xx is below critical limit of yy.
•When risen above the threshold:
AL5005 Available physical drives no longer below critical limit of yy.
|
PDRVLOW
|
value
|
Available Physical Drive Low Warning Limit
This is the threshold, in number of physical drives, at which the TS7700 generates a message indicating that the number of available physical drives has fallen below the low warning limit. The following message text is shown:
•When fallen below the threshold:
AL0004 Available physical drives of xx is below low limit of yy.
•When risen above the threshold:
AL0005 Available physical drives no longer below low limit of yy.
|
PSCRCRIT
|
value
|
Physical Scratch Volume Critical Warning Limit
This is the threshold, in number of scratch physical volumes, at which the TS7700 generates a message indicating that the number of available scratch physical volumes has fallen below the critical warning limit. The following message text is shown:
•When fallen below the threshold:
AL5006 Available physical scratch volumes of xxx below critical limit of yyy for pool zz.
•When risen above the threshold:
AL5007 Available physical scratch volumes no longer below critical limit of yyy for pool zz.
Tip: The TS7700 enters panic reclaim if the number of scratch volumes available to a defined pool is less than two, including ones that it can borrow from pool 0.
|
PSCRLOW
|
value
|
Physical Scratch Volume Low Warning Limit
This is the threshold, in number of scratch physical volumes, at which the TS7700 generates a message indicating that the number of available scratch physical volumes has fallen below the low warning limit. The following text is shown:
•When fallen below the threshold:
AL0006 Available physical scratch volumes of xxx below low limit of yyy for pool zz.
•When risen above the threshold:
AL0007 Available physical scratch volumes no longer below low limit of yyy for pool zz.
Tip: The TS7700 enters panic reclaim if the number of scratch volumes available to a defined pool is less than two, including ones that it can borrow from pool 0.
|
RESDHIGH
|
value
|
Resident Data High Warning Limit
This is the threshold, in gigabytes of resident data, at which the TS7700 generates a message indicating that the amount of resident data has exceeded a high warning limit. The following message text is shown:
•When above the threshold:
AL5008 Resident data of xxxxxxxx GB above high warning limit of yyyyyyyy GB.
•When below the threshold:
AL5009 No longer above resident data high warning limit of yyyyyyyy GB.
|
RESDTHIGH
|
value
|
This is the same threshold with RESDHIGH, but only applicable to the total TS7720 TA tape attached cache partitions (CPx). The following message test is shown:
•When above the threshold:
AL5015 Sum of resident data in tape partitions of xxxxxxxx GB above high warning limit of yyyyyyyy GB.
•When below the threshold:
AL5016 Sum of resident data in tape partitions no longer above resident data high warning limit of yyyyyyyy GB.
|
RESDLOW
|
Value
|
Resident Data Low Warning Limit
This is the threshold, in gigabytes of resident data, at which the TS7700 generates a message indicating that the amount of resident data has exceeded a low warning limit. The following message text is shown:
•When above the threshold:
AL0008 Resident data of xxxxxxxx GB above low warning limit of yyyyyyyyy GB.
•When below the threshold:
AL0009 No longer above resident data low warning limit of yyyyyyyy GB.
|
RSDTLOW
|
Value
|
This is the same threshold with RESDLOW, but only applicable to the total TS7720 TA tape attached cache partitions (CPx). The following message text is shown:
•When above the threshold:
AL0012 Sum of resident data in tape partitions of xxxxxxxx GB above low warning limit of yyyyyyyyy GB.
•When below the threshold:
AL0013 Sum of resident data in tape partition no longer above low warning limit of yyyyyyyy GB.
|
PCPYLOW
|
Value
|
Pending Copy Low
This is the threshold in gigabytes of volumes in the copy queue. The following message text is presented when the level falls below or rises above the threshold:
•AL0011 Distributed Library xx has successfully fallen below the inbound copy backlog low warning limit of zzzz GB.
•AL0010 Distributed Library xx has a total pending inbound copy backlog of yyyy GB, which is above the low warning limit of zzzz GB.
|
PCPYCRIT
|
Value
|
Pending Copy Critical
This is the upper limit in gigabytes for volumes in the copy queue. The same messages, AL0011 and AL0010, are presented (see the PCPYLOW keyword section).
|
DEFDEG
|
ENABLE
DISABLE
|
Synchronous deferred or the immediate deferred condition occurs:
•When the ENABLE keyword is specified, the degraded state is reported to the host through the operational state change attention.
•When the DISABLE keyword is specified, the degraded state is not reported to the host through the operational state change attention.
The following messages are shown:
•G0005 Distributed Library xx has entered the immediate deferred state.
•G0032 Distributed Library xx has entered the synchronous deferred state due to volser yyyyyy are generated regardless of the DEFDEG setting.
|
LINKDEG
|
ENABLE
DISABLE
|
Prevents a composite library from entering the link degraded state when Grid link degradation occurs.When the ENABLE keyword is specified, the degraded state is reported to the host through the operational state change attention. When the DISABLE keyword is specified, the degraded state is NOT reported to the host through the operational state change attention. The following operator messages are still generated regardless of the LINKDEG setting:
•G0030 Library XXXXX, PPP, AAA Grid Link are degraded.
•G0031All grid links for this cluster have left the degraded state.
|
REMOVMSG
|
ENABLE
DISABLE
|
Prevents a distributed library (TS7720) from reporting Automatic Removal start and stop events to the MI and operator messages to the host when Auto Removal occurs.
|
Keyword3
|
Keyword4
|
Description
|
COPYFSC
|
ENABLE,
DISABLE
|
Copies To Follow Storage Class Preference
When the ENABLE keyword is specified, the logical volumes that are copied into the cache from a peer TS7700 are managed by using the actions that are defined for the Storage Class (SC) construct that is associated with the volume, as defined at the TS7700 receiving the copy.
When the DISABLE keyword is specified, the logical volumes that are copied into the cache from a peer TS7700 are managed as PG0 (prefer to be removed from cache).
The default is disabled.
|
PMPRIOR
|
value
|
Premigration Priority Threshold
This is the threshold, in gigabytes of unpremigrated data, at which the TS7700 begins increasing the number of premigration tasks that are allowed to compete with host I/O for cache and processor cycles.
Tip: Do not change this setting from the default unless you understand the effect that the change will have on the operation of the TS7700. Raising the value might increase the length of time a peak write rate might be accepted, but also means that more data is solely resident in the cache and delays copying that data to physical tape.
|
PMTHLVL
|
value
|
Premigration Throttling Threshold
This is the threshold, in gigabytes of unpremigrated data, at which the TS7700 begins introducing a delay in responding to host write operations on all virtual tape device addresses of the TS7700.
Tip: Do not change this setting from the default unless you understand the effect that the change will have on the operation of the TS7700. Raising the value might increase the length of time a peak write rate might be accepted, but also means that more data is solely resident in the cache and delays copying that data to physical tape.
|
RECLPG0
|
ENABLE,
DISABLE
|
Recalls Preferred to be Removed from Cache
When the ENABLE keyword is specified, logical volumes that are recalled into cache are managed as PG0 (prefer to be removed from cache). This overrides the actions defined for the SC associated with the recalled volume.
When the DISABLE keyword is specified, logical volumes that are recalled into cache are managed by using the actions that are defined for the SC construct associated with the volume as defined at the TS7700.
The default is disabled.
|
REMOVE
|
ENABLE,
DISABLE |
Automatic removal starts when cache usage size crosses the removal threshold.
When the ENABLE keyword is specified, automatic removal is enabled on this disk-only cluster.
When the DISABLE keyword is specified, automatic removal is disabled on this disk-only cluster.
The default value is enabled.
|
REMVTHR
|
Value
|
Automatic removal starts when the cache usage size crosses the removal threshold.
When automatic removal is enabled on this disk-only cluster, logical volume removal starts when the free cache space is below the removal threshold plus 1000 GB (1000 GB is the out-of-cache warning threshold).
The default value is 3000 (in GB). A value of 2000 - 10000 can be set. As an example, a value of 2000 means that the TS7700 starts the automatic removal when there is less than 3000 GB (2000 GB + 1000 GB) of free cache space. If a value less than 2000 is given, it is set to 2000. If a value more than 10000 is given, it is set to 10000.
|
CPYPRIOR
|
ENABLE,
DISABLE |
Limit premigration resources under Grid copy activity
When the ENABLE keyword is specified, the number of premigration tasks starts decreasing when Grid copy activity crosses the threshold defined by the CPYPRITH command.
When the DISABLE keyword is specified, the number of premigration tasks do not decrease.
The default value is DISABLED.
|
CPYPRITH
|
Value
|
Premigration resources start being limited when Grid copy activity crosses the threshold
When CPYPRIOR is enabled, the number of premigration tasks starts decreasing when the total Grid copy activity (the data transfer rate to read/write the data from/into the local cluster’s cache) is above the threshold.
|
RBPRIOR
|
Value
|
Cache Rebuild Priority
|
RBTHLVL
|
Value
|
Cache Rebuild Priority Threshold
|
Keyword3
|
Keyword4
|
Description
|
COPYFT
|
ENABLE,
DISABLE
|
Full Cache Copy Throttling
When the ENABLE keyword is specified, throttling when the cache is full of uncopied data to other TS7700 tape drives is enabled.
When the DISABLE keyword is specified, throttling when the cache is full of uncopied data to other TS7700 tape drives is disabled.
The default is enabled.
Tip: Full Cache Copy Throttling is also disabled for 24 hours after one of the other TS7700 tape drives has been in service mode. This is to prevent immediate host throttling when the TS7700 being serviced is returned to use.
|
DCOPYT
|
value
|
Deferred Copy Throttle
The default value is 125 milliseconds.
|
ICOPYT
|
ENABLE,
DISABLE
|
Immediate Copy Throttling
The default is enabled.
|
DCTAVGTD
|
value
|
Deferred Copy Throttling Average Threshold
A value of 0 sets the threshold to the default. A value of 1 - 500 can be set.
|
Keyword3
|
Keyword4
|
Description
|
SCRATCH
|
ENABLE,
DISABLE
|
Device Allocation Assist for Scratch Volumes
The default is disabled.
|
PRIVATE
|
ENABLE, DISABLE
|
Device Allocation Assist for Private Volumes
The default is enabled.
|
Note: Also, if a valid RECLAIM request is received while reclaims are inhibited, that request takes effect as soon as reclaims are no longer inhibited by the Inhibit Reclaim schedule.
|
Keyword3
|
Keyword4
|
Description
|
RCLMMAX
|
value
|
Reclaim Maximum Tasks Limit
|
Keyword3
|
Keyword4
|
Description
|
RUN
|
Number of Concurrent RUN Copy Threads
|
The number of concurrent copy threads for processing RUN copies
The allowed values for copy thread counts are 5 - 128.
The default value is 20 for clusters with two 1-gigabit Ethernet (GbE) links, and 40 for clusters with four 1 Gb Ethernet links or two 10 Gb Ethernet links.
|
DEF
|
Number of Concurrent Deferred Copy Threads
|
The number of concurrent copy threads for processing Deferred copies
The allowed values for copy thread counts are 5 - 128.
The default value is 20 for clusters with two 1 Gb Ethernet links, and 40 for clusters with four 1 Gb Ethernet links or two 10 Gb Ethernet links.
|
Keyword3
|
Keyword4
|
Description
|
IMMSNS
|
All
UNEXP
NONE
|
Immediate-Deferred State Reporting Method
This is the control method to report the immediate-deferred state in the CCW (RUN) ERA35 sense data. With Release 1.6 code, TS7700 reports all the immediate-deferred state in the CCW (RUN) ERA35 sense data. Since Release 1.7, subsequent modification level 5 (8.7.0.155), or 2.0 release level the reporting method can be modified:
•If keyword4 of ALL is specified, all the immediate-deferred state is reported in the ERA35 sense data the same as Release 1.6.
•If keyword4 of UNEXP is specified, only the immediate-deferred state induced unexpectedly is reported in the ERA35 sense data.
•If keyword4 of NONE is specified, no immediate-deferred state is reported in the ERA35 sense data except the case where no valid source to copy is available.
•The default value is NONE.
For more information, see IBM Virtualization Engine TS7700 Series Best Practice Understanding, Monitoring, and Tuning the TS7700 Performance, WP101465, found at:
|
SCRATCH
|
ALWAYS/
NEVER/
NONTLDY
|
Control the replication of logical volumes in the scratch category:
•If a keyword4 of ALWAYS is specified, all logical volumes regardless of the category are replicated in the grid the same as the previous code level.
•If a keyword 4 of NEVER is specified, no logical volumes in the scratch category are replicated in the grid.
•If a keyword 4 of NONTDLY is specified, only the logical volumes in the scratch category with Time Delayed copy policy aren’t replicated in the grid. The logical volumes with other copy modes are still replicated.
The request is supported only when all the clusters in the grid have the code level of 8.32.X.X or later. The default value is ALWAYS.
|
TIMEOUT
|
value
|
Volume Copy Timeout Time
This is the timeout value in minutes for logical volume copies between clusters to complete. The allowed values for copy timeout are 30 - 999 minutes.
|
Keyword 3
|
Keyword4
|
Description
|
FAILOVER
|
ENABLE
DISABLE
|
IP Link Failover for Remount Mounts
If keyword4 of ENABLE is specified, a cluster at code level 8.21.x.x or greater uses the failover capability in a link failure during a remote mount.
Keyword4 of DISABLE removes the failover capability.
The default behavior is ENABLE.
|
Keyword3
|
Keyword4
|
Description
|
COUNT
|
Value
|
Delete Expire Count
The Delete Expire Count can be set to any value from the default value of 1000 to the maximum value of 2000.
|
Keyword3
|
Keyword4
|
Description
|
CRITERIA
|
STALE/
ALWAYS/
NONE
|
Delete E (Exist) copy mode volume at mount/demount.
•STALE: Delete only a E copy mode volume when it is inconsistent.
•ALWAYS: Always delete E copy mode volume if all other non-E copy mode sites are consistent.
•NONE: Never delete consistent or inconsistent E copymode volumes.
The request is supported only when all clusters in the domain have the code level of 8.31.x.x or later. The default is STALE.
|
WHEN
|
ATCLOSE/
AUTO
|
This is the setting to determine when E copy mode volumes that satisfy the condition set by the “CRITERIA” keyword can be deleted. E copy mode volume is deleted at the timing based on the following settings:
•ATCLOSE: E copy volume is deleted at the volume mount/demount. It is the same behavior with the previous release 8.31.
•AUTO: In addition to the volume mount/demount timing, TS7700 periodically checks E copy mode volume, then deletes it if it satisfies the condition set by CRITERIA. The check runs once per 24 hours and it deletes up to 100 E copy mode volumes all
at once. The request is supported only when all clusters in the domain have the code level of 8.32.x.x or later. The default is “ATCLOSE”.
|
Clarification: The distributed library number or cluster index number for a given logical drive can be determined with the DS QT command. As identified in Figure 9-2, the response shows LIBPORT-ID 01 for logical drive 9600. LIBPORT-ID 01 is associated with Cluster 0. The association between distributed libraries and LIBPORT-IDs is discussed in 5.4.1, “Defining devices through HCD” on page 190.
|
Tip: You can get the real device type from the Host Console Request function
LI REQ,<distributed library name>,PDRIVE in the distributed library. |
Note: The asterisks in the QLIB displays indicate libraries that are attached to the host.
|
Tip: Logical volumes that are in the error category (000E) can be moved back to the scratch category by using ISMF ALTER to move them from Scratch to Scratch category.
|
Clarification: In a DFSMS system-managed tape environment, if you try to eject a logical volume and get this error, OAM notifies the tape management system. This is done through the OAM eject exit CBRUXEJC command before the eject request is sent to the tape library. The Integrated Library Manager eventually fails the eject, but the tape management system has already marked the volume as ejected.
|
More information: For the current information about ALxxxx messages and all other messages that are related to CBR3750I, see the IBM Virtualization Engine TS7700 Series Operator Informational Messages white paper, which is available on the following website:
|