Skip to Content

Default language.

Information
Limited support BMC provides limited support for this version of the product. As a result, BMC no longer accepts comments in this space. If you encounter problems with the product version or the space, contact BMC Support.BMC recommends upgrading to the latest version of the product. To see documentation for that version, see BMC AMI Unload for Db2 13.1.

_lspace() function

The _lspace() function returns the space information for a volume. Use this function to precede an IDCAMS DEFINE operation in the XSUTALLO automation control point.

Syntax

x = _lspace(<volser>)

The volser parameter contains a series of numbered strings that represent available volumes for which you want space information.

Values returned

The _lspace() function returns either the value ERROR (indicating that the volume you selected is offline or otherwise unavailable), or a string of numbers that indicate the following values:

  • Total number of available cylinders
  • Total number of available tracks in addition to the number of available cylinders
  • Total number of contiguous cylinders
  • Total number of contiguous tracks in addition to the number of contiguous cylinders

 

Information
Examples

 The following example shows statements for an _lspace() function for volume VZ9923:

vinfo = _lspace('VZ9923')
say vinfo

The following results indicate that volume VZ9923 has 127 available cylinders, with 14 additional tracks, and 80 contiguous cylinders, with 9 additional tracks:

127  14   80   9

The following example shows statements for an _lspace() function for volume GW8871:

vinfo = _lspace('GW8871')
say vinfo

Because this volume is offline, the following output might result from the _lspace() function:

ERROR


Related topic

General-built-in-functions 


 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

BMC AMI Unload for Db2 12.1