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 working storage field names will be prefixed with "URL" followed by the three-letter prefix of the base file as shown in dbdef. For example, if the base file is "COMPANY" and its prefix is "COM", then the name of the "SIZE" field would be "URLCOM-SIZE".

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

Variable Description
URL<Prefix>-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.

URL<Prefix>-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.
URL<Prefix>-CREATE-DATE The date (YYYYMMDD) that the attachment record was created.
URL<Prefix>-CREATE-TIME The time (HHMMSS) that the attachment record was created.
URL<Prefix>-MODIFY-DATE The last date (YYYYMMDD) that the attachment record was modified.
URL<Prefix>-MODIFY-TIME The last time (HHMMSS) that the attachment record was modified
URL<Prefix>-SCHEME HTTP or e-mail address may be up to 50 characters long.
URL<Prefix>-URL-TEXT The text of the URL or e-mail address. May be up to 256 characters.
URL<Prefix>-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 URL-ORDER and DATE-USER fields are used to control the behavior of the URL APIs. The URL-FOUND-SW field is used by the URL APIs to return status from the API calls to the program.

Variable Description
URL<Prefix>-URL-ORDER Specifies the order in which attachment records are retrieved by the 900-FIND-BEGRNG-URL API. Valid values are 0, 1, 2 and 3.
URL<Prefix>-DATE-USER If TRUE, it will use whatever was put into date and time fields instead of auto-filling the creation and modification date and time.
URL<Prefix>-FOUND-SW

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.

The URL<Prefix>-KFOUND and URL<Prefix>-KNOTFOUND 88-level redefines of URL<Prefix>-FOUND-SW are deprecated and should not be used.

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