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. |