Updated server commands, utilities, and options

Be aware of the commands, utilities, and options that are updated in V6 and later.

Updated commands
Updated utilities
Updated server options

Updated commands

Table 1. Updated commands
Command	Changes
BACKUP DB	You must run the SET DBRECOVERY command before the BACKUP DB command. By running the SET DBRECOVERY command, you set the device class for the database backup. An incremental database backup is a backup of all changes since the last full backup. In earlier versions of the server, an incremental backup was a backup of all changes since either the last full backup or the last incremental backup. New parameters are available: The COMPRESS parameter specifies whether volumes that are created during backup processing are compressed. The DEDUPDEVICE parameter specifies that a target storage device can be used for data deduplication. The NUMSTREAMS parameter specifies the number of parallel data movement streams that are used for database backup.
BACKUP NODE QUERY NASBACKUP RESTORE NODE	The commands include the SNAPMIRROR value for the TYPE parameter: When you specify the SNAPMIRROR value for the BACKUP NODE command, the file system is copied to a storage pool by using the NetApp SnapMirror to Tape feature. When you specify the SNAPMIRROR value for the QUERY NASBACKUP command, the output shows information about NetApp SnapMirror images. When you specify the SNAPMIRROR value for the RESTORE NODE command, the file system is retrieved from a NetApp SnapMirror image.
BACKUP STGPOOL DEFINE STGPOOL QUERY STGPOOL UPDATE STGPOOL	The commands can be used with data deduplication functions.
BACKUP VOLHISTORY DELETE VOLHISTORY QUERY VOLHISTORY UPDATE VOLHISTORY	Database memory dump operations are no longer available. Therefore, database memory dump volumes are not displayed in volume history. If you are migrating a V5 server that is running on a z/OS® operating system to a V7.1.1 server on an AIX® or Linux operating system, you can issue the DELETE VOLHISTORY command on the V5 server to prepare for the migration. The command specifies the device class of volumes to be deleted.
DEFINE DEVCLASS UPDATE DEVCLASS	When you run the DEFINE DEVCLASS command or the UPDATE DEVCLASS command to specify a 3592 or LTO device class, you can use the LBPROTECT parameter. The LBPROTECT parameter specifies whether logical block protection is used to ensure data integrity on tape. A limited set of device class types is available for devices that are accessed through a z/OS media server.
DEFINE LIBRARY	You can use the DEFINE LIBRARY command to define a ZOSMEDIA library type. In this way, you can define a library that represents a tape or FILE storage resource that is maintained by Tivoli Storage Manager for z/OS Media.
DEFINE LIBRARY UPDATE LIBRARY	You can use the DEFINE LIBRARY command to define a virtual tape library (VTL) to the Tivoli Storage Manager server. You can use the UPDATE LIBRARY command to update a VTL definition.
DEFINE PATH	You can use the DEFINE PATH command to define a path to a ZOSMEDIA library.
DEFINE SERVER	You can use the DEFINE SERVER command to define a server for the following functions: LAN-free data movement, node replication, and data movement by using z/OS media server.
DEFINE SPACETRIGGER DELETE SPACETRIGGER QUERY SPACETRIGGER UPDATE SPACETRIGGER	The commands can be used only for storage pools. Space triggers are no longer available for databases and logs.
DEFINE VOLUME	The maximum capacity of a volume in a DISK storage pool is 8 TB.
DISABLE SESSIONS ENABLE SESSIONS	The DIRECTION parameter specifies whether to disable or enable inbound sessions, outbound sessions, or both.
EXPIRE INVENTORY	Expiration processing can be run for specific nodes and node groups, or for all nodes in a policy domain. The types of data to be examined for expiration can be specified. The values for the DURATION parameter are changed. You can specify a value in the range 1 - 999999 to define the maximum number of minutes for the expiration process.
GRANT AUTHORITY REVOKE AUTHORITY	The ANALYST privilege class is removed.
HALT	The QUIESCE parameter is removed.
LOCK ADMIN	The AUTHENTICATION parameter specifies the method of authentication that the administrator uses to log on.
LOCK NODE	The AUTHENTICATION parameter specifies the method of password authentication that is required to log on to a node.
MOVE DRMEDIA PREPARE QUERY DRMEDIA QUERY DRMSTATUS	Changes to disaster recovery manager commands make it possible to include active-data pools in recovery plans and procedures. The MOVE DRMEDIA command cannot be used concurrently with the BACKUP STGPOOL command. Ensure that the primary storage pool backup process is complete before you back up the database. Ensure that the BACKUP STGPOOL command and the BACKUP DB command are complete before you issue the MOVE DRMEDIA command.
QUERY DB	The output shows the total number of free pages in all table spaces.
QUERY DEVCLASS QUERY LIBRARY QUERY PATH	You can use this command to view information that is specific to the z/OS media server.
QUERY FILESPACE	You can use this command to view replication information.
QUERY LOG	You can use this command to view information about the active log directory, mirror log directory, archive failover log directory, and archive log directory.
QUERY NODE	You can use this command to view information about the password authentication method and security settings for the administrator ID. You can use this command to determine whether the recovery of damaged files from a target replication server is enabled for this node.
QUERY OPTION	Obsolete options are removed from the output. The output is updated to include information about settings for LDAP directory servers.
QUERY PROCESS	You can use this command to obtain information about duplicate identification processes. You can also view information about the process of recovering damaged files from a replication server.
QUERY SERVER	You can use this command to find out whether Secure Sockets Layer (SSL) communication is used.
QUERY SESSION	You can use this command to display the actions that occurred during the session.
QUERY STATUS	Obsolete options and the database backup trigger are removed. You can use this command to verify whether passwords are authenticated with the Tivoli Storage Manager server or with the LDAP directory server. You can view the name of the default target replication server, and determine whether node replication is enabled to recover damaged files from that server. You can determine the number of days for which scratch pad entries are retained since they were last updated. If you have an IBM Tivoli Storage Manager Suite for Unified Recovery license, you can obtain information about the Tivoli Storage Manager products that are included in the Tivoli Storage Manager Suite for Unified Recovery bundle. You can determine the amount of space that is used to store data for the bundle, and the date and time when the data was last collected.
QUERY VOLHISTORY	For the TYPE parameter, the values RPFile and RPFSnapshot are added. By using the values, you can display records that contain information about recovery plan file objects.
QUERY VOLUME	You can use this command to verify whether logical block protection is enabled.
REGISTER ADMIN	New parameters are available: The ALERT parameter specifies whether alerts are sent to an administrator email address. The AUTHENTICATION parameter specifies the authentication method for the administrator user ID. The SSLREQUIRED parameter specifies whether the administrator user ID must use SSL to communicate with the backup-archive client from the Tivoli Storage Manager server.
REGISTER ADMIN QUERY ADMIN UPDATE ADMIN	In these commands, the ALERT parameter specifies whether alerts are sent to an administrator email address. In the QUERY ADMIN command, the output is updated to include information about email alerts, the password authentication method, and security settings for the administrator ID.
REGISTER LICENSE	You are required to use this command to register licenses for server components. Use of the REGISTER LICENSE command implies that you agree to and accept the license terms that are specified in the license agreement.
REGISTER NODE	New parameters are available: The AUTHENTICATION parameter specifies the password authentication method for the node. The AUTOFSRENAME parameter specifies whether file spaces are automatically renamed when you upgrade the client system to use Unicode characters. The BACKUPINITIATION parameter specifies whether the non-root user ID on the client node can back up files to the server. The BKREPLRULEDEFAULT, ARREPLRULEDEFAULT, and SPREPLRULEDEFAULT parameters specify the replication rule that applies to a data type if the file space rules for the data type are set to `DEFAULT`. The DEDUPLICATION parameter specifies whether data can be deduplicated only on the server, or on both the client and server. The EMAILADDRESS parameter specifies contact information. The RECOVERDAMAGED parameter specifies whether damaged files can be recovered for this node from a target replication server. The REPLSTATE parameter specifies whether data that belongs to the client node is ready to be replicated. The ROLEOVERRIDE parameter specifies whether to override the reported role of the client for PVU estimation. The SPLITLARGEOBJECTS parameter specifies whether large objects that are stored by this node are split up into smaller segments to optimize server processing. The SSLREQUIRED parameter specifies whether the node must use SSL to communicate with the Tivoli Storage Manager server. The URL parameter specifies the URL of the Tivoli Storage Manager web client that is configured on the client system. The UTILITYURL parameter specifies the address for Tivoli Storage Manager client management services.
REMOVE ADMIN	You can use the SYNCLDAPDELETE parameter to remove an administrative user ID that is stored on an LDAP directory server.
REMOVE NODE	You can use the SYNCLDAPDELETE parameter to remove a node ID that is stored on an LDAP directory server.
RENAME ADMIN	You can use the SYNCLDAPDELETE parameter to rename an administrative user ID that authenticates to an LDAP directory server.
RENAME NODE	You can use the SYNCLDAPDELETE parameter to rename a node ID that is stored on an LDAP directory server.
REPLICATE NODE	You can use the PREVIEW parameter to obtain information about data that can be recovered from a target replication server.
SELECT	The following updates apply to the SELECT command: In previous versions of the server, syntax that did not conform to SQL syntax rules could be used in the SELECT command. In V6.3 and later, you must use SQL syntax that conforms to the syntax rules of the database manager, DB2®. You can use the `SELECT * FROM PVUESTIMATE_DETAILS` query to generate a PVU report that provides detailed information at the node level. You can use the SELECT command to list user ID passwords for administrators and nodes that authenticate with an LDAP directory server. You can use the SELECT command to verify whether logical block protection is enabled for a device class or volume.
SET DBRECOVERY	The COMPRESS parameter specifies whether volumes that are created during backup processing are compressed. The NUMSTREAMS parameter specifies the number of concurrent data movement streams to use while you back up the database.
SETOPT	Obsolete options are removed. The LDAPCACHEDURATION option determines the length of time that the Tivoli Storage Manager server caches information about LDAP password authentication.
UNLOCK ADMIN	The AUTHENTICATION parameter specifies the method of password authentication that is required for an administrator to log on.
UNLOCK NODE	The AUTHENTICATION parameter specifies the method for node password authentication.
UPDATE ADMIN	The ANALYST privilege class is removed. New parameters are available: The AUTHENTICATION parameter specifies the password authentication method that is used for the administrator ID. The SSLREQUIRED parameter specifies whether the administrator user ID must use SSL to communicate with the backup-archive client from the Tivoli Storage Manager server. The SYNCLDAPDELETE parameter is used to remove an administrator user ID from an LDAP directory server.
UPDATE LIBRARY	You can use this command to update a library definition for a VTL.
UPDATE NODE	The ANALYST privilege class is removed. New parameters are available: The AUTHENTICATION parameter specifies the password authentication method. The BACKUPINITIATION parameter specifies whether the non-root user ID on the client node can back up files to the server. The RECOVERDAMAGED parameter specifies whether damaged files for this node can be recovered from a target replication server. The ROLEOVERRIDE parameter specifies whether to override the reported role of the client for PVU estimation. The SSLREQUIRED parameter specifies whether a node must use SSL to communicate with the Tivoli Storage Manager server. The SYNCLDAPDELETE parameter is used to change the authentication method for a node from authentication with the LDAP directory server to authentication with the Tivoli Storage Manager server. The URL parameter specifies the URL of the Tivoli Storage Manager web client that is configured on the client system. The UTILITYURL parameter specifies the address for Tivoli Storage Manager client management services.
UPDATE PATH	You can use this command to update a path to a ZOSMEDIA library.
UPDATE SERVER	You can use this command to specify whether to use SSL during server-to-server communications.

Updated utilities

Table 2. Updated utilities
Utility	Changes
DSMSERV	You can specify the owning user ID for the server instance on startup. You can also specify the user ID for other DSMSERV utilities.
DSMSERV FORMAT	Obsolete parameters are removed. New parameters are available to specify the directories for database space, and the maximum size and locations of the recovery log.
DSMSERV INSERTDB	The CONFIGINFO parameter specifies the device configuration information that is used by the DSMSERV INSERTDB utility to load a database.
DSMSERV RESTORE DB	Volume history is required for restoring a database. All restore operations use rollforward recovery. The function for restoring individual database volumes is removed. The server no longer manages database volumes.
DSMUPGRD EXTRACTDB DSMUPGRD PREPAREDB	The MEDIASERVER parameter is used during an upgrade from a V5 server on z/OS. The parameter specifies the name of the server to be used as the z/OS media server.

Updated server options

Table 3. Updated server options
Option	Changes
CHECKTAPEPOS	You can use the CHECKTAPEPOS option to enable append-only mode for IBM LTO Generation 5 and later drives, and for any drives that support this feature.
SANDISCOVERY	The SANDISCOVERY option changed in Tivoli Storage Manager V5.5.3 and later releases. To ensure that the system operates correctly, verify the setting for the SANDISCOVERY option.
TXNGROUPMAX	The default value is increased from 256 to 4096. Verify whether the server options file has this option: If the server options file does not include this option, the server automatically uses the new default value. If the server options file includes a value for the option, the server uses the specified value. If the specified value is less than 4096, consider increasing this value, or removing the option so that the server uses the new default value. By increasing the value or using the new default value, you can improve the performance for data movement operations such as storage pool migration and storage pool backup. Increasing the value for the TXNGROUPMAX option has no effect on data-movement performance for files that were stored on the server by using a smaller value for the option.