Display Hardware Resources (DSPHDWRSC)

Where allowed to run: All environments (*ALL)
Threadsafe: No

The Display Hardware Resources (DSPHDWRSC) command is used to display, print, or save in an output file the various types of System Resource Management (SRM) information.

Restriction: The Work with LAN Adapters (WRKLANADPT) command must be run before running this command; otherwise, there is no information to display.

Top

Parameters

Keyword	Description	Choices	Notes
TYPE	Type	AHW, CMN, CRP, CSA, LAN, LWS, PRC, STG	Required, Positional 1
OUTPUT	Output	, PRINT, *OUTFILE	Optional, Positional 2
OUTFILE	File to receive output	Qualified object name	Optional, Positional 3
	Qualifier 1: File to receive output	Name
	Qualifier 2: Library	Name, LIBL, CURLIB
OUTMBR	Output member options	Element list	Optional, Positional 4
	Element 1: Member to receive output	Name, *FIRST
	Element 2: Replace or add records	REPLACE, ADD
OUTFILFMT	Outfile format	TYPE1, TYPE2	Optional, Positional 5
LINETYPE	Line type	ALL, DDI, *TRN	Optional, Positional 6

Top

Type (TYPE)

Specifies the type of information that is to be displayed, printed, or written to an output file.

The possible values are:

*AHW: Displays, prints, or directs to an output file the combined contents of all hardware resource records. This includes all *CMN, *CRP, *CSA, *LWS, *PRC, and *STG records.
*CMN: Displays, prints, or writes to an output file the communications resource information. This information consists of the resource name, resource type, serial number, location, status, address, configuration description, and resource description.
*CRP: Displays, prints, or writes to an output file the cryptographic resource information. This information consists of the resource name, resource type, serial number, location, status, address, configuration description, and resource description.
*CSA: Displays, prints, or directs to an output file the coupled adapter resource information. This information consists of resource name, model, status, location, resource description, and the system the adapter is connected to.
*LAN: Displays, prints, or directs token-ring or distributed data interface adapter resource information to an output file. This information consists of the LAN controller adapter address, adapter name, line type, and adapter description.
*LWS: Displays, prints, or writes to an output file the local work station resource information. This information consists of the resource name, resource type, serial number, location, status, address, configuration description, and resource description.
*PRC: Displays, prints, or writes to an output file the processor resource information. This information consists of the resource name, resource type, serial number, location, status, and resource description.
*STG: Displays, prints, or writes to an output file the storage devices resource information. This information consists of the resource name, resource type, serial number, location, status, address, configuration description, and resource description. For fibre channel adapters, the information also includes the worldwide port name, port status, protocol, port speed, and the number of targets detected.

This is a required parameter.

Top

Output (OUTPUT)

Specifies whether the output from the command is displayed at the requesting work station or printed with the job's spooled output.

The possible values are:

*: Output requested by an interactive job is shown in the display. Output requested by a batch job is printed with the job's spooled output.

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

*OUTFILE: The requested data is stored in an output database file.

Top

File to receive output (OUTFILE)

Specifies the name and library of the output file used to store the requested System Resource Management (SRM) data. Only one of the following types of resource information can be stored per output file: *CMN, *CRP, *CSA, *LWS, *PRC, *STG, or *LAN. If the output file does not exist, this command creates a database file in the specified library. If a new file is created, the system uses as a model one of the following file names with one of the following format names, depending on the value specified on the Type prompt (TYPE parameter).

  TYPE Parameter       Output File Created
      Value          Output File    Format
      *CMN            QARZDCMN      QRZDCMN
      *CRP            QARZDCRP      QRZDCRP
      *CSA            QARZDCSA      QRZDCSA
      *LWS            QARZDLWS      QRZDLWS
      *PRC            QARZDPRC      QRZDPRC
      *STG            QARZDSTG      QRZDSTG
      *LAN            QARZDTRA      QRZDTRA

This parameter is valid only if *OUTFILE is specified on the Output prompt (OUTPUT parameter).

The possible values are:

*LIBL: All libraries in the library list for the current thread are searched until the first match is found.

*CURLIB: The current library for the job is used to locate the output file. If no library is specified as the current library for the job, QGPL is used.
library-name: Specify the name of the library where the output file is located.
file-name: Specify the name of the file where the requested information is to be stored.

Top

Output member options (OUTMBR)

Specifies the name of the database file member to which the output is directed when *OUTFILE is specified for the Output (OUTPUT) parameter.

The possible values are:

*FIRST: The requested SRM data is stored in the first member.
member-name: Specify the name of the member used to store the requested SRM data. Valid values range from 1 through 10 characters.

The possible optional values are:

*REPLACE: If a member exists, the old information is cleared and the new information is added.
*ADD: If a member exists, the new information is added to the end of the existing information.

Top

Outfile format (OUTFILFMT)

Specifies the physical file model used to format the output file.

Note: This parameter is not used when TYPE(*LAN) is specified.

The possible values are:

*TYPE1: The format of the output file is the same as that of the physical file models, QARZDCMN, QARZDCRP, QARZDCSA, QARZDLWS, QARZDPRC, and QARZDSTG.
*TYPE2: The format of the output file is the same as that of the physical file model, QARZALLF, and its associated record format model, QRZALL. This value is the functional equivalent of the physical file, QARZHWOF, which was used by the DSPLCLHDW command in releases prior to V3R6M0.

Top

Line type (LINETYPE)

Specifies the local area network (LAN) type for which information will be displayed, printed, or directed to an output file.

This parameter is required if TYPE(*LAN) was specified.

The possible values are:

*ALL: Both distributed data interface and token-ring network adapter resource information is displayed, printed, or directed to an output file.
*DDI: All distributed data interface adapter resource information is displayed, printed, or directed to an output file.
*TRN: All token-ring network adapter resource information is displayed, printed, or directed to an output file.

Top

Examples

DSPHDWRSC  TYPE(*STG)
           OUTPUT(*OUTFILE)  OUTFILE(STG)  OUTFILFMT(*TYPE2)

This command places SRM information for storage resources in the output file STG, which is formatted like the physical file model, QARZALLF. If output file STG is located in the library list, the records of its first member are replaced by the new records. If output file STG is not located in the library list, it is created in the current library with first member STG. This member contains the new records.

Top

Error messages

*ESCAPE Messages

CPF8B75: No adapter entries in network adapter file.
CPF9812: File &1 in library &2 not found.
CPF9815: Member &5 file &2 in library &3 not found.
CPF9845: Error occurred while opening file &1.
CPF9846: Error while processing file &1 in library &2.
CPF9847: Error occurred while closing file &1 in library &2.
CPF9860: Error occurred during output file processing.

Top