Hardware Interface Service Commands › Textual Commands for Topology Entities › OSCMD—Send Operating System Command

OSCMD—Send Operating System Command

The OSCMD command sends an operating system command to the operating system in an LPAR. Only an LPAR entity can process this command.

Note: The target operating system is not guaranteed to receive the command, or that the command can be executed. Also, no response is returned from the target. (Some operating systems send OSMSG events, but there is no easy way to correlate the messages in these events to a specific OSCMD request.)

Syntax

OSCMD [ PRIORITY={ NORMAL | HIGH } ]
      [ FOLD={ YES | NO } ]
        COMMAND=command

Parameters

PRIORITY={ NORMAL | HIGH }

(Optional) Priority for this command. The meaning of this priority is not defined. The priority depends on the target operating system.

FOLD={ YES | NO }

(Optional) Controls the folding to uppercase of the command string.

Specify FOLD=NO if you do not want the operating system command to be uppercased.

Default: YES, fold the entire command to uppercase.

COMMAND=command

Actual command that you want to pass to the target operating system. The rest of the command text is treated as part of the command that is passed.

Note: The format and meaning of the actual command depends on the operating system executing in the targeted LPAR.

Important! Any apparent OSCMD command operands that are specified after this point are treated as part of the command. Any OSCMD operands must precede the COMMAND operand.