Add CC Server Client (ADDCCSCLT)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Add Change Control Server Client (ADDCCSCLT) command allows the user to define a change control client to be recognized by the change control server. This command should be used at least to define the first change control client to the change control server.
| Top |
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 (CLIENT)
Specifies the name of the change control client being added.
- client-name
- Specify a maximum of 63 characters for the name of the client. Valid client names consist of uppercase letters A through Z, numbers 0 through 9, and the following special characters: at sign (@), dollar sign ($), and number sign (#).
The asterisk (*), the question mark (?), and the slash (/) characters are not allowed.
| Top |
Control point name (CPNAME)
Specifies the APPN control point name for the change control client being added. This value is the control point part of the SNA distribution services address. NetView/DM refers to this field as the target address.
- control-point-name
- Specify the name of the APPN control point of the client being added. A maximum of 8 characters can be used in this field. Both letters and numbers are allowed. Embedded blanks are not allowed. If any lowercase characters are specified, the system changes them to and stores them as uppercase characters.
| 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).
| Top |
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.
| Top |
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.
| Top |
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 (#).
| Top |
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 IBM Managed System Services for i5/OS.
- *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.
| Top |
Text (TEXT)
Specifies the text that describes the change control client being added.
- *NONE
- No text is specified.
- description
- Specify up to 59 characters for the description of the client.
| Top |
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.
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).
| Top |
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 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
- 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.
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).
| Top |
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.
| Top |
Customer (CUSTOMER)
The name of the customer at the client system. This name is used when it is necessary to contact the customer.
The possible customer values are:
- *NONE
- No customer name is specified.
- customer-name
- Specify up to 59 characters for the name of the customer. The customer name can be specified in any format appropriate to the user.
| Top |
Contact (CONTACT)
Specifies the name of the person that service personnel on the change control client enterprise should contact.
The possible contact values are:
- *NONE
- No contact name is specified.
- customer-name
- Specify up to 59 characters for the name of a contact. The contact name can be specified in any format appropriate to the user.
| Top |
Address (ADDRESS)
Specifies the street address, city, state, country or region, and zip code of the change control client enterprise.
- *NONE
- No address is specified.
- contact-address
- Specify up to 199 characters for an address for the specified client. The contact address can be specified in any format appropriate to the user.
| Top |
Manager (MANAGER)
Specifies the name of the person who is the manager on the change control client enterprise.
- *NONE
- No owning manager is specified.
- owning-manager
- Specify up to 59 characters for the name of the owning manager for the specified client. The owning manager can be specified in any format appropriate to the user.
| Top |
Telephone (PHONE)
Specifies the complete change control client enterprise telephone number. The telephone number should include the area code, exchange, number, and the extension where the service representative can reach the person to contact about system problems.
- *NONE
- No telephone number is specified.
- telephone-number
- Specify up to 31 characters for the telephone number of the client. The telephone number can be specified in any format appropriate to the user.
| Top |
| Top |
Access key (ACCKEY)
The client access key (TAK) value. If this value is specified, the access key must exist in the access key table and must be assigned to the user.
The possible access key values are:
- *NONE
- No client access key is specified.
- access-key
- Specify an access key to be assigned to the client. The access key is a four-byte binary field. An example of a client access key is TAK1.
| Top |
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.
| Top |
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.
| Top |
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.
| Top |
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.
| Top |
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)
| Top |
Error messages
*ESCAPE Messages
- MSS0A1A
- Target access key not found.
- MSS0A1F
- Control point name &2 already exists.
- MSS0A2B
- Installation token not valid.
- MSS0A2D
- Client name specified already exists.
- MSS0A29
- Target access key table not found.
- MSS0123
- Internal processing error occurred.
- MSS2102
- Change control client not added.
| Top |