Script function GET_FILESYSTEM with “File System Value” PATH_SPACE_USED always returns 0 Bytes on z/OS files

Document ID : KB000087959
Last Modified Date : 14/04/2018
Show Technical Document Details
Issue:
Error Message :
N/A

A GET_FILESYSTEM script function with “File System Value” PATH_SPACE_USED always returns 0 Bytes when used on z/OS files.

Example: 

On version 10, UC.MSL file shows 1679702 Byte used.
On version 11.2, it shows 0 Bytes used.

This is shown with the following script.  Tthe dataset name for he “UC.MSL” needs to be adjusted to the environment:
 
:s &ret# = GET_FILESYSTEM(ITA#S901, "UC4SCJ.UC410.UC.MSL", PATH_SPACE_USED, BYTES):s &errnr# = SYS_LAST_ERR_NR():if ISNUMERIC(&ret#)eq "Y":  set &ret# = FORMAT(&ret#):endif:print "UC4SCJ.UC4112.MSL: &ret# Byte":if &errnr# NE "0":  s &ERRINS# = SYS_LAST_ERR_INS():  s &MESSAGE# = GET_MSG_TXT(&ERRNR#, &ERRINS#):  print "&ERRNR#,&ERRINS#,&MESSAGE#":endif
 
The reports prints the following line:
U0020408 UC4SCJ.UC4112.MSL: 0 Byte
It should be:
U0020408 UC4SCJ.UC4112.MSL: 1679702 Byte

 
Environment:
OS: MVS
Cause:
Cause type:
Defect
Root Cause: z/OS Agent calculates data set size incorrectly. The result is always zero.
Resolution:
Update to a fix version listed below or a newer version if available.

Fix Status: Released

Fix Version(s):
Component(s): Agent MVS

Automation Engine 12.0.1 - Available
Automation Engine 11.2.4 - Available
Automation Engine 11.1.6 - Available
Additional Information:
Workaround :
The allocated / used space can be determined using an operating system function. A v10 Agent can be used as well, the function works correctly in that version.