Skip to Content

_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>)

Related topic

General-built-in-functions 

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


 

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

BMC AMI Stats for Db2 13.1