Rational Developer for System z
Enterprise PL/I for z/OS, Version 3.8, Language Reference Manual

SIZE

Example

SIZE returns a FIXED BINARY value giving the implementation-defined storage, in bytes, allocated to a variable x.

Read syntax diagramSkip visual syntax diagram>>-SIZE(x)-----------------------------------------------------><
 
x
A variable of any data type, data organization, alignment, and storage class, except as listed below.

x cannot be:

The value returned by SIZE(x) is the maximum number of bytes that could be transmitted in the following circumstances:

  declare F file record input
          environment(scalarvarying);
  read file(F) into(x);

If x is:

The SIZE built-in function must not be used on a BASED variable with adjustable extents if that variable has not been allocated.

Under the CMPAT(V3) compiler option, SIZE returns a FIXED BIN(63) value. Under all other CMPAT options, it returns a FIXED BIN(31) value.

To get the number of bytes currently required by a variable, as opposed to the number of bytes allocated to it, use the CURRENTSIZE built-in function. See CURRENTSIZE for more details.


Terms of use | Feedback

This information center is powered by Eclipse technology. (http://www.eclipse.org)