Start Service Agent (STRSRVAGT)

The Start Service Agent (STRSRVAGT) command allows a user to start an aspect of Service Agent. The aspect to be started is specified by the Type (TYPE) parameter.

Restrictions:

You must have input/output system configuration (*IOSYSCFG) special authority and also have use (*USE) authority to the Create Line Description PPP (CRTLINPPP) command to create service configurations.
You must have job control (*JOBCTL) special authority to run the TYPE(*SBSJOB) of this command.

Parameters

Keyword	Description	Choices	Notes
TYPE	Type	ACTIVATE, ACTPWD, MASTERPWD, SBSJOB	Optional, Positional 1
ACTPWD	Activation password	Character value	Optional
MSTPWD	Master password	Character value	Optional

Top

Type (TYPE)

Specifies the aspect of Service Agent to be started.

This is a required parameter.

*SBSJOB: All Service Agent monitoring jobs which normally run in the QSYSWRK subsystem are to be started in that subsystem. This option will have no effect if the QSYSWRK subsystem does not exist or is not started.
*ACTPWD: The activation password may be entered as part of Service Agent activation.
*ACTIVATE: Service Agent is to be activated. This option may be used only in a batch program. It is useful for those users who have many systems or logical partitions on which to activate Service Agent and would like to distribute a program to do so.
Before this option will run successfully, either the ECS or the Service Agent service configuration must be created. This can be done using the Create Service Configuration (CRTSRVCFG) command.
*MASTERPWD: The master password may be entered.

Activation password (ACTPWD)

Specifies the current value of the activation password. Entering this password is required for activation of hardware problem reporting for a network of systems or logical partitions. An activation password is not required to activate service information collection and transmission capabilities or to activate hardware problem reporting for only the local system or logical partition.

The password will not display when you type it.

Note: This is a required parameter when TYPE(*ACTPWD) is specified.

character-value: Specify the activation password.

Master password (MSTPWD)

Specifies the current value of the master password. This may be either the original master password, or the additional value already created.

Note: This is a required parameter when TYPE(*MASTERPWD) is specified.

character-value: Specify the master password.

Examples

STRSRVAGT   TYPE(*SBSJOB)

This command starts the Service Agent monitoring jobs that run in the QSYSWRK subsystem.