net Command

Purpose

Configures and controls Fast Connect servers.

Syntax

net [ help | start | stop | pause | resume | config | status | statistics | trace | share ]

Description

The net command configures and controls Fast Connect servers.

Subcommands

net help Subcommand

Syntax

net help subcommand

or

net subcommand help

Description

Provides help information about the subcommands.

net start Subcommand

Purpose

Starts the server

Syntax

net start [/load]

Description

The start subcommand starts and initializes the server using parameters from the configuration file.

It can start the server only if the server process is already loaded but the server is in stopped (not running) state. The server can be in this state either in the beginning when the process was started at system initialization time or after stopping the server using net stop.

Flags

/load

Loads the server process if it is not already loaded.

Return Codes

0	The server (%s) is already running.
0	The server (%s) has started successfully.
1	Syntax error was detected: Unknown keyword or command option (%s).
2	The server (%s) could not be started because its process was not running.
3	The request is not valid for the current state of the server (%s).
4	Operation could not be performed.

net stop Subcommand

Purpose

Stops and terminates the server.

Syntax

net stop [/unload]

Description

The net stop subcommand stops and unloads the server. It can stop the server only if it is running or paused. Once stopped, the server can be restarted using net start.

Flags

/unload

Unloads the server process.

Return Codes

0	The server (%s) has stopped successfully.
0	The server (%s) has stopped and its process unloaded successfully.
1	Syntax error detected: Unknown keyword or command option (%s).
2	The request is not valid for the current state of the server (%s).
3	Error in unloading the server process on the server (%s).
4	Operation could not be performed.
5	Either cifsPrintServer is not running or it could not be terminated.

net pause Subcommand

Purpose

Pauses the server

Syntax

net pause

Description

The net pause subcommand pauses the server. It can pause the server only if it is running. Once paused, the server does not accept any new connections but continues serving the existing ones. It can be resumed with net resume.

Return Codes

0	The server (%s) has paused successfully.
1	Syntax error detected: Unknown keyword or command option (%s).
2	The request is not valid for the current state of server
3	Operation could not be performed.

net resume Subcommand

Purpose

Resumes the server.

Syntax

net resume

Description

The net resume subcommand resumes the server. It can resume the server only if it is paused. Once resumed, it starts accepting new connections.

Return Codes

0	The server (%s) has resumed successfully.
1	Syntax error detected: Unknown keyword or command option (%s).
2	The request is not valid for the current state of server
3	Operation could not be performed.

net config Subcommand

Purpose

Lists and changes the configuration parameters of the server.

Syntax1

net config

Syntax2

net config /component

Syntax3

net config /component: cname /parameter:val

Syntax4

net config /listparm /component: cname /parameter:parameter

Description

The net config subcommand lists and changes the configuration parameters of the server. For example:

Syntax1	Lists the configuration parameters.
Syntax2	Lists all the components or groups of configuration parameters for the server.
Syntax3	Adds or changes the given parameter for the given component cname.
Syntax4	Lists the entry for the given parameter for the given component cname from the configuration file.

Note: The configuration parameter can only be changed by the root user.

Flags

/listparm

Lists the given parameter for the given component.

/component:cname

Specifies the component in the configuration file whose parameter needs to be added or changed. Valid values for cname are smbserver, and one of the shares specified for shares parameter of the smbserver. The default component is smbserver. The parameter can be one of the following: /maxconnections:number Maximum number of connections to server resources. 0 specifies unlimited number. /maxusers:number Maximum number of users (sessions) that are permitted. 0 specifies unlimited number. /autodisconnect:number Timeout (in minutes) for inactive, unused sessions. /maxopens:number Maximum number of open files on the server. 0 specifies unlimited number. /maxsearches:number Maximum number of open searches on the server. 0 specifies unlimited number. /servername:s_name The name of the server. /domainname:d_name The name of the domain, server belongs to. /guestname:g_name Logon name as guest on the server. /passthrough_authentication_server:pas_name The name of the passthrough authentication server. /backup_passthrough_authentication_server:bpas_name The name of the backup passthrough authentication server. /primary_wins_ipaddr:pwins_addr Specifies the dotted IP address of the primary WINS server. /secondary_wins_ipaddr:swin_ipaddr Specifies the dotted IP address of the secondary WINS server. /wins_proxy:0|1 Specifies whether or not the server has to act as WINS PROXY. Valid values are 0 for no and 1 for yes with 0 as the default. /send_file_api:0|1 Specifies whether or not the send_file API is to be used. Valid values are 0 for off and 1 for on with 1 as the default. /send_file_size:sf_size If the send_file_api is 1 and the requested SMB read size is greater than the value of this parameter, send_file API will be used in the SMB operation. The value ranges between 1 and 4194304 with 4096 as the default value. /send_file_cache_size:sfc_size If the send_file_api is 1 and the requested SMB read size is less than the value of this parameter, the send_file API will cache the file. The value ranges between 0 and 4194304 with 0 as the default value which means that the send_file API will not cache the file. /umask:u_mask AIX umask. It is an octal value and ranges between 0 and 0777 with 022 as the default. /guestlogonsupport: 0|1 Specifies whether or not guest access is allowed. Valid values are 0 for no and 1 for yes with 0 being the default. /dosattrmapping:0|1 If set to 1, then Archive, System, and Hidden attributes will be mapped to user, group, and other execute bits respectively. Otherwise, these attributes are not supported. /dosfilenamemapping:0|1 If set to 1, long filenames will be mapped to 8.3 format. Otherwise long filenames will be truncated. /dosfilenamemapchar:m_char The characters used to map long filenames to 8.3 format. Valid values are'~' and '^' with '~' being the default.

Return Codes

0	Command completed successfully.
1	Syntax error: Unknown keyword or command option (%s).
2	Command could not be executed. Invalid parameter value (%s).
3	Operation could not be performed.

Output for syntax1 command net config

        Server Name                             ........
        Server Description                      ........
        Domain Name                             ........
        AIX Fast Connect Software version       ........
        Guest ID Name                           ........
       

Assuming that the smbserver had entries:

       adapters = tr0 tr1 and
       shares   = file0 print1)

Output for syntax2 command net config /component

        smbserver
        tr0
        tr1
        file0
        print1

Assuming that the smbserver had entries

       adapters = tr0 tr1 and
       shares   = file0 print1

Output for syntax4 command net config /listparm /component:smbserver /parameter: adapters

        tr0 tr1

Output for syntax4 command net config /listparm /component:smbserver /parameter: shares

        file0 print1

net status Subcommand

Purpose

Displays status of the server.

Syntax

net status

Description

The status subcommand displays status of the server. It tells whether the status of the server is running, paused, or stopped.

Return Codes

0	Server (%s) is running.
1	Syntax error: Unknown keyword or command option (%s).
2	Server (%s) is not running.
3	Server (%s) has been paused.
4	Operation could not be performed

net statistics Subcommand

Purpose

Displays the statistics on server resource usage.

Syntax

net statistics [ /reset ]

Description

Lists the statistics on server resources since it was started or resets the statistics.

Flags

/reset

Resets all statistic fields for the server.

Return Codes

0	Command completed successfully.
1	Syntax error: Unknown keyword or command option (%s).
2	Operation could not be performed.

Output

Server statistics for server (%s) since %s time

  Sessions started              .....
  Sessions timedout             .....
  Sessions dropped              .....
  Password Errors               .....
  Permission Errors             .....
  System Errors                 .....
  Bytes sent low                .....
  Bytes sent high               .....
  Bytes received low            .....
  Bytes received high           .....
  Average response              .....
  Request buffer failures       .....
  Big buffer failures           .....
  Jobs  queued                  .....

net trace Subcommand

Purpose

Turns tracing on or off for the server.

Syntax1

net trace /on

Syntax2

net trace /off

Description

Turns tracing on or off for the server. The user does not have to start or stop the server.

Flags

/on	Turns tracing on.
/off	Turns tracing off.

Return Codes

0	Command completed successfully.
1	Syntax error: Unknown keyword or command option (%s).
2	Operation could not be performed.

net share Subcommand

Purpose

To list, add and delete file or printer shares on the server.

Syntax1

net share [ /infolevel:0|1|2 | /netname:share_name ]

Syntax2

net share /add /netname:share_name /type:file /path:path_name [/desc:share_desc ]

Syntax3

net share /add /netname:share_name /type:printer /printq:qname [/print_options:ostr | /desc:share_desc]

Syntax4

net share /delete /netname:share_name

Description

Syntax1 lists one or more shares.
Syntax2 adds a file share to the server.
Syntax3 adds a printer share.
Syntax4 deletes a share from the server.

Note: To change a share, you must first delete it and then add it again.

Flags

/add	Adds a share to the server.
/deletes	Deletes a share from the server.
/infolevel	Specifies the level of information desired. Default level is 1. Valid values are 0, 1 and 2 and 99.
/type	Specifies the share type. Valid values are file and printer. Default value is file.
/netname:share_name	Name of the share that is to be listed, added or deleted. Without this option, all shares will be listed.
/path:path_name	Absolute pathname of the share which must be specified if it is of type file.
/printq:qname	Name of the share queue which must be specified if it is of type printer.
/print_options:ostr	String specifying printer options.
/desc:desc	Brief description of the share.

Return Codes

0	Command completed successfully.
1	Syntax error: Unknown keyword or command option (%s).
2	Operation could not be performed.
3	Command could not be executed. Invalid value (%s) of parameter.
4	Syntax Error: The share path or queue name must be specified.
5	Error adding the share - share name already exists.
6	Error deleting the share - share name not found.
7	The configuration file could not be updated to reflect the current change.

Output for info level 0 :

        netname1
        netname2
        ...
        netnamen

Output for info level 1 :

        Share Name      Share Type      Path Name or        Share Description
                                        Queue Name
        -----------     ----------      ---------------     ------------------

        netname1        File            /home/name/xxx      File Description
        netname2        Printer         lpq1                Printer Description
        ......          ......          ....                ..........
        netnamen        Printer         lpq2                Printer Description

Output for info level 99 :

        netname:%s:type:%s:path:%s:printq:%s:print_options:%s:desc:%s::