Skip to content

ZosNetwork

The ZosNetwork object represents the overall ZDD Network. ZosNetwork is always the starting point for the ChangeMan ZDD programming interface. It is created as shown in the following section.

ZosNetwork Constructor

The following constructor can be used to initialize a new ZosNetwork object:

Constructor Parameters
ZosNetwork() (none)

See the ZosNetwork Examples section for an example of initializing the network for access.

ZosNetwork Properties

ZosNetwork exposes the following properties:

Property Type R/W Description
Servers ZosServers R Collection of all servers.
Servers[name] ZosServer R Server with specified name.
Servers[name, id] ZosServer R Server with specified name and connection ID.
LocalCodePage Int32 R/W Local ASCII code page.
CacheFolder String R/W Name of folder used to store cached files.
CacheDays Int32 R/W Number of days to keep cached files.
SystemSettingsFolder String R/W The system settings folder allows you to share system settings, server configuration, and security controls, between machines. This folder is optional. You can export the system settings from one machine into a shared folder. The system settings are automatically imported from this folder each time the system is booted.
UserSettingsFolder String R/W The user settings folder is used to save user configuration such as folders and filters. You can share settings between machines by using a shared folder. This is a system-wide setting, but the path name can include environment variables, such as %USERNAME% to make the folder user-specific.
NotifyPort Int32 R/W TCP/IP port number used to receive notification messages from the server. This port number should be unblocked on your local machine in the Windows firewall or other firewall software.
NotifyDelay Int32 R/W Time delay, in seconds, before a message box is displayed. The time delay allows messages to accumulate so that several messages can be displayed in a single message box.
NotifyMessageBox Boolean R/W Display message box for notify messages.
TimeOut Int32 R/W Time, in minutes, to wait for a network operation to complete. Network operations are aborted if no response is received after this period of time. Must be in the range 3 - 30 minutes.
KeepAlive Int32 R/W TCP/IP keep alive time interval, in minutes. TCP/IP keep alive packets are sent after this many minutes of inactivity to detect lost connections.

ZosNetwork Methods

ZosNetwork exposes the following methods:

ExportUserSettings Method

Exports user settings to a file in the specified folder. User settings are those settings that are user-specific, such as “DataSets”, “Jobs”, or “Unix” folder definitions, as well as filters, such as “Applications”, “Packages”, or “Releases” filters.

void  ExportUserSettings(  
            String folder  
            )

ImportUserSettings Method

Imports user settings from a file in the specified folder. User settings are those settings that are user-specific, such as “DataSets”, “Jobs”, or “Unix” folder definitions, as well as filters, such as “Applications”, “Packages”, or “Releases” filters.

void  ImportUserSettings(  
            String folder  
            )

StartNetwork Method

Start the ZDD Network service. This service provides all communication with z/OS servers.

void StartNetwork()

StopNetwork Method

Stop the ZDD Network service. This service provides all communication with z/OS servers.

void StopNetwork()

ZosNetwork Examples

ZosNetwork is the root of the ChangeMan ZDD programming interface. The ZosNetwork object is created as shown in the following examples.

C#

ZosNetwork network = new ZosNetwork();

C++

ZosNetwork^ network = gcnew ZosNetwork();

Visual Basic

Dim network As New ZosNetwork()

Jscript

var network : ZosNetwork = new ZosNetwork();

Examples of getting or setting network properties are shown below.

C

ZosNetwork network = new ZosNetwork();
ZosServers servers = network.Servers;
ZosServer server = network.Servers[“SYSA”];
network.CacheFolder = "C:\\Temp";
network.CacheDays = 3;
network.NotifyPort = 8000;
network.NotifyDelay = 60;
network.NotifyMessageBox = true;

...

C++

ZosNetwork^ network = gcnew ZosNetwork();
ZosServers^ servers = network->Servers;
ZosServer^ server = network->Servers[“SYSA”];
network->CacheFolder = "C:\\Temp";
network->CacheDays = 3;
network->NotifyPort = 8000;
network->NotifyDelay = 60;
network->NotifyMessageBox = true;

...

Visual Basic

Dim network As new ZosNetwork()
Dim servers As ZosServers = network.Servers
network.CacheFolder = "C:\Temp"
network.CacheDays = 3
network.NotifyPort = 8000
network.NotifyDelay = 60
network.NotifyMessageBox = True

...

Jscript

var network : ZosNetwork = new ZosNetwork();
var servers : ZosServers = network.Servers;
var server : ZosServer = network.Servers[“SYSA”];
network.CacheFolder = "C:\\Temp";
network.CacheDays = 3;
network.NotifyPort = 8000;
network.NotifyDelay = 60;
network.NotifyMessageBox = true;

...

Back to top