Create Node List (CRTNODL)

The Create Node List (CRTNODL) command allows the user to create a node list object. This object is used to store node names that identify a set of systems in a network.

Note: Node lists can be used by system functions to indicate an operation is to be performed on a set of systems.

Parameters

Node list (NODL)

Specifies the qualified name of the node list object to be created.

The node list name can be qualified by one of the following library values:

*CURLIB

The node list is created in the current library for the job. If no library is specified as the current library for the job, the QGPL library is used.

library-name

Specify the name of the library where the node list is to be created.

The possible values are:

node-list-object-name

Specify the name of the node list to be created.

Text 'description' (TEXT)

Specifies text that briefly describes the node list.

The possible values are:

*BLANK

Text is not specified.

'description'

Specify no more than 50 characters of text, enclosed in apostrophes.

Authority (AUT)

Specifies the authority given to users who do not have specific authority to the object, who are not on the authorization list, and whose user group has no specific authority to the object.

The possible values are:

*LIBCRTAUT

The public authority for the object is taken from the CRTAUT value of the target library (the library that is to contain the object). This value is determined when the object is created. If the CRTAUT value for the library changes after the object is created, the new value does not affect any existing objects.

*CHANGE

The user can perform all operations on the file except those limited to the owner or controlled by object existence authority and object management authority. The user can perform basic functions on the file, and the user can change it. Change authority provides object operational authority and all data authority.

*ALL

The user can perform all operations except those limited to the owner or controlled by authorization list management authority. The user can control the object's existence, specify the security for the object, change the object, and perform basic functions on the object. The user can transfer ownership of the object.

*USE

The user can perform basic operations on the object, such as running a program or reading a file. The user cannot change the object. Use (*USE) authority provides object operational (*OBJOPR), read (*READ), and execute (*EXECUTE) authorities.

*EXCLUDE

The user is prevented from accessing the object.

authorization-list-name

Specify the name of the authorization list used.

Examples

Example 1: Node List Creation without Text Description

CRTNODL   NODL(QGPL/NODL01)

This command creates a node list in library QGPL called NODL01. The node list has the same public authority as that defined for QGPL and it does not have a text description.

Example 2: Node List Creation with Text Description

CRTNODL   NODL(MYLIB/NODL02)  AUT(*EXCLUDE)
          TEXT('This is my Node List number 2')

This command creates node list NODL02 in library MYLIB with public *EXCLUDE authority. The text description for this node list is 'This is my Node List number 2'.

Error messages

*ESCAPE Messages

CPF2108

Object &1 type *&3 not added to library &2.

CPF2112

Object &1 in &2 type *&3 already exists.

CPF2113

Cannot allocate library &1.

CPF2151

Operation failed for &2 in &1 type *&3.

CPF2182

Not authorized to library &1.

CPF2283

Authorization list &1 does not exist.

CPF9810

Library &1 not found.

CPF9820

Not authorized to use library &1.