FLMLSS General Purpose Parser

Purpose

This translator provides an interface to the general purpose SYNTRAN parser. Parsing criteria are provided to this translator through tables.

General information:

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.
Total lines and blank lines are always counted.
Control statements and assignment statements are always set to zero.
The FLMLSS FLMPC370 parser is not case-sensitive.
Dependencies are truncated to 8 characters before being added to the dependency list.
Dependencies are ONLY found if they are outside comments. Comment syntax for each table is listed below. No other comment syntax is supported.
Note: This comment syntax does not match that allowed by some compilers.
Table Name

Syntax

FLMPALST

* indicates a comment that ends at the end of the line.

FLMPBOOK

.* or .CM in column 1 or following a semicolon (;) indicates a comment that ends at the end of the line.

FLMC370
/* or */ turns comments on or off. These delimiters are used interchangeably.
In the following example, bold text indicates areas considered to be comments by the FLMLSS parser.
```
         /* Comment 1 */
              #include <i1>
         /* Comment 2 /*
              #include <i2>
         /* Comment 3
         /* Comment 4 */
         #include <i3>
         /*#include <i4>
```
In the example, include dependencies are found for i1, i2, and i4, but not for i3.
FLMDBRM

No comments are processed.

FLMPJOV
Two types of comments are supported. " turns the first type of comment on or off. % turns the second type of comment on or off. This allows for nesting of comments. Comments are allowed between the !COPY or !COMPOOL statement and the copy or compool name.
In the following example, bold text indicates areas considered to be comments by the FLMLSS parser.
```
        !COMPOOL %COMMENT1%('I1');
        !COMPOOL "COMMENT2"('I2');
        !COMPOOL %COMMENT3('I3');
        !COMPOOL "COMMENT4('I4');
        !COMPOOL "COMMENT5%COMMENT6%"('I5');
        !COMPOOL %COMMENT7"COMMENT8"%('I6');
        !COMPOOL "COMMENT9%COMMENT10%('I7');
        !COMPOOL %COMMENT11"COMMENT12"('I8');
```
In the example, include dependencies are found for I1, I2, I5, and I6, but not for I3, I4, I7 or I8.
FLMPPAS
Two types of comments are supported. (* or *) turns the first type of comment on or off and is used interchangeably. /* or */ turns the second type of comment on or off and is used interchangeably. The two comment delimiters let you nest comments.
In the following example, bold text indicates areas considered to be comments by the FLMLSS parser.
```
         %INCLUDE I1; (* COMMENT 1 *)
         %INCLUDE I2; /* COMMENT 2 */
         %INCLUDE I3; (* COMMENT 3 (*
         %INCLUDE I4; */ COMMENT 4 */
         %INCLUDE I5; (* COMMENT 5 /*NESTED COMMENT 5 */ *)
         %INCLUDE I6; /* COMMENT 6 (*NESTED COMMENT 6 *) */
         %INCLUDE I7; (* COMMENT 7
         %INCLUDE I8; (*COMMENT 8
         %INCLUDE I9;
    /* COMMENT 9
         /* COMMENT 10 */
         %INCLUDE I10;
```
In the example, include dependencies are found for I1, I2, I3, I4, I5, I6, I7 and I9 but not for I8 and I10.
FLMPSCRP

.* or .CM in column 1 or following a semicolon (;) indicates a comment that ends at the end of the line.

Parameters

The following keyword parameters are expected as input to FLMLSS

CONTIN

The column in which the continuation line indicator is set in the input file. If you specify 0 for this parameter, the parser will not concatenate continued lines. The default is column 72.

EOLCOL

The maximum number of characters from each input line to be processed by the parser. The parser ignores any information past this point. The default is 0.

LISTINFO

Pointer to the SCLM statistics 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.

PTABLEDD

The ddname assigned to the parser data set load module. This parameter is required.

SOURCEDD

The ddname assigned to the source file to be parsed. This parameter is required.

STATINFO

Pointer to the SCLM statistics information record. This parameter is required and must be set to @@FLMSTP.

TBLNAME

The name of the parser table load module. This parameter is required. The following tables are provided with SCLM:

FLMPALST: Architecture definition
FLMPBOOK: BookMaster®
FLMPC370: C/370™
FLMPDBRM: DBRM
FLMPJOV: JOVIAL
FLMPPAS: PASCAL
FLMPSCRP: Script

Purpose

Parameters

Return codes