Display Firmware Status (DSPFMWSTS)

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

The Display Firmware Status (DSPFMWSTS) command displays information for the current server firmware.

Restrictions:

This command is shipped with exclude (*EXCLUDE) public authority and the QPGMR, QSYSOPR, QSRV, and QSRVBAS user profiles are shipped with private authorities to use this command.

Parameters

Keyword	Description	Choices	Notes
OUTPUT	Output	, PRINT, *OUTFILE	Optional, Positional 1
OUTFILE	File to receive output	Qualified object name	Optional
	Qualifier 1: File to receive output	Name
	Qualifier 2: Library	Name, LIBL, CURLIB
OUTMBR	Output member options	Element list	Optional
	Element 1: Member to receive output	Name, *FIRST
	Element 2: Replace or add records	REPLACE, ADD

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 output is displayed (if requested by an interactive job) or printed with the job's spooled output (if requested by a batch job).
*PRINT: The output is printed with the job's spooled output. The name of the spooled output file is QSYSPRT.

*OUTFILE: The output is directed to the database file specified for the File to receive output (OUTFILE) parameter.

Top

File to receive output (OUTFILE)

Specifies the database file to which the output of the command is directed. If the file does not exist, this command creates a database file in the specified library. If the file is created, the public authority for the file is the same as the create authority specified for the library in which the file is created. Use the Display Library Description (DSPLIBD) command to show the library's create authority. A member is created for the file with the name specified in the Output member options (OUTMBR) parameter. If a new file is created, system file QADSPFMW with a format name of QPZFMW is used as a model. The fields in record format QPZFMW are the same as the fields in the IBM-supplied format QPZFMW in file QADSPFMW in the library QSYS.

Qualifier 1: File to receive output

name: Specify the name of the database file to which the command output is directed.

Qualifier 2: Library

*LIBL: The library list is used to locate the file. If the file is not found, one is created in the current library. If no current library exists, the file will be created in the QGPL library.
*CURLIB: The current library for the thread is used to locate the file. If no library is specified as the current library for the thread, the QGPL library is used.

name: Specify the name of the library to be searched.

Top

Output member options (OUTMBR)

Specifies the name of the database file member that receives the output of the command.

Element 1: Member to receive output

*FIRST: The first member in the file receives the output. If OUTMBR(*FIRST) is specified and the member does not exist, the system creates a member with the name of the file specified for the File to receive output (OUTFILE) parameter. If the member already exists, you have the option to add new records to the end of the existing member or clear the member and then add the new records.

name: Specify the name of the file member that receives the output. If it does not exist, the system creates it.

Element 2: Replace or add records

*REPLACE: The system clears the existing member and adds the new records.

*ADD: The system adds the new records to the end of the existing records.

Top

Examples

DSPFMWSTS   OUTPUT(*PRINT)

This command produces a printout of the current server firmware information.

Top

Error messages

*ESCAPE Messages

CPF3580: No server firmware status to display.
CPF3925: Cannot open file &1.
CPF3950: Error message &2 received for file &1. Request ended.
CPF9860: Error occurred during output file processing.
CPF9899: Error occurred during processing of command.

Top