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.

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.

This is a required parameter.

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.

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.

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.

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.

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.

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.

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.