Initialization › Initialization Parameter Statement Descriptions › CID

CID

Syntax

CID cidname,
    AUTH= 1 | 2 | 3,
    GROUP=nnnn,
    ISTATUS=START | STOP,
    MAXPORT=nn,
    OPENTYPE=A | U,
    PASSWORD=cccccccc,
    RCVLIM=16 | nn,
    SNDLIM=16 | nn,
    USMR=NO | YES,
    XFERLIM=16 | nn

Description

The CID statement specifies the characteristics of a communication channel.

We strongly recommend that you avoid specifying any value for AUTH and GROUP. These parameters are maintained only to ensure backward compatibility; set OPENTYPE = U, and SECUCALL.

For more information about communication channels and the use of the Advanced Communication Interface, see the chapter Application Program Facilities in the Programming Guide.

CID Parameters

This section describes the CID parameters:

cidname,

This required parameter specifies the full or generic name of a communication channel.

The cidname must be:

• Alphanumeric and from 1 - 8 characters for a full channel name
• Alphanumeric and from 1 - 4 characters for a generic channel name

This parameter does not have a default value.

See also the MAXPORT parameter, discussed later in this section.

AUTH = 1 | 2 | 3,

This parameter specifies the authorization level associated with this communication channel; values are as follows:

• 1—(Default) Gives ordinary user level.
• 2—Gives system operator level.
• 3—Gives supervisor level, which means ordinary user level extended to display all files and all nodes in the system.

GROUP=nnnn,

This optional parameter defines the number of the network group to which this communication channel is related. The upper limit is MAXGROUP if specified else 99,999.

Note the following:

• If you specify AUTH=1, then this parameter causes the communication channel to be logically connected to the specified network group, and all messages sent to this network group are also sent to the user of this communication channel.
• If you specify AUTH=2, then this parameter has no meaning.
• If the communication channel is to be dynamically associated to various CA Spool network groups, this parameter must be omitted or set to zero. During opening of the communication channel, the CA Spool network group number must be supplied exactly or indirectly as the group to which a specified node belongs.

The default value is 0.

ISTATUS=START | STOP,

This parameter specifies whether this communication channel must be initially started.

If you specify ISTATUS=STOP, then the communication channel cannot be opened by a communication user program until the channel is started by the system operator.

The default value is START.

MAXPORT=nnnn,

This parameter specifies the maximum number of users who can use this communication channel concurrently. The value of MAXPORT can range from 1 - 9999.

Note:

• If this parameter is specified, the cidname is considered to be a generic communication channel name, and the cidname must be only 1 - 4 characters in length.
• CA Spool allocates a communication interface block (CIB) for each port requested during initialization. It also assigns a channel name consisting of the generic cidname appended with a numeric sequence number from 1 to the value of MAXPORT, causing the channel name to be a total of 8 characters in length.
• If this parameter is specified, the communication system user must specify that a generic channel name will be used when the channel is opened. If this is done, CA Spool assigns a free communication port in the pool defined by the generic name and returns the full channel name to the issuer of the open channel request.

This parameter does not have a default value.

OPENTYPE=A | U,

This parameter specifies the values that can be entered in the TYP field in the COMI parameter list.

Options are as follows:

• A—(Default) All the values are allowed in the TYP field in the COMI parameter list.
• U—If this value is specified, U is the only value, which can be specified in TYP field in the COMI parameter list. Other values result in a PE error.

Be aware that the cidname is considered to be a full channel name and only one communication interface block (CIB) is allocated.

PASSWORD=cccccccc,

This parameter specifies an optional password to be associated with this communication channel.

If specified, the password must be a 1- to 8-character alphanumeric string. The user of this communication channel must supply this password when the channel is opened.

This parameter does not have a default value.

RCVLIM=16 | nn,

This parameter specifies the maximum number of concurrent outstanding receive requests the communication channel can have, in the range 0 - 65535. If a value of 0 is specified, there is no limit on the number of concurrent receive requests. The default value is 16.

SNDLIM=16 | nn,

This parameter specifies the maximum number of concurrent outstanding send requests the user of this communication channel might have.

The value can range from 0 - 65535. If a value of 0 is specified, there is no limit to the number of concurrent pending send requests. The default value is 16.

USMR=NO | YES,

The USMR (unsolicited message receiver) parameter specifies whether the user of this communication channel must receive unsolicited messages, that is, messages not related to a specific user. The default value is NO.

XFERLIM=16 | nn,

This parameter specifies the number of data transfer buffers to be allocated when the communication channel opens.

The value of XFERLIM can range from 1 - 32 and must be considered carefully because the buffers are allocated in ECSA subpool 241 common storage. Each data transfer buffer occupies 168 bytes of storage. The default value is 16.