Add CC Server Client (ADDCCSCLT)

Parameters

Keyword	Description	Choices	Notes
CLIENT	Client	Character value	Required, Positional 1
CPNAME	Control point name	Character value	Required, Positional 2
CLTMODE	Client mode	FOCAL, PULL, PUSH, MANAGER, *NOMODE	Optional
CLTTYPE	Client type	CLIENT, SERVER, SINGLE, UI	Optional
SVRNAME	Server name	Character value, *DFT	Optional
DMNID	Domain identifier	Character value, *SVRCPNAME	Optional
OPSYSTYPE	Operating system type	AIX, DOS, HPUX, IRIX, MAC, MVS, NCR, NETWARE, OS2, OS400, SCO, SINIX, SOLARIS, SUNOS, WINDOWS, WINDOWSNT, WINDOWS95, OS/2	Optional
TEXT	Text	Character value, *NONE	Optional
CCPERIOD	Change control period	Element list	Optional
	Element 1: Starting time	Time, *FIRST
	Element 2: Ending time	Time, *LAST
DSTPERIOD	Distribution period	Element list	Optional
	Element 1: Starting time	Time, *FIRST
	Element 2: Ending time	Time, *LAST
MSGLOGLVL	Message log level	NORM, MIN, *DIAG	Optional
CUSTOMER	Customer	Character value, *NONE	Optional
CONTACT	Contact	Character value, *NONE	Optional
ADDRESS	Address	Character value, *NONE	Optional
MANAGER	Manager	Character value, *NONE	Optional
PHONE	Telephone	Character value, *NONE	Optional
PASSWORD	Password	Simple name, *CPNAME	Optional
ACCKEY	Access key	Character value, *NONE	Optional
HDWPARM	Hardware parameter	Single values: NONE Other values (up to 10 repetitions): Element list*	Optional
	Element 1: Parameter	Character value
	Element 2: Value	Character value
INSTKN	Installation token	Single values: NONE Other values (up to 10 repetitions): Element list*	Optional
	Element 1: Token	Character value
	Element 2: Value	Character value
RMTLOCNAME	Remote location name	Element list	Optional
	Element 1: Client address	Character value, CLIENT, CPNAME
	Element 2: Address type	IP, SNA
MODE	Mode name	Communications name, *NETATR	Optional

Top

Client mode (CLTMODE)

Specifies the mode in which the change control client is configured.

*PUSH: The change control client is configured with push mode. Change control and distribution operations on a change control client that is configured with push mode are controlled from a change control server in the network. A push mode change control client cannot intervene in the operations performed on it. This mode is allowed when the value of the Client Type (CLTTYPE) parameter is *CLIENT, *SERVER, or *SINGLE.
*FOCAL: The change control client is configured as a focal point. A change control client configured in this mode receives change control reports from change control clients for which it is defined as the focal point. Reports are routed to the focal point even if operations are initiated from another change control client in the network. A focal point can be considered as a manager. Change control operations cannot be performed on a focal point from a remote change control client.
This value is only valid when the value of the CLTTYPE parameter is *SERVER or *SINGLE. When the change control client is configured as a focal point, it is recognized as a remote change control client. Only one client can be identified as the focal point.
*PULL: The change control client is configured with pull mode. Change control operations on a pull mode change control client can be controlled either by the change control client itself, or by a change control server in the network. This mode is allowed when the value of the CLTTYPE parameter is *CLIENT, *SERVER, or *SINGLE.
*MANAGER: The change control client is configured as a manager. A change control client that is configured in manager mode can perform change control operations on any change control client inside its domain. It also receives change control reports from those change control clients for which it is defined as manager. This mode is allowed when the value of the Client Type (CLTTYPE) parameter is *SERVER or *SINGLE. When the change control client is configured as a manager, it is recognized as a remote change control client.
*NOMODE: The change control client is a user interface only. This mode must be used when the value of the Client Type (CLTTYPE) parameter is *UI (user interface).

Client type (CLTTYPE)

The type of client that you are defining.

*CLIENT: The change control client is configured as a client type. A change control client is of client type when it is working in conjunction with a change control server and has the Software Distribution Client product installed. All local or remote change control clients must be configured. Remote change control clients must be configured if they are to send or receive files or change control requests. Change control operations can be performed on remote change control clients if the remote administration product option is installed on your system. You do not need to configure a remote change control client to receive distributed files or change control commands from it. Up to 2024 local change control clients can be defined for a change control server. This value is only valid when CLTMODE(*PUSH) or CLTMODE(*PULL) is specified.
*SERVER: The change control client is configured as a server type. Change control clients that have the Software Distribution Server option installed are configured as servers. The Software Distribution catalog resides at a change control server, and change control and distribution operations for a change control domain are initiated from them. A change control server can initiate change control operations to remote change control clients if the Remote Administration product option is installed on it. This value is valid for CLTMODE(*PUSH), CLTMODE(*PULL), CLTMODE(*MANAGER), and CLTMODE(*FOCAL).
*SINGLE: The change control client is configured as single-node type. Change control clients running Software Distribution configured as a base system can be configured as single-node change control clients. Single-node change control clients can be used as preparation sites for software or as focal points to receive reports of change control operations. NetView/DM for MVS nodes must be defined as single-node change control clients. This value is valid for CLTMODE(*PUSH), CLTMODE(*PULL), CLTMODE(*MANAGER), and CLTMODE(*FOCAL).
*UI: The change control client is configured as user-interface type. These change control clients that can only be used to run the Software Distribution user interfaces. This type of change control client is useful when you have an environment with more than one change control server. It allows an administrator to access all change control servers from the same change control client either to perform administrative tasks or to schedule distributions to change control clients. A workstation configured as a user-interface change control client is used to initiate change control on other change control clients, or to request distributions to and from the change control server. User interface change control clients cannot receive change control instructions from a change control server to which they are defined as a user interface change control client. This value is valid when CLTMODE(*NOMODE) is specified.

Server name (SVRNAME)

Specifies the name of the change control server that the remote change control client is connected to. This parameter is required if the change control client is remote or if CLTTYPE(*CLIENT) is specified.

*DFT: The name of the change control server to which the change control client is physically connected.
server-name: The name of the change control server to which the change control client is connected. If the name you specify is different from the name of the local server, the client is configured as a remote client.
The server name can be up to 63 characters. Valid server names consist of uppercase letters A through Z, numbers 0 through 9, and special characters at sign (@), dollar sign ($), and the number sign (#). The asterisk (*), question mark (?), and slash (/) characters are not allowed.

Domain identifier (DMNID)

Specifies the change control server domain identifier of the change control client being added. This parameter is not valid when CLTTYPE(*UI) is specified and the change control client is remote, or when the change control client is local. This parameter is required if CLTMODE(*MANAGER) or CLTMODE(*FOCAL) is specified.

*SVRCPNAME: The control point name of the client. If CLTTYPE(*CLIENT) is specified, the domain identifier is set to the control point name of the change control server to which the change control client is connected. If CLTTYPE(*SERVER) or CLTTYPE(*SINGLE) is specified, the domain identifier is set to the value specified in the control point name (CPNAME) parameter.
domain-identifier: Specifies the change control server domain identifier of the change control client being added. The domain identifier can be a maximum of 8 characters. Valid domain identifiers consist of uppercase letters A through Z, numbers 0 through 9, and special characters: the at sign (@), the dollar sign ($), and the number sign (#).

Operating system type (OPSYSTYPE)

Defines the operating system type of the client being defined. Some of the products or names listed within the help text may be trademarks or service marks of other companies.

*OS2: The client running NetView Distribution Manager Agent/2.
*AIX: The client running NetView Distribution Management Agent/6000.
*DOS: The client running NetView Distribution Management Agent for DOS.
*HPUX: The client running NetView Distribution Management Agent for HP-UX, a trademark of Hewlett-Packard Company.
*IRIX: The client running NetView Distribution Manager Agent for IRIX.
*MAC: The client running NetView Distribution Management Agent for Macintosh. Macintosh is a trademark of Apple Computer, Incorporated.
*MVS: The client running NetView Distribution Manager Agent for MVS.
*NCR: The client running NetView Distribution Management Agent for NCR. NCR means Network Computing Resource Corporation which is a division of AT & T Global Information Solutions.
*NETWARE: The client running NetView Distribution Manager Agent for Netware.
*OS/2: The client running NetView Distribution Manager Agent/2.
*OS400: The client running Managed System Services for iSeries.
*SCO: The client running NetView Distribution Management Agent for Santa Cruz Operations (SCO) operating system which is a Unix-based system.
*SOLARIS: The client running NetView Distribution Management Agent for Sun Solaris. Sun Solaris is a SunSoft product and is a trademark of SUN Microsystems, Incorporated.
*SUNOS: The client running NetView Distribution Management Agent for SunOS. SunOS is a trademark of SUN Microsystems, Incorporated.
*SINIX: The client running NetView Distribution Management Agent for SINIX. SINIX is a product of Siemens Nixdorf company.
*WINDOWS: The client running NetView Distribution Management Agent for Microsoft Windows. Windows is a trademark of Microsoft Corporation.
*WINDOWS95: The client running NetView Distribution Manager Agent for Windows 95.
*WINDOWSNT: The client running NetView Distribution Management Agent for Windows NT. Windows NT is a trademark of Microsoft Corporation.

Change control period (CCPERIOD)

Specifies the period of time allocated for change control requests. This parameter is not valid when CLTTYPE(*UI) is specified. This parameter is ignored when the change control client is remote. The following values can be used.

The possible starting time values are:

*FIRST: Use this value to specify that change control operations can start at the first time of day. For example, the first time of day you may want to use is 24:01.
start-time: Specifies the time when the change control requests are started.

The time can be specified as 4 or 6 digits (hhmm or hhmmss, where hh = hours, mm = minutes, and ss = seconds). Seconds are optional. The time can be specified with or without a time separator, such as a colon (:). With a time separator, specify a string of 5 or 8 digits (hh:mm or hh:mm:ss).

The possible ending time values are:

*LAST: Use this value to specify that change control operations can stop at the last time of day. For example, the last time of day you may want to use is 23:59.
stop-time: Specifies the time when the change control requests are stopped.

Distribution period (DSTPERIOD)

Specifies a period of time allocated for distribution requests. This parameter is not valid when CLTTYPE(*UI) is specified. This parameter is ignored when the change control client is remote. There are two values that can be used.

The possible starting time values are:

*FIRST: The distribution requests can start at the first time of day. For example, the first time of day you may want to use is 24:01.
start-time: Specifies the time when the change control requests are started.

The possible ending time values are:

*LAST: The distribution requests are stopped at the last time of day. For example, the last time of day you may want to use is 23:59.
end-time: Specifies the time when the distribution requests are stopped.

Message log level (MSGLOGLVL)

The Message log level defines the log level that should be used by change control clients before they establish a connection to the change control server and discover the level configured for them. This parameter is ignored when the change control client is remote.

*NORM: This is the default log level and includes both errors and messages about the main or normal events such as the acceptance of a change management request.
*MIN: This value should only be selected if there are problems with excess logging on the system. At this level, error logs with the minimal amount of information are produced. Fatal errors are always logged.
*DIAG: This value should only be selected if a collection of logs is being performed for helping to solve a problem. When you specify this value, detailed information about the change control server process is reported.

Hardware parameter (HDWPARM)

This is the value that specifies the definition of a hardware parameter that is used for checking hardware prerequisites when installing a change file. Up to 10 hardware parameters can be specified. This parameter is not valid when CLTTYPE(*UI) is specified. This parameter is ignored when the change control client is remote.

The possible single value is:

*NONE: No hardware parameters are specified.

Possible hardware parameters are:

hardware-parameter: Specify a maximum of 80 characters for the hardware parameter.

value: Specify a maximum of 80 characters for the value of the hardware parameter.

Installation token (INSTKN)

This is the value of an installation token to be used by the client during change file installation. An installation token should be the directories that will contain the files and paths that will be installed with the product on the change control client. Up to 10 installation tokens can be specified. This parameter is not valid when CLTTYPE(*UI) is specified.

The possible single value is:

*NONE: No installation tokens are specified.

Possible installation tokens are:

installation-token: Specify a maximum of 11 characters for the installation token.

The possible installation token values are:

value: Specify a maximum of 49 characters for the value of the installation token parameter.

Remote location name (RMTLOCNAME)

Specifies the address and the address type of the client to be added. This parameter is ignored when the change control client is remote.

The following elements can be specified:

Element 1: Client address

The client address can be an internet protocol host name, an internet address or an SNA network ID and control point name.

A host name must follow these conventions:

The first character must be either an English alphabetic character or a numeric character.
The last character must be either an English alphabetic character or a numeric character.
Blanks ( ) are not allowed.
The special characters, period(.) and minus(-), are allowed.
Parts of the name separated by periods (.) can be up to 63 characters in length.
Internet address names (in the form nnn.nnn.nnn.nnn) are not allowed.
Names must be from 1 to 255 characters in length.
Note: The internet address is specified in the form nnn.nnn.nnn.nnn, where nnn is a decimal number ranging from 0 through 255. An internet address is not valid if it has a value of all binary ones or all binary zeros for the network identifier (ID) portion or the host name portion of the address. If the internet address is entered from a command line, the address must be enclosed in apostrophes.

An SNA client address is specified using the format nnnnnnnn.cccccccc, where nnnnnnnn is the network ID and cccccccc is the control point name. If only the control point name cccccccc is specified, the network ID will be set to the control point name assigned to the change control server. The SNA client address can also be specified as nnnnnnnn.*CPNAME, where *CPNAME is the value specified in the control point name (CPNAME) keyword.

The possible client address values are:

*CLIENT: The client address will be set to the value specified in the client name (CLIENT) keyword. If this value is specified then *IP should be specified as the address type. The value specified in the client name (CLIENT) keyword will be validated as an internet or host name address.
*CPNAME: The control point name will be set to value specified in the control point name (CPNAME) keyword and the network ID will be set to the control point name assigned to the change control server. If this value is specified then *SNA should be specified as the address type.
remote-location-name: Specify an internet protocol host name, an internet address or SNA network ID and control point name.

For more information about the characteristics of the names that can be used here, see the Managed System Services for AS/400 Use book, SC41-3323.

Element 2: Address type

The possible address type values are:

*IP: The remote location name has an Internet Protocol (IP) address type.
*SNA: The remote location name has a Systems Network Architecture (SNA) address type.

Mode name (MODE)

Specify the name of the mode that defines the connection with the change control client. This parameter is ignored when the value of the address type keyword on the RMTLOCNAME parameter is something other than *SNA.

The possible mode values are:

*NETATR: The mode specified in the network attributes is used.
mode-name: Specify a maximum of 8 characters for the mode name. Valid values consist of uppercase letters A through Z and numbers 0 through 9. Embedded blanks are not allowed. If any lowercase characters are specified, the system changes them to and stores them as uppercase characters.

Examples

Example 1: Adding a client using default values

ADDCCSCLT CLIENT(KevinAldux) CPNAME(MEXGPL13)

Example 2: Adding client KevinAldux using hardware parameters, installation tokens, distribution period and password

ADDCCSCLT   CLIENT(KevinAldux)  CPNAME(MEXGPL13)
            TEXT('Client no.2')
            DSTPERIOD('12:30:00' '16:43:00')  PASSWORD()
            HDWPARM((MEM 16MB) (DISK 120MB) (KEYB LA))
            INSTKN((TOKEN1 /USR) (TOKEN2 /USR2))

Example 3: Adding client CONNERY using DOS operating system, Manager, phone, password, address, SNA client address and mode

ADDCCSCLT   CLIENT(CONNERY)  CPNAME(MEXGPL16)  OPSYSTYPE(*DOS)
            TEXT('Client no.3')  DSTPERIOD(*FIRST '16:43:00')
            MANAGER(Charles)  PHONE('(507)285-2884')  PASSWORD()
            ADDRESS('Patria Avenue 30')
            HDWPARM((MEM 16MB) (DISK 120MB) (KEYB LA))
            INSTKN((TOKEN1 /USR) (TOKEN2 /USR2))
            RMTLOCNAME(APPN.MEXGPL13 *SNA)  MODE(blank)

Example 4: Adding client Lorena with Windows/NT operating system, an internet address, message log level, hardware parameters, installation tokens, manager name, phone and password

ADDCCSCLT   CLIENT(Lorena)  CPNAME(MEXGPL13)
            OPSYSTYPE(*WINDOWSNT)  TEXT('Client no.4')
            MSGLOGLVL(*MIN)  MANAGER(Charles)
            PHONE('(507)112-2884') PASSWORD()
            ADDRESS('Patria Avenue 30')
            HDWPARM((MEM 16MB) (DISK 120MB) (KEYB LA))
            INSTKN((TOKEN1 /USR) (TOKEN2 /USR2))
            RMTLOCNAME('9.18.1.2' *IP)