$ude ("exist")

Check whether a compiled runtime object, symbol table, or script listing exists.

$ude("exist", "Type;ResourceType",ResourceName, "" {, OptionList})

Example: vResult =$ude("exist","resources_output;message", "generror","","library=MyLib;language=fr")

Parameters

Parameters
Parameter Data Type Description
Type String Type of information; one of:
  • resources_output to check for compiled runtime objects
  • symbolTable to check for symbol tables
  • listing to check for ProcScript listings
ResourceType String

Type of compiled runtime object. See Resource Types.

ResourceName String Name of the resource
OptionList String Associative Uniface list containing one or more options that are appropriate to the operation or the ObjectType. See Option List.

Resource Types

Use Gold separators in specifying specific types of resources. Depending on the type, you may need to specify additional options.

Supported Resource Types
Resource Type Syntax   Applies To
Resource Symbol Table ProcScript Listing
Application shells application ✓ ✓ ✓
Signatures signature ✓

 

 
Components

 

 

 

 

 

 

 component -- ✓ ✓
dynamic_server_page ✓ ✓ ✓
server_page ✓ ✓ ✓
form ✓ ✓ ✓
report ✓ ✓ ✓
service ✓ ✓ ✓
entity_service ✓ ✓ ✓
session_service ✓ ✓ ✓
Global variables variables ✓    
Global ProcScript proc ✓ ✓ ✓
Menus, menu bars, and menu items menu ✓ ✓ ✓
Panels panel ✓ ✓  
Messages and help texts message ✓    
Glyphs glyph ✓    
Drag and drop formats format ✓    
Entity descriptor entity_descriptor ✓    
DTD dtd ✓    
Device translation table device_table ✓    
Translation tables translation_table ✓    

Option List

If the ResourceType is a global object, you must also specify the language and library (and class for a glyph). Use Gold ; when specifying multiple options.

Options
Option Description
library=LibraryName Mandatory if ResourceType is a global object.
language=Language Mandatory if ResourceType is message | glyph | format | menu
class=Class Mandatory if ResourceType is glyph. Specifies the size and GUI platform.
model=EntityModel Specify the model if ResourceType is entity_descriptor.

Return Values

Values Returned by $ude ("exist")
Value Description
1 Specified object exists. For runtime objects checked by resources_output, the file properties are returned as a Uniface list in $procreturncontext.
0 Specified object does not exist.

If $status returns <0, an error occurred. $procerror contains the exact error and $procerrorcontext provides the details.

Description

Use $ude ("exist") to check whether an object, symbol table, or script listing exists.

Check the Existence of Global Objects

When checking for global objects, you must specify the library, as well as the language for messages:

vResult=$ude("exist","resources_output;message", "generror","","library=MyLib;language=usa")
vResult=$ude("exist","symboltable;message", "generror","","library=MyLib")
vResult=$ude("exist","listing;proc", "message","","library=MyLib")
History
Version Change
9.3.01 Introduced

Related Topics