Job Management Partner 1/Client Security Control Description, User's Guide and Operator's Guide

cscnetctrl (controls network connections)

Function

This command permits or immediately denies access to the network by a specified client.

You must specify the client by one or more of the following: MAC address, IP address, or host name. The client specification is handled according to the following rules:

• When a MAC address is specified, the client is identified by MAC address only.
• When only an IP address is specified, the client is identified by IP address.
• When only a host name is specified, the client is identified by host name.
• When both an IP address and host name are specified, the client is identified by both IP address and host name.

Format

cscnetctrl {-p|-r}{ {-m MAC-address[ -i IP-address][ -h host-name]
                    |-i IP-address[ -m MAC-address][ -h host-name]
                    |-h host-name[ -m MAC-address] [ -i IP-address]}
                    |-f network-connection-control-list-file-name}

Server for execution

JP1/CSC - Manager Remote Option

Required permissions

Administrator permissions

Command directory

JP1/CSC - Manager-Remote-Option-installation-folder\bin

Arguments

-p

Permits network connections by the specified client.

-r

Immediately blocks network connections by the specified client.

-m MAC-address

Specify the MAC address of the client whose network connections are to be controlled.

To specify multiple MAC addresses, use the format -f network-connection-control-list-file-name.

-i IP-address

Specify the IP address of the client whose network connections are to be controlled.

To specify multiple IP addresses, use the format -f network-connection-control-list-file-name.

-h host-name

Specify the host name of the client whose network connections are to be controlled as a character string of 1 to 64 bytes.

To specify multiple host names, use the format -f network-connection-control-list-file-name.

-f network-connection-control-list-file-name

Specify by full path the name of the network connection control list file containing the MAC addresses, IP addresses, or host names of the clients whose network connections are to be controlled.

For details about this file, see 16.15 Network connection control list file.

Notes

• Execute this command when JP1/CSC - Manager is active.
• Execute this command after registering the IP address of the remote management server on which the command is to be executed with JP1/CSC - Manager.
• An immediate denial request by this command takes precedence over other actions when processed by JP1/CSC - Manager.
• To clear an immediate denial executed by this command, the administrator must explicitly grant network connection, either by this command or by instruction in the Client Security Management window. Network connection permission as the result of a subsequent security level judgment does not clear an immediate denial already in force.

Output messages

For details about the messages displayed, see 17.3 List of JP1/CSC messages.

Return values

Return value	Description
0	Command processing terminated normally.
1	The specified command arguments are incorrect.
2	You do not have execution permissions for the command.
3	The format of a MAC address is incorrect.
4	The format of an IP address is incorrect.
5	The length of a host name is incorrect.
6	The specified file could not be accessed.
7	JP1/CSC - Manager - Remote Option has not been set up.
8	The network connection control list file contains an error.
9	JP1/CSC - Manager is inactive.
10	The IP address of JP1/CSC - Manager could not be authenticated.
11	Network connection control processing in JP1/CSC - Manager failed.
255	An error other than those listed above has occurred.

[Contents][Back][Next]

All Rights Reserved. Copyright (C) 2009, 2011, Hitachi, Ltd.
Copyright, patent, trademark, and other intellectual property rights related to the "TMEng.dll" file are owned exclusively by Trend Micro Incorporated