Process Command Language › System-supplied Data Fields

System-supplied Data Fields

System-supplied data fields are available that keep count of how many input, output, and suspense file records have been read or written by each dialog. A field is set to zero when the file it describes is opened; therefore, if an input file is opened, closed, and then opened again, the field is reset to zero when the file is opened a second time. Data in these fields can be moved to other data fields, but data cannot be moved into these fields.

Syntax for the system-supplied data fields, including the data fields used in the online environment, is shown below:

►►─┬─ + ◄ ─┬──┬── DIRECT-DBKEY  ─────────────┬─────────────────────────────────►◄
   └─ - ───┘  ├── DB-NAME ───────────────────┤
              ├── NODE-NAME ─────────────────┤
              ├── agr-data-field ────────────┤
              ├── amr-data-field ────────────┤
              ├── $RESPONSE ─────────────────┤
              ├── $PAGE ─────────────────────┤
              ├── LENGTH ( map-field-name ) ─┤
              ├── CURSOR-ROW ────────────────┤
              ├── CURSOR-COLUMN ─────────────┤
              ├── JULIAN ────────────────────┤
              ├── JULIANX ───────────────────┤
              ├── DATE ──────────────────────┤
              ├── DATEX ─────────────────────┤
              ├── TIME ──────────────────────┤
              ├┬─ $ERROR ──┬─────────────────┤
              │└─ $ERRCNT ─┘                 │
              ├┬─ $INPUT-COUNT ─┬────────────┤
              │└─ $INCNT ───────┘            │
              └┬─ $OUTPUT-COUNT ─┬───────────┘
               └─ $OUTCNT ───────┘

Syntax rules for the batch parameters follow:

$ERROR-COUNT

(Batch only) contains the number of input records that have been written to the suspense file for the current dialog. Data cannot be moved to $ERROR-COUNT.

Note: If a record is to be written to the suspense file, but a suspense file was not allocated for the dialog, nothing is written; however, $ERROR-COUNT is still incremented.

$INPUT-COUNT

(Batch only) contains the number of input records that have been read for the current dialog. Data cannot be moved to $INPUT-COUNT.

$OUTPUT-COUNT

(Batch only) contains the number of output records that have been written for the current dialog. Data cannot be moved to $OUTPUT-COUNT.