Restriction: DFSMS and MVS commands apply only to SMS-defined libraries. The library name 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 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, 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 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 Virtualization Engines in the grid configuration.	N/A	Y	ALL
COPYRFSH	volser	See the User’s Guide	See the User’s Guide	Refresh 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)	Add/remove a cluster to/from the disaster recovery (DR) family.	Y	N/A	ALL
		WP	ENABLE/ DISABLE	Enable/disable write protect mode within the DR family.	Y	N/A	ALL
		FLASH	ENABLE/ DISABLE	Enable/disable Flash Copy within the DR family.	Y	N/A	ALL
		DOALL	ENABLE/ DISABLE	Enable/disable write protect mode and Flash Copy with a single command.	Y	N/A	ALL
		LIVECOPY	FAMILY/ NONE	Enable or disallow use of a live copy within the DR family.	Y	N/A	ALL
	SHOW	CCCCCCCC (DR family name)		View information about the DR family.	Y	N/A	ALL
PARTRFSH				Change 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 (GBs) of data in cache, that needs to be copied to other TS7700 Virtualization Engines in a grid configuration, at which point the TS7700 Virtualization Engine 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 GBs of data, in cache that needs to be copied to other TS7700 Virtualization Engines in a grid configuration, at which the TS7700 Virtualization Engine 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 Virtualization Engine 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 Virtualization Engine 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 Virtualization Engine 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 Virtualization Engine 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 Virtualization Engine generates a message indicating that the number of available scratch physical volumes has fallen below the low warning limit. The message 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 Virtualization Engine 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 Virtualization Engine 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 Virtualization Engine 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 GBs 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 GB 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 copied into the cache from a peer TS7700 Virtualization Engine are managed using the actions defined for the Storage Class construct associated with the volume as defined at the TS7700 Virtualization Engine receiving the copy. When the DISABLE keyword is specified, the logical volumes copied into the cache from a peer TS7700 Virtualization Engine 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 Virtualization Engine 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 Virtualization Engine. 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 Virtualization Engine begins introducing a delay in responding to host write operations on all virtual tape device addresses of the TS7700 Virtualization Engine.   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 Virtualization Engine. 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 Storage Class associated with the recalled volume. When the DISABLE keyword is specified, logical volumes that are recalled into cache are managed using the actions defined for the Storage Class construct associated with the volume as defined at the TS7700 Virtualization Engine. 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 Virtualization Engines is enabled. When the DISABLE keyword is specified, throttling when the cache is full of uncopied data to other TS7700 Virtualization Engines is disabled. The default is enabled.   Tip: Full Cache Copy Throttling is also disabled for 24 hours after one of the other TS7700 Virtualization Engines has been in service mode. This is to prevent immediate host throttling when the TS7700 Virtualization Engine 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. See IBM Virtualization Engine TS7700 Series Best Practice Understanding, Monitoring, and Tuning the TS7700 Performance, WP101465, for more information: http://www.ibm.com/support/techdocs
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: Only delete 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 187.

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 latest information about ALxxxx messages and all other messages related to CBR3750I, see the IBM Virtualization Engine TS7700 Series Operator Informational Messages white paper, which is available on the following website: http://www-03.ibm.com/support/techdocs/atsmastr.nsf/WebIndex/WP101689