modify dfs processes

Purpose

The modify dfs command can start, stop, or query the status of DFS control task daemons or send a command string to the dfskern daemon. For additional modify dfs command options, see Tuning and debugging guidelines.

Format

You can use either of the following formats for this command.

modify procname,{start | stop | query} daemon

modify procname,send dfskern,[reload,{print | smbmap}] 
[trace,{reset | print | tsize,nnM | qtab}]

Parameters

procname

The name of the DFS control task. On DFS, the default procname is DFS.

command

The action that is performed on DFS daemon or daemons. This parameter can have one of the following values:

start: Starts either a single DFS daemon or all the DFS daemons.
stop: Stops either a single DFS daemon or all the DFS daemons.
query: Displays the status and process identifier (PID) of the DFS daemon or DFS daemons. See QUERY command for more information.
send: Sends a command string to the dfskern daemon.

daemon

The name of the DFS control task daemon for which the action is being requested. This parameter can have one of the following parameters:

dfskern

The dfskern daemon is the DFS File Exporter process. The dfskern daemon parameter of the send command can be further modified through the following parameters:

reload

Reload or reinitialization based on the following options:

print: Causes reload or reinitialization of the Infoprint Server DLL. See z/OS Program Directory for more information.
smbmap: Ensures that new SMB identity mappings are used by first eliminating any cached SMB identity mappings and then reloading the updated smbidmap file.

trace

Reset, print, resize, or query the internal SMB trace table based on the following options:

reset: Resets the internal (wrap around) trace table to empty.
print: Format and print the trace records.
tsize,nnM: Sets the size specification for the trace table. The variable nn represents a numeric multiplier and M represents the multipliers KB (1024 bytes), or MB (1024 x 1024 = 1 048 576 bytes).
qtab: Display the current size of the dfskern internal trace table.

export

The export daemon. The export server daemon permits exporting and sharing of HFS File Systems.

unexport

The unexport daemon. The unexport server daemon permits unexporting and unsharing of HFS File Systems.

all

All of the DFS daemons.

Usage

The modify dfs daemon command is used to manually start or stop one or more DFS daemons, or to view the status of the daemons. It is especially useful in situations where a daemon has stopped abnormally. On DFS, the DFS daemons are contained in the dfs address space (with the possible exception of dfskern).

Using the MODIFY system command, you can perform the following tasks:

Start or stop one daemon or all the daemons configured on the host.
View the status of the DFS daemons from the operator console, using the query option
Send a parameter to the dfskern daemon.

The reload,print parameter causes the print DLL used by the SMB File/Print Server to communicate with the Infoprint Server to be reloaded and reinitialized. See z/OS Program Directory for more information about the Infoprint Server DLL. This enables or updates the Infoprint Server without the need to restart dfskern. (You may need to update smbtab and you may need to issue the dfsshare command.) Print jobs in the process of being submitted may need to be resubmitted. An open window for a remote printer may need to be refreshed.

The reload,smbmap parameter eliminates any cached identity mappings and reloads a new smbidmap file to update identity mappings between SMB user IDs and z/OS® user IDs. The new identity mappings take effect for new connections.

Privilege Required

This command is a z/OS system command.

Examples

The following example starts the DFS dfskern process.

modify dfs,start dfskern

The following example starts all the DFS daemons.

modify dfs,start all

The following example views the status of all the DFS Control Task daemons that are currently active on the host.

modify dfs,query all

The following example resets the internal trace table to empty.

modify dfs,send dfskern,trace,reset

In the following example, the dfskern daemon is instructed to eliminate existing identity mappings and to reload an updated smbidmap file that includes recently added or deleted user identity mapping information.

modify dfs,send dfskern,reload,smbmap

Related Information

Files:

ioepdcf
smbidmap