SBMRMTCMD (Submit Remote Command) command

The Submit Remote Command (SBMRMTCMD) command submits a command using DDM to run on the target server.

The remote location information in the DDM file is used to determine the communications line to be used, and thus, indirectly identifies the target server that is to receive the submitted command.

You can use the SBMRMTCMD command to send commands to any of the following target servers:

The SBMRMTCMD command can be used to send CL commands (and only CL) to an iSeries server or a System/38. It can also be used to send commands to target servers other than iSeries or System/38 servers if the target server supports the DDM architecture Submit System command. The command must be in the syntax of the target server. The SBMRMTCMD command cannot be used to send operation control language (OCL) commands to a System/36™ target because the System/36 server does not support the function.

The primary purpose of this command is to allow a user or program using the source server to perform file management operations and file authorization activities on files located on a target server. The user must have the proper authority for the target server objects that the command is to operate on. The following actions are examples of what can be performed on remote files using the SBMRMTCMD command:

Although the command can be used to do many things with files or objects, some are not as useful as others. For example, you can use this command to display the file descriptions or field attributes of remote files, or to dump files or other objects, but the output remains at the target server. Another way to display remote file descriptions and field attributes at the source system is to use the Display File Description (DSPFD) and Display File Field Description (DSPFFD) commands. Specify the SYSTEM(*RMT) parameter and the names of the DDM files associated with the remote files. This returns the information you want directly to the local server.

A secondary purpose of this command is to allow a user to perform nonfile operations (such as creating a message queue) or to submit user-written commands to run on the target server. The CMD parameter allows you to specify a character string of up to 2000 characters that represents a command to be run on the target server.

Related concepts
Parts of DDM: DDM file
Source server actions dependent on type of target server
Related reference
Perform file management functions on remote servers
Reclaim DDM Conversations (RCLDDMCNV) command