QUERY PENDINGCMD (Display a list of commands that are pending approval)

Use this command to display a list of commands that were, or currently are, pending approval by an approval administrator.

Privilege class

Any administrator can issue this command.

Important: The history of command approval requests is stored in the IBM Spectrum® Protect server database. The length of time that the history is stored is determined by the value that is specified in the SET SUMMARYRETENTION command. After the specified retention period expires, command approval history is no longer stored in the database.

Syntax

Parameters

Format

Specifies how the information is displayed. This parameter is optional. The default is STANDARD. The following values are possible:

Standard

Specifies that partial information is displayed.

Detailed

Specifies that complete information is displayed.

Type

Specifies the command type that is being queried. The following values are possible:

PENDINg: Displays commands that have a status of PENDING. These commands are pending approval by an approval administrator. This is the default value.
APProved: Displays commands that were pending, but now have a status of APPROVED. These commands were approved by an approval administrator.
REJEcted: Displays commands that were pending, but now have a status of REJECTED. These commands were rejected by an approval administrator.
WITHdrawn: Displays commands that were pending, but now have a status of WITHDRAWN. These commands were withdrawn by the administrator who issued the command.
ALl: Displays the history of all commands that were pending approval or are currently pending approval. This includes pending commands that were approved, rejected, or withdrawn.

Example: Display a detailed list of pending commands

Display information about pending commands that are waiting for approval by an approval administrator.

query pendingcmd


                                  Server Name: Source
                          Date Became Pending: 01/03/2019 12:23:29
                           Pending request ID: 297
                                      Outcome: Pending
                                      Command: del fi \\joe\c$
                           Administrator Name: ADMIN2

Example: Display a detailed list of all commands submitted for approval

Display information about all commands that were submitted for approval.

query pendingcmd f=d type=all


                                  Server Name: Source
                          Date Became Pending: 01/02/2019 18:08:25
                           Pending request id: 274
                                      Outcome: Pending
                                      Command: del file fake *
                           Administrator Name: ADMIN1 
                     Resolution Administrator: 
                              Resolution Date:
                                       Reason:
                    RC from Submitted Command:

Field Descriptions

Server Name

Specifies the name of the server where the command was issued.

Date Became Pending

Specifies the date and time when the pending command was issued by an administrator.

Pending request ID

Specifies the identification number for the pending command request.

Outcome

Specifies the status of the command that was issued. The outcome can be one of the following values:

Pending: Specifies that a command is pending approval by an approval administrator.
Approved: Specifies that a command was approved by an approval administrator.
Rejected: Specifies that a command was rejected by an approval administrator.
Withdrawn: Specifies that a command was withdrawn by the administrator who issued the command.

Command

Specifies the pending command that was issued.

Administrator Name

Specifies the name of the administrator who issued the command.

Resolution Administrator

Specifies the administrator who approved or rejected the command.

Resolution Date

Specifies the date and time that the command was approved, rejected, or withdrawn.

Reason

Specifies the reason that was provided by the administrator who approved, rejected, or withdrew the command.

RC from Submitted Command

Specifies the return code that is issued by the server after the command is approved and the server completes processing of the command.

Related commands

Table 1. Commands related to QUERY PENDINGCMD
Command	Description
APPROVE PENDINGCMD	Approve commands that are pending approval.
REGISTER ADMIN	Defines a new administrator.
REJECT PENDINGCMD	Reject commands that are pending approval.
SET APPROVERSREQUIREAPPROVAL	Specifies whether commands issued by approval administrators require approval.
SET COMMANDAPPROVAL	Specifies whether command approval is required.
UPDATE ADMIN	Changes the password or contact information associated with any administrator.
WITHDRAW PENDINGCMD	Withdraw commands that are pending approval.