FILEDDWORD

Edit online

FILEDDWORD returns a character string that is the value of the attribute c for the file x.

Read syntax diagramSkip visual syntax diagramFILEDDWORD( x,c)
x
File reference.
c
Character string that holds the attribute to be queried.

When using FILEDDWORD, the following options are valid for c:

ACCESS
AMTHD
ACTION
CHARSET
DSORG
FILENAME
ORGANIZATION
PUTPAGE
RECFM
SHARE
TYPE
TYPEF
These options return the following values:
  • ACCESS returns SEQUENTIAL or DIRECT.
  • ACTION returns INPUT, OUTPUT, or UPDATE.
  • AMTHD returns VSAM KSDS, VSAM ESDS or VSAM RRDS on the z/OS platform and FILESYS, DDM, BTRIEVE or ISAM on the Windows or AIX platforms.
  • CHARSET returns ASCII or EBCDIC.
  • DSORG returns the data set organization of the file reference. This option is only valid on the z/OS platform. Currently the following data set organizations are available:
    • PS (Physical sequential data set)
    • PSU (Physical sequential data set that contains location-dependent information)
    • DA (Direct access data set)
    • DAU (Direct access data set that contains location-dependent information)
    • PO (Partitioned data set (PDS or PDSE))
    • POU (Partitioned data set (PDS) that contains location-dependent information)
    • GS (Graphic data control block)
    • zFS (UNIX system file)
    • VSAM (Virtual Storage Access Method data set)
    If the file organization is not supported, the FILEDDWORD for DSORG will return a blank value.
  • On the z/OS platform, FILENAME returns the fully qualified path name for zFS files and the MVS data set name for all other files except it returns the value 'NULLFILE' for files specified with either DSN=NULLFILE and DD DUMMY. For a MVS data set that is a member of a PDS or PDSE, the name returned includes the member name. On the Windows and AIX platforms, it returns the fully qualified path name of the file .
  • ORGANIZATION returns CONSECUTIVE, RELATIVE, REGIONAL(1) or INDEXED.
  • RECFM returns the appropriate record format setting for the file, and U for VSAM files. This option is only valid on z/OS.
  • SHARE returns NONE, READ or ALL.
  • TYPE returns RECORD or STREAM.
  • TYPEF returns the type of the native file.

The ERROR condition with oncode 1010 is raised when the file is not open or the attribute is invalid for the file being queried.