ADDRESS AXC Commands › Commands for Utilities › CONFIG Command

CONFIG Command

The CONFIG Command applies configuration for AP Desktop. The command reloads configuration for all sessions and function windows, optionally also rules and termination and initialization Rexx programs from selected session definition set. It can also reload configuration for single session or function window or all sessions or function windows from active session definition set.

For more information on which configuration items are applied see Applying Configuration Changes to a Running AP Desktop topic in the Administrator Guide.

This command has the following format:

"CONFIG RELOAD {DEFSET(name) | ACTDEFSET} [TERMREXX(YES|NO)] [INITREXX(YES|NO)] [RULES(YES|NO)]"
"CONFIG RELOAD {SESSION(name) | ALLSESSIONS | FNWIN(name) | ALLFNWINS}"

RELOAD

Specifies to load configuration and apply it. This keyword is required. After this keyword specify one of DEFSET, ACTDEFSET, SESSION, ALLSESSIONS, FNWIN or ALLFNWINS keyword. Optional TERMREXX, INITREXX and RULES keywords are only valid when DEFSET or ACTDEFSET is specified.

DEFSET

Specifies session definition set name to load configuration from. This session definition set is marked as active during the reload.

ACTDEFSET

Specifies to load configuration from active session definition set.

TERMREXX

Specifies whether to execute previously configured termination Rexx program before reloading session definition set configuration.

Default:yes

INITREXX

Specifies whether to terminate previously configured initialization Rexx programs before reload and execute new initialization Rexx programs after reloading session definition set configuration.

Default:yes

RULES

Specifies whether to reload rules during reload of session definition set configuration.

Default:yes

SESSION

Specifies to reload configuration of a session from active session definition set.

ALLSESSIONS

Specifies to reload configuration of all sessions from active session definition set.

FNWIN

Specifies to reload configuration of a function window from active session definition set.

ALLFNWINS

Specifies to reload configuration of all function windows from active session definition set.

Note: When a session with message processing buffer opened by OPENBUF command is reloaded, this buffer is closed and all unprocessed messages are lost.

Examples:

"CONFIG RELOAD DEFSET(Session Definition Set 1) TERMREXX(no) INITREXX(no) RULES(no)" 

This command loads configuration for all sessions and function windows from specified session definition set and marks it as active.

"CONFIG RELOAD ACTDEFSET"

This command executes previously configured termination script, then loads configuration for all sessions and function windows from active session definition set and reloads rules, configuration for termination and initialization Rexx scripts and executes initialization Rexx scripts. New configuration for termination Rexx script will have effect for next reload or AP Desktop shutdown.

"CONFIG RELOAD SESSION(MCS1)" 

This command reloads configuration for session MCS1 from active session definition set. Other sessions and function windows are unaffected.