FLMLPFRT FORTRAN Parser

Purpose

This is the FORTRAN parser translator that parses the source identified by the SOURCE DDNAME.

Using FLMLPFRT

The FORTRAN parser uses the following rules:

Source must be fixed 80 and must be of the fixed form input format. Comment characters ('C' and '*') are recognized in column 1, continuation characters are recognized in column 6, and source statements are recognized in columns 7-72.

Includes recognized are of the forms

   INCLUDE (NAME)
   EXEC SQL INCLUDE NAME

INCLUDE statements can span lines if continuation characters are used.
EXEC SQL INCLUDE statements are recognized and dependencies are generated (SQLCA and SQLDA are not flagged as external dependencies). SQL includes can span lines if continuation characters are used. All other EXEC statements are not flagged as a dependency.
Comments and the contents of quoted strings are ignored.
DBCS strings (delimited by shift-out and shift-in characters) in comments and quotes are allowed.

FLMLPFRT collects the following statistics about the source to be parsed:

Total lines: The total number of records in the file.
Comment lines: The number of lines with a (C) or an asterisk (*) in column 1 plus continued comments. A continued comment is a line that has a nonblank continuation character in column 6 and that follows a comment line or a continued comment.
Noncomment lines: The number of lines that are not comment lines, continued comment lines, or blank lines.
Blank lines: The number of lines that contain only blanks.
Prolog lines: The number of comment lines that are found before the first noncomment line.
Total statements: Comment statements plus noncomment statements.
Comment statements: The number of comment lines minus the number of lines that are continued comments.
Control statements: This value is always 0.
Assignment statements: This value is always 0.
Noncomment statements: The number of noncomment lines minus the number of lines that are continued noncomments. A continued noncomment is a line that has a nonblank continuation character in column 6 and that follows a noncomment line or a continued noncomment.

Parameters

The following keyword parameters are expected as input for FLMLPFRT:

LISTINFO: Pointer to the SCLM list information record. This parameter is required and must be set to @@FLMLIS.
LISTSIZE: The size of the LISTINFO buffer. This parameter is required and must be set to @@FLMSIZ.
PARSEDSN: Data set name containing the member to be parsed. The SCLM variable @@FLMDSN is the recommended value. This parameter is required.
PARSEMEM: The name of the member to be parsed. The SCLM variable @@FLMMBR is the recommended value. This parameter is required.
SOURCEDD: The ddname of the source to be read. This parameter is optional. If a SOURCEDD is specified, it will override the PARSEDSN and PARSEMEM parameters.
STATINFO: Pointer to the SCLM statistics information record. This parameter is required and must be set to @@FLMSTP.

Return codes

FLMLPFRT uses ISPF services. When a failure is the result of an ISPF service error, the message returned by the ISPF service is logged in the user's ISPF log (if there is one).