_file - UDM Built-in Variable


The _file built-in variable contains the name of the file for the current iteration in a forfiles loop. _file also has special attributes, as shown in the following table.

For information on using _file and its special attributes, see _file Variable Attributes.

Note

_file cannot be set using the set command.


Attribute Name

Description

accessdate

Date on which the file was last accessed.
 
Format (ISO 8601) is yyyy-mm-dd.

accesstime

Time when the file was last accessed.
 
The default format (ISO 860) is hh:mm:ss. If the msecs parameter is added to the forfiles statement, the format is hh:mm:ss.nnn, where .nnn is a millisecond value. If the file system does not capture the millisecond portion of a file time, .000 is used.

accesstimestamp

Combination of accessdate and accesstime: yyyy-mm-dd hh:mm:ss[.nnn].
 
If the file does not have an access time, but does have a access date, 00:00:00 is used for the time portion. The millisecond portion (.nnn) of the timestamp value is displayed only for supported platforms when msecs=yes is added to the forfiles statement.

createdate

Date on which the file was created.
 
Format (ISO 8601) format of yyyy-mm-dd.
 

Note

Creation dates and times are guaranteed to be reliable only on Windows. The value returned for this attribute on UNIX systems reflects the file's most recent status change on the file system. Such changes include - but are not limited to - ownership changes, permissions changes, and content changes. This means that the value returned in this attribute will be the actual create date/time only if the file and its properties have not changed since it was created. (For more information on the times recorded for files, refer to documentation for the UNIX stat command.)

createtime

Time when the file was created.
 
The default format (ISO 860) is hh:mm:ss. If the msecs parameter is added to the forfiles statement, the format is hh:mm:ss.nnn, where .nnn is a millisecond value. If the file system does not capture the millisecond portion of a file time, .000 is used.
 

Note

Creation dates and times are guaranteed to be reliable only on Windows. The value returned for this attribute on UNIX systems reflects the file's most recent status change on the file system. Such changes include - but are not limited to - ownership changes, permissions changes, and content changes. This means that the value returned in this attribute will be the actual create date/time only if the file and its properties have not changed since it was created. (For more information on the times recorded for files, refer to documentation for the UNIX stat command.)

createtimestamp

Combination of createdate and createtime: yyyy-mm-dd hh:mm:ss[.nnn].
 
If the file does not have a creation time, but does have a creation date, 00:00:00 is used for the time portion. The millisecond portion (.nnn) of the timestamp value is displayed only for supported platforms when msecs=yes is added to the forfiles statement.
 

Note

Creation dates and times are guaranteed to be reliable only on Windows. The value returned for this attribute on UNIX systems reflects the file's most recent status change on the file system. Such changes include - but are not limited to - ownership changes, permissions changes, and content changes. This means that the value returned in this attribute will be the actual create date/time only if the file and its properties have not changed since it was created. (For more information on the times recorded for files, refer to documentation for the UNIX stat command.)

moddate

Date on which the file was last modified (referenced for z/OS).
 
Format (ISO 8601) is yyyy-mm-dd.

modtime

Time when the file was last modified (referenced for z/OS).
 
The default format (ISO 860) is hh:mm:ss. If the msecs parameter is added to the forfiles statement, the format is hh:mm:ss.nnn, where .nnn is a millisecond value. If the file system does not capture the millisecond portion of a file time, .000 is used.

modtimestamp

Combination of moddate and modtime: yyyy-mm-dd hh:mm:ss[.nnn].
 
If the file does not have a modification time, but does have a modification date, 00:00:00 is used for the time portion. The millisecond portion (.nnn) of the timestamp value is displayed only for supported platforms when msecs=yes is added to the forfiles statement.

name

Name of the file (same as referencing _file itself without any attributes).

size

Size of the file (in bytes).

type

Type of file. Values are:

  • file
  • directory (also used for PDSs under z/OS)
  • unknown

type has meaning in a forfiles statement under IBM i in the LIB file system:

  • If the value of _file.type is directory, the file type is a Physical file.
  • If the value of _file.type is file, the file type is a Save file.