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
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

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.

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.

Error messages

*ESCAPE Messages

CPF9899
Error occurred during processing of command.