Display Remote Definition (DSPRMTDFN)

Where allowed to run: All environments (*ALL)
Threadsafe: No
Parameters
Examples
Error messages

The Display Remote Definition (DSPRMTDFN) command allows the user to display or print remote definitions for a system. The output can be displayed, printed, or directed to a database file.

Top

Parameters

Keyword Description Choices Notes
SYSTEM System name Element list Required, Positional 1
Element 1: System name Character value, *ANY, *ALL
Element 2: System group Character value
OUTPUT Output *, *PRINT, *OUTFILE Optional, Positional 2
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 *ADD, *REPLACE
Top

System name (SYSTEM)

Specifies the system name and system group of the remote system being displayed.

The possible values are:

*ANY
Displays the default definition for a remote system not covered by the other entries.
*ALL
Displays all definitions for remote systems.

The possible System Name value is:

system-name
Specify the name of the remote system to be displayed.

The possible System Group value is:

system-group
Specify the group name of the remote system to be displayed. Do not specify this value if the group name is blank.
Top

Output (OUTPUT)

Specifies whether the output from this command is displayed, printed, or directed to a database file. More information on this parameter is in "Appendix A, Expanded Parameter Descriptions" in the CL Reference.

The possible values are:

*
Output requested by an interactive job is shown on 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 output is directed to the database file specified on the File to receive output prompt (OUTFILE parameter).
Top

File to receive output (OUTFILE)

Specifies the qualified name of the database file to which the output of this command is directed. If the file does not exist, the system creates a file in the specified library. If a new file is created, system file QAOCRMTDFN in system library QSYS with a record format name of RMTDFN is used as a model. If the file already exists, it must have this format.

The possible library 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 file. If no library is specified as the current library for the job, the QGPL library is used.
library-name
Specify the name of the library where the file is located.

The possible value is:

file-name
Specify the name of the output file.
Top

Output member options (OUTMBR)

Specifies the name of the database file member to which the output is directed.

The possible member to receive output values are:

*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 on the File to receive output prompt (OUTFILE parameter).
member-name
Specify the file member that receives the output. If OUTMBR(member-name) is specified and the member does not exist, the system creates it.

The possible operation to perform on member values are:

*REPLACE
The output data replaces existing records in the specified member.
*ADD
The output data is added after existing records in the specified member.
Top

Examples

Example 1: Displaying a Specific Remote Definition

DSPRMTDFN   SYSTEM(RCHAS1)

This command displays the current attributes for remote system RCHAS1.

Example 2: Writing a Definition to an Output File

DSPRMTDFN   SYSTEM(*ALL)  OUTPUT(*OUTFILE)  OUTFILE(RMTDFNOUT)

This command writes the current attributes for all defined remote systems to the output file RMTDFNOUT.

Top

Error messages

*ESCAPE Messages

CPF6A50
Error was found during display file or printer file operation.
CPF6DCA
SYSTEM parameter cannot be local system.
CPF6DCC
Remote definition for system &1 &2 not found.
CPF9860
Error occurred during output file processing.
CPF9899
Error occurred during processing of command.
Top