Add Communications Entry (ADDCMNE)

Where allowed to run: All environments (*ALL) Threadsafe: No

Parameters Examples Error messages

The Add Communications Entry (ADDCMNE) command adds a communications entry to an existing subsystem description. Each communications entry describes one or more communications devices, device types, or remote locations for which the subsystem will start jobs when program start requests are received. The subsystem can allocate a communications device if the device is not currently allocated to another subsystem or job. A communications device that is currently allocated may eventually be de-allocated, making it available to other subsystems.

Notes:

1. The job associated with an active subsystem can only find objects that exist in the system auxiliary storage pool (ASP) or in a basic user ASP. Therefore, objects that are referenced by this command should exist in the system ASP or in a basic user ASP.

Restrictions:

1. To use this command, have:

   • object operational (*OBJOPR), object management (*OBJMGT), and read (*READ) authority to the specified subsystem description and execute (*EXECUTE) authority to the library containing that subsystem description.

   • object operational (*OBJOPR) and read (*READ) authority to the job description and execute (*EXECUTE) authority to the library containing that job description.

   • use (*USE) authority to the user profile.

2. Only a user with all object (*ALLOBJ) special authority is allowed to add an entry for which the job description does not exist.

3. A subsystem cannot allocate a communications device that is currently allocated to another subsystem or job.

Top

---

 

Parameters

Keyword	Description	Choices	Notes
SBSD	Subsystem description	Qualified object name	Required, Positional 1
	Qualifier 1: Subsystem description	Name
	Qualifier 2: Library	Name, *LIBL, *CURLIB
DEV	Device	Generic name, name, *ALL, *APPC, *ASYNC, *BSCEL, *FINANCE, *INTRA, *RETAIL, *SNUF	Optional, Positional 2
RMTLOCNAME	Remote location	Communications name	Optional, Positional 3
JOBD	Job description	Single values: *USRPRF, *SBSD Other values: Qualified object name	Optional, Positional 4
	Qualifier 1: Job description	Name
	Qualifier 2: Library	Name, *LIBL, *CURLIB
DFTUSR	Default user profile	Name, *NONE, *SYS	Optional
MODE	Mode	Communications name, *ANY	Optional
MAXACT	Maximum active jobs	0-1000, *NOMAX	Optional

Top

 

Subsystem description (SBSD)

Specifies the name and library of the subsystem description to which the communications entry is being added or in which it is being changed.

This is a required parameter.

Qualifier 1: Subsystem description

name

Specify the name of the subsystem to which the communications entry is being added.

The following IBM-supplied objects are not valid on this parameter:

• QSYSSBSD

Qualifier 2: Library

*LIBL

All libraries in the thread's library list are searched until a match is found.

*CURLIB

The current library for the thread is used to locate the object. If no library is specified as the current library for the thread, the QGPL library is used.

name

Specify the name of the subsystem description's library to which the communications entry is being added.

Top

 

Device (DEV)

Specifies the name of the device description or the type of the device being used with this communications entry.

You must specify a value on either this parameter or the Remote location (RMTLOCNAME) parameter, but not both.

*ALL

All communications device types or names can be used with this communications entry.

*APPC

All advanced program-to-program communications devices can be used with this communications entry. The devices created with the Create Device Desc (APPC) (CRTDEVAPPC) command can be used.

*ASYNC

All asynchronous communications devices can be used with this communications entry. The devices created with the Create Device Desc (Async) (CRTDEVASC) command can be used. This value is valid only when *ANY is specified on the Mode (MODE) parameter.

*BSCEL

All bisynchronous equivalency link communications devices can be used with this communications entry. The devices created with the Create Device Desc (BSC) (CRTDEVBSC) command can be used. This value is valid only when *ANY is specified on the Mode (MODE) parameter.

*FINANCE

Specifies that all finance communications devices can be used with this communication entry. The devices created with the Create Device Desc (Finance) (CRTDEVFNC) command can be used by this communications entry. This value is valid only when *ANY is specified on the Mode (MODE) parameter.

*INTRA

All INTRA communications devices can be used with this communications entry. The devices created with the Create Device Create Device Desc (Intra) (CRTDEVINTR) command can be used. This value is valid only when *ANY is specified on the Mode (MODE) parameter.

*RETAIL

All retail communications devices can be used with this communications entry. The devices created with the Create Device Desc (Retail) (CRTDEVRTL) command can be used by this communications entry. This value is valid only when *ANY is specified on the Mode (MODE) parameter.

*SNUF

All SNA upline facility communications devices can be used with this communications entry. The devices created with the Create Device Desc (SNUF) (CRTDEVSNUF) command are can be used. This value is valid only when *ANY is specified on the Mode (MODE) parameter.

generic-name

Specify the generic name of the device description used with this communications entry.

name

Specify the device description used with this communications entry.

Top

 

Remote location (RMTLOCNAME)

Specifies the name of the remote location used with this communications entry. The remote location name specified in the associated device description can be used here. No validity checking is done on the remote location name.

You must specify a value for either this parameter or the Device (DEV) parameter, but not for both.

communications-name

Specify the name of the remote location used with this communications entry.

Top

 

Job description (JOBD)

Specifies the name and library of the job description used for jobs that are started as a result of receiving a program start request, and that are processed through this communications entry. If the job description does not exist when the entry is added or changed, a library qualifier must be specified because the qualified job description name is kept in the subsystem description.

Only a user with all object (*ALLOBJ) special authority is allowed to add or change an entry for which the job description does not exist.

Single values

*USRPRF

The job description name that is specified in the user profile of the user that made the program start request is used for jobs that are started through this communications entry.

*SBSD

The job description having the same name as the subsystem description, specified on the Subsystem description (SBSD) parameter, is used for jobs started through this communications entry.

Qualifier 1: Job description

name

Specify the name of the job description that is used for jobs started through this communications entry.

Qualifier 2: Library

*LIBL

All libraries in the thread's library list are searched until a match is found.

*CURLIB

The current library for the thread is used to locate the object. If no library is specified as the current library for the thread, the QGPL library is used.

name

Specify the library where the job description is located.

Top

 

Default user profile (DFTUSR)

Specifies the default user profile used for a program start request that contains no security information. This user profile is not used for program start requests that contain a password or specify a user profile (either valid or not valid).

*NONE

No user profile is specified as the default.

*SYS

All user program start requests will be treated the same as *NONE. For program start requests sent by system functions, the request will run under a predetermined user profile if a user profile is not specified on the program start request.

name

Specify the name of the user profile that is used for all program start requests that enter the system through this communications entry and that contain no password or user profile name.

The names QDFTOWN, QLPINSTALL, QSECOFR, QSPL, QDOC, QDBSHR, QRJE, QTSTRQS, and QSYS are not valid entries for this parameter.

Top

 

Mode (MODE)

Specifies the mode name of the communications device or remote location name whose communications entry is being added or changed.

*ANY

Any available modes defined to the communications device or remote location are allocated to the subsystem. If the communications device does not have defined modes associated with it, the communications device itself is allocated to the subsystem.

name

Specify the mode name of the communications device or remote location name that is being added or changed.

The names SNASVCMG and CPSVCMG are not valid for this parameter.

Top

 

Maximum active jobs (MAXACT)

Specifies the maximum number of jobs (received program start requests) that can be active at the same time through this communications entry.

*NOMAX

There is no maximum number of jobs that can be active at the same time through this communications entry.

1-1000

Specify the maximum number of jobs that can be active at the same time through this communications entry.

Top

---

 

Examples

 ADDCMNE   SBSD(ALIB/SBS1)  DEV(COMDEV)

This command adds a communications entry for the APPC device named COMDEV and mode *ANY to the subsystem description SBS1, which resides in library ALIB. The DFTUSR parameter defaults to *NONE, which means that no jobs may enter the system through this entry unless valid security information is supplied on the program start request.

Top

---

 

Error messages

*ESCAPE Messages

CPF1619

Subsystem description &1 in library &2 damaged.

CPF1691

Active subsystem description may or may not have changed.

CPF1697

Subsystem description &1 not changed.

Top