The CODEFILEINFO request produces a report about various requested attributes of a code file or group of code files. The output is sent to the printer by default. The CODEFILEINFO request performs many of the same functions as the ATTRIBUTES request.

<codefileinfo request>

── CODEFILE ─┬─────────────────────────────┬───────────────────────────►
             └─<relation>──<release level>─┘
►─┬───────────────────────────────────────────────────────────┬────────┤
  └─ : ─┬─────────────────────────────────────────────────────┤
        │ ┌◄────────────────────────────────────────────────┐ │
        └─┴─┬─ ABBREVIATED ───────────────────────────────┬─┴─┘
            ├─ ALL ───────────────────────────────────────┤
            ├─ ARCHIVE ───────────────────────────────────┤
            ├─ ARCHIVEBACKUP ── = ─┬─ ANY ────────────────┤
            │                      ├─ CURRENT ────────────┤
            │                      ├─ NONCURRENT ─────────┤
            │                      └─ NONE ───────────────┤
            ├─ BACKUPSN ── = ──<tape serial number>───────┤
            ├─ CATALOGUE ─────────────────────────────────┤
            ├─ CONTAINER ─┬─ =<file title> ─┬─────────────┤
            ├─ DIRECTORY ─┤                 ├─ (CD) ──────┤
            ├─ TITLE ─────┘                 └─ (CDROM) ───┤
            ├─ DATABASE ── = ──<file title>───────────────┤
            ├─ FAMILYNAME ─┬─ =<family name> ─┬───────────┤
            ├─ PACKNAME ───┘                  ├─ (CD) ────┤
            │                                 └─ (CDROM) ─┤
            ├─<file attributes>───────────────────────────┤
            ├─ INUSE ─────────────────────────────────────┤
            ├─ LEVEL ─────────────────────────────────────┤
            ├─ NAMESONLY ─────────────────────────────────┤
            ├─ NEWDATABASE ── = <file title> ─────────────┤
            ├─<output option>─────────────────────────────┤
            ├─ PPB ───────────────────────────────────────┤
            ├─ RAWHEADERS ────────────────────────────────┤
            ├─ REMOVED ───────────────────────────────────┤
            ├─ TAPE ── = ─┬─<unit number>─────────────────┤
            │             └─<tape name>─┬─────────────────┤
            │                           ├─ (CD) ──────────┤
            │                           └─ (CDROM) ───────┤
            ├─ TAPEHEADERS ───────────────────────────────┤
            └─ WRAPPEDFILES ──────────────────────────────┘

Explanation

<relation> <release level>

Reports on each code file whose version number bears the indicated relationship to the given release level.

If the <relation> and <release level> modifiers are not specified, they default to LEQ and the release level of the active MCP.

The release level must have an SSR format of XX.Y.

<output option>

For more information about <output option> refer to “Output Options” earlier in this section.

FILEDATA Modifiers

The following FILEDATA modifiers perform functions such as selecting the disk family or file names to be reported on, and specifying the types of information to be reported for each file. These modifiers are explained under “FILEDATA Modifiers” later in this section.

<file attributes>

FILEDATA reports information only for the file attributes you request. Refer to <file attributes> under “ATTRIBUTES Request” earlier in this section for a list of available attributes and their abbreviated names. The file attributes are explained in “FILEDATA Modifiers” later in this section.

CODEFILEINFO Examples

The following command initiates a CODEFILEINFO report on all code files under the directory MYFILES whose version numbers are SSR 60.0 or earlier. The report includes the timestamp, number of the last record, and the version number of each file. The output is sent to the printer by default.

RUN *SYSTEM/FILEDATA ("CODEFILEINFO LEQ 60.0: DIR = MYFILES
TIMESTAMP LASTRECORD VERSION");

The following command initiates a CODEFILEINFO report on all code files under the directory USER whose version number is SSR 60.0 or earlier. The report includes the code version with code file privileges and executable status and security (such as SECURITYTYPE, SECURITYUSE, or guard file title if applicable) of each file. Refer to the description of CODEVERSION and SECURITY modifiers under “FILEDATA Modifiers” in this section for more details.

RUN *SYSTEM/FILEDATA("CODEFILEINFO LEQ 60.0: DIR = (USER)
CODEVERSION SECURITY")

The following output is sent to the printer by default:

(USER)
. TEST
.. OBJECT
... AL
.... HELLO: CODEVERSION=60.0 
        SECURITY=OWNER USER:RWX, GROUP <none>:RWX, OTHER:RWX
         USEGUARDFILE GUARDED BY *TEST/GUARD ON DISK
... TADS
.... TEST: CODEVERSION=60.0 TADS-CAPABLE 
        SECURITY=OWNER USER:RWX, GROUP <none>:NO, OTHER:NO
                   PRIVATE  (I/O)
... TEST
.... UNSAFE: CODEVERSION=60.0 NON-EXECUTABLE:UNSAFE
        SECURITY=OWNER USER:RWX, GROUP <none>:NO, OTHER:NO
                     PRIVATE  (I/O)
. SYSTEM
.. OBJECT
... POINTER: CODEVERSION=60.0 COMPILER
         VERSION: 60.011.0024
         SECURITY=OWNER USER:RWX, GROUP <none>:RWX, OTHER:RWX
          USEGUARDFILE GUARDOWNER
                   CONTROLLED BY (USER)TEST/GUARD2 ON MYPACK.