Appendix A: dqMan Syntax Extensions

This section holds information about undocumented DQL commands as well as dqMan syntax extensions to API and DQL that will not work in other environments.

The API Command: filename

This command can be used anywhere within dqMan (API command, API scripts, functions etc.). The usage is the same as the API get command, but it returns a valid windows filename. This is very helpful for all types of file operations, like export.

Within the returned value all invalid characters are replaced by an underscore.

Command	get,c,<r_object_id>,object_name	filename,c,<r_object_id>,object_name
Return value	Name:Is this a slash / ?	Name_Is this a slash _ _

The DQL Administration Method: set_session_dd_locale

This method can be used to change the current session locale with a DQL command or a DQL script (within dqMan only).

Syntax: EXECUTE set_session_dd_locale WITH locale=’new_locale’

New_locale must be a valid locale in the repository where the command is executed in, e.g. en.

dqMan uses this command in the generated scripts of the functions Edit Attribute or Attribute Create Script.

The DQL Administration Method: count_sessions

This is a regular, but undocumented DQL Administrative Method to find the details of sessions, other than list_sessions and show_sessions.

Syntax: Execute count_sessions

The above DQL returns the following values:

• concurrent_sessions

• history_sessions

• history_timeout

• hot_list_size (active sessions)

• warm_list_size (timed out sessions)

• cold_list_size (free sessions)

This method is also available in the Server Session Statistics session function, available in the Functions menu.

Script Commands and Variables

Go to Customize dqMan to see more about script commands and the use of variables in API scripts. These are also dqMan specific and will not work anywhere else.