Command Syntax

The syntax of the VARY WLM,APPLENV command is:

V WLM,APPLENV=applenvname,                        {REFRESH}
                                                  {QUIESCE|Q}
                                                  {RESUME}
     ,DYNAPPL=applenvname,{SNODE=nodename},
                          {SNAME=subsystemname},
                          {STYPE=subsystemtype},

WLM,APPLENV=applenvname

Specifies the 1 to 32 character name of the application environment for the command.

The VARY WLM command is rejected if the named application environment does not exist in the workload management service definition. To list all the application environment names, use the DISPLAY WLM,APPLENV=* command.

WLM,DYNAPPL=applenvname

Specifies the name (length=1–32 characters) of the dynamic application environment for the command. The VARY WLM,DYNAPPL command is rejected if the named dynamic application environment was not defined to the system. To list all the dynamic application environment names, use the DISPLAY WLM,DYNAPPL=* command. The following keywords are valid:

SNODE=nodename: When SNODE=nodename is used, the VARY WLM,DYNAPPL command specifically applies to the dynamic application environments with the specified node name.
SNAME=subsystemname: When SNAME=subsystemname is used, the VARY WLM,DYNAPPL command specifically applies to the dynamic application environments with the specified subsystem name.
STYPE=subsystemtype: When STYPE=subsystemtype is used, the VARY WLM,DYNAPPL command specifically applies to the dynamic application environments with the specified subsystem type.

REFRESH

Specifies that the application environment server address spaces be terminated after completion of the currently executing request and new ones started in their place.

QUIESCE | Q

Specifies that the application environment server address spaces be terminated after completion of the currently executing request. No new server address spaces can be started for the application environment by either WLM or an operator. Additional work requests for an application environment that supports queueing, are queued but not selected.

When an application environment is quiesced, changes can be made to libraries, procedures, and other items for the application environment.

To restart the application environment, use the VARY WLM,APPLENV=applenvname,RESUME command; any other VARY WLM,APPLENV action is rejected by the system.

To restart a dynamic application environment, use the VARY WLM,DYNAPPL=applenvname,RESUME command; any other VARY WLM,DYNAPPL action is rejected by the system.

RESUME

Specifies that the application environment be restarted. After this command is executed, server address spaces are allowed to start. Work requests that are queued are eligible for selection.

Example 1:

To quiesce application environment db2pay, enter:

V WLM,APPLENV=db2pay,Q

The system responds with:

IWM032I VARY QUIESCE FOR DB2PAY COMPLETED

Example 2:

To quiesce dynamic application environment websphere in node testnode, enter:

V WLM,APPLENV=websphere,snode=testnode,Q

The system responds with:

IWM032I VARY QUIESCE FOR WEBSPHERE COMMAND COMPLETED