Useful commands for administrators

Product administrators can issue the following commands using the modify (MODIFY) operator console command.

DB2® QUERY ID
Description: Use this command to determine the subsystem ID (SSID) of the Db2® subsystem that the Output Manager started task is using.

Syntax: Use the following command syntax:

MODIFY started_task_name,DB2 QUERY ID
DB2 QUERY QUEUES
Description: Use this command to determine the status of Output Manager requests to the Db2 database. A message will be displayed that specifies: 1) the number of Db2 requests that are currently queued and waiting for a Db2 task to become available, 2) the total number of Db2 requests (queued and undergoing processing), and 3) the total number of Db2 tasks that are active for the Output Manager started task.

Syntax: Use the following command syntax:

MODIFY started_task_name,DB2 QUERY QUEUES
POLICY ACTIVATE or ACTIVATE
Description: Use this command to activate the current policy. The policy is composed of the set of selector rules, subselector rules and report selection rules that are currently enabled and saved on your Output Manager system. You must activate the policy whenever you create or change a rule. Otherwise, your changes will not take effect.

If the policy is already activated, this command deactivates the current policy and activates the new policy.

Note: The web server options in Type = ITOMWeb, are only loaded when the server is restarted. At server startup, the configuration table is read and the values are stored in local workspace variables. The ACT command should not be allowed for ITOMWeb.

To restrict the use of this command, you can use a RACF® profile. The resource name for the ACTIVATE command is BJT.BJTNAME.CMND.ACTIVATE, where BJT is the SAF ID and BJTNAME is the product instance name.

To specify the ACTIVATE command, use in any of the following methods:

  • By using the Modify operator command. Use the following syntax: 
    MODIFY started_task_name,POLICY ACTIVATE
  • By specifying POLICY ACTIVATE in the SBJTSAMP member BJT#IN03. This method activates the policy each time Output Manager is started. For more information, see the customization chapter of IBM Tivoli Output Manager for z/OS Installation and Customization Guide.
  • By issuing the ACTIVATE command from the command line on the Selector Rules panel or Report Rules panel in the ISPF interface. To do so, you must have administrator authority.
  • By issuing the ACT command from the command line on the Policy Administration panel. To do so, you must have administrator authority.
    1. Access the Policy Administration panel (Option A.PA from the main menu).
    2. At the command line, type ACT.
    3. Specify * in both the Subsystem and Type fields and press Enter.
    4. In the activation results pop-up window, press Enter.
    Note: The ACT command issued from A.PA does not stop and restart the sysout and report selectors. It only affects the configuration options in the specified Subsystem/Type.

To specify the ACTIVATE command from an ISPF panel:

  1. Access the Selector Rules panel (Option A.S from the main menu) or the Report Rules panel (Option A.R from the main menu).
    Tip: If you change any rules that comprise the policy, you must specify the SAVE command prior to issuing the ACTIVATE command. Otherwise, your changes will be lost.
  2. At the command line, type ACTIVATE (or only ACT) and press Enter.
  3. In the Rules Activation Confirmation pop-up window, press Enter.
  4. In the activation results pop-up window, press Enter. The panel from which you started is redisplayed and the policy is activated.
Note: The ACT command does not reset the options for current ISPF sessions. Sessions that start after you have saved changes to Type = ISPF options will pick up the new values. Each user starting an ISPF session loads all configuration options from the database.
POLICY DEACT
Description: Use this command to deactivate the policy and stop the selector tasks that are running. Other Output Manager functions, including the ISPF interface, remain available. You might want to stop selectors as part of diagnosing a problem. To reactivate the policy and start the selector tasks again, you must issue the POLICY ACTIVATE command.

Syntax: Use the following command syntax:

MODIFY started_task_name,POLICY DEACT
QUERY CONDCODE
Description: Use this command to determine the option that is currently in effect for reporting condition codes from jobs (that is, the option that was set with the CONDITION_CODE configuration parameter.) This option can be either LASTNONZERO (report the last non-zero condition code) or HIGHEST (report the highest non-zero condition code).

Syntax: Use the following command syntax:

MODIFY started_task_name,QUERY CONDCODE
For additional commands: Additional commands can be issued with the Modify command but are more appropriately specified as startup commands. For more information, see the customization chapter of IBM Tivoli Output Manager for z/OS Installation and Customization Guide.