Display Service Agent (DSPSRVAGT)

The Display Service Agent (DSPSRVAGT) command allows a user to display several aspects of Service Agent. The area to be displayed is specified by the Type (TYPE) parameter.

Parameters

Keyword	Description	Choices	Notes
TYPE	Type	DEVICE, SRVINF, MAINT, PRDACTLOG, SRVREGINF, PRBRPT	Required, Positional 1
DEVICE	Device	Character value	Optional
CATEGORY	Category	DASD, TAPE, PROCESSOR, OPTICAL, FSIOP, OTHER	Optional
SENSEFMT	Sense byte format	0, 4, 2, 8, C	Optional
SYSNAME	System or logical partition	Character value, *LOCAL	Optional
OUTPUT	Output	, PRINT	Optional
SRVREP	IBM Service representative	Character value, *BLANK	Optional
SRVTELNBR	IBM Service telephone number	Character value, *BLANK	Optional
RECOMMEND	Recommendations	Character value, *BLANK	Optional
ERRLOGID	Error log identifier	Character value	Optional

Top

Type (TYPE)

Specifies the aspect of Service Agent to be displayed.

This is a required parameter.

*DEVICE: Information from the Service Agent threshold table for a device is to be displayed.
*SRVINF: Information about Service Agent service information collection and transmission is displayed.
*MAINT: The IBM Service preventive maintenance checklist is to be displayed or printed. This is a list of actions suggested during a preventive maintenance call on the system or logical partition. This list should be printed and given to the customer after each preventive maintenance service call.
*PRDACTLOG: A record from the Product Activity Log is to be displayed or printed.
*SRVREGINF: Information needed to register a system or logical partition as a Service Agent is to be displayed.

Device (DEVICE)

Specifies the device for which the threshold table information is to be displayed.

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

character-value: Specify the four-character device type for which the threshold table information is to be displayed. For example, DEVICE(2420) might be specified for a 2420 tape device.

Category (CATEGORY)

Specifies the type of device for which the threshold table information is to be displayed.

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

*DASD: The device is a DASD device.
*TAPE: The device is a tape device.
*PROCESSOR: The device is a processor.
*OPTICAL: The device is an optical device.
*FSIOP: The device is an FSIOP device.
*OTHER: The device is other than one of the above listed devices.

Sense byte format (SENSEFMT)

Specifies the format of the volume statistical data for tape devices.

Note: This parameter is valid only when CATEGORY(*TAPE) is specified.

0: The device does not report removable media statistics.
4: The format is for a 1/4" cartridge tape device.
2: The format is for a 1/2" reel tape device.
8: The format is for an 8 mm tape device.
C: The format is for a 1/2" cartridge tape device.

System or logical partition (SYSNAME)

Specifies the name of the system or logical partition for which information is to be displayed.

Note: This parameter is valid only when TYPE(*SRVINF) is specified.

*LOCAL: Information for the local system or logical partition is to be displayed.
character-value: Specify the name of the system or logical partition for which information is to be displayed.

Output (OUTPUT)

Specifies where the output from the command is to be directed.

Note: This parameter is valid only when TYPE(*MAINT) or TYPE(*PRDACT) is specified.

*: The output is displayed for interactive jobs or printed with the job's spooled output for non-interactive jobs.

*PRINT: The output is printed with the job's spooled output.

IBM Service representative (SRVREP)

Specifies the name of the IBM service representative making this service call or the name of the IBM service representative the customer should contact when they have questions concerning the service performed.

Note: This parameter is valid only when TYPE(*MAINT) and OUTPUT(*PRINT) are specified.

*BLANK: No value is specified.
character-value: Specify the name of the IBM Service contact. This value will be included in the output when OUTPUT(*PRINT) is specified.

IBM Service telephone number (SRVTELNBR)

Specifies the telephone number the customer should call to contact IBM Service.

Note: This parameter is valid only when TYPE(*MAINT) and OUTPUT(*PRINT) are specified.

*BLANK: No value is specified.
character-value: Specify the complete telephone number sequence to contact IBM Service. This value will be included in the output when OUTPUT(*PRINT) is specified.

Recommendations (RECOMMEND)

Specifies any recommendations the IBM Service representative has for the customer.

Note: This parameter is valid only when TYPE(*MAINT) and OUTPUT(*PRINT) are specified.

*BLANK: No value is specified.
character-value: Specify any recommendations IBM Service wishes to make to the customer. This value will be formatted and included in the output when OUTPUT(*PRINT) is specified.

Error log identifier (ERRLOGID)

Specifies the record identifier for the Product Activity Log record that is to be displayed.

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

character-value: Specify the identifier of the Product Activity Log record to be displayed. Identifiers may be found using the Work with Service Agent (WRKSRVAGT) command with TYPE(*EVENT) specified, or by using the Start Service Tools (STRSST) command.

Examples

DSPSRVAGT   TYPE(*DEVICE)  DEVICE(2420)  CATEGORY(*TAPE)

This command will display the information in the Service Agent threshold table for device 2420, a tape device.