URL Working Storage

When a program references any of the URL APIs, the compilation process will automatically generate URL working storage for each base file that is referenced.

The variable names in this table include the three-character database file prefix (<Prefix>). For example, if the program is using the file COMPANY with a prefix of COM, then the URL variable for the SIZE field would be DCOM@U@SIZE.

The values of the following working storage fields are stored in the database.

Variable Description
D<Prefix>@U@NAME

The name of the attachment, as defined in the SC.or file or by the program. The name can be up to 50 characters long. For more information on attachment names, see Application Development Workbench Standards.

D<Prefix>@U@TYPE The one-character user-defined type of the attachment as defined in the SC.or file or by the program. For more information on defining the attachment type, see Application Development Workbench Standards.
D<Prefix>@U@CRTDT The date (YYYYMMDD) that the attachment record was created.
D<Prefix>@U@CRTTM The time (HHMMSS) that the attachment record was created.
D<Prefix>@U@MODDT The last date (YYYYMMDD) that the attachment record was modified.
D<Prefix>@U@MODTM The last time (HHMMSS) that the attachment record was modified
D<Prefix>@U@SCHEME HTTP or e-mail address may be up to 50 characters long.
D<Prefix>@U@URLTXT The text of the URL or e-mail address. May be up to 256 characters.
D<Prefix>@U@SIZE The size of the attachment, in bytes. Valid values are 0 to 256.

The following working storage fields are not stored in the database. The URLORD and DTUSR fields are used to control the behavior of the URL APIs. The D<Prefix>@U@FOUND field is used by the URL APIs to return status from the API calls to the program.

Variable Description
D<Prefix>@U@URLORD Specifies the order in which attachment records are retrieved by the UFNDBEG API. Valid values are 0, 1, 2 and 3.
D<Prefix>@U@DTUSR If TRUE, it will use whatever was put into date and time fields instead of auto-filling the creation and modification date and time.
D<Prefix>@U@FOUND

A single-digit switch which indicates the result of the most recent URL API call. The value should only be set by the URL APIs. Valid values are 0, 1, 2 and 3. 3 is used to indicate that an error occurred. 2 is deprecated.

D<Prefix>@MODE This field is deprecated. Do not use this field or its 88-level redefines.