Script Statement: Changes the system settings while the system is running.
:SET_UC_SETTING Setting, Component, Value
Currently, you can use the script statement :SET_UC_SETTING in order to change three system settings. Your modifications are valid until a new value is assigned or until the server processes or the agent are terminated.
To change the system settings, you need the authorization "Modify at runtimeThe duration of a task's execution. It refers to the period between a task's start and end. It does not include its activation period (see also: activation and start)."
and the privilege "Create diagnostic information".
This script statement has the effect that all the script's open transactions are written to the AE databaseA database is an organized collection of data including relevant data structures..
If you change trace options for WPs, you may change them only for all of them together. It is not possible to change them for individual WPs.
You should change the trace options for CPs one at a time.
Changing Trace Options
By setting trace options, you can use a script to log the behavior of work processes and agents in exceptional cases. Neither the work processes nor the agents need to be terminated for this purpose but setting trace options can result in a lot of data that is accumulated and performance losses can be a result thereof. Automic recommends setting trace
options only in close cooperation with our support team.
To modify the trace options, you can use the Setting SET_TRACE. The Value
is a 16-digit string. Each digit corresponds to a particular trace
flag (such as the first position in a TCP/IP trace).
The order of
the trace flags complies with the order that is used in the System OverviewThe UserInterface window that contains information about the Automation Engine system.'s properties dialog for server
processes and agents.
If you reboot only one work process, it will use the trace options that are specified in the INI file. All other work processes use the values that are specified by using the script statement :SET_UC_SETTING until they are rebooted.
The first example sets the number of resources that the agent WIN01 provides for jobs and file transfers to 1000. The result is written to the activation reportA report provides more detailed information about a task's execution or a component..
:SET_UC_SETTING WORKLOAD_MAX, WIN01, 1000
:SET &RET# = GET_UC_SETTING(WORKLOAD_MAX_JOB,
WIN01)
:PRINT &RET#
The second example retrieves the name of the AE system and then activates the TCP/IP trace for its work processes.
:SET &TRC# = GET_UC_SYSTEM_NAME()
:SET_UC_SETTING
SET_TRACE, &TRC#,
"1000000000000000"
The following example changes the server process AE#WP003 to a dialog process provided that it is active.
:IF SYS_SERVER_ALIVE("AE#WP003") = "Y"
: SET_UC_SETTING "SERVER_MODE", "AE#WP003", "D"
:ELSE
: SEND_MSG "ADMIN","AE","Work process AE#WP003
is not active!"
:ENDIF
In this example the trace options for the agent WINAGENT01 are set with the noted values, those to be found in the agent's properties dialog in the System Overview:
:SET_UC_SETTINGSET_TRACE,"WINAGENT01","2400000000000000,MEMORY,128,SIMPLE,FileTransfer * ended abnormally."
See also:
Script element | Description |
---|---|
Reads current system settings. |
Script Elements - System Conditions and Settings
About Scripts
Script Elements - Alphabetical Listing
Script Elements - Ordered by Function
Automic Documentation - Tutorials - Automic Blog - Resources - Training & Services - Automic YouTube Channel - Download Center - Support |
Copyright © 2016 Automic Software GmbH |