Data Manipulation Language Statements › #TREQ › List #TREQ

List #TREQ

Using the list #TREQ you can build a terminal request block (TRB) in the data definition section of program storage, and assign constant values. After you have issued one list #TREQ statement, subsequent execute #TREQ statements override only the fields in the named TRB that need to be updated.

The TRB is identified by the list #TREQ label. This label is referenced by the TRB parameter in subsequent execute requests.

In the list #TREQ, only the label and the MF parameter are required; all other parameters should be specified only when required to predefine TRB parameter values.

In a list #TREQ request, parameter values cannot be specified by using register notation. The list #TREQ syntax presented here shows only those parameters that are affected by this restriction. Syntax for the list #TREQ statement is shown below:

Syntax

►►─┬─────────┬─ #TREQ ─┬─ ALLOC ────┬─────────────────────────────────────────►
   └─ label ─┘         ├─ CHECK ────┤
                       ├─ DISC ─────┤
                       ├─ GET ──────┤
                       ├─ PUT ──────┤
                       ├─ PUTGET ───┤
                       ├─ READ ─────┤
                       ├─ UIOCB ────┤
                       ├─ WRITE ────┤
                       └─ WRITREAD ─┘

 ►─── ,MF=L ──────────────────────────────────────────────────────────────────►

 ►─┬─────────────────────────────────────────┬────────────────────────────────►
   └─ ,OUTAREA=output-data-location-pointer ─┘

 ►─┬────────────────────────────────────────┬─────────────────────────────────►
   └─ ,OUTLEN=output-data-length-register ──┘
 ►─┬────────────────────────────────────────┬─────────────────────────────────►
   └─ ,INAREA=input-data-location-pointer ──┘

 ►─┬─────────────────────────────────────────┬────────────────────────────────►
   └─ ,MAXIN=input-data-max-length-register ─┘

 ►─┬──────────────────────────────────┬───────────────────────────────────────►
   └─ ,UIOCBA=user-i/o-control-block ─┘

 ►─┬────────────────────────┬─────────────────────────────────────────────────►
   └─ ,LTEADDR=lte-address ─┘
 ►─┬─────────────────────────┬────────────────────────────────────────────────►
   └─ ,SENSE=sna-sense-code ─┘

 ►─┬─────────────────────────────┬────────────────────────────────────────────►
   └─ ,LOGDATA=log-data-address ─┘

 ►─┬────────────────────────────────────────┬─────────────────────────────────►◄
   ├─ ,DESTID=destination-id-pointer ───────┤
   ├─ ,USERID=user-id-pointer ──────────────┤
   └─ ,LTERMID=logical-terminal-id-pointer ─┘

Parameters

ALLOC/CHECK/DISC/GET/PUT/PUTGET/READ/UIOCB/WRITE/WRITREAD

Specifies the type of #TREQ statement.

MF=L

Specifies a list #TREQ.

Each parameter (other than MF=L) functions identically to the corresponding parameter in the regular and execute forms of #TREQ statements, described previously.

For example, the value specified for OUTAREA must be a symbolic name of a user-defined area, whereas in the regular and execute forms it could be either a register that points to the area or the symbolic name of the area.