Send License (SNDLIC)

Where allowed to run: All environments (*ALL)
Threadsafe: No
Parameters
Examples
Error messages

The Send License (SNDLIC) command provides the capability to send one or more license keys from the central site system to one or more managed systems. Only the license keys matching the system serial number will be added to the managed system license repository.

Notes:

  1. A change request is automatically submitted which can be viewed to determine the status of this command. A message is returned identifying the name of the change request.
  2. All the existing records in the central site license repository containing the license key information for the specified product will be sent to the specified managed system or systems. Only those ones that match the system serial number are added to the managed system license repository.

Restrictions:

  1. This command is shipped with public authority of *EXCLUDE.
  2. If a node list (NODL) value is specified, the node list can only contain entries that have a value of *SNA for the address type.
  3. The license key information for the specified product and managed system must exist in the central site license repository.
Top

Parameters

Keyword Description Choices Notes
PRDID Product ID Character value, *ALL Required, Positional 1
LICTRM License term Character value, *ALL Required, Positional 2
NODL Managed systems node list Element list Optional
Element 1: Node list Single values: *NONE
Other values: Qualified object name
Qualifier 1: Node list Name
Qualifier 2: Library Name, *LIBL, *CURLIB
CPNAME Managed system node names Single values: *NONE
Other values (up to 50 repetitions): Element list
Optional
Element 1: Network identifier Communications name, *NETATR
Element 2: Control point Communications name
Top

Product ID (PRDID)

Specifies the 7-character identifier of the product for which the license key information will be distributed.

The possible values are:

*ALL
The license keys for all the products existing in the central site license repository will be distributed.
product-ID
Specifies the 7-character identifier of the product for which the license key information will be distributed.
Top

License term (LICTRM)

Specifies the license term for which the licenses key information will be sent.

The possible values are:

*ALL
The product licenses for all license term found will be sent.
license-term
Specify the license term in one of the following formats:
Vx
The authorized usage limit is valid for the entire version of the product or feature.
VxRy
The authorized usage limit is valid for the entire release of the product or feature.
VxRyMz
The authorized usage limit is valid only for a modification of the product.

where x and y can be a number from 0 through 9, and z can be a number 0 through 9 or a letter A through Z.

Top

Managed systems node list (NODL)

Node list object name that contains a list of systems which are the destinations for the request. Cannot be specified if control point names (CPNAME parameter) are also specified.

The possible values are:

*NONE
The systems on which this activity is to be performed are not identified by a node list. Individual control point names must be specified.

The possible library values are:

*LIBL
All of the libraries in the user and system portions of the job's library list are searched for the node list object.
*CURLIB
The current library for the job is used to locate the node list object.
library-name
Only the library named in this keyword is searched.

The possible value for the node list name is:

node-list-name
Node list object name which contains the list of systems on which the command is to be performed.
Top

Managed system node names (CPNAME)

The APPN control point names of the managed systems on which this activity is to be performed. Control point names cannot be specified if the node list (NODL) parameter is specified.

*NONE
The systems on which this activity is to be performed are not identified individually. A node list must be specified.
*NETATR
The network ID of the local system will be used. This useful when the node being specified is in the same network as the local system.
network-identifier
The APPN network identifier of the managed system on which the activity is to be performed, it is a character field of length 8.
control-point-name
The APPN control point name of the managed system on which the activity is to be performed, it is a character field of length 8.
Top

Examples

SNDLIC   PRDID(1ACCOUN)  LICTRM(V4)  CPNAME((*NETATR SYS1))

Send the licenses for 1ACCOUN product with license term V4, and add the licenses matching the system serial number to the repository of system SYS1.

Top

Error messages

None

Top