Top
Systemwalker Service Quality Coordinator Reference Guide
Systemwalker

1.1.4 sqcMdPolicy (Temporary Policy Change Command)

Policies can be changed temporarily after they have been applied and started operating (while collection is running). Specifically, once information collection policies for the following middleware products have been created and applied, collection can be stopped (by specifying "off") and started (by specifying "on").

Note

Do not execute multiple sqcMdPolicy command simultaneously.


Privileges required for execution

[Windows]

The privileges of a user belonging to the "Administrators" group are required to execute this command.

[UNIX]

The privileges of a system administrator (superuser) are required to execute this command.

Point

Use temporary policy changes to control information collection behavior according to the operation mode of jobs or cluster systems.

Execution environment

This command can be executed on Enterprise Manager, Manager, Proxy Manager and Agent.

Syntax

[Windows]

<Installation directory>\bin\sqcMdPolicy.exe on|off|stat -c Type [ -i instance-name ]

[UNIX]

/opt/FJSVssqc/bin/sqcMdPolicy.sh on|off|stat -c Type [ -i instance-name ]


Function

This command temporarily changes policies. Specify the management target with the -c option and the instance name with the -i option.


Options

on|off|stat

Specify either of the following types of changes:

  • on: Enables the target policy

  • off: Disables the target policy

  • stat: Display the policy status

    If "on" or "sample" is displayed in the "Execute" column of the displayed results: Policy status is enabled.

    If "off" is displayed in the "Execute" column of the displayed results: Policy status is disabled.


-c Type

Specify one of the following managed objects:

  • sym : Symfoware Server

  • ora : Oracle Database Server

  • jla: Operation Manager

  • reg: Server performance (Windows only)

  • sar: Server performance (UNIX only)


-i instance-name (Can only be specified in the case of a database server)

This option specifies an instance name for the managed object specified by the -c option. If this option is omitted, all instances of the managed object will be targeted.

  • When sym is specified: RDB system name

  • When ora is specified: Instance name

Point

If the RDB system does not have a name, specify "-i @default".

  • ora: Oracle instance name (SID)


Return values

Normal termination: 0
Abnormal termination:>0


  1. A parameter has been specified incorrectly.

  2. The memory required for processing could not be allocated.

  3. There is no policy to be changed.

  4. An internal error has occurred.

  5. An error has occurred with file access.


Usage example

[Windows]

C:\Program Files\SystemwalkerSQC\bin>sqcMdPolicy on -c sym -i systemwalker

[UNIX]

# cd /opt/FJSVssqc/bin/

# ./sqcMdPolicy.sh off -c ora -i orcl

Note

If an operation change is performed using the temporary change command while an Enterprise Manager, Manager, Proxy Manager or Agent is running, the command must be executed again later to return to the original status.