Updating space statistics for volumes in the SMS configuration

SMS maintains space statistics for each SMS-managed DASD volume in the IGDVLD control block in the active configuration data set (ACDS). SMS also provides a VARY SMS,…,SPACE command to update the space values for volumes in a pool storage group or a specific SMS-managed DASD volume. With this VARY command, you no longer need to allocate a small data set or use other approaches to ensure that the IGDVLD volume entry contains accurate space statistics.

The syntax of the VARY SMS,…,SPACE command is:

V SMS,{{STORGRP|SG}(storgrp)},{SPACE|S}
      {{VOLUME|VOL}(volser) }

STORGRP(storgrp) or SG(storgrp): Identifies the name of a pool storage group.
VOLUME(volser) or VOL(volser): Identifies the volume serial number of a SMS-managed DASD volume.
SPACE or S: Requests SMS to update the active configuration with the most current space statistics for the online volumes in the specified pool storage group or the specified SMS-managed online DASD volume.

Note: Since a storage group may contain thousands of volumes and for the performance reason, SMS will not immediately obtain the most current space statistics and update the IGDVLD volume entry when this vary space command is entered. Instead SMS will update the IGDVLD volume entry and return the most current space statistics of the online volume(s) back to the caller when these affected volumes are requested in the subsequent construct services call.

A new variant of IGD010I will be issued as shown in the following examples if the command is valid and successfully processed:

Example 1:

V SMS,SG(S1P03),SPACE
IGD010I STORAGE GROUP (S1P03) VARY SPACE COMMAND PROCESSED

Example 2:

V SMS,VOL(1P0301),S
IGD010I VOLUME (1P0301) VARY SPACE COMMAND PROCESSED

A new variant of IGD005I will be issued as shown in the following examples if the command is rejected because the specified storage group is not a pool storage group or the specified volume is not in a pool storage group.

Example 1:

V SMS,SG(ATLSG1),S
IGD005I COMMAND REJECTED
STORAGE GROUP ATLSG1 IS NOT A POOL STORAGE GROUP

Example 2:

V SMS,VOL(TAPE01),SPACE
IGD005I COMMAND REJECTED
VOLUME TAPE01 IS NOT IN A POOL STORAGE GROUP