CRTCFGL (Create Configuration List)

CRTCFGL Command syntax diagram

 

Purpose

The Create Configuration List (CRTCFGL) command creates a configuration list.

 

Required Parameters

TYPE

Specifies the type of configuration list that will be created.

*APPNDIR: An advanced peer-to-peer networking (APPN) directory search filter configuration list is created. Only the text description (TEXT) and the default action (DFTACN) parameters can be specified using this command.

*APPNLCL: An APPN local location list is created. Up to 476 APPN local location entries are allowed in the configuration list.

*APPNRMT: An APPN remote location list is created. Up to 1898 APPN remote location entries are allowed in the configuration list.

*APPNSSN: An APPN session end point filter configuration list is created. Only the text description (TEXT) and the default action (DFTACN) parameters can be specified using this command.

*ASYNCADR: An asynchronous network address list is created. Up to 294 asynchronous network address entries are allowed in the configuration list.

*ASYNCLOC: An asynchronous remote location list is created. Up to 32000 asynchronous remote location entries are allowed in the configuration list.

*RTLPASTHR: A retail pass-through list. Up to 450 retail pass-through entries are allowed in the configuration list.

*SNAPASTHR: An SNA pass-through list. Up to 254 SNA pass-through entries are allowed in the configuration list. Only the text description for an SNA configuration list can be specified using this command.

 

Notes

1. To add an entry to an SNA configuration list, use the Add Configuration List Entry (ADDCFGLE) command.
   
2. To add a device name and description to an existing entry, use the Change Configuration List Entry (CHGCFGLE) command.

CFGL

Specifies the name of the configuration list. This parameter is valid only when *ASYNCADR is specified on the TYPE parameter. Only one of the other configuration list types is allowed on a system. The list types have system-supplied names: QAPPNDIR, QAPPNLCL, QAPPNRMT, QAPPNSSN, QASYNCADR, QASYNCLOC, QRTLPASTHR, QSNAPASTHR.

 

Optional Parameters

DFTFTRACN

Specifies the default filter action for APPN requests being handled by the local system. This filter action applies to all directory search requests and session endpoint requests that are not specifically listed in the configuration list.

Note:

This parameter is valid only if TYPE(*APPNDIR) or TYPE(*APPNSSN) is specified.

*REJECT: The request is rejected.

*ACCEPT: The request is accepted.

APPNRMTFTR

Specifies whether APPN remote configuration list entries should be used when filtering session endpoint requests.

Note:

This parameter is valid only if TYPE(*APPNSSN) is specified.

*ACCEPT: Session endpoint requests for entries specified in the APPN remote configuration list are accepted.

*NONE: Session endpoint requests will not be filtered using the entries specified in the APPN remote configuration list.

APPNLCLE

Specifies the APPN local location entry. This value is required if *APPNLCL is specified for the TYPE parameter.

*PROMPT: The value of *PROMPT allows the user to add, remove, and change entries using a full-screen entry display.

Element 1: Operation on a Local Entry

local-location-name: Specify the local location name residing on the local system. These names are used by the local APPN controller to determine whether a request being received is intended for its system or another system in the network. The local location name must be unique, and it cannot already exist as a remote location name used by configuration list QAPPNRMT or be specified on another system as a local location in the same APPN network.

Element 2: Describing a Local Entry

*BLANK: Text is not specified.

'entry-description': Specify a short description for each local entry.

APPNRMTE

Specifies the APPN remote location entry. This value is required if *APPNRMT is specified for the TYPE parameter.

*PROMPT: The value of *PROMPT allows the user to add, remove, and change entries using a full-screen entry display.

Element 1: Remote Location Name

*ANY: The system potentially accepts all requests sent to it.

generic*-remote-location-name: Specify the generic name (part of a name followed by an asterisk) of the remote location(s) to be changed. The generic location name allows one directory entry to be defined for all locations, on a single control point, with a name that matches the characters preceding an *. A generic name is a character string of one or more characters followed by an asterisk (*); for example, ABC*. The asterisk substitutes for any valid characters. A generic name specifies all objects with names that begin with the generic prefix for which the user has authority. If an asterisk is not included with the generic (prefix) name, the system assumes it to be the complete object name. See generic names for additional information.

remote-location-name: Specify the full name of a remote location.

Element 2: Remote Network Identifier

*NETATR: The RMTNETID value specified in the system network attributes is used.

*NONE: No remote network identifier (ID) is used.

remote-network-identifier: Specify the network identifier of the network in which the remote location resides.

Element 3: Local Location Name

*NETATR: The LCLLOCNAME value specified in the system network attributes is used.

local-location-name: Specify the location name on the local system. This name is used by APPN to match a local/remote location pair entry.

Element 4: Control Point Name

*NONE: There is no control point name.

control-point-name: Specify the name of the control point that provides network functions for the remote location. This field is required if the entry is either a generic name or *ANY.

Element 5: Control Point Network Identifier

*NETATR: The LCLNETID value specified in the system network attributes is used.

control-point-network-identifier: Specify the network identifier of the network in which the control point resides.

Element 6: Location Password

*NONE: There is no location password.

location-password: Specify the password used when establishing sessions on the local location/remote location name pair. It must be an even number of hexadecimal characters.

Element 7: Location Security

Specifies how security information is handled for program start requests received from remote systems. The value is sent to the remote system when sessions are established. It is used in determining how allocate or evoke requests should be built. The value only applies to conversations started with the SECURITY(SAME) level of security.

*NO: The remote system is not a secure location. Security validation done by the remote system is not accepted. SECURITY(SAME) conversations are treated as SECURITY(NONE). No security information will be sent with allocate or evoke requests.

*YES: The remote system is a secure location and the local system will accept security validation done by remote systems. For SECURITY(SAME) conversations, the local system allows the remote system to verify user passwords. On the remote system, user IDs are retrieved from the operating system. The user IDs are then sent with an already verified indicator in the allocate or evoke requests.

*VFYENCPWD: The remote system is not a secure location. For SECURITY(SAME) conversations, the remote system is not allowed to send the already verified indicator. On the remote system, user IDs and passwords are retrieved from the operating system. Passwords are then encrypted and sent with the user IDs in the allocate or evoke requests, to be verified by the local system. This value should only be used if the remote system is using OS/400 V3R2M0 or later. If the remote system does not support password protection then session establishment will not be allowed. For remote systems that support password protection, but do not support verification of encrypted passwords (VFYENCPWD), conversations will be treated as SECURITY(NONE).

Element 8: Single Session Location

This value specifies whether the connection between the local location and remote location is a single session connection.

*NO: The connection between the local location and the remote location is not a single session connection.

*YES: The connection between the local location and the remote location is a single session connection.

Element 9: Locally Controlled Session

This value specifies, for single connection sessions only, whether the connection between the local location and remote location is locally controlled.

*NO: The single session connection is not locally controlled.

*YES: The single session connection is locally controlled.

Element 10: Preestablished Session

This value specifies whether the single session is automatically bound when the mode is started between the local location and remote location.

*NO: The single session connection is not automatically bound between the local and remote location.

*YES: The single session connection is automatically bound between the local and remote location.

Element 11: Remote Entry Description

*BLANK: Text is not specified.

'entry-description': Specify up to 20 characters of text, enclosed in apostrophes, for the entry description.

Element 12: Number of Single-Session Conversations

10: The number of single session conversations allowed for this device description is ten.

single-session-conversations: Specify the number of conversations allowed for a single session of this device description. Valid values range from 1 through 512.

Note:

The combination of remote location name, remote network identifier, and local location name must be unique. Also, the remote location name cannot already exist as a local location in configuration list QAPPNLCL, or as the current value for either LCLLOCNAME or CPNAME network attribute.

ASYNCADRE

Specifies the asynchronous network address entry. This value is required if *ASYNCADR is specified for the TYPE parameter.

Element 1: Operation on a Network Address Entry

*PROMPT: The value of *PROMPT allows the user to add, remove, and change entries using a full-screen entry display.

network-address: Specify the X.25 network address. This value must contain only digits ranging from 0 to 9.

Element 2: Number of Dial Retries

2: The LZ algorithm with the 12-bit code for repeated substrings in the data stream is used. These codes refer to entries in a common dictionary, created as the data flows between the sender and receiver. The LZ algorithms require storage and extra processing time. The LZ12 requires the most storage and processing time of the LZ algorithms; however, it compresses the data stream the most.

dial-retry: Specify the number of times dialing is retried (because errors occur) before the next number on the list is dialed. The valid number of dial retries ranges from 1 through 255.

Element 3: Description of Network Address Entry

*BLANK: Text is not specified.

'entry-description': Specify a short description for each remote network address entry. Specify no more than 20 characters of text, enclosed in apostrophes.

ASYNCLOCE

Specifies the asynchronous remote location entry. This value is required if *ASYNCLOC is specified for the TYPE parameter.

*PROMPT: The value of *PROMPT allows the user to add, remove, and change entries using a full-screen entry display.

Element 1: Remote Location Name

This name, in combination with the remote location identifier, is used to determine whether an incoming call is accepted. This value must be unique on the system.

remote-location-name: Specify the full name of a remote location.

Element 2: Remote Location Identifier

remote-location-identifier: Specify an identifier which, when combined with the remote location name, determines whether an incoming call is accepted. This identifier must be the same as the remote system's local identifier.

Element 3: Description of Remote Location Entry

*BLANK: Text is not specified.

'entry-description': Specify a short description for each remote location entry.

RTLPASTHRE

Specifies the retail pass-through entry. This value is required if TYPE(*RTLPASTHR) is specified. Up to of 50 entries can be specified for this parameter.

The values for the retail-pass-through entry can be specified as a single value (*PROMPT) or as a list of values (elements).

*PROMPT: The value of *PROMPT allows the user to add, remove, and change entries using a full-screen entry display.

Element 1: Retail Device Name

retail-device-name: Specify the name of the retail device to use for the pass-through session. This must be a unique value.

Element 2: SNA Upline Facility Device Name

SNUF-device-name: Specify the name of the host device to use for the pass-through session. This must be a unique value. retail controller.

Element 3: Default Host Program Name

default-host-program-name: Specify the name of the program to be started on the host if a program name was not specified by the retail controller.

Element 4: Text Description

*BLANK: Text is not specified.

'entry-description': Specify a short description for each retail pass-through entry.

AUT

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

*LIBCRTAUT: The authority for the object is the same as the create authority for QSYS. The create authority for QSYS can be displayed by using the Display Library Description (DSPLIBD) command. If the create authority is changed with the Change Library (CHGLIB) command, the new authority does not affect existing objects.

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

*USE: The user can perform basic operations on the configuration list, such as running a program or reading a file. The user cannot change the configuration list. *USE authority provides object operational authority, read authority, and execute 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 also can change ownership of the configuration list.

*EXCLUDE: The user cannot access the configuration list.

authorization-list-name: Specify the name of the authorization list used.

TEXT

Specifies the text that briefly describes the configuration list. More information on this parameter is in Commonly used parameters.

*BLANK: Text is not specified.

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

Example for CRTCFGL

CRTCFGL   TYPE(*APPNLCL)

This command brings up a full-screen entry display that allows the user to add new entries to configuration list QAPPNLCL.

Error messages for CRTCFGL

*ESCAPE Messages

CPF2182

Not authorized to library &1.

CPF260D

Configuration list &1 already exists.

CPF260E

Configuration list &1 not created.

CPF261C

Index for configuration list &1 not changed.

CPF261D

Index for configuration list &1 not changed.

CPF261F

Configuration list &1 has been deleted.

CPF2625

Not able to allocate object &1.

CPF2634

Not authorized to object &1.

CPF9838

User profile storage limit exceeded.